Plugin de discussion

Ce document explique comment programmer l’ajout du plugin de discussion à votre expérience Messenger sur votre site Web.

Afin de savoir comment utiliser Meta Business Suite pour ajouter le plugin de discussion à votre page Web (recommandé), consultez les Pages d’aide Meta Business.

Fonctionnement

Lorsque vous installez le SDK Facebook pour JavaScript sur votre page Web, le plugin de discussion s’affiche sur la page. Par défaut, la boîte de dialogue de bienvenue s’affiche sur les ordinateurs et les mobiles. Vous pouvez cliquer sur le bouton Fermer pour la réduire. Vous pouvez personnaliser le message de bienvenue, l’apparence, telle que la couleur, et l’expérience des messages, telle que les menus et les réponses rapides, du plugin. L'état de la boîte de dialogue est mis en cache, maximisé ou minimisé, et persiste d'une session à l'autre.

Connexions

Si la personne est connectée à Facebook, le plugin affiche les boutons « Continuer en tant que [NAME] » et « Continuer en tant qu’invité ». Si elle n’est pas connectée à Facebook, le plugin affiche les boutons « Se connecter à Messenger » et « Continuer en tant qu’invité ».

Notifications Webhook

Lorsqu’une personne clique sur le plugin pour lancer ou continuer une discussion avec votre entreprise, une notification webhook est envoyée à votre serveur avec les éléments suivants :

• Informations sur la personne, telles que les ID spécifiques de Page (PSID) ou les ID de référence utilisateur·ice
• Identification du plugin de discussion comme étant la source du message
• Informations de référence incluses dans la notification

Si vous avez implémenté l’Écran Bienvenue dans le plugin et que la personne clique sur le bouton Démarrer pour lancer une conversation avec votre entreprise, une notification webhook messaging_postbacks est envoyée à votre serveur. Votre entreprise peut alors utiliser l’ID de référence utilisateur·ice pour envoyer des messages à la personne dans la fenêtre d’envoi de messages standard de 24 heures.

Conversations existantes

Si la personne a déjà initié une conversation avec votre entreprise, l’historique de discussion se charge automatiquement dans le plugin. Lorsque la personne continue la conversation, qu’elle envoie un message, clique sur un bouton ou effectue toute autre action que vous avez implémentée dans la conversation, une notification webhook messaging est envoyée à votre serveur, ou une notification webhook messaging_referral si vous incluez des informations de parrainage. Votre entreprise peut ensuite utiliser le PSID pour envoyer des messages à la personne dans la fenêtre d’envoi de messages standard de 24 heures.

Types de messages pris en charge par le plugin de discussion

Le plugin ne prend pas en charge les éléments suivants :

Avant de commencer

Vous aurez besoin des éléments suivants :

• Vous devez disposer de l’autorisation pages_messaging
• Un token d’accès de Page demandé par une personne autorisée à effectuer la tâche MODERATE sur votre Page Facebook
• L’application associée à votre Page Facebook abonnée aux champs de Webhooks messaging, messaging_postbacks et messaging_referrals
• Le domaine de votre site Web ajouté à la liste des éléments autorisés à l’aide de l’API Messenger Profile ou de Meta Business Suite

Les Conditions générales d’utilisation des Outils Meta Business s’appliquent au plugin de discussion.

Limites

• Votre site Web doit être actif ou autorisé avant de pouvoir installer le plugin de discussion
• Si des restrictions liées au pays ou à l’âge sont définies dans les paramètres de la Page Facebook de votre entreprise, le plugin de discussion ne s’affichera pas chez les personnes qui ne sont pas connectées à leur compte Facebook lorsqu’elles consultent votre site Web.
• La boîte de dialogue de bienvenue n’est pas mise en cache pour les navigateurs Safari 12+ et Firefox

Ajouter le plugin de discussion

Étape 1. Ajouter le SDK

Ajoutez le SDK Facebook pour JavaScript pour chacune des pages de votre site Web sur lesquelles vous souhaitez afficher le plugin.

<!-- Messenger Chat Plugin Code --> <div id="fb-root"></div> <div id="fb-customer-chat" class="fb-customerchat"></div> <script> var chatbox = document.getElementById('fb-customer-chat'); chatbox.setAttribute("page_id", "PAGE-ID"); chatbox.setAttribute("attribution", "biz_inbox"); </script> <script> window.fbAsyncInit = function() { FB.init({ xfbml : true, version : 'API-VERSION' }); }; (function(d, s, id) { var js, fjs = d.getElementsByTagName(s)[0]; if (d.getElementById(id)) return; js = d.createElement(s); js.id = id; js.src = 'https://connect.facebook.net/en_US/sdk/xfbml.customerchat.js'; fjs.parentNode.insertBefore(js, fjs); }(document, 'script', 'facebook-jssdk')); </script> 

Étape 2. Personnaliser le plugin

Utilisation de l’API

Envoyez une requête POST au point de terminaison /PAGE-ID/chat_plugin pour personnaliser le message de bienvenue du plugin, sa couleur, son icône, etc.

Exemple de requête

curl -i -X POST "https://graph.facebook.com/v19.0/PAGE-ID/chat_plugin
    ?welcome_screen_greeting:YOUR-WELCOME-TEXT
    &theme_color:553399
    &entry_point_icon:MESSENGER-ICON
    &entry_point_label:CHAT
    &access_token=PAGE-ACCESS-TOKEN"

Pour plus d’informations sur les champs utilisés pour personnaliser votre plugin, consultez la Référence sur le plugin de discussion.

Utilisation des attributs HTML

Nous vous recommandons d’utiliser cette méthode uniquement pour les personnalisations non gérées par l’outil de configuration des paramètres de la Page ou par l’API.

Notifications Webhooks

Chaque fois qu’une personne envoie un message à votre entreprise, une notification webhook est envoyée à votre serveur.

Conversations existantes

Une notification webhook messaging est envoyée lorsqu’une personne envoie un message à une conversation existante avec votre entreprise. La notification inclut l’ID spécifique de Page de la personne, ainsi que le paramètre source de l’objet tags défini sur customer_chat_plugin.

Notification de message

{
    "object": "page",
    "entry": [
        {
            "id": "PAGE-ID",
            "time": 1559598624359,
            "messaging": [
                {
                    "sender": {
                        "id": "PSID"
                    },
                    "recipient": {
                        "id": "PAGE-ID"
                    },
                    "timestamp": 1559598623749,
                    "message": {
                        "tags": {
                            "source": "customer_chat_plugin"
                        },
                        "mid": "nhEqs_THGoYyAhpK93uNCrIfLZD...",
                        "text": "hello, from customer chat!"
                    }
                }
            ]
        }
    ]
}

Notification de parrainage de message

Si vous définissez l’attribut ref pour votre plugin de discussion, une notification webhook messaging_referrals est envoyée à votre serveur.

{
    "object": "page",
    "entry": [
        {
            "id": "PAGE-ID",
            "time": 1559598385735,
            "messaging": [
                {
                    "recipient": {
                        "id": "PAGE-ID"
                    },
                    "timestamp": 1559598385735,
                    "sender": {
                        "user_ref":"USER-REFERENCE-ID"
                    },
                    "referral": {
                        "ref": "REF-PARAMETER-INFORMATION",
                        "source": "CUSTOMER_CHAT_PLUGIN",
                        "type": "OPEN_THREAD",
                        "referer_uri": "REFERRAL-URI"
                    }
                }
            ]
        }
    ]
}

Nouvelles conversations

Une notification webhook messaging_postbacks est envoyée lorsqu’une personne lance une conversation en cliquant sur le bouton Démarrer de l’écran d’accueil du plugin.

Notification de renvoi de messages

{
    "object": "page",
    "entry": [
        {
            "id": "PAGE-ID",
            "time": 1559598624359,
            "messaging": [
                {
                    "sender": {
                        "user_ref": "USER-REFERENCE-ID"
                    },
                    "recipient": {
                        "id": "PAGE-ID"
                    },
                    "timestamp": 1559598623749,
                    "postback":{
                        "title": "TITLE-FOR-THE-CTA",  
                        "payload": "PAYLOAD-DEFINED-BY-CTA",
                        "referral": {
                            "ref": "ADDITIONAL-INFORMATION",
                            "source": "CUSTOMER_CHAT_PLUGIN",
                            "type": "OPEN_THREAD",
                    }
                }
            ]
        }
    ]
}

Demandes d’inscription aux messages marketing

Consultez notre guide des messages marketing pour apprendre à créer des demandes d’inscription aux messages marketing.

Limites

Seul le sujet Nouvelles et promotions est pris en charge pour les messages marketing pour le plugin de discussion.

Notification d’inscription aux messages

Une notification webhook messaging_optins est envoyée à votre serveur lorsqu’une personne accepte de recevoir des messages marketing de la part de votre entreprise.

"object": "page",
    "entry": [
        {
            "id": "PAGE-ID",
            "time": TIMESTAMP,
            "messaging": [
                {
                    "recipient": {
                        "id": "PAGE-ID"
                    },
                    "timestamp": TIMESTAMP,
                    "optin": {
                        "type": "notification_messages",
                        "payload": "empty_payload",
                        "notification_messages_token": "NOTIFICATION-MESSAGE-TOKEN",
                        "notification_messages_frequency": "MESSAGE-FREQUENCY",
                        "topic": "NOTIFICATION-MESSAGE-TOPIC",
                        "token_expiry_timestamp": EXPIRATION-DATE-TIMESTAMP,
                        "ref": "ADDITIONAL-INFORMATION",
                        "user_token_status": "NOT_REFRESHED",
                        "notification_messages_status": "RESUME_NOTIFICATIONS"
                    }
                }
            ]
        }
    ]
}

Vous pouvez définir la valeur notification_messages_token sur la valeur d’ID dans l’objet recipient pour envoyer des messages marketing à une personne.

Conseils de dépannage

• Refus d’affichage...

  • Assurez-vous que votre domaine a bien été mis sur liste verte
  • Vérifiez que l’en-tête Referrer-Policy est bien défini pour permettre l’envoi de l’URL du référent

• Aucun rendu du plugin de discussion dans Firefox

  • Supprimez l’add-on Firefox Facebook Container.
  • Désactivez le blocage du contenu (cliquez sur le bouclier gris dans la barre de recherche) pour afficher le rendu de plugin.

Étapes suivantes

• Envoyer une réponse
• Envoyer des messages marketing

Voir aussi

• Désactiver le menu fixe
• SDK Facebook pour JavaScript
• Mode invité : permet aux utilisateur·ices de lancer des conversations sans être connecté·es à Facebook.
• Amorce de conversation : permet aux utilisateur·ices de lancer une conversation avec une entreprise avec une liste de questions/réponses.
• Menu fixe : aide les personnes à découvrir vos fonctionnalités tout au long de la conversation et à y accéder plus facilement.