Facebook Workplace

Grâce à l'intégration de Dialogflow à Facebook Workplace, vous pouvez créer un espace de travail à partir du bot Facebook 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 :

  • Configurez l'intégration Dialogflow et une instance Workplace de sorte qu'elles communiquent entre elles.
  • L'intégration Dialogflow envoie des messages à l'utilisateur final à l'aide de l'API Messenger de Facebook.
  • L'intégration Dialogflow reçoit les messages de l'utilisateur final en tant que webhook de Facebook Workplace.

Début

Pour démarrer l'intégration :

  1. Enregistrez une instance Workplace si vous n'en avez pas, et assurez-vous d'être l'administrateur système du groupe.

  2. Activez 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 Workplace from Facebook (Espace de travail Facebook).
    4. Cliquez sur START (DÉMARRER) et vous serez redirigé vers Workspace pour terminer l'installation :
      • Connectez-vous à votre compte Workspace. Le compte doit disposer du rôle Administrateur système sur Workplace pour installer les intégrations.
      • Cliquez sur Add to Workplace (Ajouter au lieu de travail) dans la fenêtre pop-up qui vous invite à installer l'intégration Dialogflow. Vous avez également la possibilité de personnaliser le nom du bot.

  3. Testez votre application :

    1. Accédez à Workplace et connectez-vous au compte.
    2. Recherchez Dialogflow (ou le nom personnalisé de votre bot) dans Bots dans la section Home (Accueil) de la barre latérale et commencez à discuter avec le bot.

Annuler

Si vous avez cliqué sur le bouton START (DÉMARRER), mais que vous ne souhaitez pas terminer l'installation sur Workplace, procédez comme suit :

  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 Workplace :

    1. Si un bouton CANCEL (ANNULER) s'affiche, cliquez sur CANCEL (ANNULER) pour annuler l'installation.
    2. Si vous voyez un bouton STOP, suivez les instructions suivantes pour désinstaller l'intégration.

Stop

Pour arrêter l'intégration avec succès, procédez comme suit :

  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 Workplace.

  4. Cliquez sur STOP et vous serez redirigé vers Workplace pour terminer l'installation :

    1. Connectez-vous à votre compte Workspace. Le compte doit disposer du rôle Administrateur système sur Workplace pour désinstaller les intégrations.
    2. Recherchez et sélectionnez l'intégration de Dialogflow dans les intégrations installées sur Workplace, cliquez sur Uninstall (Désinstaller) pour terminer la désinstallation.

  5. L'intégration Dialogflow va être désinstallée.

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"
      }
    }
  }
}

Limites

  1. Un agent Dialogflow ne peut être installé que sur une instance Workplace, mais vous pouvez en installer plusieurs sur une instance Workplace.

  2. Pour supprimer une installation ayant échoué, vous devez l'annuler sur Dialogflow et la supprimer de Workplace.

Migration

Si vous utilisez l'intégration Messenger et que vous souhaitez la migrer vers l'intégration Workplace, procédez comme suit :

  1. Arrêtez l'intégration Messenger.

  2. Supprimez l'URL de rappel (callback_url) de l'application Facebook en inversant les étapes de la page Configurer l'application Facebook.

  3. Démarrez l'intégration Workplace en suivant la procédure ci-dessus.