Riferimento per i plug-in web

La Piattaforma Messenger offre un pratico insieme di plug-in web che ti consentono di avviare una conversazione con le persone che ti visitano sul web. Tutti i plug-in sono implementati con l'SDK di Facebook per Javascript.

Plug-in per la chat con i clienti (beta)

Il plug-in per la chat con i clienti della Piattaforma Messenger ti consente di integrare il tuo bot di Messenger direttamente nel tuo sito web. In questo modo, i clienti potranno interagire con la tua azienda in qualsiasi momento con la stessa esperienza personalizzata e ricca di contenuti multimediali elaborati di Messenger.

Per dettagli sull'utilizzo, vedi Plug-in per la chat con i clienti.

Includi formato

<div class="fb-customerchat"
 page_id="<PAGE_ID>">
</div>

Attributi

Attributo Tipo Descrizione

class

Stringa

Il valore deve essere fb-customerchat.

page_id

Stringa

ID della tua Pagina

ref

Stringa

Facoltativo. Stringa personalizzata passata al tuo webhook negli eventi messaging_postbacks e messaging_referrals.

theme_color

Stringa

Facoltativo. Il colore da usare come tema per il plug-in, compreso il colore di sfondo dell'icona del plug-in per la chat con i clienti e il colore di sfondo di tutti i messaggi inviati dagli utenti. Supporta qualsiasi codice colore esadecimale con un segno numerico iniziale (es. #0084FF), eccetto il bianco. Ti consigliamo vivamente di scegliere un colore che abbia un contrasto elevato con il bianco.

logged_in_greeting

Stringa

Facoltativo. Il testo del saluto che verrà mostrato se l'utente è collegato a Facebook. Massimo 80 caratteri.

logged_out_greeting

Stringa

Facoltativo. Il testo del saluto che verrà mostrato se l'utente non è collegato a Facebook. Massimo 80 caratteri.

greeting_dialog_display

Stringa

Facoltativo. Imposta il modo in cui verrà visualizzata la finestra di dialogo del saluto. Sono supportati i seguenti valori:


  • show: la finestra di dialogo del saluto è sempre visibile durante il caricamento del plug-in.
  • fade: la finestra di dialogo del saluto del plug-in viene inizialmente visualizzata, poi svanisce e rimane nascosta.
  • hide: la finestra di dialogo del saluto del plug-in è nascosta fino a quando un utente non clicca sul plug-in.

L'impostazione predefinita è show su computer e hide su mobile.

greeting_dialog_delay

Stringa

Facoltativo. Imposta il numero di secondi di ritardo prima che venga mostrata la finestra di dialogo del saluto dopo il caricamento del plug-in. Questo attributo può essere usato per personalizzare il momento in cui desideri che venga visualizzata la finestra di dialogo del saluto.

minimized

Booleano

Avviso di disattivazione

Questo attributo è ora obsoleto. Usa greeting_dialog_display per personalizzare il tuo plug-in. L'attributo greeting_dialog_delay avrà la precedenza sull'attributo minimized.

Facoltativo.

  • true Quando impostato su true, avrà lo stesso effetto dell'impostazione greeting_dialog_delay = "fade".
  • false Quando impostato su false, avrà lo stesso effetto dell'impostazione greeting_dialog_delay = "show".

Plug-in Inviaci un messaggio

Porta una persona direttamente in una conversazione su Messenger.

Per dettagli sull'utilizzo, vedi Plug-in Inviaci un messaggio.

Includi formato

<div class="fb-messengermessageus" 
  messenger_app_id="<APP_ID>" 
  page_id="<PAGE_ID>"
  color="<blue | white>"
  size="<standard | large | xlarge>">
</div>

Attributi

Attributo Attributo HTML5 Tipo Descrizione

class

Stringa

Il valore deve essere fb-messengermessageus.

page_id

Stringa

ID della tua Pagina

messenger_app_id

Numero

Il tuo ID dell'app Facebook.

color

data-color

Stringa

Colore del pulsante: blue o white.


L'impostazione predefinita è blue.

size

data-size

Stringa

Dimensioni del pulsante: standard, large o xlarge.


L'impostazione predefinita è large.

ref

Stringa

Facoltativo. Stringa personalizzata passata al tuo webhook negli eventi messaging_postbacks e messaging_referrals.

Plug-in Invia a Messenger

Invia un messaggio a una persona dal tuo bot di Messenger in background e attivane l'iscrizione.

Per dettagli sull'utilizzo, vedi Plug-in Invia a Messenger.

Includi formato

<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>

Attributi

Attributo Tipo Descrizione

class

Stringa

Il valore deve essere fb-send-to-messenger.

page_id

Stringa

ID della tua Pagina

messenger_app_id

Numero

Il tuo ID dell'app Facebook.

color

Stringa

Facoltativo. Colore del pulsante: blue o white.


L'impostazione predefinita è blue.

size

Stringa

Facoltativo. Dimensioni del pulsante: standard, large o xlarge.


L'impostazione predefinita è large.

ref

Stringa

Facoltativo. Parametro di stato personalizzato. Massimo 250 caratteri.


I caratteri validi sono a-z A-Z 0-9 +/=-._


Deve essere codificato e crittografato per motivi di sicurezza.

enforce_login

Booleano

Facoltativo. Se true, gli utenti che hanno effettuato l'accesso devono accedere di nuovo quando cliccano sul pulsante. L'impostazione predefinita è false.

Usa il parametro ref per passare lo stato con l'autenticazione. Se decidi di visualizzare il plug-in in più punti, potrebbe essere opportuno modificare lo stato in base al luogo in cui viene mostrato il plug-in.

Plug-in della casella di spunta

Il plug-in della casella di spunta attiva l'iscrizione di una persona al tuo bot di Messenger come parte di un modulo, come acquisto o iscrizione.

Per dettagli sull'utilizzo, vedi Plug-in della casella di spunta.

Includi formato

<div class="fb-messenger-checkbox"  
  origin=<PAGE_DOMAIN>
  page_id=<PAGE_ID>
  messenger_app_id=<APP_ID>
  user_ref="<UNIQUE_REF_PARAM>"
  prechecked="<true | false>"
  allow_login="<true>"
  size="<small | medium | large | standard | xlarge>"
  skin="<light|dark>"
  center_align="<true|false>">
</div>

Attributi

Attributo Tipo Descrizione

class

Stringa

Il valore deve essere fb-messenger-checkbox

page_id

Numero

ID della Pagina Facebook associato al tuo bot.

messenger_app_id

Numero

Il tuo ID dell'app Facebook.

user_ref

Stringa

Parametro unico per il riferimento a un utente. Massimo 250 caratteri.


I caratteri validi sono a-z A-Z 0-9 +/=-._

allow_login

Booleano

Facoltativo. Consente alle persone di accedere se non è presente nessuna sessione esistente. L'impostazione predefinita è true.

size

Stringa

Facoltativo. Dimensioni del plug-in: small, medium, large, standard, xlarge.


L'impostazione predefinita è large.

skin

Stringa

Facoltativo. Imposta il tema colori per il contenuto del plug-in. Sono supportate le opzioni seguenti:

  • light: il plug-in viene visualizzato con testo scuro.
  • dark: il plug-in viene visualizzato con testo bianco, icona Messenger trasparente e fulmine bianco.

L'impostazione predefinita è light.

center_align

Booleano

Facoltativo. Definisce se il contenuto del plugin deve essere allineato al centro.


L'impostazione predefinita è false.