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.

Limites

Seuls les default agent language (langue par défaut de l'agent) est compatible avec cette intégration.

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 la procédure décrite dans le Configurer votre application Facebook documentation pour effectuer les opérations suivantes:

    • Ajoutez la plate-forme Messenger à votre application Facebook.
    • Abonnez votre application à une page Facebook. 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édez à la console Dialogflow ES.
    2. Cliquez sur Integrations (Intégrations) dans le menu de la barre latérale gauche.
    3. Cliquez sur Facebook Messenger.
    4. Une boîte de dialogue de configuration s'ouvre :

      • Show old callback URL (Afficher l'ancienne URL de rappel) : si ce bouton est affiché, il est désactivé par défaut. Il s'agit d'une option temporaire permettant de prendre en charge une modification récente de l'API Facebook Messenger. N'activez pas ce bouton, sauf instruction contraire de l'assistance Dialogflow. Une fois tous les agents mis à jour, cette option sera supprimée.
      • Callback URL (URL de rappel) : copiez cette valeur. Elle servira à configurer le webhook Facebook Messenger.
      • Verify Token (Jeton de validation) : vous pouvez saisir n'importe quel jeton privé de votre choix. Copiez cette valeur. Elle servira à configurer le webhook Facebook Messenger.
      • Page Access Token (Jeton d'accès à la page) : saisissez le jeton d'accès que vous avez copié lors de la création de la page Facebook.
      • Start (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 la procédure décrite dans le Configurer votre application Facebook documentation pour effectuer les opérations suivantes:

    • Configurez le webhook Facebook pour votre application. Utilisez les valeurs Callback URL (URL de rappel) et Verify Token (Jeton de validation) que vous avez copiées ci-dessus. Veillez à activer messages et messages_postbacks.
    • Testez l'application.

Events

Les événements suivants sont appelés par cette intégration :

Événement Description
FACEBOOK_WELCOME Déclenché lorsqu'un utilisateur final entame une conversation avec votre bot.

Messages de réponses enrichies

Cette intégration traduit certains messages de réponses enrichies en types de messages de la plate-forme Facebook Messenger.

Réponses sous forme d'images

Les réponses sous forme d'images sont envoyées à Facebook Messenger sous forme de messages de pièces jointes Facebook Messenger. La valeur message.attachment.type est définie sur image. Les formats suivants sont acceptés :

  • jpg
  • png
  • gif statique
  • gif animé

Réponses sous forme de fiches

Les réponses sous forme de fiches sont envoyées à Facebook Messenger sous forme de modèles génériques Facebook Messenger.

Réponses rapides

Les réponses rapides sont envoyées à Facebook Messenger sous forme de réponses rapides Facebook Messenger.

Réponses de charge utile personnalisée

Pour envoyer d'autres types de messages Facebook Messenger, vous pouvez utiliser une charge utile personnalisée.

Le format général de la charge utile personnalisée se présente comme suit :

{
  "facebook": {
    message
  }
}

À la place de message, indiquez l'objet message Facebook Messenger. Pour en savoir plus sur l'objet message, consultez la documentation de référence de l'API Facebook Messenger.

Exemple :

  • Pour envoyer un lien audio :
    {
      "facebook": {
        "attachment": {
          "type": "audio",
          "payload": {
            "url": "https://example.com/audio/test.mp3"
          }
        }
      }
    }
        
  • Pour envoyer une vidéo lisible :
    {
      "facebook": {
        "attachment": {
          "type": "video",
          "payload": {
            "url": "https://example.com/video.mp4"
          }
        }
      }
    }
        
  • Pour envoyer un fichier :
    {
      "facebook": {
        "attachment": {
          "type": "file",
          "payload": {
            "url": "https://example.com/file.pdf"
          }
        }
      }
    }