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.
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.
Previously, permission to send subscription messages was granted via the app-level
As of the release of Messenger Platform v2.3, the following changes will take effect:
pages_messaging_subscriptionswill be deprecated, and the ability to send subscription messages will be granted at the Page-level.
NON_PROMOTIONAL_SUBSCRIPTIONmessage tag in the body of the Send API request to be delivered.
Page admins may access the subscription messaging request form by doing the following:
In the form, the Page admin will be asked to provide the following:
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:
NON_PROMOTIONAL_SUBSCRIPTIONmessage tag in the body of the request.
Bots that have already been individually reviewed for a given Page 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.
As we continue to review our Subscription Messaging policies, developers provided access to send messages via app-level permissions may continue to do so until further notice. We highly encourage developers to migrate to the Page-level permission as soon as possible as we evaluate potential updates to this policy.
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.