Transitioning from App-level to Page-level Subscription Messaging

This FAQ is intended to give you the information you need to understand how the new Page-level subscription messaging permission works and help you transition your bot from app-level to Page-level subscription messaging permission.

What are subscription messages?

Subscription messages are non-promotional messages sent outside the 24-hour standard messaging window for use cases that may require recurring non-promotional updates.

A Page must apply for and be approved to send subscription messages. Once the Page is approved, any app subscribed to the Page may send subscription messages on the Page's behalf using the Send API's NON_PROMOTIONAL_SUBSCRIPTION message tag. All subscription messages must abide by the Messenger Platform's subscription messaging policy.

What are we changing?

Previously, permission to send subscription messages was granted via the app-level pages_messaging_subscriptions permission.

As of the release of Messenger Platform v2.3, the following changes will take effect:

  • pages_messaging_subscriptions will be deprecated, and the ability to send subscription messages will be granted at the Page-level.
  • Subscription messages must include the NON_PROMOTIONAL_SUBSCRIPTION message tag in the body of the Send API request to be delivered.

How do I apply to send subscription messages?

Page admins may access the subscription messaging request form by doing the following:

  1. Go to Page Settings > Messenger Platform
  2. Under 'Subscription Messaging' in the 'Advanced Messaging Settings' section, click the 'Request' button.

In the form, the Page admin will be asked to provide the following:

  • A sample message and a brief description of how the bot will use subscription messaging.
  • A short screencast that shows how people will start a conversation with the bot and examples of subscription messages that the bot will send.
  • Which of the three eligible subscription messaging use cases applies to the bot.
  • A confirmation that the bot will only send non-promotional content, and will abide by all Facebook Platform policies and community standards.

What are the requirements for sending subscription messages?

When a person begins a conversation via specific entry points with a Page that has been approved to send subscription messages, they automatically opt-in to receive subscription messages from the Page. The person may opt-out from receiving subscription messages at any time. What are the requirements for sending subscription messages? Subscription messages must meet the following requirements:

  • Cannot contain promotional content.
  • Must adhere to the Messenger Platform's subscription messaging policy.
  • Only contain content that falls into one of the subscription messaging policy's eligible use cases (news, productivity, or personal trackers).
  • Must include the NON_PROMOTIONAL_SUBSCRIPTION message tag in the body of the request.
  • The bot must adhere to all Facebook Platform policies and community standards.

What if my bot is already using subscription messaging?

Bots that have already been individually reviewed and granted the existing app-level pages_messaging_subscriptions permission will automatically be grandfathered-in and allowed to send subscription messages with the NON_PROMOTIONAL_SUBSCRIPTION message tag. All subscription messages must meet the requirements outlined above.

Bots that have not been individually reviewed for the existing app-level pages_messaging_subscriptions permission, such as those using a service provider, must submit their Page for review and approval to continue sending subscription messages. These Pages will be allowed to continue sending subscription messages under the existing app-level permission until December 31, 2018, but should apply for Page-level approval as soon as possible.

How will I know if my Page has been grandfathered in?

We offer two ways to check the Page-level permission status for subscription messaging:

  • Messaging Feature Review API: This is API allows you to programmatically check the status of Page-level feature review submissions, including subscription messaging. This is useful for developers that need to check the status of multiple Pages.

  • Page Settings: Page admins may check whether their Page has been granted permission to send subscription messages in the 'Messenger Platform' tab of Page settings in the 'Advanced Messaging Settings' section.