Messenger de Meta

Grâce à l'intégration de Meta Messenger, vous pouvez créer Messenger pour interagir avec vos utilisateurs finaux.

Fonctionnement

Voici comment fonctionne l'intégration :

  • Vous créez une application Meta qui utilise la Plate-forme Meta Messenger.
  • Vous configurez l'intégration des agents conversationnels (Dialogflow CX) et l'application Meta afin qu'elles communiquent entre elles.
  • L'intégration des agents conversationnels (Dialogflow CX) envoie des messages à l'utilisateur final à l'aide de l'API Meta Messenger.
  • L'intégration des agents conversationnels (Dialogflow CX) reçoit les messages de l'utilisateur final en tant que webhooks Meta pour la plate-forme Messenger.

Configuration

Pour configurer l'intégration, procédez comme suit :

  1. Suivez les étapes ci-dessous pour créer une application Meta: Développement d'applications Meta.

  2. Configurez l'application Meta pour utiliser la plate-forme Meta Messenger. Suivez les étapes de la documentation Meta Webhooks for Messenger Platform pour effectuer les opérations suivantes :

    • Ajoutez la plate-forme Messenger à votre application Meta.
    • Abonnez votre application à une page Meta. Assurez-vous que messages et messaging_postbacks sont activés dans l'abonnement à la page.
    • Un jeton d'accès vous est fourni à cette étape. Copiez cette valeur. Ce jeton permet de configurer l'intégration à partir des agents conversationnels (Dialogflow CX) console.
    • Ne configurez pas le webhook et ne testez pas votre intégration pour le moment.

  3. Configurez l'intégration à partir de la console Conversational Agents (Dialogflow CX) :

    1. Accédez à la console Dialogflow CX.
    2. Cliquez sur l'onglet Gérer dans le panneau de gauche.
    3. Cliquez sur Integrations (Intégrations) dans le menu de la barre latérale gauche.
    4. Cliquez sur le bouton Connecter du bloc Meta Messenger.

    5. Une boîte de dialogue de configuration s'ouvre :

      • Secret de l'application : saisissez le secret de l'application dans les paramètres de base du tableau de bord des applications.

      • Jeton de validation : vous pouvez saisir n'importe quel jeton privé de votre choix. Copiez cette valeur. Ceci permet de configurer Meta Messenger. Webhook.

      • Page access token (Jeton d'accès à la page) : saisissez le jeton d'accès que vous avez copié lors du Configuration de l'appli Meta ci-dessus.

      • Activer le bouton "Commencer" : consultez la section Bouton "Commencer".

      • Webhook URL : copiez cette valeur. Cela permet de configurer Webhook Meta Messenger.

      • Démarrer : cliquez pour démarrer ce service d'intégration pour votre agent.

  4. Terminez la configuration de l'application Meta et testez-la. Suivez les étapes de la documentation Meta Webhooks for Messenger Platform pour effectuer les opérations suivantes :

    • Configurez le webhook Meta pour votre application. Utilisez les valeurs Webhook URL (URL du webhook) et Verify token (Jeton de validation) que vous avez copiées ci-dessus. Veillez à activer messages et messaging_postbacks dans l'abonnement à la page.
    • Testez l'application.

Events

Les événements suivants sont appelés par cette intégration. Vous pouvez créer des gestionnaires d'événements personnalisés pour définir ce qu'il faut faire lorsque les événements sont déclenchés.

Événement Description
FACEBOOK_WELCOME Déclenché lorsqu'un utilisateur final clique sur le bouton "Commencer" de Meta Messenger.
FACEBOOK_MEDIA Déclenché lorsque le message d'un utilisateur final contient des pièces jointes (par exemple, audio, image, vidéo, etc.).

Bouton "Commencer"

Pour configurer Bouton "Commencer" de Meta Messenger:

  1. Activez l'option Activer le bouton "Commencer" lorsque vous activez ce service d'intégration.

    • Ce service d'intégration active le bouton pour vous en appelant API Messenger Profile :

      curl -X POST \
-H "Content-Type: application/json" \
-d '{"get_started": {"payload": "FACEBOOK_WELCOME"}}' \
"https://graph.facebook.com/v10.0/me/messenger_profile?access_token=${PAGE_ACCESS_TOKEN}"

  2. Créez un gestionnaire d'événements personnalisé pour l'événement FACEBOOK_WELCOME.

Pour la tester :

  1. Supprimez la conversation précédente avec votre page Meta (le cas échéant).

    • Le bouton Commencer ne s'affiche que dans les nouvelles conversations.

  2. Démarrez une nouvelle conversation avec votre page Meta.

  3. Cliquez sur le bouton Commencer et vérifiez la réponse du gestionnaire d'événements personnalisé.

Vous pouvez toujours appeler API Messenger Profile pour gérer le bouton Get Started (Commencer). Cela peut être utile pour les tests.

Par exemple, la requête suivante vérifie l'état du bouton Commencer :

curl -X GET \
"https://graph.facebook.com/v10.0/me/messenger_profile?fields=get_started&access_token=${PAGE_ACCESS_TOKEN}"

La requête suivante désactive le bouton Commencer :

curl -X DELETE \
-H "Content-Type: application/json" \
-d '{"fields": ["get_started"]}' \
"https://graph.facebook.com/v10.0/me/messenger_profile?access_token=${PAGE_ACCESS_TOKEN}"

Messages de réponses enrichies

Les messages de réponses enrichies sont acceptés via une charge utile personnalisée dans Fulfillment. Pour connaître le format du message, consultez la section Objet de message de l'API Send.

Par exemple, la charge utile personnalisée suivante fournit un message texte simple :

{
  "text": "Hello, world"
}

La charge utile personnalisée suivante fournit un message avec image :

{
  "attachment": {
    "type": "image",
    "payload": {
      "url": "https://example.com/test.jpg"
    }
  }
}

Réponses spécifiques à un canal

Une fois que vous avez configuré les réponses spécifiques au canal, le canal DF_CX_FB_MESSENGER est automatiquement utilisé lorsque l'agent répond aux messages Meta Messenger.