Referência dos eventos de webhook

Os eventos de webhook são o método usado pela plataforma do Messenger para notificar seu bot da ocorrência de várias interações ou eventos, incluindo quando uma pessoa envia uma mensagem. Os eventos de webhook são enviados pela plataforma do Messenger como solicitações de POST para seu webhook.

Observação: é preciso assinar os webhooks de mensagem em todos os apps de mensagem da empresa.

Lista de eventos de webhook

Veja abaixo uma lista dos eventos que podem ser enviados pela plataforma do Messenger ao seu webhook.

Observação: é recomendável usar a versão mais recente da API para receber todas as informações disponíveis para cada webhook.

Formato do evento

Todos os retornos de chamada para a plataforma do Messenger têm um conjunto comum de propriedades que fornecem as informações necessárias para processar e responder às entradas das pessoas que usam seu bot. Além das propriedades mostradas abaixo, há um conjunto de propriedades específicas que detalha cada evento.

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

          ...
        }
      ]
    }
  ]
}

Propriedades

entry

entry.messaging

Saiba mais

Se você gerenciar as conversas usando mais de um app (por exemplo, um para respostas automáticas e outro para agente humano), será necessário implementar o protocolo de entrega para transferir a conversa entre eles. Protocolo de entrega