Messenger de Meta

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

Fonctionnement

Voici comment fonctionne l'intégration :

Configuration

Assurez-vous que la facturation est activée sur votre projet avant de tester l'intégration.

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 les étapes de la documentation Meta Webhooks for Messenger Platform (Webhooks Meta pour la plate-forme Messenger) pour effectuer les opérations suivantes :
    • Ajoutez la plate-forme Messenger à votre application Meta.
    • Abonnez votre application à une page Meta. Assurez-vous que messages et messaging_postbacks sont activés dans l'abonnement à la page.
    • Copiez le jeton d'accès fourni à cette étape. Ce jeton permet de configurer l'intégration à partir de la console Dialogflow CX.
    • Ne configurez pas encore le webhook et ne testez pas votre intégration.
  3. Configurez l'intégration à partir de la console Dialogflow CX :
    1. Accédez à la console Dialogflow CX.
    2. Sélectionnez l'onglet Gérer dans le menu de navigation.
    3. Sélectionnez Intégrations.
    4. Cliquez sur le bouton Connecter sur la tuile Meta Messenger.
    5. Renseignez les champs de la boîte de dialogue de configuration :
      • Secret de l'application : saisissez le secret de l'application à partir des paramètres de base du tableau de bord de l'application.
      • Jeton de validation : saisissez le jeton privé dont vous avez besoin. Copiez cette valeur. Il permet de configurer le webhook Meta Messenger.
      • Jeton d'accès à la page : saisissez le jeton d'accès que vous avez copié lors de la configuration de l'application Meta.
      • Activer le bouton "Commencer" : cochez cette case pour activer le bouton "Commencer".
      • URL du webhook : copiez cette valeur. Il est utilisé pour configurer le webhook Meta Messenger.
      • Démarrer : cochez cette case pour démarrer le service d'intégration de votre agent.
  4. Terminez la configuration de l'application Meta et testez-la. Suivez les étapes de la documentation Meta Webhooks for Messenger Platform (Webhooks Meta 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 précédemment. 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 les actions à effectuer lorsque les événements sont déclenchés.

Événement Description
FACEBOOK_WELCOME Déclenché lorsqu'un utilisateur final clique sur le bouton "Démarrer" de Meta Messenger.
FACEBOOK_MEDIA Déclenché lorsque le message d'un utilisateur final contient des pièces jointes (par exemple, un fichier audio, une image ou une vidéo).

Bouton pour commencer

Configurez le bouton "Démarrer" de Meta Messenger :

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

    • Ce service d'intégration vous permet d'activer 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é 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 appeler l'API Messenger Profile pour gérer le bouton Get Started (Commencer). Cela peut être utile pour les tests.

Pour vérifier l'état du bouton Get Started (Commencer), utilisez la requête suivante :

curl -X GET \
"https://graph.facebook.com/v10.0/me/messenger_profile?fields=get_started&access_token=${PAGE_ACCESS_TOKEN}"

Vous pouvez utiliser la requête suivante pour désactiver le bouton Get Started (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éponse enrichie sont compatibles avec la charge utile personnalisée dans le fulfillment. Pour en savoir plus, consultez la documentation sur l'objet de message des paramètres de l'API Send pour le format de message.

Par exemple, la charge utile personnalisée suivante fournit un message textuel :

{
  "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 au canal

Une fois que vous avez configuré les réponses spécifiques au canal, l'agent utilise automatiquement le canal DF_CX_FB_MESSENGER pour répondre aux messages Meta Messenger.