Onboard Businesses with Marketing Message API for Messenger

The Marketing Message API for Messenger is available exclusively to tech providers with an existing app that has successfully completed Meta App Review for the following permissions:

ads_management
pages_messaging
paid_marketing_messages

Currently, tech providers can only serve businesses located in the following regions:

Australia
Brazil
Chile
Colombia
Hong Kong

India
Indonesia
Israel
Malaysia
Mexico

New Zealand
Peru
Philippines
Saudi Arabia
Singapore

Taiwan
Thailand
United Arab Emirates
United States
Vietnam (VN)

In addition, messages can be sent to users/subscribers in all regions except:

European Union
Japan
South Korea
Australia
United Kingdom

The Marketing Message API for Messenger is only available for Web applications.

This document shows you how to configure Facebook Login for Business to onboard businesses to your Marketing Messages on Messenger app.

NOTE: In this guide, business refers to the business portfolios onboarding to your app (your app's user).

Before You Start

Go to Your App > Messenger > Messenger API Settings > Advanced and accept Terms to use Marketing Message API for Messenger.
Read our Get Started Guide for more on setting up Marketing Message API for Messenger.

Create a configuration

In the following steps, you are creating a login configuration that requires the business to select the following assets for sending marketing messages:

Facebook Pages
Meta business portfolio
Meta ad account

Note: If the business does not have one of the required assets (Facebook Page, a Meta business portfolio, or a Meta ad account), the business can create any, or all, of these assets during the login flow.

In the Meta App Dashboard, click Configurations under Facebook Login for Business in the menu to the left.
Click Create Configuration.
Add a name for this configuration and click Next.
In the Choose login variation section, select General and click Next.
In the Choose access token section, select System-business access token.
In the Choose token expiration section, select Never and click Next.
In the Choose assets section, select Pages and then Asset Required, and Ad accounts and then Asset Required.
Click Next.
In the Choose permissions section, add the following permissions:
- ads_management
- pages_messaging
- paid_marketing_messages
Click Create.

Launch the Graph API Explorer

Your Marketing Message API for Messenger login configuration is complete.

Test your login flow

We recommend testing the login flow in Meta's Graph API Explorer.

On the right side of the explorer, select your marketing messages app from the Meta App dropdown menu.
Click Configurations then select your marketing messages configuration from the dropdown menu. The access token type, permissions, and assets required by this configuration are listed.
Click Generate Access Token to trigger the login flow.
After you complete the login flow in the pop-up window, a new system business access token is shown in the Graph API Explorer.

Launch the Graph API Explorer

Upon successful log in, your app creates a non-expiring system business access token for the business.

View token details

Click the triangle icon to view the following access token information:

App name and Meta ID
Business ID
Validation status
Scopes
Graph domain

Click Open in Access Token Tool to view more information about this access token.

Invoke the login dialog in your app

We recommend implementing the Javascript SDK from Meta in your web app to invoke the login dialog flow.

Embed your login button or URL in your web app

Set the config_id attribute to your configuration's ID in the fb:login-button element to invoke your configuration during login

<fb:login-button config_id="<CONFIG_ID>" onlogin="checkLoginState();">
</fb:login-button>

Use the JavaScript SDK from Meta's FB.login() method in your web app to use a specific configuration to get a system user access token.

Set config_id to your configuration's ID
Set response_type to code – authorization code grant type required for system user access tokens
Set override_default_response_type to true – any response types passed in take precedence over the default types

Example code

FB.login(
  function(response) [
    console.log(response);
  ],
  [
    config_id: '<CONFIG_ID>',
    response_type: 'code',
    override_default_response_type: true
  ]
);

When your app user completes the login dialog flow, Meta redirects the user to your redirect URL and includes the authorization code. You must then exchange this code for an access token by performing a server-to-server call to Meta servers.

curl https://graph.facebook.com/<API_VERSION/oauth/access_token?
  client_id=<APP_ID>
  &client_secret=<APP_SECRET>
  &code=<AUTHORIZATION_CODE>

See Exchanging Code for an Access Token for more information about this step.

Best practices

Implement the following recommendations to help businesses discover and onboard to your app.

Use "Marketing Messages" in the name for the marketing messages product in your app and explain its benefits.

Marketing Messages on Messenger
Increase customer retention, and boost engagement and sales by sending personalized updates and promotions on Messenger.

Re-engage with customers anytime, beyond a 24-hour limit.
Automatically get people to subscribe to marketing messages. Subscriptions do not expire.
Send messages to everyone subscribed, or segment customers based on the subscription source or custom tag.
Pay per message delivered and measure down-funnel conversions.

Place the entry point to Marketing Messages in your app's primary navigation, or near the relevant messaging flows, with an informational banner or a contextual guidance card.
Link your Marketing Messages onboarding flow to your app's Get started action button.

Next steps

Now that you have onboarded businesses to your app, get a list of subscribers to send paid marketing messages.