Plugin Envoyer vers Messenger
Tant que votre application Facebook est en mode développement, les fonctionnalités du plugin et de l’API ne sont effectives que pour les admins, développeurs et développeuses et testeurs et testeuses de l’application avec une session valide. Une fois que votre application est approuvée et publique, elle fonctionne pour le public général.
Le plugin « Envoyer vers Messenger » permet de déclencher un évènement d’authentification à votre webhook. Vous pouvez transmettre des données pour savoir quel·le utilisateur·trice et quelle transaction ont été associés à l’évènement d’authentification, ainsi que pour lier l’utilisateur·trice à votre serveur.
La première fois qu’une personne clique sur ce bouton, une fenêtre de confirmation s’affiche.
Conditions requises
SDK JavaScript Facebook
Pour utiliser le plugin Envoyer vers Messenger, vous devez inclure le SDK Facebook pour JavaScript dans la page sur laquelle le plugin sera affiché.
Pour obtenir des instructions sur l’inclusion du SDK, consultez le Guide de démarrage rapide du SDK Facebook pour Javascript.
Configuration
<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>Pour une description complète des attributs disponibles, consultez la référence sur le plugin Envoyer vers Messenger.
Abonnement à l’évènement
S’abonner aux évènements de plugin.
<script>
FB.Event.subscribe('send_to_messenger', function(e) {
// callback for events triggered by the plugin
});
</script>Champ d’évènement
| Nom du champ | Type | Description |
|---|---|---|
| Énumération | Nom de l’évènement. Valeurs possibles : |
| Chaîne | Contient la valeur définie dans le paramètre |
| Booléen | Indique si l’évènement s’est produit après la confirmation sur la fenêtre de confirmation. |
| non défini | Ce champ n’est pas utilisé. |
Évènement webhook
Le plugin Envoyer vers Messenger déclenche l’évènement webhook messaging_optins.
Personnaliser le comportement de connexion
Si aucun·e utilisateur·trice Facebook n’est connecté·e, le plugin sera rendu sans afficher l’identité de l’utilisateur·trice. En cliquant sur le bouton, l’utilisateur·trice sera invité·e à se connecter.
Si vous définissez allow_login sur Faux, le plugin n’effectuera pas le rendu pour les utilisateur·trices qui ne sont pas connecté·es.
Notez que le plugin effectuera le rendu sans session Facebook uniquement si l’application est approuvée et publique.
Options de texte CTA
Le plugin Envoyer vers Messenger prend aussi en charge l’attribut cta_text. Cet attribut permet de choisir le texte du bouton pour le plugin à partir d’une liste de chaînes prédéfinie. Lorsque l’attribut cta_text est utilisé, la plupart des utilisateur·trices inscrit·es devront simplement cliquer sur le bouton du plugin pour s’inscrire sans avoir à confirmer à nouveau sur la fenêtre. L’évènement messaging_optins sera déclenché immédiatement.
Les valeurs suivantes sont prises en charge pour l’attribut cta_text :
GET_THIS_IN_MESSENGERRECEIVE_THIS_IN_MESSENGERSEND_THIS_TO_MEGET_CUSTOMER_ASSISTANCEGET_CUSTOMER_SERVICEGET_SUPPORTLET_US_CHATSEND_ME_MESSAGESALERT_ME_IN_MESSENGERSEND_ME_UPDATESMESSAGE_MELET_ME_KNOWKEEP_ME_UPDATEDTELL_ME_MORESUBSCRIBE_IN_MESSENGERSUBSCRIBE_TO_UPDATESGET_MESSAGESSUBSCRIBEGET_STARTED_IN_MESSENGERLEARN_MORE_IN_MESSENGERGET_STARTED