Changelog for Messenger API Updates for Europe and Japan

• Custom labels
• Persona API

• Receive API (webhooks): messaging_referrals is restored for CTM ads.

• Messenger Extension SDK
• PSID/ASID matching
• Persona API
• Account linking
• Custom labels
• Video on Media template

• Receive API (webhooks): message_deliveries, message_reactions, message_reads

• Messenger Extension SDK
• PSID/ASID matching
• Persona API
• Account linking
• Custom labels
• Video on Media template

• Customer Feedback Template

• Receive API (webhooks): message_deliveries, messaging_account_linking, message_reactions, message_reads
• Messenger Extension SDK
• PSID/ASID matching
• Persona API
• Account linking
• Custom labels
• Video on Media template

• Receipt Template
• One Time Notification
• Sender actions
• CTM HOP

Feature restoration TBD:

• Receive API (webhooks): message_deliveries, messaging_account_linking, message_reactions, message_reads
• Messenger Extension SDK
• PSID/ASID matching
• Persona API
• Account linking
• Custom labels

• source attribute in webhooks is not included for accounts affected by the regulations in Europe and Japan

• messaging_optins webhook is restored for Chat Plugin, Send to Messenger Plugin, and Checkbox Plugin. One Time Notification messaging_optins webhook will be restored in Q2 2021.
• messaging_referrals webhook is restored for m.me link and Chat Plugin. CTM ads messaging_referrals webhook restoration is TBD.

• Included CTM HOP details

• Send API: Media/attachment (audio, video, files)
• Receive API (webhooks): message with media/attachment, message_echoes
• Product template
• Persistent menu
• Chat Plugin guest mode upgrade
• Messenger feature review API
• Web Plugins prior_message block
• Web Plugins (Send to Messenger, Checkbox Plugin)
• Send API with user_ref
• User Profile API profile_pic field

Targeting restoration in Q2 2021 (actual dates of restoration may vary):

• Receive API (webhooks): message_deliveries, messaging_account_linking, messaging_optins, message_reactions, message_reads, messaging_referrals
• Receipt Template
• One Time Notification
• Sender actions
• Persona API
• Account linking

Feature restoration TBD:

• Airline Template
• Custom labels
• Messenger Extension SDK
• PSID/ASID matching
• CTM HOP

• Updated context section below to address new privacy rules in Japan
• Timeline for all feature remediations we had targeted to restore by end of Q1 is now being moved to Q2. Actual dates of restoration may vary

• Generic Template, Button Template, Media Template (images only), URL Button, Postback Button, Call Button are supported on iOS, Android, and web.
• Updated restoration timeline for affected features.

Targeting restoration in Q1 2021 (actual dates of restoration may vary):

• Send API: Media/attachment (audio, video, files)
• Receive API (webhooks): message with media/attachment, message_echoes
• Product template
• Persistent menu
• PSID/ASID matching
• Chat Plugin guest mode upgrade
• Messenger feature review API
• Web Plugins prior_message block
• Web Plugins (Send to Messenger, Checkbox Plugin)
• Send API with user_ref
• User Profile API profile_pic field

Targeting restoration in Q2 2021 (actual dates of restoration may vary):

• Receive API (webhooks): message_deliveries, messaging_account_linking, messaging_optins, message_reactions, message_reads, messaging_referrals
• Receipt Template
• One Time Notification
• Sender actions
• Persona API
• Account linking

Feature restoration TBD:

• Airline Template
• Custom labels
• Messenger Extension SDK

• Pages in Europe and Japan
• Pages with admins in Europe and Japan
• People in Europe and Japan who message businesses globally

• All 27 European Union member states
• Norway
• Iceland
• Liechtenstein
• United Kingdom
• Japan

• Features and APIs with no changes
• Affected Features and APIs with Mitigations

• Page Impact - To determine go to your app dashboard and navigate to the Messenger Settings menu. Enter page IDs in the section titled Will your page be affected by updates due to new privacy rules in Europe and Japan. Note that your app must have ‘pages_messaging’ permission for the Pages you’re querying. Developer can also leverage subject_to_new_eu_privacy_rules flag on Messenger Profile API to check for page impact.
• User Thread Impact - To determine, invoke the User Level Menu API. If you get a valid response, there is no impact. If you get an error message with code 10, subcode 2018336, the thread is impacted. NOTE: This status can change over time. Use care if you are caching this data and update it regularly.
• Any API call which results in error code 10, subcode 2018336

{
   "error":{
      "message":"(#10) This action was not submitted due to new privacy rules in Europe and Japan.
                 See developer documentation for more info",
      "type":"OAuthException",
      "code":10,
      "error_subcode":2018336,
      "fbtrace_id":"AUmkjfWVra1NAa-qEH5NcI8"
   }
}

• Images can be sent as a plain text url. Users will then have to click on it and it wil open up Messenger In-app browser.
• Buttons can be replaced with quick replies because you will still receive the message payload when users click on it.
• Title and description can be sent as a separate messages.
• More complex templates such as the airline and receipt templates can be simplified by ignoring some fields or you can recreate a similar template hosted at a external URL and serve the template by providing the URL link.

Before

{
   "recipient":{
      "id":"{{PSID}}"
   },
   "message":{
      "attachment":{
         "type":"template",
         "payload":{
            "template_type":"{{SOME_UNSUPPORTED_TEMPLATE}}",
            "elements":[
               {
                  "title":"Welcome!",
                  "image_url":"https://petersfancybrownhats.com/company_image.png",
                  "subtitle":"We have the right hat for everyone.",
                  "buttons":[
                     {
                        "type":"web_url",
                        "url":"https://petersfancybrownhats.com",
                        "title":"View Website"
                     },
                     {
                        "type":"postback",
                        "title":"Start Chatting",
                        "payload":"DEVELOPER_DEFINED_PAYLOAD"
                     }
                  ]
               }
            ]
         }
      }
   }
}

After

{
   "recipient":{
      "id":"{{PSID}}"
   },
   "messaging_type":"response",
   "message":{
      "text":"Welcome! We have the right hat for everyone.",
      "quick_replies":[
         {
            "content_type":"text",
            "title":"View Website",
            "payload":"{{DEVELOPER_DEFINED_PAYLOAD}}"
         },
         {
            "content_type":"text",
            "title":"Green",
            "payload":"{{DEVELOPER_DEFINED_PAYLOAD}}"
         }
      ]
   }
}

Before

{
  "recipient":{
    "id":"{{PSID}}"
  },
  "message":{
    "text":"How can I help you?"
  },
  "persona_id":"{{PERSONA_ID}}"
}

After

{
   "recipient":{
      "id":"{{PSID}}"
   },
   "messaging_type":"response",
   "message":{
      "text":"Hi, this is Joe from OCC, How can I help you?"
   }
}

Example

• If a brand using Provider A for regular messages, and Provider B as the secondary receiver for CTM messages, where Provider A is unable to set the hand-off to Provider B. This would require the Brand to do the routing with their own solution (essentially acting as provider C).

  Solution

• Create a custom app to be a “router app” and assign it as the new primary app for the page
• The router app will route all threads that receive the payload to the CTM ad flow app
• The router app will route al other threads to the default app fo the page (the previous Primary App)

  User enters free text instead of clicking on the quick reply or generic template button

  Solution #1

• Determine or estimate percentage of users entering free text. If the volume is within your operational limits, consider transferring them to a live agent.

  Solution #2

• Leverage NLU (Natural Language Understanding) to extract an intent from the free text and determine if the user needs to be handover to the CTM Ad Flow
• The NLU processing can happen either in your Primary App (if the app/vendor/platform supports this) or programmed in the “router app” discussed earlier.

  Solution #3

• Disable by default free text for the page by disabling the composer at the page level as described here
• In the CTM Ad welcome message, add either a Quick Reply or Generic Template button to “Talk to an agent”
• In the page’s default welcome message, add a similar option to add either a Quick Reply or Generic Template button to “Talk to an agent”
• Enable free text entry only for users who click the relevant Quick Reply or Generic Template button by enabling the user level persistent menu as described here