messaging_postbacks
Webhooks ReferenceThis document explains the JSON payload your webhooks server will receive when a messaging postback webhook event is triggered. A postback webhook event is triggered when a person clicks a postback button, Get Started button, or persistent menu item.
The following is an example of the JSON payload that will be sent to your webhooks server.
{ "field": "messaging_postbacks", "value": { "sender": { "user_ref": "USER-REF-ID" }, "recipient": { "id": "PAGE-ID" }, "timestamp": "1527459824", "postback": { "mid": "m_MESSAGE-ID", "title": "TITLE-FOR-THE-CTA", "payload": "USER-DEFINED-PAYLOAD", "referral": { "ref": "USER-DEFINED-REFERRAL-PARAM", "source": "SHORT-URL", "type": "OPEN_THREAD" } } } }
All JSON properties in a webhook notification are strings.
Property | Description |
---|---|
| The ID for the message |
| Information defined in the CTA |
| Information about the action the person took to enter a conversation. The
|
| The arbitrary data that was originally passed in the |
| The URL for this referral. For m.me links, the value of source is |
| The identifier for the referral. For referrals coming from m.me links, it will always be |
| The title for the Call To Action (CTA) that a person clicked |
| The ID for your Facebook Page |
| The ID for the reference for a person who took an action, such as clicked a Get Started, Chat Plugin or Persistent Menu item, that sent a message |
| The Unix timestamp for date when the webhook notification was sent to your server |
Additional developer documentation to further your understanding of concepts mentioned in this Messaging Postbacks Webhooks guide.