Référence concernant les plugins pour le web

La plateforme Messenger offre un ensemble pratique de plugins pour le web qui vous permet de démarrer facilement une conversation avec les personnes qui consultent votre site web. Tous les plugins sont implémentés avec le SDK Facebook pour JavaScript.

Contenu

Plugin Customer Chat
Plugin Message Us
Plugin Send to Messenger
Plugin Checkbox

Plugin Customer Chat (bêta)

Le plugin Customer Chat de la plateforme Messenger vous permet d’intégrer votre bot Messenger directement dans votre site web. Grâce à lui, votre clientèle peut interagir avec votre entreprise à tout moment avec la même expérience multimédia personnalisée que dans Messenger.

Pour en savoir plus sur son utilisation, consultez la rubrique Plugin Customer Chat.

Inclure le format

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

Attributs

Attribut	Type	Description
`class`	Chaîne	La valeur doit être `fb-customerchat`.
`page_id`	Chaîne	ID de votre page
`ref`	Chaîne	*Facultatif.* La chaîne personnalisée est transmise à votre webhook dans les évènements `messaging_postbacks` et `messaging_referrals`.
`theme_color`	Chaîne	*Facultatif.* La couleur à utiliser comme thème pour le plugin, notamment la couleur d’arrière-plan de l’icône Customer Chat, et la couleur d’arrière-plan de tout message envoyé par les utilisateur·trice·s. Tous les codes de couleur hexadécimale commençant par un signe dièse (ex. #0084FF) sont pris en charge, à l’exception du blanc. Nous vous recommandons vivement de choisir une couleur qui contraste fortement avec le blanc.
`logged_in_greeting`	Chaîne	*Facultatif.* Le texte de salutation qui sera affiché si l’utilisateur est actuellement connecté à Facebook. 80 caractères maximum.
`logged_out_greeting`	Chaîne	*Facultatif.* Le texte de salutation qui sera affiché si l’utilisateur n’est actuellement pas connecté à Facebook. 80 caractères maximum.
`greeting_dialog_display`	Chaîne	*Facultatif.* Définit le comportement d’affichage de la boîte de dialogue de bienvenue. Les valeurs prises en charge sont les suivantes : `show` : la boîte de dialogue de bienvenue s’affiche toujours lors du chargement du plugin. `fade` : la boîte de dialogue de bienvenue du plugin s’affiche, puis s’efface progressivement jusqu’à disparaître totalement. `hide` : la boîte de dialogue de bienvenue du plugin est masquée jusqu’à ce qu’un·e utilisateur·trice clique sur le plugin. Défini par défaut sur `show` pour les ordinateurs et sur `hide` pour les appareils mobiles.
`greeting_dialog_delay`	Chaîne	*Facultatif.* Définit le nombre de secondes écoulées entre le chargement du plugin et l’affichage de la boîte de dialogue de bienvenue. Il s’agit d’un paramètre de personnalisation du délai d’affichage de la boîte de dialogue de bienvenue.
`minimized`	Booléen	Avis de dépréciation Cet attribut est désormais obsolète. Utilisez plutôt `greeting_dialog_display` pour personnaliser votre plugin. L’attribut `greeting_dialog_delay` l’emporte sur l’attribut `minimized`. *Facultatif.* `true` S’il est défini sur true, il aura le même effet que le paramètre greeting_dialog_delay = "fade". `false` S’il est défini sur false, il aura le même effet que le paramètre greeting_dialog_delay = "show".

Plugin Message Us

Les utilisateurs et utilisatrices atterrissent directement dans une conversation sur Messenger.

Pour en savoir plus sur son utilisation, consultez la rubrique Plugin Message Us.

Inclure le format

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

Attributs

Attribut	Attribut HTML5	Type	Description
`class`		Chaîne	La valeur doit être `fb-messengermessageus`.
`page_id`		Chaîne	ID de votre page
`messenger_app_id`		Numéro	Votre ID d’application Facebook.
`color`	`data-color`	Chaîne	Couleur du bouton : `blue` ou `white`. Valeur par défaut : `blue`.
`size`	`data-size`	Chaîne	Taille du bouton : `standard`, `large` ou `xlarge`. Valeur par défaut : `large`.
`ref`		Chaîne	*Facultatif.* La chaîne personnalisée est transmise à votre webhook dans les évènements `messaging_postbacks` et `messaging_referrals`.

Plugin Send to Messenger

Envoyez un message à une personne depuis votre bot Messenger en arrière-plan et inscrivez-la.

Pour en savoir plus sur son utilisation, consultez la rubrique Plugin Send to Messenger.

Inclure le format

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

Attributs

Attribut	Type	Description
`class`	Chaîne	La valeur doit être `fb-send-to-messenger`.
`page_id`	Chaîne	ID de votre page
`messenger_app_id`	Numéro	Votre ID d’application Facebook.
`color`	Chaîne	*Facultatif.* Couleur du bouton : `blue` ou `white`. Valeur par défaut : `blue`.
`size`	Chaîne	*Facultatif.* Taille du bouton : `standard`, `large` ou `xlarge`. Valeur par défaut : `large`.
`ref`	Chaîne	*Facultatif.* Paramètre d’état personnalisé. 250 caractères maximum. Les caractères autorisés sont `a-z A-Z 0-9 +/=-._`. Il doit être codé et chiffré à des fins de sécurité.
`enforce_login`	Booléen	*Facultatif.* Si `true`, les utilisateurs et utilisatrices connecté·e·s doivent se reconnecter après avoir cliqué sur le bouton. Valeur par défaut : `false`.

Utilisez le paramètre ref pour transférer un état avec l’authentification. Si vous placez le plugin dans plusieurs endroits, nous vous conseillons de modifier son état en fonction de son emplacement.

Plugin Checkbox

Le plugin Checkbox abonne une personne à votre bot Messenger via un formulaire, au moment d’un paiement ou d’une inscription.

Pour en savoir plus sur son utilisation, consultez la rubrique Plugin Checkbox.

Inclure le format

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

Attributs

Attribut	Type	Description
`class`	Chaîne	La valeur doit être `fb-messenger-checkbox`.
`page_id`	Numéro	L’ID de la Page Facebook associée à votre bot.
`messenger_app_id`	Numéro	Votre ID d’application Facebook.
`user_ref`	Chaîne	Paramètre unique permettant de référencer un·e utilisateur·trice. 250 caractères maximum. Les caractères autorisés sont `a-z A-Z 0-9 +/=-._`.
`allow_login`	Booléen	*Facultatif.* Permet aux personnes de se connecter si aucune session n’a été détectée. Valeur par défaut : `true`.
`size`	Chaîne	*Facultatif.* Taille du plugin : `small`, `medium`, `large`, `standard`, `xlarge`. Valeur par défaut : `large`.
`skin`	Chaîne	*Facultatif.* Définit la couleur du thème du contenu du plugin. Les options suivantes sont prises en charge : `light` : le plugin s’affiche avec du texte foncé. `dark` : le plugin s’affiche avec du texte blanc, l’icône Messenger transparente et un éclair blanc. Valeur par défaut : `light`.
`center_align`	Booléen	*Facultatif.* Indique si le contenu du plugin doit être aligné au centre. Valeur par défaut : `false`.

Référence concernant les plugins pour le web

Contenu

Plugin Customer Chat (bêta)

Inclure le format

Attributs

Avis de dépréciation

Plugin Message Us

Inclure le format

Attributs

Plugin Send to Messenger

Inclure le format

Attributs

Plugin Checkbox

Inclure le format

Attributs