Customize the Engage with customers on Messenger Use Case

This document shows you how to customize the Engage with customers on Messenger use case you added to your app during the app creation process.

Click Dashboard in menu to the left in the App Dashboard. Each use case that you have added to your app is listed here.
Select the use case you want to customize. This allows you to add settings and permissions to make your app work the way you want it to.
Add permissions that your app needs and remove permissions that your app doesn't need.
Click Ready to test to test each use case. If you need to submit your app for Meta App Review, you must test each use case. The Meta's Graph API Explorer allows you to test your queries and get access tokens and code samples for your queries.
Click Dashboard to repeat the above for each use case.

Permissions and features

To customize the Messenger Platform use case, select Customize the Engage with customers on Messenger from Meta use case. You are redirected to a list of permissions.
Click Add next to each additional feature or permission that your app needs to work the way you want it to.
If your app requires App Review click the Actions button and select + Add to App Review. You'll complete the review submission later.

Messenger from Meta use cases permissions and features

The following table shows the permissions and features available for the Messenger from Meta use cases.

Feature or Permission	API usage	Allowed actions
Business Asset User Profile	Optional for this use case.	Can be added to this use case.
`ads_management`	Optional for this use case.	Can be added to this use case.
`business_management`	Required for this use case.	Cannot be removed for this use case.
`email`	Optional for this use case.	Can be added to this use case.
`instagram_basic`	Optional for this use case.	Can be added to this use case.
`instagram_manage_messages`	Optional for this use case.	Can be added to this use case.
`page_manage_metadata`	Required for this use case.	Cannot be removed for this use case.
`pages_messaging`	Required for this use case.	Cannot be removed for this use case.
`pages_read_engagement`	Optional for this use case.	Can be added to this use case.
`pages_show_list`	Required for this use case.	Cannot be removed for this use case.
`pages_user_gender`	Optional for this use case.	Can be added to this use case.
`pages_user_locale`	Optional for this use case.	Can be added to this use case.
`pages_user_timezone`	Optional for this use case.	Can be added to this use case.
`pages_utility_messaging`	Optional for this use case.	Can be added to this use case.
`paid_marketing_messages`	Optional for this use case.	Can be added to this use case.
`public_profile`	Required for this use case.	Cannot be removed for this use case. Can increase access for any use case.*

* Increasing access to this permission or feature will affect other use cases – This permission or feature is part of more than one use case on this app. Any changes made to the access level of this permission or feature will affect the use cases listed below. This change might mean new requirements and reviews.

Messenger API Setup

In the Configure webhooks section, add your Callback URL and Verify token to configure webhooks or use services that help you set up an endpoint.
In the Generate access tokens section, click Connect to add Facebook pages to your app.
Click Continue, or log into a Facebook account, in the dialog popup.
Select the Pages you want to connect to this app and click Continue.
Click Save then Got it to return to the App Dashboard.
In the Generate access tokens section, click Add Subscriptions to subscribe to available Page webhook fields.
Select each field you want to subscribe to and click Confirm.

The Complete App Review section has a Request Permission button with a popup that adds additional permissions. Select any additional feature or permission that your app needs to work the way you want it to.

Customize Facebook Login for Business

If you are implementing Facebook Login for Business in your app, follow these steps.

Settings

Click Facebook Login for Business in the menu to the left in the App Dashboard.
Select Settings.
Add your Redirect URI and click Check URI to validate it.
Customize the Client OAuth settings.
Add your Deauthorize Callback URL.
Add your Data Deletion Request URL.
Click Save changes.

Quickstart

Use the Quickstart to add Facebook Login for Business to your app.

Click Quickstart.
Select and customize each platform for this app.
Add the Facebook Login Button to your app.

Configurations

This optional feature of Facebook Login for Business allows you to create multiple configurations and present them to different sets of users. Configurations allow you to choose:

The type of login variation to present to your app users.
The type of access token you want to request from your business clients, a User access token or System-user access token and token expiration
If you select User access token then your app users will log in using their personal Facebook account.
If you select System-user access token your app users will be required to log in using a business portfolio. This is only required if this configuration needs continuous access to business assets, such as Facebook Pages, ad accounts or Instagram accounts.
The business assets you want to request from your clients.
The permissions your app users are required to grant your app.

Become a Tech Provider

If your app needs to access business data owned by other business portfolios to provide services or functionality to those businesses, you must become a Tech Provider. This option will require additional data questions and approval through App Review before publishing.

Click Become a Tech Provider.
Click Yes, I'm a Tech Provider. The App Dashboard is updated to include additional items listed on Dashboard for your use cases.
Click Business verification to add a verified business portfolio or add a business portfolio and start the verification process.

App Review

In the left side menu go to Review > App Review. Click the Edit button to start your submission. All permissions and features you are requesting, with links to the documentation for each, are listed here.
Complete App Settings – Click Review your app settings to add or update any app settings such as app icon, privacy policy URL, and app category. This step must be complete before continuing.
Reviewer instructions – Click Provide reviewer instructions A popup dialog appears for each platform on which you app is available. Select each platform and answer the questions with questions for our reviewers to test your use case implementations. Click Done.
Click each permission and feature you requested.
Click the checkbox to agree to use each permission or feature in accordance with its allowed usage. If your app doesn't use a permission or feature listed, remove it by clicking the trashcan icon.
Click the Submit for Review button in the lower right.

Publish

Required app assets

To publish your app, you need the following assets:

An app icon – Your app's unique icon image; this file must be less than 5 MB, between 512 x 512 and 1024 x 1024 pixels, and in JPEG, GIF or PNG format.
Contact information for a Data Protection Officer, if you are doing business in the European Union.
A Privacy Policy URL for your app
A data deletion URL with instructions or a callback that allows your app user to delete their data from your app.

When you are ready to publish, select Publish in the left side menu.
Review your use cases and requirements.
Click Publish in the lower right corner.