Workplace by Meta

Grâce à l'intégration Meta Workplace, vous pouvez créer un bot Meta Workplace pour interagir avec vos utilisateurs finaux.

Fonctionnement

Voici comment fonctionne l'intégration :

  • Vous créez une intégration client qui utilise Meta Workplace.
  • Vous configurez l'intégration des agents conversationnels (Dialogflow CX) et l'instance Workplace de sorte qu'ils communiquent entre eux.
  • L'intégration des agents conversationnels (Dialogflow CX) envoie des messages à l'utilisateur final à l'aide de l'API Send de Meta.
  • L'intégration des agents de conversation (Dialogflow CX) reçoit les messages de l'utilisateur final en tant que webhook Workplace de Meta.

Configuration

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

  1. Suivez la procédure pour créer une intégration personnalisée Meta Workplace : Créer une intégration personnalisée Meta Workplace.

    • Créez une intégration personnalisée Meta Workplace.
    • Un secret d'application vous est fourni à cette étape. Copiez cette valeur. Ce jeton sera utilisé pour configurer l'intégration à partir de la console des agents conversationnels (Dialogflow CX).
    • Créez ou réinitialisez le jeton d'accès de votre intégration. Copiez cette valeur. Ce jeton sera utilisé pour configurer l'intégration à partir de la console des agents conversationnels (Dialogflow CX).
    • Configurez les autorisations d'intégration personnalisée. Assurez-vous que Message any member est activé dans "Autorisations".
  2. Configurez l'intégration à partir de la console des agents conversationnels (Dialogflow CX) :

    1. Accédez à 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 Meta Workplace.
    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.

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

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

      • Webhook URL : copiez cette valeur. Elle servira à configurer le webhook Meta Workplace.

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

  3. Terminez la configuration de l'intégration personnalisée Meta Workplace et testez-la. Suivez les étapes de la documentation Webhook pour Meta Workplace pour effectuer les opérations suivantes:

    • Configurez le webhook Meta pour votre application. Utilisez les valeurs URL du webhook et Jeton de validation que vous avez copiées ci-dessus.
    • Abonnez votre intégration aux sujets de webhook. Veillez à activer messages et messaging_postbacks dans l'abonnement à la page.
    • Testez l'application.

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 de message, consultez la section Objet de message des paramètres de l'API 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"
    }
  }
}

Réponses spécifiques à la chaîne

Une fois 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.