Messenger de Meta

Grâce à l'intégration de Dialogflow Meta Messenger, vous pouvez créer un conteneur Meta 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 Dialogflow et l'application Meta de sorte qu'elles communiquer entre eux.
  • L'intégration Dialogflow envoie des messages à l'utilisateur final à l'aide de la classe API Meta Messenger :
  • L'intégration Dialogflow reçoit les messages de l'utilisateur final en agissant en tant que la Meta Webhooks pour Messenger Platform

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 le les étapes de la Meta Webhooks pour Messenger Platform documentation pour effectuer les opérations suivantes:

    • Ajoutez la plate-forme Messenger à votre application Meta.
    • Abonner 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 sera utilisé pour configurer l'intégration à partir de la console Dialogflow.
    • Ne configurez pas le webhook et ne testez pas votre intégration pour le moment.

  3. Configurez l'intégration à partir de la console Dialogflow :

    1. Accéder à 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 Connect (Se connecter) de la tuile Meta Messenger.

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

      • App secret (Code secret de l'application) : saisissez le code secret de l'application à partir de Paramètres généraux du tableau de bord de l'application.

      • Jeton de validation : vous pouvez saisir n'importe quel jeton privé de votre choix. Copiez cette valeur. Cela permettra 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 permettra 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 la procédure décrite dans le Meta Webhooks pour Messenger Platform documentation pour effectuer les opérations suivantes:

    • Configurez le méta-webhook pour votre application. Utilisez l'URL du webhook et Vérifiez le jeton que vous avez copiés 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 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éclenchement lorsqu'un utilisateur final clique sur le bouton de démarrage 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 activera 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és pour FACEBOOK_WELCOME événement.

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 à des fins de test.

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. Consultez la page Envoyer un objet de message pour les paramètres de l'API pour le format de message.

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 configurées, les réponses spécifiques à un canal avec le canal DF_CX_FB_MESSENGER sont automatiquement utilisées lorsque l'agent répond aux messages Meta Messenger.