Plug-in Invia a Messenger

Quando la tua app Facebook è in Modalità sviluppo, le funzionalità plug-in e API funzioneranno solo per amministratori, sviluppatori e tester dell'app che hanno una sessione valida. Dopo che la tua app sarà stata approvata e pubblica, funzionerà anche per il pubblico.

Il plug-in "Invia a Messenger" viene usato per attivare un evento di autenticazione al tuo webhook. Puoi trasmettere i dati per sapere quale utente e transazione sono collegati all'evento di autenticazione e collegare l'utente sul tuo back-end.

La prima volta che una persona clicca su questo pulsante, verrà presentata una conferma a comparsa.

Requisiti

SDK JavaScript di Facebook

Per usare il plug-in Invia a Messenger, devi includere una versione dell'SDK di Facebook per Javascript nella pagina in cui sarà visualizzato il plug-in.

Per le istruzioni sull'inclusione dell'SDK, consulta l'Avvio rapido dell'SDK di Facebook per Javascript.

Configurazione

<div class="fb-send-to-messenger" 
  messenger_app_id="<APP_ID>" 
  page_id="PAGE_ID" 
  data-ref="<PASS_THROUGH_PARAM>" 
  color="<blue | white>" 
  size="<standard | large | xlarge>">
</div>

Per una descrizione completa degli attributi disponibili, consulta il riferimento per il plug-in Invia a Messenger.

Abbonamento all'evento

Attiva l'iscrizione agli eventi plug-in.

<script>

      FB.Event.subscribe('send_to_messenger', function(e) {
      // callback for events triggered by the plugin

      });

      </script>

Campi dell'evento

Nome del campo Tipo Descrizione

event

Enum

Nome dell'evento. Possibili valori: rendered, clicked, not_you, opt_in.

ref

Stringa

Contiene il valore impostato sul parametro data-ref sul plug-in. Sono consentiti solo caratteri alfanumerici e i caratteri -, _ e =.

is_after_optin

Booleano

Indica se l'evento si è verificato dopo aver accettato il messaggio di conferma a comparsa.

pluginID

indefinito

Questo campo non è in uso.

Evento webhook

Il plug-in Invia a Messenger attiva l'evento webhook messaging_optins.

Personalizzazione del comportamento di accesso

In assenza di utenti collegati a Facebook, il plug-in viene visualizzato senza mostrare alcune identità utente. Facendo clic sul pulsante l'utente visualizza un prompt di accesso.

Se imposti allow_login su false, il plug-in non viene visualizzato per gli utenti che non hanno effettuato l'accesso.

Tieni presente che il plug-in verrà visualizzato senza una sessione di Facebook solo se l'app è approvata e pubblica.

Opzioni di testo CTA

Il plug-in Invia a Messenger supporta anche l'attributo cta_text. Questo permette di scegliere il testo del pulsante per il plug-in da una lista predefinita di stringhe. Quando viene usato l'attributo cta_text, la maggior parte degli utenti collegati dovrà solo fare clic sul pulsante del plug-in per attivarlo, senza dover riconfermare con il messaggio a comparsa, e l'evento messaging_optins verrà consegnato immediatamente.

I seguenti valori sono supportati per l'attributo cta_text:

  • GET_THIS_IN_MESSENGER
  • RECEIVE_THIS_IN_MESSENGER
  • SEND_THIS_TO_ME
  • GET_CUSTOMER_ASSISTANCE
  • GET_CUSTOMER_SERVICE
  • GET_SUPPORT
  • LET_US_CHAT
  • SEND_ME_MESSAGES
  • ALERT_ME_IN_MESSENGER
  • SEND_ME_UPDATES
  • MESSAGE_ME
  • LET_ME_KNOW
  • KEEP_ME_UPDATED
  • TELL_ME_MORE
  • SUBSCRIBE_IN_MESSENGER
  • SUBSCRIBE_TO_UPDATES
  • GET_MESSAGES
  • SUBSCRIBE
  • GET_STARTED_IN_MESSENGER
  • LEARN_MORE_IN_MESSENGER
  • GET_STARTED