Webhook messaging_postbacks di Instagram: ice breaker e pulsanti
Il campo webhook messaging_postbacks di Instagram avvisa un'app quando una persona tocca una domanda ice breaker, un pulsante postback in un template o una voce del menu persistente in una conversazione con un account professionale. L'oggetto postback dell'evento contiene title, il testo che la persona ha toccato; payload, la stringa impostata dall'app per quell'opzione; e mid, l'ID del messaggio, da Graph API v11.0.
easyCoexistence iscrive ogni account Instagram collegato a commenti, messaggi e menzioni e inoltra questi eventi, incluse le risposte rapide toccate, al tuo endpoint HTTPS non appena arrivano, firmati con il segreto di quell'account e senza conservare alcuna copia.
Il massimo di domande ice breaker che un account può impostare tramite l'API Ice Breaker di Meta.
Versione di Graph API da cui gli eventi postback includono mid; il campo stesso richiede v8.0 o successiva.
Il massimo di pulsanti in un messaggio button template, ciascuno di tipo postback o web_url.
Tempo per rispondere dopo che una persona tocca una voce del menu persistente, che apre la finestra di messaggistica standard.
Il massimo di risposte rapide che un messaggio può offrire; una risposta rapida toccata arriva su messages, non su messaging_postbacks.
Quando si attiva messaging_postbacks?
Quando una persona tocca una delle opzioni strutturate dell'account in una conversazione, una volta che app e account sono iscritti al campo. Le guide di Meta elencano queste fonti:
- Una domanda ice breaker, una delle fino a 4 che l'account offre all'inizio di una conversazione. Non disponibile su desktop.
- Un pulsante postback in un button template, fino a 3 per messaggio, oppure in un generic template, fino a 3 per elemento.
- Una voce postback nel menu persistente dell'account.
- Un ice breaker toccato in una nuova conversazione aperta da un link ig.me con un parametro ref: il postback include allora anche referral.
- Un test di auto-messaggio, in cui l'account tocca un proprio pulsante: l'evento aggiunge
is_selfimpostato su true.
Che aspetto ha una notifica di postback?
Un evento di messaggistica con un oggetto postback dove un DM avrebbe il suo messaggio. L'esempio di Meta per Instagram Login contiene mid, title e payload, e la sua guida agli ice breaker mostra lo stesso oggetto senza mid. Una notifica ha questo aspetto:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"postback": {
"mid": "<MESSAGE_ID>",
"title": "<ICE_BREAKER_QUESTION_OR_BUTTON_TITLE>",
"payload": "<PAYLOAD_SET_FOR_THE_OPTION>"
}
}
]
}
]
}Che cosa significa ciascun campo?
I campi che Meta documenta per un postback, dall'esterno verso l'interno:
- sender.id: l'ID con ambito Instagram della persona che ha toccato, cioè l'ID a cui rispondere. recipient.id e entry[].id: l'account professionale.
- timestamp: quando la persona ha toccato, secondo la guida agli ice breaker di Meta.
- postback.title: la domanda ice breaker o il titolo del pulsante che la persona ha visto.
- postback.payload: la stringa impostata per quell'opzione al momento della creazione, scelta dall'app.
- postback.mid: l'ID del messaggio che il tocco ha inviato all'account, da Graph API v11.0.
- postback.referral: ref, source e type, quando la conversazione è stata aperta da un link ig.me con un parametro ref.
is_self: impostato su true, accanto a postback, quando l'account tocca un proprio pulsante in un test di auto-messaggio.
Come si impostano gli ice breaker?
Con POST /<IG_ID>/messenger_profile su graph.instagram.com: platform impostato su instagram e un array ice_breakers i cui call_to_actions contengono fino a 4 coppie domanda e payload, con un locale per ogni set tradotto. GET /me/messenger_profile?fields=ice_breakers li elenca, e un DELETE con fields impostato su ice_breakers li rimuove. Il payload scelto qui è quello che messaging_postbacks restituisce quando la domanda viene toccata.
POST https://graph.instagram.com/<IG_ID>/messenger_profile?access_token=<INSTAGRAM_USER_ACCESS_TOKEN>
Content-Type: application/json
{
"platform": "instagram",
"ice_breakers": [
{
"call_to_actions": [
{ "question": "<QUESTION_1>", "payload": "<PAYLOAD_1>" },
{ "question": "<QUESTION_2>", "payload": "<PAYLOAD_2>" }
]
}
]
}Come si inviano i pulsanti postback?
All'interno di un messaggio che l'account invia con POST /<IG_ID>/messages. Un button template contiene un testo fino a 640 caratteri e da 1 a 3 pulsanti; un generic template contiene fino a 10 elementi, ciascuno con fino a 3 pulsanti. Un pulsante di tipo postback restituisce il suo payload su messaging_postbacks quando viene toccato, mentre un pulsante web_url apre invece una pagina nel browser in-app. Il menu persistente, impostato su messenger_profile, accetta gli stessi due tipi.
Le risposte rapide usano messaging_postbacks?
No: arrivano su messages. Una risposta rapida toccata inserisce il suo titolo nella conversazione come messaggio, e l'evento messages contiene text impostato su quel titolo e quick_reply.payload impostato sul payload dell'opzione. Un messaggio può offrire fino a 13 risposte rapide di massimo 20 caratteri ciascuna, solo testo semplice. La guida Instagram Messaging di Meta elenca anche le selezioni di ice breaker e generic template tra ciò che messages riporta, senza un esempio di payload.
Un tocco apre la finestra di messaggistica?
Per il menu persistente, Meta lo dichiara: un tocco su una voce del menu apre la finestra di messaggistica standard, e l'account ha 24 ore per rispondere. Rispondi con POST /<IG_ID>/messages e recipient.id impostato sul sender.id del postback. La risposta dell'account torna su messages come echo, con is_echo impostato su true.
easyCoexistence inoltra i postback?
Solo i tocchi sulle risposte rapide. Arrivano su messages, a cui sono sottoscritti l'app di easyCoexistence e ogni account connesso, quindi raggiungono il tuo endpoint con quick_reply.payload. I tocchi su ice breaker, pulsanti e voci di menu arrivano su messaging_postbacks, a cui easyCoexistence non si sottoscrive, quindi non vengono inoltrati.
Errori comuni
- Aspettare le risposte rapide su messaging_postbacks. Una risposta rapida arriva su messages, con quick_reply.payload accanto al testo dell'opzione toccata.
- Instradare in base a postback.title. Il titolo è ciò che la persona ha visto e può variare per lingua; instrada sul payload, che imposta l'app.
- Aspettarsi mid su una versione API più vecchia. Meta include postback.mid solo da Graph API v11.0.
- Impostare più di 4 ice breaker, o testarli su desktop. L'API Ice Breaker di Meta accetta fino a 4 domande, e la funzione non è disponibile su desktop.
send_social_dm risponde alla persona entro la finestra di 24 ore. Da US$ 9 fino a US$ 0.75 per connessione al mese, con il prezzo che scende man mano che aggiungi connessioni, con i primi 3 giorni di prova gratuita.
Domande frequenti
Quale campo webhook riporta i tocchi sugli ice breaker di Instagram?
messaging_postbacks. L'oggetto postback contiene la domanda come title e il payload impostato per essa, più mid da Graph API v11.0.
Quanti ice breaker può avere un account Instagram?
Fino a 4 domande, impostate con POST /<IG_ID>/messenger_profile e platform impostato su instagram, facoltativamente per locale.
Come rispondo a un postback di Instagram?
Con POST /<IG_ID>/messages e recipient.id impostato sul sender.id del postback, cioè l'ID con ambito Instagram della persona che ha toccato. Dopo un tocco sul menu persistente, Meta dà all'account 24 ore per rispondere.
Devo instradare i postback di Instagram su title o payload?
Sul payload, la stringa impostata dall'app per l'opzione. title è il testo che la persona ha visto, che può variare per lingua.
Continua a leggere
Collega il tuo primo canale in due minuti.
Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.
- 3 giorni gratis
- Disdici quando vuoi
- Solo API ufficiali
- Monitorato 24/7
Verificato il