API del profilo Messenger: saluto, pulsante Get Started, ice breaker e menu persistente
Il profilo Messenger di una Pagina Facebook si imposta tramite /{page-id}/messenger_profile con un token di accesso della Pagina e il permesso pages_messaging: POST scrive proprietà come get_started, greeting, ice_breakers, persistent_menu e commands, GET le legge con fields, e DELETE rimuove quelle indicate in un array fields. Meta consente 10 chiamate ogni 10 minuti per Pagina, e vengono sovrascritte solo le proprietà inviate.
easyCoexistence risponde alle conversazioni Messenger di una Pagina con send_social_dm entro la finestra di 24 ore, da Claude, ChatGPT o dal tuo codice, con i nuovi messaggi inoltrati al tuo endpoint man mano che arrivano.
Chiamate all'API del profilo Messenger consentite per Pagina in ogni intervallo di 10 minuti.
Numero massimo di ice breaker impostabili dall'API; se sono impostati entrambi, quelli dell'API hanno la precedenza sul pulsante Get Started.
Numero massimo di voci di primo livello in un menu persistente; il titolo di ogni voce è limitato a 30 caratteri.
Tempo necessario affinché un aggiornamento del menu persistente a livello di Pagina diventi effettivo; un menu impostato per una singola persona si aggiorna in tempo reale.
Testo del saluto, che il riferimento di Meta indica non più funzionante su Messenger per Android e iOS.
Cosa contiene il profilo Messenger?
Le impostazioni da cui parte l'esperienza Messenger di una Pagina. L'API del profilo Messenger di Meta elenca queste proprietà, ciascuna impostata e letta sullo stesso endpoint; per un'app in modalità Sviluppo, le impostazioni sono visibili solo alle persone con un ruolo sull'app:
Come si leggono, impostano ed eliminano le proprietà?
Con tre metodi su un unico endpoint, chiamati con il token della Pagina. POST accetta un corpo JSON di proprietà e sovrascrive solo quelle indicate, GET accetta fields come elenco separato da virgole, e DELETE accetta un corpo JSON il cui array fields indica cosa rimuovere; POST e DELETE rispondono con result success. Impostazione di un pulsante Get Started e di un menu in un'unica chiamata:
POST /{page-id}/messenger_profile
{
"get_started": { "payload": "GET_STARTED" },
"persistent_menu": [
{
"locale": "default",
"composer_input_disabled": false,
"call_to_actions": [
{ "type": "postback", "title": "Talk to an agent", "payload": "AGENT" },
{ "type": "web_url", "title": "Shop now", "url": "https://example.com/shop" }
]
}
]
}
{ "result": "success" }Come funziona il pulsante Get Started?
Si trova nella schermata di benvenuto, che mostra il nome della Pagina, la foto del profilo e la foto di copertina, oltre a quanto tempo impiega di solito l'azienda a rispondere. Un tocco invia Get Started nella conversazione, passa get_started.payload all'app come evento messaging_postbacks e apre la finestra di messaggistica standard. Meta precisa che il pulsante non è supportato quando Messenger viene aperto nel browser integrato dell'app Facebook, e un menu persistente richiede che sia impostato prima.
Il saluto funziona ancora?
Non sui telefoni. Il riferimento di Meta ora è intitolato [Deprecated] Greeting Text: la funzione non funziona più su Messenger per Android e iOS e, sebbene l'API possa ancora accettare la proprietà greeting, i clienti non la vedranno, quindi Meta chiede agli sviluppatori di evitarla. Come documentato, greeting prevede un testo per locale, con default obbligatorio, fino a 160 caratteri, personalizzabile con {{user_first_name}}, {{user_last_name}} o {{user_full_name}}, e per impostarlo serve il ruolo di Amministratore della Pagina.
Come funzionano gli ice breaker?
Elencano fino a 4 domande che una persona può toccare per aprire una conversazione; la domanda viene inviata nel thread come se l'avesse posta la persona, e il suo payload torna come evento postback. Da aprile 2022 sono localizzati: ogni oggetto in ice_breakers contiene call_to_actions e un locale, è obbligatorio un locale predefinito, e un DELETE di ice_breakers rimuove tutti. Meta ordina gli elementi che competono per una nuova conversazione:
- Gli ice breaker dell'API hanno la precedenza sul pulsante Get Started quando sono impostati entrambi.
- Entrambi vengono prima delle domande personalizzate impostate nella casella della Pagina, la cui modifica è disattivata finché sono impostati gli ice breaker dell'API.
Come è costruito il menu persistente?
Come array di menu, uno per locale con default obbligatorio, ciascuno con fino a 20 call_to_actions di tipo web_url o postback. Un titolo può avere fino a 30 caratteri e un payload postback fino a 1.000, e composer_input_disabled impostato su true lascia il menu, i pulsanti e le webview come unico modo di interazione. Requisiti di Meta prima che compaia:
- Un pulsante Get Started già impostato e il permesso
pages_messaging. - Una Pagina pubblicata e l'app impostata come pubblica.
- Il ruolo di Amministratore della Pagina per chi lo imposta.
- Messenger v106 o successiva su iOS o Android, al di fuori del browser integrato dell'app Facebook.
- Le modifiche a livello di Pagina possono richiedere fino a 24 ore; un menu per una singola persona, impostato tramite
custom_user_settingscon un PSID, si aggiorna in tempo reale.
Cosa sono i comandi?
Parole chiave che una persona può richiamare in qualsiasi momento, da un menu di comandi accanto al campo di composizione, digitando una barra o una chiocciola, oppure da un popover quando digita una parola corrispondente. Ogni locale contiene da 1 a 100 comandi, con un nome da 1 a 32 caratteri senza barra iniziale e una descrizione da 1 a 64 caratteri; quando sono impostati i comandi, hanno la priorità sul menu persistente. I comandi richiamati arrivano all'app all'interno dell'evento messages, in message.commands.
A cosa servono whitelisted_domains e account_linking_url?
Entrambi servono esperienze al di fuori della conversazione stessa. whitelisted_domains elenca fino a 50 domini che la webview di Messenger può aprire per l'SDK Messenger Extensions e per il plugin checkbox, ciascuno servito via HTTPS con nome di dominio completo, mai un indirizzo IP o localhost, e impostarlo richiede il ruolo di Amministratore della Pagina. account_linking_url è il callback HTTPS che collega l'account Messenger di una persona al suo account presso l'azienda.
Come easyCoexistence imposta il profilo Messenger di una Pagina?
Non lo fa: nessuno strumento chiama {page-id}/messenger_profile e i token delle Pagine non vengono consegnati, quindi impostare il profilo esula da questa connessione. I comandi richiamati dalle persone arrivano nell'evento messages che easyCoexistence inoltra e che le automazioni leggono; i tocchi che Meta segnala come eventi messaging_postbacks, da Get Started, dalle voci di menu postback e dagli ice breaker, non vengono inoltrati, poiché le Pagine sono iscritte a feed, messages e mention.
Errori comuni
- Impostare il menu persistente prima di Get Started. I requisiti di Meta includono un pulsante Get Started, quindi imposta prima get_started.
- Omettere il locale predefinito. Ice breaker, menu e comandi richiedono ciascuno un oggetto con locale impostato su default come fallback.
- Chiamare l'API del profilo in un ciclo. Meta consente 10 chiamate ogni 10 minuti per Pagina, quindi inserisci più proprietà in un unico POST.
- Aspettarsi che una modifica del menu sia immediata. Un aggiornamento del menu a livello di Pagina può richiedere fino a 24 ore per raggiungere le persone.
Impostare il profilo Messenger non rientra tra i suoi strumenti. Da US$ 9 a US$ 0.75 per connessione al mese, con prezzo che scende man mano che aggiungi connessioni, con i primi 3 giorni di prova gratuita.
Domande frequenti
Un menu persistente può essere diverso per ogni persona?
Sì. custom_user_settings con il PSID della persona sostituisce il menu della Pagina per quella persona, si aggiorna in tempo reale e consente 10 chiamate per persona ogni 10 minuti.
Quali locale supporta il profilo Messenger?
Quelli dell'elenco dei locale supportati da Meta, come en_GB, pt_BR o ja_JP, più default, il fallback usato quando nessun locale corrisponde a quello della persona.
Chi può modificare il profilo Messenger di una Pagina?
Un'app con un token della Pagina che include pages_messaging. Il menu persistente, il saluto e l'elenco dei domini richiedono anche il ruolo di Amministratore della Pagina.
Quanto costa easyCoexistence per una Pagina Facebook?
Ogni Pagina è una connessione: da US$ 9 a US$ 0.75 per connessione al mese, con prezzo che scende man mano che cresce il numero di connessioni, e i primi 3 giorni sono gratuiti.
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