Page Subscription Messaging

On August 29th, 2019 we announced updates to Subscription Messaging. After January 15, 2020 Only Pages that are registered with the Facebook News Page Index (NPI) will be allowed to send non-promotional subscription messages. We highly encourage relevant pages to submit their application immediately to register with the News Page Index to allow sufficient time for review and approval before the new policies go into effect.

Breaking Change Notice - Page-level Subscription Messaging Feature Requirement

Starting April 30, 2019, a Page must be approved with the Page-level Subscription Messaging feature in order to use the Broadcast API. Apps were granted the subscription messaging permission at the app-level will no longer be respected. This change is in effect immediately to v3.3+ of the Graph API, and will apply to all lower versions on July 31, 2019.

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.

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 > Advanced Messaging
  2. Under 'Subscription Messaging' in the 'Requested Features' section, click the 'Request' button.

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

  • Which of the three eligible subscription messaging use cases apply to the Page.
  • A sample message and a brief description of how the bot will use subscription messaging.
  • Examples of subscription messages that your Page will send.
  • A confirmation that the Page won't use subscription messaging to send advertisements or promotional messages 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 Page must adhere to all Facebook Platform policies and community standards.

How to know if the Page has the subscription feature?

We offer two ways to check the Page subscription messaging feature:

  • 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.

New Subscription Messaging for News Pages

On August 29th, 2019 we announced that, effective January 15, 2020, only Pages registered via the News Page Index (NPI) are allowed to send subscription messages.

Subscription messaging is available for Pages registered under the Facebook News Page Index (NPI). To be included as part of the News Page Index, Pages can apply within Business Manager by navigating to the “News Pages” option under the “Registrations” tab in Business Settings.

Sending Subscription Messages

To send a tagged message with the Send API, send a message as you normally would, with the tag property appended to the body of your POST request:

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient": { 
    "id": "<PSID>"
  },
  "message":{
    ...
  },
  "messaging_type": "MESSAGE_TAG",
  "tag": "NON_PROMOTIONAL_SUBSCRIPTION "
      
}' "https://graph.facebook.com/v5.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"  
    

For a complete list of API calls and request properties, see the Send API Reference.