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.

Indice

Plug-in per la chat con i clienti
Plug-in Inviaci un messaggio
Plug-in Invia a Messenger
Plug-in della casella di spunta

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

Riferimento per i plug-in web

Indice

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

Includi formato

Attributi

Avviso di disattivazione

Plug-in Inviaci un messaggio

Includi formato

Attributi

Plug-in Invia a Messenger

Includi formato

Attributi

Plug-in della casella di spunta

Includi formato

Attributi