Informations de référence sur les canaux

  • Article

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 Chat 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
Email 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 (préversion) Oui
Rechercher (préversion) 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.
Texte 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 Chat Oui* Oui Oui Oui Oui Oui Oui Oui
Email Image Texte Texte Oui Oui Oui Oui Texte
Facebook Image, partielle Oui Oui Oui Oui Oui Oui Oui
GroupMe Image Texte Texte Texte Texte Texte Texte Texte
LINE Image, partielle Oui Texte Oui Oui Oui Oui Texte
Microsoft Teams Oui No Non Oui Oui Oui Oui Non
Omnicanal
Outlook (préversion)
Rechercher (préversion)
Slack Image Oui Texte Texte Oui Oui Texte Texte
Telegram Image, partielle Oui Texte Oui Oui Oui Oui Oui
Twilio (SMS) Image Texte Non Texte Texte Texte Texte 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 Chat
Direct Line 100 100
Direct Line Speech 100 100
Email None None
Facebook 11 3
GroupMe None None
LINE 13 99
Microsoft Teams Aucun 3
Omnicanal
Outlook (préversion)
Rechercher (préversion)
Slack Aucun 100
Telegram 100 100
Twilio (SMS) None None
Chat Web 100 100

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.

Conseil

Lorsque vous ajoutez la prise en charge d’un canal à votre bot, familiarisez-vous avec la documentation du développeur du canal. Chaque canal a des limitations différentes sur différents aspects d’une conversation. Les différences comprennent :

  • Le temps pendant lequel le bot doit gérer chaque demande HTTP.
  • Si un bot peut envoyer une activité qui n’est pas en réponse à une activité utilisateur spécifique.
  • Le nombre de messages que le bot peut envoyer dans un délai d’exécution donné.
  • Comment une carte est rendue et quelles cartes sont prises en charge.