Bots pour Workplace

Vue d’ensemble

Grâce aux intégrations personnalisées pour Workplace, il est désormais possible de créer des bots performants qui peuvent interagir avec les internautes dans les groupes et les discussions.

Vous pouvez créer un bot qui publie automatiquement des contenus dans des groupes, répond aux questions en fournissant des informations supplémentaires ou réalise des actions quand il est mentionné dans les commentaires d’une publication. Votre bot peut également discuter avec des utilisateurs dans Workplace Chat, fournir des informations en temps réel ou gérer des demandes avec des éléments de conversation structurés, comme les réponses rapides et les menus fixes.

Bots sous forme de Pages

Dans Workplace, comme dans la plateforme Messenger, les bots sont représentés par des Pages. La Page est créée automatiquement lorsque vous créez une app d’intégration personnalisée. Les membres de votre communauté Workplace peuvent découvrir votre bot et interagir avec lui à travers cette Page.

Ce type de bot est public au niveau de l’entreprise, ce qui signifie que tous les membres d’une communauté Workplace peuvent voir, mentionner et contacter le bot. Toutefois, en fonction du niveau d’autorisation que vous choisissez au moment de sa création, votre bot n’aura pas accès à tous les contenus dans Workplace.

Par exemple, si votre bot est autorisé à lire le contenu des groupes, il pourra accéder aux contenus publiés dans les groupes. En revanche, s’il n’est pas autorisé à publier dans les groupes, il ne pourra pas réagir aux contenus publiés dans les groupes.

De plus, votre bot pourra apparaître dans Workplace Chat et être contacté par les utilisateurs uniquement s’il dispose de l’autorisation Contacter tous les membres.

Bots dans les groupes

Dans les groupes, les bots ont quasiment les mêmes possibilités que les utilisateurs. Ils peuvent ainsi publier de nouveaux contenus, commenter des contenus pour apporter des informations complémentaires et aimer des publications en signe de confirmation ou d’approbation.

Les bots peuvent mentionner des utilisateurs pour attirer leur attention, et ces derniers peuvent les mentionner pour initier un workflow particulier ou leur poser une question.

Enfin, les bots peuvent s’abonner à un groupe et mentionner des webhooks, qui permettent de surveiller le contenu et d’interagir avec les utilisateurs de manière flexible.

Bots dans une discussion

Alors que, dans les groupes, les bots peuvent lire des informations et les partager à plusieurs personnes en différé, les bots de discussion peuvent interagir en temps réel avec une ou plusieurs personnes définies.

Par exemple, vous pouvez utiliser un bot de discussion pour envoyer des rappels importants ou des notifications à une personne au sujet d’un évènement à venir comme un entretien ou une réunion. Les bots de discussion Workplace peuvent entamer une conversation avec un utilisateur et prendre les mesures qui s’imposent en fonction de sa réponse.

Ce modèle d’interaction repose sur les mêmes concepts que celui de la plateforme Messenger. Les bots de discussion Workplace peuvent donc eux aussi utiliser des fonctionnalités telles que les menus fixes, les réponses rapides et les modèles pour enrichir l’expérience d’utilisation.

Discussion entre un bot et un utilisateur

Quand un bot est autorisé à contacter tous les membres, il peut envoyer un message direct à n’importe quel utilisateur de Workplace via son adresse e-mail ou son ID Workplace grâce à l’API Send de Messenger.

Bot dans la recherche incrémentielle d’un nouveau message

L’autorisation Contacter tous les membres permet également à un bot d’apparaître dans les recherches incrémentielles des supports dans Workplace Chat.

Bot dans la recherche incrémentielle d’un nouveau message

En abonnant votre bot aux webhooks Message de Page, celui-ci recevra des notifications quand un utilisateur lui enverra un message. Vous pouvez ainsi créer un flux de conversation en combinant les envois et les réceptions.

Conversation entre un bot et un utilisateur

Discussion entre un bot et un groupe

Les bots peuvent également créer, gérer et intégrer des fils de discussion de groupe d’utilisateurs. Les bots peuvent créer de nouveaux fils de discussion de groupe en spécifiant une liste de destinataires, puis renommer ces fils en fonction des sujets abordés et des participants.

Fil de discussion créé par un bot regroupant des personnes spécifiques et renommé en conséquence

Activer les bots dans les discussions de groupe

Pour autoriser un bot à créer des discussions de groupe avec des utilisateurs de Workplace, ouvrez le panneau Autorisations de la boîte de dialogue Modifier l’intégration personnalisée et cochez la case Autoriser le fonctionnement de cette intégration dans les discussions de groupe.

Autoriser les bots d’intégration personnalisée dans les discussions de groupe

Une fois autorisé dans les discussions de groupe, votre bot apparaîtra dans les recherches incrémentielles Ajouter des personnes d’un fil de discussion de groupe existant. Il recevra ensuite des webhooks pour chaque message envoyé par les participants de cette discussion et pourra y répondre en utilisant son thread ID.

Ajouter, puis mentionner un bot dans une discussion de groupe

Créer et nommer de nouveaux fils

Pour créer un fil de discussion avec des destinataires spécifiques, envoyez une requête POST au point de terminaison /me/messages en intégrant une grille des recipient IDs et une charge utile message initiale, comme dans l’exemple ci-dessous :

POST /me/messages
{
  "recipient": {
    "ids": [<user_ids>]
  },
  "message": <message_payload>
}

Vous recevrez en retour une charge utile comprenant un thread ID, que vous pourrez utiliser pour répondre aux messages.

Si vous utilisez à nouveau le même point de terminaison avec la même liste de destinataires, le système créera un nouveau fil de discussion. Pour envoyer des messages dans un fil de discussion existant, envoyez une requête POST au point de terminaison /me/messages en utilisant le thread_id dans la charge utile recipient, comme dans l’exemple ci-dessous :

POST /me/messages
{
  "recipient": {
    "thread_key": <thread_id>
  },
  "message": <message_payload>
}

Pour renommer un fil de discussion créé par votre bot, envoyez une requête POST à l’arête /{thread}/threadname, comme dans l’exemple ci-dessous :

POST /t_<thread_id>/threadname
{
  "name": "new name"
}

Notez qu’il est obligatoire d’ajouter le préfixe t_ au thread_id dans le chemin de l’arête.

Vous pouvez également obtenir la liste des participants d’un fil de discussion en envoyant des requêtes GET à l’arête /{thread}/?fields=participants, comme dans l’exemple ci-dessous :

GET /t_<thread_id>/?fields=participants

Vous pouvez également ajouter ou supprimer des participants d’un fil de discussion en envoyant des requêtes POST ou DELETE à l’arête /{thread}/participants, comme dans l’exemple ci-dessous :

POST t_<thread_id>/participants
{
  "to": [<user_ids>]
}

DELETE t_<thread_id>/participants
{
  "to": [<user_ids>]
}

Partenaires spécialisés dans les bots

Nous avons établi de nombreux partenariats avec des plateformes de bot pour faciliter l’intégration des bots dans Workplace. Pour consultez la liste complète de nos partenaires, cliquez ici. Vous pouvez utiliser l’une de ces plateformes pour créer un bot puissant sans écrire une seule ligne de code.

Recommandations

Choisir le bon canal

Au moment de choisir le type d’interaction pour votre bot (groupe ou discussion), le point essentiel à prendre en considération est son utilité.

• Si plusieurs personnes pourront interagir en même temps avec votre bot, ou s’il publiera des contenus destinés à plusieurs personnes, privilégiez les groupes : il pourra ainsi répondre aux commentaires et mentions dans les groupes où seront publiés les contenus.
• Si le rôle de votre bot est d’alerter rapidement un utilisateur sur un point urgent, qui peut nécessiter un suivi ou une interaction en privé, privilégiez les discussions dans Workplace Chat.

Une même app peut prendre en charge les deux canaux. Selon les situations, un bot d’assistance pourra aussi bien répondre à des messages dans Workplace Chat que publier dans des groupes et recueillir les réponses.

Interactions dans un groupe

Une fois votre app abonnée à des webhooks, votre bot recevra des notifications quand il sera mentionné dans une publication ou un commentaire d’un groupe. Il est essentiel que votre bot réponde rapidement aux mentions. S’il a besoin de traiter une requête avant de répondre, votre bot peut ajouter une mention J’aime au commentaire afin d’informer l’utilisateur qu’il a pris connaissance de la mention.

Si vous souhaitez apporter des informations complémentaires à un commentaire dans lequel le bot a été mentionné, ajoutez un commentaire en fil pour que la conversation de groupe reste fluide.

Si votre bot a besoin d’apporter des informations à la personne à l’origine d’une publication, ajoutez un commentaire directement à la publication afin qu’elle soit également notifiée.

Interactions dans une discussion

Les bots de Workplace Chat proposent quasiment les mêmes fonctionnalités que ceux de la plateforme Messenger. Les boutons de réponse rapide et les modèles sont ainsi disponibles pour intégrer des arbres de décision dans les conversations avec le bot.

Vous pouvez alors créer facilement des workflows utiles et réduire la quantité de messages que l’utilisateur doit écrire, sans passer par un traitement automatique du langage naturel. Cette caractéristique permet notamment de simplifier l’internationalisation pour les bots utilisés par des collaborateurs répartis aux quatre coins du monde.