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.
Vous devez avoir le rôle d’admin système pour créer un bot pour votre communauté.
Si vous n’êtes pas l’admin de votre communauté Workplace, vous devez vous associer à un·e admin pour créer un bot.
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 application 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.
L’autorisation Contacter tous les membres permet également à un bot d’apparaître dans les recherches incrémentielles des supports dans Workplace Chat.
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.
Discussion entre un bot et un groupe
Quand un bot dispose des autorisations Contacter tous les membres et Bot de discussion de groupe, il peut créer, gérer et intégrer des fils de discussion de groupes 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.
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.
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 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>]
}Comme vous pouvez le voir, les opérations impliquant l’arête /{thread}/participants sont disponibles pour les fils de discussion créés par l’intégration.
Mentions dans un fil de discussion
Quand votre bot est mentionné dans un message, nos webhooks envoient la liste des membres identifiés dans ce message, comme dans la charge utile suivante :
{
"object":"page",
"entry":[{
"id":"746230239054322",
"time":1539281406974,
"messaging":[{
...
"message":{
"mid":"<message id>",
"seq":2192,
"text":"@Edu Gomes @Example Bot What's 2+2?"
},
"mentions":[{
"offset":0,
"length":10,
"id":"100017376437045"
},
{
"offset":11,
"length":12,
"id":"746230239054322"
}]
}]
}]
} 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.
Liens profonds vers des bots
Utilisez le format https://w.m.me/{page-id} pour que vos liens redirigent directement vers un bot de discussion dans Workplace. Ce format est accepté dans les versions web, Android et iOS de Workplace Chat. Dans les plateformes mobiles, quand l’application Workplace Chat est installée, le lien s’ouvre directement dans l’application.
Paramètres de référence
Pour intégrer davantage d’informations dans le lien, vous pouvez utiliser un paramètre de référence. Votre bot pourrait ainsi réaliser des actions personnalisées en fonction de l’utilisateur sur lequel l’utilisateur a cliqué pour accéder au bot.
Pour utiliser cette fonctionnalité, utilisez le format de lien https://w.m.me/{page-id}?ref={referral_parameter}. Cette fonctionnalité repose sur le même principe que la plateforme Messenger. Pour en savoir plus, consultez la documentation sur Messenger.
Le champ de webhook concerné est messaging_referrals, et il nécessite un nouvel abonnement. Ce champ n’était pas disponible pour les applications Workplace jusqu’à présent.
La charge utile du webhook utilise le même format que Messenger, à quelques différences près : Workplace utilise les ID spécifiques à l’application, non à la page. De plus, Workplace intègre également un champ « community » dans le webhook, qui contient l’ID de la communauté.
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.