Riferimento per gli eventi del webhook

Gli eventi del webhook rappresentano il modo in cui la Piattaforma Messenger avvisa il tuo bot quando si verificano una serie di interazioni o eventi, ad esempio quando una persona invia un messaggio. Gli eventi del webhook vengono inviati alla Piattaforma Messenger sotto forma di richieste POST al tuo webhook.

Nota: dovrai attivare l'iscrizione ai webhook dei messaggi per tutte le app di messaggistica della tua azienda.

Lista degli eventi del webhook

Di seguito è riportata una lista degli eventi che possono essere inviati al tuo webhook dalla Piattaforma Messenger.

Nota: consigliamo di usare l'ultima versione dell'API per ricevere tutte le informazioni disponibili per ciascun webhook.

Azione del webhook	Descrizione
`messages`	Effettua l'iscrizione alle azioni dei messaggi ricevuti
`messaging_account_linking`	Effettua l'iscrizione alle azioni di collegamento di account
`messaging_checkout_updates` (beta)	Effettua l'iscrizione alle azioni di aggiornamento delle azioni di acquisto
`message_deliveries`	Effettua l'iscrizione alle azioni dei messaggi consegnati
`message_echoes`	Effettua l'iscrizione alle azioni delle richieste echo dei messaggi
`messaging_game_plays`	Effettua l'iscrizione agli eventi dei giochi istantanei
`messaging_handovers` (beta)	Effettua l'iscrizione alle azioni del protocollo di consegna
`messaging_optins`	Effettua l'iscrizione alle azioni di attivazione del plug-in
`messaging_payments` (beta)	Effettua l'iscrizione alle azioni dei pagamenti
`messaging_policy_enforcement`	Effettua l'iscrizione alle azioni di applicazione della normativa
`messaging_postbacks`	Effettua l'iscrizione alle azioni dei postback ricevuti
`messaging_pre_checkouts` (beta)	Effettua l'iscrizione delle azioni di preacquisto del pagamento
`message_reads`	Effettua l'iscrizione alle azioni dei messaggi letti
`messaging_referrals`	Effettua l'iscrizione alle azioni dei reindirizzamenti
`standby` (beta)	Effettua l'iscrizione alle azioni del canale di standby del protocollo di consegna

Formato dell'evento

Tutte le callback per la Piattaforma Messenger presentano un insieme comune di proprietà che forniscono informazioni necessarie per elaborare gli input delle persone che utilizzano il tuo bot e e rispondervi. Oltre alle proprietà riportate di seguito, ogni evento dispone anche di un insieme di proprietà specifiche che descrivono in modo dettagliato l'evento.

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

          ...
        }
      ]
    }
  ]
}

Proprietà

Proprietà	Tipo	Descrizione
`object`	Stringa	Il valore sarà `page`
`entry`	Array di `entry`	Array che contiene i dati dell'evento

`entry`

Proprietà	Tipo	Descrizione
`id`	Stringa	ID della Pagina
`time`	Numero	Orario dell'aggiornamento (tempo Unix in millisecondi)
`messaging`	Array<`messaging`>	Array che contiene un oggetto `messaging`. Anche se si tratta di un array, contiene solo un oggetto `messaging`.

`entry.messaging`

Proprietà	Tipo	Descrizione
`sender.id`	Stringa	ID utente del mittente
`recipient.id`	Stringa	ID utente del destinatario

Per saperne di più

Se disponi di più di un'app che gestisce i messaggi, ad esempio un'app gestisce le risposte automatiche e un'altra le escalation a un operatore, dovrai implementare il protocollo di consegna per passare la conversazione da un'app all'altra. Protocollo di consegna