Piattaforma Messenger

Pulsanti

La maggior parte dei modelli di messaggi e il menu always-on supportano pulsanti che richiamano diversi tipi di azioni. Questi pulsanti ti consentono di offrire al destinatario del messaggio la possibilità di eseguire azioni in risposta al modello in modo semplice, ad es. aprendo la visualizzazione web di Messenger, iniziando un flusso di pagamento, inviando un messaggio di postback al tuo webhook e molto altro.

Per i modelli di messaggi, i pulsanti vengono definiti dagli oggetti nell'array buttons. Per il menu always-on, i pulsanti vengono definiti dagli oggetti nell'array call_to_actions.

Pulsante con URL

Il pulsante con URL apre una pagina web nella visualizzazione web di Messenger. Ciò ti consente di arricchire la conversazione con un'esperienza basata sul web, in cui puoi godere della totale flessibilità di sviluppo offerta dal web. Ad esempio, nella conversazione puoi mostrare il riepilogo di un prodotto, quindi utilizzare il pulsante con URL per aprire la pagina completa del prodotto sul tuo sito web.

Se il sito contiene deep link all'interno dell'app, il pulsante avvierà l'app nativa specificata.

Affinché il reindirizzamento funzioni, il crawler di Facebook deve leggere i metatag per il deep link all'interno dell'app. Se hai appena implementato i tag nel tuo sito web, puoi richiedere di eseguire nuovamente lo scraping con lo strumento Debugger di condivisione. Dopo che il crawler ha eseguito lo scraping del sito, i nuovi pulsanti con URL inviati dovrebbero seguire il comportamento di reindirizzamento.

Utilizzo supportato

Il pulsante con URL è supportato per l'utilizzo con i seguenti elementi:

  • Menu always-on
  • Modello generico
  • Modello di lista
  • Modello di pulsante
  • Modello di contenuto multimediale

SDK per le estensioni di Messenger: autorizzazione dei domini richiesta

Per visualizzare una pagina web con l'SDK per le estensioni di Messenger abilitato nella visualizzazione web di Messenger, devi aggiungere alla whitelist il dominio, includendo il sottodominio nella proprietà whitelisted_domains del profilo Messenger del tuo bot. In questo modo, solo i domini affidabili possono accedere alle informazioni sull'utente disponibili attraverso le funzioni dell'SDK.

Per maggiori informazioni sull'aggiunta alla whitelist dei domini, consulta il riferimento whitelisted_domains.

Formato del pulsante

Per una lista completa delle proprietà del pulsante, consulta il riferimento per pulsante con URL.

{
  "type": "web_url",
  "url": "

Pulsante di postback

Il pulsante di postback invia un evento messaging_postbacks al tuo webhook con la stringa impostata nella proprietà payload. Ciò ti consente di eseguire azioni arbitrarie al tocco del pulsante. Ad esempio, puoi mostrare una lista di prodotti e inviare l'ID prodotto nel postback al tuo webhook, dove può essere utilizzato per effettuare una query al database e restituire i dettagli del prodotto sotto forma di messaggio strutturato.

Utilizzo supportato

Il pulsante di postback è supportato per l'utilizzo con i seguenti elementi:

  • Menu always-on
  • Modello generico
  • Modello di lista
  • Modello di pulsante
  • Modello di contenuto multimediale

Formato del pulsante

Per una lista completa delle proprietà del pulsante, consulta il riferimento per il pulsante di postback.

{
  "type": "postback",
  "title": "

Pulsante Chiama

Il pulsante Chiama compone un numero di telefono quando viene toccato. Il numero di telefono deve essere nel formato +<COUNTRY_CODE><PHONE_NUMBER>, ad es. +15105559999.

Utilizzo supportato

Il pulsante Chiama è supportato per l'utilizzo con i seguenti elementi:

  • Modello generico
  • Modello di lista
  • Modello di pulsante
  • Modello di contenuto multimediale

Formato del pulsante

Per una lista completa delle proprietà del pulsante, consulta il riferimento per il pulsante Chiama.

{
  "type":"phone_number",
  "title":"

Pulsante Accedi

Il pulsante Accedi viene usato nel flusso di collegamento dell'account, che ti consente di collegare l'identità su Messenger del destinatario del messaggio con il rispettivo account sul tuo sito, reindirizzando l'utente al tuo flusso di accesso basato sul web per l'autenticazione.

Per maggiori informazioni sull'uso del pulsante Accedi per il collegamento dell'account, consulta Collegamento dell'account.

Utilizzo supportato

Il pulsante Accedi è supportato per l'utilizzo con i seguenti elementi:

  • Modello generico
  • Modello di lista
  • Modello di pulsante
  • Modello di contenuto multimediale

Formato del pulsante

Per una lista completa delle proprietà del pulsante, consulta il riferimento per il pulsante Accedi.

{
  "type": "account_link",
  "url": "

Pulsante Esci

Il pulsante Esci viene usato nel flusso di collegamento dell'account per scollegare l'identità su Messenger del destinatario del messaggio dal rispettivo account sul tuo sito.

Per maggiori informazioni sull'uso del pulsante Esci per lo scollegamento dell'account, consulta Collegamento dell'account.

Utilizzo supportato

Il pulsante Esci è supportato per l'utilizzo con i seguenti elementi:

  • Modello generico
  • Modello di lista
  • Modello di pulsante
  • Modello di contenuto multimediale

Formato del pulsante

Per una lista completa delle proprietà del pulsante, consulta il riferimento per il pulsante Esci.

{
  "type": "account_unlink"
}

Pulsante Utilizzo del gioco

Il pulsante Utilizzo del gioco avvia un gioco istantaneo associato alla tua Pagina Facebook. Per personalizzare il modo in cui il tuo gioco viene aperto, puoi impostare una proprietà payload nella richiesta inviata al gioco durante l'avvio, nonché una proprietà game_metadata.player_id o game_metadata.context_id facoltativa, che consente al tuo bot di avviare il gioco in un contesto specifico rispetto a un singolo giocatore o a un gruppo esistente.

Formato del pulsante

La proprietà payload deve essere in formato JSON serializzato. La serializzazione viene annullata dall'SDK per Giochi istantanei.

Per una lista completa delle proprietà del pulsante, consulta il riferimento per il pulsante Utilizzo del gioco.

{
  "type":"game_play",
  "title":"Play",
  "payload":"{

Consulta l'evento del webhook di Utilizzo del gioco per l'evento che verrà inviato al bot quando un utente completa un round del gioco.

Best practice

Usa i pulsanti per richiedere altre interazioni o follow-up con uno specifico messaggio.

Inizia con un verbo per aiutare le persone a capire le azioni che stanno eseguendo.

Usa i pulsanti con URL per le attività che devono essere completate sul tuo sito web (ad es. acquisti, collegamento di account, ecc.). Fai in modo che le persone comprendano di essere reindirizzate al di fuori di Messenger.

Invia una risposta dopo che qualcuno tocca un pulsante di callback. Questo conferma che hai elaborato o completato l'azione dell'utente (ad es. annullare una prenotazione, rispondere a una domanda).

Non usare i pulsanti quando il loro funzionamento dipende dallo stato attuale del bot, dal momento che resteranno sempre disponibili nella conversazione.

Non usare più di 1-3 parole e non aggiungere la punteggiatura. Prova a mantenere il testo sotto i 20 caratteri, spazi inclusi.

Non usare solo pulsanti con URL. Più interazioni puoi creare all'interno di Messenger, più uniforme sarà la tua esperienza.

Non usare un solo pulsante di callback. Quando è disponibile un solo pulsante, spesso le persone credono che sia una continuazione del testo del messaggio, senza rendersi conto che si tratta di un'azione che vuoi che eseguano.