Submitting Your Messenger Bot

As of May 1, 2018, all apps that were previously approved to access Messenger Platform APIs must be resubmitted for review by August 1, 2018. Apps that are not submitted by this date will automatically lose the pages_messaging permission.

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

In addition, the document must show your company's legal business name, as well as one of the following:

  • Address
  • Tax ID
  • Phone number

Business verification is required once per Business Manager account. Once business verification is complete, any additional apps submitted that are owned by the same Business Manager account will not be asked to complete business verification.

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. The supplemental terms will be sent to you in an email with the subject line, "[Action Required] Supplemental Terms for Extended Platform Products with Facebook".

  • 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'. The Tech Provider Agreement will be sent to you in an email with the subject line, "Please sign Technology Provider Amendment"

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.

If you do not receive the supplemental terms and, if applicable, the Tech Provider Agreement, please check your spam folder.

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'.

What to do if your bot is not approved

If your bot is not approved, click the 'Add to Submission' button next to 'pages_messaging' to see the feedback from our review team.

If you have any questions, you can communicate directly with the review team to clarify how you can update your bot by using the 'Ask a Question' button below the rejection notice.