Concepts de base d’une conversation
Importante
Les exemples de code de cette section sont basés sur la version 4.6 et les versions ultérieures du Kit de développement logiciel (SDK) Bot Framework. Si vous recherchez de la documentation pour les versions antérieures, consultez la section bots - Kit de développement logiciel (SDK) v3 dans le dossier Kits de développement logiciel (SDK) hérités de la documentation.
Une conversation est une série de messages envoyés entre votre bot Microsoft Teams et un ou plusieurs utilisateurs. Le tableau suivant fournit les trois types de conversations, également appelés étendues dans Teams :
| Type de conversation | Description |
|---|---|
channel |
Ce type de conversation est visible par tous les membres du canal. |
personal |
Ce type de conversation inclut les conversations entre les bots et un seul utilisateur. |
groupChat |
Ce type de conversation inclut la conversation entre un bot et deux utilisateurs ou plus. Il active également votre bot dans les conversations de réunion. |
Un bot se comporte différemment en fonction de la conversation dans laquelle il est impliqué :
Les bots dans les conversations de canal et de groupe nécessitent que l’utilisateur @mention le bot pour l’appeler dans un canal.
Les bots dans une conversation en face à face ne nécessitent pas de @mention. Tous les messages envoyés par l’utilisateur acheminent vers votre bot.
Les bots peuvent recevoir tous les messages de canal et de conversation d’une équipe sans utiliser @mentioned les autorisations de consentement spécifiques aux ressources (RSC). RSC pour tous les messages de conversation est disponible uniquement dans la préversion publique pour les développeurs pour Teams. Pour plus d’informations, consultez Recevoir tous les messages de conversation avec RSC.
Pour que le bot fonctionne dans une conversation ou une étendue particulière, ajoutez la prise en charge de cette étendue dans le manifeste de l’application.
Chaque message dans une conversation de bot est un Activity objet de type messageType: message. Lorsqu’un utilisateur envoie un message, Teams publie le message sur votre bot et le bot gère le message. En outre, pour définir les commandes principales auxquelles votre bot répond, vous pouvez ajouter un menu de commandes avec une liste déroulante de commandes pour votre bot. Les bots d’un groupe ou d’un canal reçoivent uniquement des messages lorsqu’ils sont mentionnés @botname. Teams envoie des notifications à votre bot pour les événements de conversation qui se produisent dans les étendues où votre bot est actif. Vous pouvez capturer ces événements dans votre code et prendre des mesures sur ceux-ci.
Un bot peut également envoyer des messages proactifs aux utilisateurs. Un message proactif est un message envoyé par un bot qui ne répond pas à la demande d’un utilisateur. Vous pouvez mettre en forme les messages de votre bot pour inclure des cartes enrichies qui incluent des éléments interactifs, tels que des boutons, du texte, des images, de l’audio, de la vidéo, etc. Le bot peut mettre à jour dynamiquement les messages après leur envoi, au lieu d’avoir vos messages sous forme d’instantanés statiques de données. Les messages peuvent également être supprimés à l’aide de la méthode de DeleteActivity Bot Framework. La requête sortante au bot affiche l’ID de conversation et l’ID de locataire dans les en-têtes.
Le bot de notification est un type de bot de conversation, qui envoie des notifications sous forme de texte brut ou de cartes adaptatives. Le modèle de bot de notification crée une application qui envoie un message à Teams avec des cartes adaptatives déclenchées par une requête http post.
Le bot de commande est un type de bot de conversation qui peut répondre à des commandes simples envoyées dans des conversations avec des cartes adaptatives. Vous pouvez créer des modèles de bot de commande dans Teams pour répondre aux commandes de conversation en affichant l’interface utilisateur à l’aide d’une carte adaptative.
Le bot de flux de travail est un type de bot de conversation, qui interagit avec les utilisateurs de la carte adaptative. Vous pouvez personnaliser la façon dont le bot envoie la carte adaptative aux utilisateurs.
Ajouter l’authentification unique à vos bots de conversation
Vous pouvez ajouter l’authentification unique à votre bot de conversation en procédant comme suit :