messaging_postbacks Webhook Event Reference

A postback webhook event is triggered when a users clicks a postback button, Get Started button, or persistent menu item.

Example Payload

{
  "sender":{
    "user_ref":"USER-REF-ID"
  },
  "recipient":{
    "id":"PAGE-ID"
  },
  "timestamp":1458692752478,
  "postback":{
    "mid":"m_1457764197618:41d102a3e1ae206a38",
    "title": "TITLE-FOR-THE-CTA",  
    "payload": "USER-DEFINED-PAYLOAD",
    "referral": {
      "ref": "USER-DEFINED-REFERRAL-PARAM",
      "source": "SHORT-URL",
      "type": "OPEN_THREAD",
    }
  }
}    

Properties

sender

PropertyTypeDescription

id

String

The PSID of the user that triggered the webhook event.

user_ref

String

The user_ref of the user that triggered the webhook event. This is only available for webhook event from the chat plugin.

recipient

PropertyTypeDescription

id

String

Your Page ID.

postback

Property Type Description

mid

String

Message ID

title

String

Title for the CTA that was clicked on. This is sent to all apps subscribed to the page. For apps other than the original CTA sender, the postback event will be delivered via the standby channel.

payload

String

payload parameter that was defined with the button. This is only visible to the app that send the original template message.

referral

Structure follows referral event

Referral information for how the user got into the thread.

postback.referral

This section is present only if:

The information contained in this section follows that of the referral webhook.