Workplace by Meta

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

Fonctionnement

Voici comment fonctionne l'intégration :

  • Vous créez une intégration client qui utilise Meta Workplace.
  • Vous configurez l'intégration de Dialogflow CX et l'instance Workplace pour qu'elles communiquent entre elles.
  • L'intégration Dialogflow CX envoie des messages à vos utilisateurs à l'aide de l'API Send de Meta.
  • L'intégration Dialogflow CX reçoit les messages de vos utilisateurs en agissant en tant que webhook Workplace de Meta.

Configuration

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

  1. Suivez les étapes de la section Créer une intégration personnalisée Meta Workplace :
    • Créez une intégration personnalisée Meta Workplace.
    • Copiez le code secret de l'application fourni à cette étape. Vous utiliserez ce jeton pour configurer l'intégration à partir de la console Dialogflow CX.
    • Créez ou réinitialisez le jeton d'accès pour votre intégration, puis copiez-le. Vous utiliserez ce jeton pour configurer l'intégration à partir de la console Dialogflow CX.
    • Configurez les autorisations d'intégration personnalisée. Assurez-vous que Message any member est activé dans les autorisations.
  2. Configurez l'intégration à partir de la console Dialogflow CX :
    1. Accédez à la console Dialogflow CX.
    2. Accédez à l'onglet Gérer dans le menu de navigation.
    3. Sélectionnez Intégrations.
    4. Cliquez sur le bouton Connecter sur la tuile Meta Workplace.
    5. Une boîte de dialogue de configuration s'ouvre :
      • Secret de l'application : saisissez le secret de l'application à partir des paramètres de base du tableau de bord de l'application.
      • Jeton d'accès : saisissez le jeton d'accès que vous avez copié lors de la configuration de l'application Meta.
      • Jeton de validation : saisissez le jeton privé dont vous avez besoin. Copiez cette valeur. Ce jeton configure le webhook Meta Workplace.
      • URL du webhook : copiez cette valeur. Ce jeton configure le webhook Meta Workplace.
      • Démarrer : cliquez sur Démarrer pour lancer le service d'intégration de votre agent.
  3. Terminez la configuration de l'intégration de Meta Workplace et testez-la. Suivez les étapes de la documentation Webhook pour Meta Workplace pour effectuer les tâches suivantes :
    • Configurez le webhook Meta pour votre application à l'aide des valeurs URL de webhook et Jeton de validation que vous avez copiées précédemment.
    • Abonnez votre intégration aux thèmes de webhook, et assurez-vous d'activer messages et messaging_postbacks dans l'abonnement à la page.
    • Testez l'application.

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 sur le format du message, consultez Objet de message des paramètres de l'API Send.

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

Lorsqu'elles sont configurées, les réponses spécifiques au canal avec le canal DF_CX_FB_MESSENGER sont automatiquement utilisées lorsque l'agent répond aux messages Meta Messenger.