Facebook Messenger

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

Fonctionnement

Voici comment fonctionne l'intégration :

  • Vous créez une application Facebook qui utilise la plate-forme Facebook Messenger.
  • Vous configurez l'intégration Dialogflow et l'application Facebook de sorte qu'elles communiquent entre elles.
  • L'intégration Dialogflow envoie des messages à l'utilisateur final à l'aide de l'API Facebook Messenger.
  • L'intégration Dialogflow reçoit les messages de l'utilisateur final en tant que webhook Facebook Messenger.

Prérequis

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

  1. Suivez la procédure permettant de créer une application Facebook : Facebook App Development.

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

    • Ajoutez la plate-forme Messenger à votre application Facebook.
    • Abonnez votre application à une page Facebook. 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 du bloc Facebook 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 Facebook.

      • Jeton de validation : vous pouvez saisir n'importe quel jeton privé de votre choix. Copiez cette valeur. Elle servira à configurer le webhook Facebook Messenger.

      • Jeton d'accès à la page : saisissez le jeton d'accès que vous avez copié lors de la configuration de l'application Facebook ci-dessus.

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

      • Webhook URL : copiez cette valeur. Elle servira à configurer le webhook Facebook Messenger.

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

  4. Terminez la configuration de l'application Facebook et testez-la. Suivez les étapes de la documentation Setting Up Your Facebook App pour effectuer les opérations suivantes :

    • Configurez le webhook Facebook pour votre application. Utilisez les valeurs URL de rappel 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 la procédure à suivre lorsque des événements sont déclenchés.

Événement Description
FACEBOOK_WELCOME Déclenché lorsqu'un utilisateur final clique sur le bouton "Commencer" de Facebook 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 "Commencer" de Facebook Messenger, procédez comme suit :

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

    • Ce service d'intégration active le bouton en appelant l'API Facebook 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 de votre page Facebook (le cas échéant).

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

  2. Commencez une conversation avec votre page Facebook.

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

Vous pouvez toujours appeler l'API Facebook Messenger Profile pour gérer le bouton Get Started (Premiers pas). Cela peut s'avérer 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 page Objet de message de l'API Facebook Messenger 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"
    }
  }
}