Messenger de Meta

Grâce à l'intégration de Dialogflow Meta Messenger, vous pouvez créer un bot 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 afin qu'elles communiquent entre elles.
  • L'intégration Dialogflow envoie des messages à l'utilisateur final à l'aide de l'API Meta Messenger.
  • L'intégration Dialogflow reçoit les messages de l'utilisateur final en tant que Meta Webhooks for Messenger Platform.

Préparation

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

  1. Suivez la procédure pour créer une application Meta : Développement d'application 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:

    • 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 des paramètres de base 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 le webhook Meta Messenger.

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

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

      • Webhook URL : copiez cette valeur. Cela permettra de configurer le 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 la documentation Meta Webhooks for Messenger Platform pour:

    • Configurez le méta-webhook pour votre application. Utilisez les valeurs Webhook URL et Verify token 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 l'action à effectuer 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 le bouton de démarrage 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 l'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 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 l'API Messenger Profile pour gérer le bouton 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. Veuillez consulter Envoyer l'objet de message des paramètres de l'API pour connaître le format du 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.