Sample App Review Submission for Messenger Platform

Let's say you have a Facebook Page for your party planning business. You want to allow people to interactively ask questions so you can help them plan their parties, so you create a Messenger app (using the Messenger Platform) connected to the Page. The app provides automated replies in response to messages. This example Messenger app needs the pages_messaging permission.

We assume that you've read the permission's description, as well as our Platform Policy, and have verified that your app uses data in an approved manner. Your app is now ready for public release, so you begin the app review process.


Before you write your App Review submission, fulfill the requirements and do the preliminary steps in Submitting Your Messenger Bot.

Adding Permissions

You sign into your App Dashboard and click on your app. Under Products, click Messenger > Settings. (If Messenger does not appear under Products, click the + icon and add it.)

Scroll down to the App Review for Messenger section, then click the Add to Submission button for the pages_messaging permission.

Describing Data Usage

Next, you scroll down to the Current Submission section and click Add Details.

Since your bot provides automated responses, the App Review submission needs to provide messages and responses that we can use to test the bot.

You provide the Facebook Page that is associated with this Messenger app. Under Commands, you list the messages that the tester can send to the bot, and under Automated Reply, list example responses that the bot sends back.

CommandAutomated Reply

Need help planning my party

Good morning / afternoon / evening. I will be happy to help you. Who is the party for? Buttons: 0 - 5 year old; 6 - 10 year old; Preteen/Teen; Adult.

(Button click)

OK, got it. You're planning a party for a young child / kid / teenager / adult. If you don't mind my asking, what is your budget?

(Monetary amount from previous message)

OK, got it. What's the first thing you need help with?


Try our Invitation Designer app for iPhone or Android. (Links)

What's the most popular party location?

Please share your location: (Map appears for Quick Reply).

In your area, {Party Party Galore / Ludwig's Laser Tag / Dave and Buster's} is the most popular place to hold a party for {young kids / teenagers / adults over 21}.

I need ideas for activities

Our favorite resource for all ages is the book Fun Party Crafts for Fun Party Guests. (Linked to Amazon)

OK, thanks, bye

Enjoy your special day. Try our Party Games app for iPhone or Android.

In Optional Notes for the Reviewer, you provide any other instructions that we will need to thoroughly test your Messenger app, including a general description of what your app does and instructions for how to start the app. A tester will need to log in to an Amazon account during the chat, so you also provide login credentials we can use.

"Open my Messenger bot by clicking the "Chat Now" button on my party planning company's Page. This app provides helpful, personalized information for people trying to plan parties. It uses the Messenger Quick Reply mechanism to ask for the user's location so we can give useful information about nearby party venues and similar questions. In our in-person interactions with customers, we have found what works best is building a personal relationship. Birthdays and other celebrations are very personal events. Customers will appreciate having the Party Chat Bot added to our Page so we can approximate this in-person relationship as closely as possible. To test the Amazon link in the chat, use test_user with password 1234."

You click Save.

Unlike some other types of apps, a Messenger app does not require a screencast as part of its App Review submission, so your submission is ready to go.


You've supplied everything a reviewer will need to verify that your app uses the pages_messaging permission in an approved manner, so you click Submit For Review.