Informations de référence sur les canaux

Article
06/09/2022
7 minutes de lecture

Activités classées par canal

S’APPLIQUE À : Kit de développement logiciel (SDK) v4

Les tableaux suivants montrent les événements (activités sur le réseau) qui peuvent provenir des canaux.

Ces symboles sont utilisés dans les tables :

Symbole	Signification
✔	Le bot doit s’attendre à recevoir cette activité.
❌	Le bot ne doit jamais s’attendre à recevoir cette activité.
❓	Actuellement indéterminé si le bot peut recevoir cela.

Les activités peuvent être réparties en diverses catégories. Pour chaque catégorie, nous avons une table des activités possibles. Consultez le schéma d’activité Bot Framework pour obtenir une description détaillée de chaque type d’activité et les informations que chaque type d’activité contient.

Conversationnel

\	Ligne directe	Direct Line (Web Chat)	E-mail	Facebook	GroupMe	Teams	Slack	Skype	Skype Entreprise	Telegram	Twilio
`message`	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔
`messageReaction`	❌	❌	❌	❌	❌	✔	❌	❌	❌	❌	❌

Tous les canaux envoient des activités de message.
Si votre bot utilise une boîte de dialogue, transférez les activités de message au dialogue.
Les réactions des messages n’ont pas besoin d’être transférées au dialogue, même si elles font partie intégrante de la conversation.
Il existe logiquement deux types de réactions de message : ajouté et supprimé.

Conseil

Les réactions des messages sont des choses comme un pouce vers le haut sur un commentaire précédent. Ils peuvent se produire hors de l’ordre et peuvent être considérés comme similaires aux boutons.

Bienvenue

\	Ligne directe	Direct Line (Web Chat)	E-mail	Facebook	GroupMe	Teams	Slack	Skype	Skype Entreprise	Telegram	Twilio
`conversationUpdate`	✔	✔	❌	❓	✔	✔	✔	❌	❌	✔	❌
`contactRelationUpdate`	❌	❌	❌	❌	❌	❌	❌	✔	✔	❌	❌

Il est courant que les canaux envoient des activités de mise à jour de conversation.
Les principaux types de mises à jour de conversation sont les membres de conversation ajoutés et les membres supprimés.
Certains canaux envoient la mise à jour de conversation lorsque le bot est ajouté à une conversation, et certains l’envoient après le premier message envoyé au bot.
Pour produire un comportement d’accueil fiable, incluez l’état utilisateur dans votre logique d’accueil des bots.

Extensibilité des applications

\	Ligne directe	Direct Line (Web Chat)	E-mail	Facebook	GroupMe	Teams	Slack	Skype	Skype Entreprise	Telegram	Twilio
`event`	✔	✔	❓	❓	❓	❓	❓	❓	❓	❓	❓
name = `CreateConversation`	❓	❓	❓	❓	❓	❓	❓	❓	❓	❓	❓
name = `ContinueConversation`	❓	❓	❓	❓	❓	❓	❓	❓	❓	❓	❓

Les activités d’événements communiquent des informations de programmation d’un client ou un canal à un bot. La signification d’une activité d’événement 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 choisir de tunneliser ses propres événements via le service à l’aide d’activités d’événements.

Microsoft Teams

En plus d’autres types d’activités, Microsoft Teams définit quelques activités spécifiques invoke à Teams. Pour plus d’informations, consultez comment fonctionnent les bots Microsoft Teams .
Les activités d’appel communiquent des informations de programmation d’un client ou un canal à un bot, et elles ont une charge utile de retour correspondante pour une utilisation dans le canal. La signification d’une activité d’appel est définie par le champ name, qui est significatif dans l’étendue d’un canal.

Mise à jour de message

\	Ligne directe	Direct Line (Web Chat)	E-mail	Facebook	GroupMe	Teams	Slack	Skype	Skype Entreprise	Telegram	Twilio
`messageUpdate`	❌	❌	❌	❌	❌	✔	❓	❌	❌	❌	❌
`messageDelete`	❌	❌	❌	❌	❌	✔	❓	❌	❌	❌	❌

La mise à jour des messages est actuellement prise en charge par Teams.

OAuth

\	Ligne directe	Direct Line (Web Chat)	E-mail	Facebook	GroupMe	Teams	Slack	Skype	Skype Entreprise	Telegram	Twilio
`invoke`	✔	✔	❌	❓	❓	❌	❓	❓	❓	❓	❓

Important

Pour que les dialogues et les invites OAuth fonctionnent, vous devez transférer les activités d’appel suivantes à la boîte de dialogue :

signin/verifyState
signin/tokenExchange
tokens/response

Sans catégorie

\	Ligne directe	Direct Line (Web Chat)	E-mail	Facebook	GroupMe	Teams	Slack	Skype	Skype Entreprise	Telegram	Twilio
`endOfConversation`	✔	✔	❌	❌	❌	❌	❌	❌	❌	❌	❌
`installationUpdate`	✔	✔	❌	❌	❌	❌	❌	❌	❌	❌	❌
`typing`	✔	✔	❌	✔	❌	❌	❌	❌	❌	❌	❌

Hors usage

deleteUserData
handoff
invoke: demande de paiement
invoke: adresse
ping

Notes

L’activité de remise est différente du scénario de remise à l’homme. Pour plus d’informations, consultez Transition des conversations du bot vers l’homme .

Résumé des activités prises en charge par canal

Ligne directe

conversationUpdate
event
- CreateConversation
- ContinueConversation
invoke
- signin/tokenExchange
- signin/verifyState
- tokens/response
message

E-mail

message

Facebook

invoke
- tokens/response
message

GroupMe

conversationUpdate
invoke
- tokens/response
message

Kik

conversationUpdate
invoke
- tokens/response
message

Teams

conversationUpdate
invoke
message
messageDelete
messageReaction
messageUpdate

Slack

conversationUpdate
invoke
- tokens/response
message

Skype

contactRelationUpdate
invoke
- tokens/response
message

Skype Entreprise

contactRelationUpdate
invoke
- tokens/response
message

conversationUpdate
invoke
- tokens/response
message

Twilio

message

Tableau récapitulative de toutes les activités sur tous les canaux

\	Ligne directe	Direct Line (Web Chat)	E-mail	Facebook	GroupMe	Teams	Slack	Skype	Skype Entreprise	Telegram	Twilio
`contactRelationUpdate`	❌	❌	❌	❌	❌	❌	❌	✔	✔	❌	❌
`conversationUpdate`	✔	✔	❌	❓	✔	✔	✔	❌	❌	✔	❌
`endOfConversation`	✔	✔	❌	❌	❌	❌	❌	❌	❌	❌	❌
`event`	✔	✔	❓	❓	❓	❓	❓	❓	❓	❓	❓
- `CreateConversation`	❓	❓	❓	❓	❓	❓	❓	❓	❓	❓	❓
- `ContinueConversation`	❓	❓	❓	❓	❓	❓	❓	❓	❓	❓	❓
`installationUpdate`	✔	✔	❌	❌	❌	❌	❌	❌	❌	❌	❌
`message`	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔
`messageDelete`	❌	❌	❌	❌	❌	✔	❓	❌	❌	❌	❌
`messageReaction`	❌	❌	❌	❌	❌	✔	❌	❌	❌	❌	❌
`messageUpdate`	❌	❌	❌	❌	❌	✔	❓	❌	❌	❌	❌
`typing`	✔	✔	❌	✔	❌	✔	✔	❌	❌	✔	❌

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

Prise en charge des actions par canal

Le tableau suivant montre le nombre maximal d’actions suggérées et d’actions de carte prises en charge dans chaque canal. Indique ❌ que l’action n’est pas prise en charge du tout dans le canal spécifié.

\	Ligne directe	Direct Line (Web Chat)	E-mail	Facebook	GroupMe	Lignes	Teams	Slack	Skype	Skype Entreprise	Telegram	Twilio
Actions suggérées	100	100	❌	10	❌	13	❌	❌	10	❌	100	❌
Actions de carte	100	100	❌	3	❌	99	50	100	3	❌	❌	❌

Pour plus d’informations sur les nombres indiqués dans le tableau ci-dessus, consultez le code de prise en charge par canal indiqué ici.

Pour plus d’informations sur les actions suggérées, consultez comment utiliser un bouton pour l’article d’entrée .

Pour plus d’informations sur les actions de carte, consultez la section Envoyer une carte héros de l’article Ajouter un média aux messages .

Prise en charge des cartes par canal

Channel	Carte adaptative	Carte d’animation	Carte audio	Carte héros	Carte de reçu	Carte de connexion	Carte miniature	Carte vidéo
Courrier	🖼	📄	📄	✔	✔	✔	✔	📄
Facebook	⚠🖼	✔	❌	✔	✔	✔	✔	❌
GroupMe	🖼	📄	📄	📄	📄	📄	📄	📄
Lignes	⚠🖼	✔	📄	✔	✔	✔	✔	📄
Microsoft Teams	✔	❌	❌	✔	✔	✔	✔	❌
Skype	❌	✔	✔	✔	✔	✔	✔	✔
Slack	🖼	✔	📄	📄	✔	✔	📄	📄
Telegram	⚠🖼	✔	📄	✔	✔	✔	✔	✔
Twilio	🖼	📄	❌	📄	📄	📄	📄	❌
Discussion Web	✔	✔	✔	✔	✔	✔	✔	✔