Informations de référence sur les canaux

Article
10/31/2024

S'APPLIQUE À : SDK v4

Cet article décrit la prise en charge des canaux pour différentes caractéristiques Bot Framework :

Les types d’activités que chaque canal peut envoyer ou recevoir.
Les types carte que chaque canal peut afficher, y compris les cartes adaptatives.
Action de carte et prise en charge des actions suggérées sur chaque canal.
Classification générale des différents types d’activités.

Pour plus d’informations sur la structure des activités et des cartes au niveau du protocole, consultez l’activité Bot Framework et les schémas de carte.

Les cartes adaptatives sont une technologie distincte. Pour plus d’informations, consultez adaptivecards.io.

Prise en charge des activités par canal

Le tableau suivant indique si un canal donné peut envoyer un type d’activité donné à votre bot. Dans le tableau, les termes suivants ont les significations suivantes.

Terme	Signification
Oui	Le bot peut recevoir cette activité à partir du canal.
Non	Le bot ne peut pas recevoir cette activité du canal.
Indéterminé	Actuellement indéterminé.

Canal	Mise à jour des relations de contact	Mise à jour de conversation	Fin de la conversation	Événement	Mise à jour de l’installation	Appeler	Message	Réaction à un message	Mise à jour de message	Suppression de message	Saisie
Alexa	Non	Non	Oui	Oui	No	Non	Oui	No	Non	Non	Non
Azure Communication Services	Non	Oui	No	Oui	No	Non	Oui	No	Oui	Oui	Oui
Direct Line	Non	Oui	Oui	Oui	Oui	No	Oui	No	Non	Non	Oui
Direct Line Speech							Oui
E-mail	Non	Non	Non	Indéterminé	Non	Non	Oui	No	Non	Non	Non
Facebook	Non	Oui	No	Oui	No	Non	Oui	Oui	No	Non	Non
GroupMe	Non	Oui	Non	Indéterminé	Non	Non	Oui	No	Non	Non	Non
LINE	Non	Oui	No	Oui	No	Non	Oui	No	Non	Non	Non
Microsoft Teams	Non	Oui	Non	Indéterminé	Non	Oui	Oui	Oui	Oui	Oui	Non
Omnicanal							Oui
Outlook (Aperçu)							Oui
Rechercher (Aperçu)							Oui
Slack	Non	Oui	Non	Indéterminé	Non	Non	Oui	No	Oui	Oui	Non
Telegram	Non	Oui	Non	Indéterminé	Non	Non	Oui	No	Oui	Indéterminé	Non
Twilio (SMS)	Non	Non	Non	Indéterminé	Non	Non	Oui	No	Non	Non	Non
Chat Web	Non	Oui	Oui	Oui	Oui	No	Oui	No	Non	Non	Oui

La prise en charge des activités event et invoke varie selon le nom de l’activité et le canal.

Prise en charge de la carte par canal

Le tableau suivant indique si un canal donné peut afficher un type de carte donné. Même si un canal peut afficher un type de carte, il peut ne pas prendre en charge toutes les caractéristiques sur la carte. Avant de publier votre bot, testez le comportement de chaque carte que votre bot peut envoyer.

Dans le tableau, les termes suivants ont les significations suivantes.

Terme	Signification
Oui	La carte est prise en charge sur ce canal. Toutefois, tout canal donné peut uniquement prendre en charge un sous-ensemble d’actions de carte ou limiter le nombre d’actions autorisées sur chaque carte.
Non	La carte n’est pas prise en charge sur ce canal.
Partiel	Prise en charge partielle. Ce canal peut ne pas afficher la carte si cette dernière contient des entrées ou des boutons. Le niveau de prise en charge varie selon le canal.
Image	La carte est convertie en image.
Détails	La carte est convertie en texte non mis en forme. Il est possible que les liens ne soient pas cliquables, que les images ne s’affichent pas et que le média ne puisse pas être lu. Le niveau de prise en charge varie selon le canal.

Canal	Carte adaptative	Carte d’animation	Carte audio	Carte de référence	Carte de reçu	Carte de connexion	Carte miniature	Carte vidéo
Alexa	Non	Non	Non	Oui	No	Oui	No	Non
Azure Communication Services	Oui*	Oui	Oui	Oui	Oui	Oui	Oui	Oui
E-mail	Image	Détails	Détails	Oui	Oui	Oui	Oui	Détails
Facebook	Image, partielle	Oui	Oui	Oui	Oui	Oui	Oui	Oui
GroupMe	Image	Détails	Détails	Détails	Détails	Détails	Détails	Détails
LINE	Image, partielle	Oui	Détails	Oui	Oui	Oui	Oui	Détails
Microsoft Teams	Oui	No	Non	Oui	Oui	Oui	Oui	Non
Omnicanal
Outlook (Aperçu)
Rechercher (Aperçu)
Slack	Image	Oui	Détails	Détails	Oui	Oui	Détails	Détails
Telegram	Image, partielle	Oui	Détails	Oui	Oui	Oui	Oui	Oui
Twilio (SMS)	Image	Détails	Non	Détails	Détails	Détails	Détails	Non
Chat Web	Oui	Oui	Oui	Oui	Oui	Oui	Oui	Oui

Remarque

Le canal Direct Line prend techniquement en charge toutes les cartes, mais il revient au client de les implémenter.
*Pour Azure Communication Services Chat, les cartes adaptatives sont uniquement prises en charge dans les cas d’utilisation d’Azure Communication Services, et non pour les cas d’utilisation Teams.

Prise en charge des actions de cartes par canal

Le tableau suivant indique le nombre maximum d'actions suggérées et d'actions de carte prises en charge dans chaque canal. La valeur « Aucune » indique que le type d’action n’est pas pris en charge dans le canal.

Canal	Actions suggérées	Actions de carte
Alexa	None	None
Azure Communication Services
Direct Line	100	100
Direct Line Speech	100	100
E-mail	None	None
Facebook	11	3
GroupMe	None	None
LINE	13	99
Microsoft Teams	Aucune	3
Omnicanal
Outlook (Aperçu)
Rechercher (Aperçu)
Slack	Aucune	100
Telegram	100	100
Twilio (SMS)	None	None
Chat Web	100	100

Pour plus d’informations sur les actions de carte, consultez Traiter les événements dans des carte riches dans l’article Ajouter un média aux messages.
Pour plus d’informations sur les actions suggérées, consultez comment Utiliser des boutons pour l’entrée.

Catégories d’activités

Les activités peuvent être réparties en diverses catégories. Pour obtenir une description détaillée de chaque type d’activité et les informations contenues par chaque type d’activité, consultez le schéma d’activité Bot Framework.

Bienvenue

Cette catégorie inclut les activités conversationUpdate et contactRelationUpdate.

De nombreux canaux envoient des activités de mise à jour de conversation.
- Souvent, le comportement de bienvenue du bot est déclenché par l’activité de mise à jour de conversation. Toutefois, la production d’un comportement de bienvenue fiable peut nécessiter l’utilisation d’une conversation ou d’un état utilisateur.
Certains canaux envoient des activités de mise à jour de relation de contact.
- Si votre bot utilise ces canaux, vous devrez peut-être inclure une logique pour cette activité dans le comportement de bienvenue de votre bot.

Conversationnel

Cette catégorie inclut les activités message, messageReaction, et endOfConversation.

Tous les canaux peuvent envoyer et recevoir des activités de message.
- Pour les bots qui utilisent des dialogues, les activités de message doivent généralement être transférées dans le dialogue.
Certains canaux peuvent envoyer et recevoir des activités de réaction aux messages.
- Selon la conception de votre bot, vous pouvez transmettre des activités de réaction aux messages dans un dialogue.
- Les activités de réaction aux messages font référence aux messages précédents par ID.
Les activités de fin de conversation signalent la fin d’une conversation du point de vue de l’expéditeur.
- Les activités de fin de conversation sont utilisées dans la communication bot-à-bot pour les compétences.

Conseil

Une réaction au message comprend par exemple un pouce vers le haut pour un commentaire. Leur affichage pouvant être aléatoire, il arrive que l’utilisateur les confonde avec un bouton. Ce type d’activité peut être envoyé par le canal Teams.

Mise à jour et suppression des messages

Cette catégorie inclut les activités messageUpdate et messageDelete.

Teams prend en charge les activités de mise à jour et de suppression des messages.

Extensibilité des applications

Cette catégorie inclut les activités event et invoke. La signification de l’activité est définie par le champ name, qui est significatif dans l’étendue d’un canal.

Une application propriétaire du client et du serveur peut utiliser des activités d’événement pour communiquer des informations programmatiques entre le client et le serveur.
- Les activités d’événement, comme la plupart des types d’activités, sont asynchrones.
- Direct Line et Chat Web utilisent des activités d’événement comme mécanisme d’extensibilité.
Les activités d’appel sont propres à une application et ne sont pas définies par un client.
- Les activités appelées, contrairement à d’autres types d’activités, sont synchrones. (Les appels sont les seuls types d’activités qui déclenchent un comportement de type « demande-réponse » chez le bot.)
- Microsoft Teams utilise des activités d’appel et définit quelques activités d’appel spécifiques à Teams.

Authentification

Pour que l’invite OAuth fonctionne avec des dialogues, l’activité d’appel TeamsVerification doit être transférée à la boîte de dialogue.

Sans catégorie

Les activités installationUpdate, typing, et handoff ne s’intègrent pas de manière significative dans les autres catégories.

Les activités de mise à jour d’installation représentent une installation ou désinstallation d’un bot au sein d’une unité d’organisation d’un canal.
Les activités de saisie représentent l’entrée en cours provenant d’un utilisateur ou d’un bot.
Les activités de transfert demandent ou signalent un changement de focus entre les éléments à l’intérieur d’un bot. L’activité de transfert est différente d’une activité d’événement qui porte le nom « transfert ».

Absence d’utilisation (inclut les appels liés au paiement)

Ces types d’activités ne sont plus utilisés :

deleteUserData
handoff
ping
appel Address
appel PaymentRequest

Informations supplémentaires

Tous les canaux peuvent envoyer et recevoir des activités message.