Submitting Your Messenger Bot

New App Review Requirements

On May 1, 2018, Facebook announced new approval requirements that affect some apps that integrate with Facebook Platform APIs, including the Messenger Platform. These new requirements are in addition to the Messenger Platform's submission and review requirements.

For more information and to find out if your app submission is affected, visit the Facebook Platform app review documentation.

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:

  • Ensure your bot abides by all of the Messenger Platform and Facebook policies
  • Ensure your bot follows the Facebook Community Standards.
  • Review our pre-launch checklist.
  • Publish the Facebook Page associated with your bot.
  • Ensure your webhook is functioning as expected and returning a 200 OK response to webhook events within 20 seconds.
  • If your bot has gated functionality or content, provide a way for our review team to access and test it. For example, if a feature requires a user to log in to your service, be sure to provide a username and password in the submission notes. Another common practice is to provide a trigger phrase our reviewers can send to your bot that will allow them to start normally gated flows.
Configure Your App Settings

At a minimum, you must provide the following basic information in the app console under Settings > Basic:

  • App Icon
  • Privacy Policy URL
  • Category
  • Business Use

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'

Put Your Bot in Development Mode
Now that you are ready to submit, ensure your bot is set to development mode in your app settings.
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.
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.

After your bot is submitted, our review team will send messages to your bot to test for responsiveness, functionality, and policy compliance. Please note that our team may message/use your bot several times over the course of multiple days.

Provide Business Information and Verification Documents

Once your bot has been reviewed for responsiveness, functionality, and policy compliance, you will receive a message asking you to complete business verification in the 'Alerts' tab of the app console.

To begin business verification, click the 'Start Business Verification' button in the message. You will be asked to provide the following for the business that owns the app:

  1. Basic business information, including business name, address, and phone number.

  2. A copy of one of the following documents that prove your business is real:

    • Business license (preferred)
    • Certificate of formation
    • Articles of incorporation document
    • Business utility or phone bill
  3. The name, job title, and email address of a signatory for the business.

Accept Supplemental Terms and Sign Tech Provider Agreement

After your business information and verification documents are submitted, you will receive an email from the Facebook legal team with links to the following:

  • Supplemental terms: These are additional terms that app developers must accept to use extended Facebook Platform products, including the Messenger Platform.

  • Tech Provider Agreement: An additional contract that must be signed by a signatory of the business. This is only required for apps whose business use in their app settings is set to 'Provide services to other businesses'.

You must read and accept the supplemental terms, as well as read and sign the Tech Provider Agreement (if applicable) as part of the business verification process.

Watch for approval alerts

Once your app has passed review and business verification, it will be approved!

Once your bot is approved, our team will send you a Facebook notification. A green checkmark will also appear next to the pages_messaging permission under 'App Review for Messenger'.