Webhook Events Reference

Webhook events are how the Messenger Platform notifies your bot when a variety of interactions or events happen, including when a person sends a message. Webhook events are sent by the Messenger Platform as POST requests to your webhook.

Note: You will need to subscribe all messaging apps for your business to the messaging webhooks.

Contents

• List of Webhook Events
• Event Format
  • Properties

List of Webhook Events

Below is a list of the events that can be sent to your webhook from the Messenger Platform.

Note: It is recommended that you use the latest API version to receive all information available for each webhook.

Event Format

All callbacks for the Messenger Platform have a common set of properties that provide information you will need to process and respond to input from people using your bot. In addition to the properties below, each event also has a set of specific properties that detail the event.

{
  "object":"page",
  "entry":[
    {
      "id":"<PAGE_ID>",
      "time":1458692752478,
      "messaging":[
        {
          "sender":{
            "id":"<PSID>"
          },
          "recipient":{
            "id":"<PAGE_ID>"
          },

          ...
        }
      ]
    }
  ]
}

Properties

entry

entry.messaging