Informations de référence sur les canaux
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 | ||||||||||
| Non | Non | Non | Indéterminé | Non | Non | Oui | No | Non | Non | Non | |
| 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 |
| Image | Détails | Détails | Oui | Oui | Oui | Oui | Détails | |
| 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 | Aucun(e) | None |
| Azure Communication Services | ||
| Direct Line | 100 | 100 |
| Direct Line Speech | 100 | 100 |
| Aucun(e) | None | |
| 11 | 3 | |
| GroupMe | Aucun(e) | None |
| LINE | 13 | 99 |
| Microsoft Teams | Aucun(e) | 3 |
| Omnicanal | ||
| Outlook (Aperçu) | ||
| Rechercher (Aperçu) | ||
| Slack | Aucun(e) | 100 |
| Telegram | 100 | 100 |
| Twilio (SMS) | Aucun(e) | 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 :
deleteUserDatahandoffping- 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.