Submitting Your Messenger Bot

When you are ready to release your bot to the public, you must submit it to our team for review and approval. This review process allows us to ensure your Messenger bot abides by our policies and functions as expected before it is made available to everyone on Messenger.

To submit your bot, review the requirements and follow the steps below.


Before you submit your bot, please do the following:

Select app permissions

In the 'App Review' section of the Messenger settings for your Facebook app, click the 'Add to Submission' button for each permission your bot requires. Added permissions will appear in the 'Current Submission' section below.

During the review process, our team will test your bot to ensure each of these permissions is needed, and that your bot complies with any related messaging policies. At a minimum, you should request the pages_messaging permissions, which allows your bot to send messages.

Add Submission Notes
In the 'Current Submission' section, click the 'Edit Notes' button for each requested permission. For each permission, a dialog will be displayed with a form for supplying additional information. Complete each form to provide our team with the required information.
Allow Users to Message Your Page
To receive messages from users, you must enable messaging for your Page. To do this, do the following:
  1. Go to Page Settings > General.
  2. In the 'Messages' section, click the 'Edit' button.
  3. Select the 'Allow people to contact my Page privately by showing the Message button' checkbox.
  4. Click 'Save Changes'

Make Your Bot Public

You must complete this step. If you do not, our review team will not be able to test your bot.

Facebook apps in development mode will not appear to the general public, and attempts to send messages to any person on Facebook that is not a developer, tester, or administrator of the app will return an error.

Now that you are ready to submit, go to the 'App Review' section of your app settings and flip the switch to change your bot from developer mode to public.
Submit your bot

Click the 'Submit for Review' button to submit your bot! The name of the person who submitted the bot and the time it was submitted will be displayed.

Watch for approval alerts
When your bot is approved, our team will send you a Facebook notification. In the 'App Review for Messenger' section, a green checkmark will appear next to each approved permission.
Apply to use customer matching (Optional)

Customer Matching is a useful feature that allows you to find existing customers on Messenger with their phone number and name. Once your bot is approved, you may apply to use customer matching and pay the one-time $99 fee in your Messenger settings. Please note the fee is non-refundable.