Messenger à partir de Meta

L'intégration de Dialogflow Meta Messenger vous permet de créer un bot Meta Messenger pour interagir avec vos utilisateurs finaux.

Fonctionnement

Voici comment fonctionne l'intégration :

Préparation

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

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

  2. Configurez l'application Meta pour utiliser la plate-forme Meta Messenger. Suivez la procédure décrite dans la documentation Meta Webhooks pour la plate-forme Messenger 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 Connecter sur 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 indiqué 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. 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 l'application Meta 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 pour la plate-forme Messenger pour effectuer les opérations suivantes:

    • Configurez le webhook Meta pour votre application. Utilisez les valeurs URL de webhook et 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 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 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 le bouton "Premiers pas" 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 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 de métarecherche.

  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 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. Veuillez consulter l'objet de message des paramètres de l'API Send 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

Lorsque cette option est configurée, les réponses propres au canal avec le canal DF_CX_FB_MESSENGER sont automatiquement utilisées lorsque l'agent répond aux messages Meta Messenger.