Kategorisierte Aktivitäten nach KanalCategorized activities by channel

gilt für: SDK v4APPLIES TO: SDK v4

In den Tabellen unten ist dargestellt, welche Ereignisse (übertragene Aktivitäten) über welche Kanäle gesendet werden können.The following tables show what events (Activities on the wire) can come from which channels.

Hier sehen Sie die Legende für die Tabellen:This is the key for the tables:

SymbolSymbol BedeutungMeaning
Der Bot sollte den Empfang dieser Aktivität erwarten.The Bot should expect to receive this Activity
Der Bot sollte den Empfang dieser Aktivität nie erwarten.The Bot should never expect to receive this Activity
Gegenwärtig steht nicht fest, ob der Bot diese Aktivität empfangen kann.Currently undetermined whether the Bot can receive this

Aktivitäten können auf sinnvolle Weise in separate Kategorien aufgeteilt werden.Activities can meaningfully be split into separate categories. Für jede Kategorie ist eine Tabelle mit möglichen Aktivitäten angegeben.For each category we have a table of possible Activities.

InteraktivConversational

\ Direct LineDirect Line Direct Line (Webchat)Direct Line (Web Chat) EmailEmail FacebookFacebook GroupMeGroupMe KikKik TeamsTeams PufferSlack SkypeSkype Skype BusinessSkype Business TelegramTelegram TwilioTwilio
MessageMessage
MessageReactionMessageReaction
  • Alle Kanäle senden Nachrichtenaktivitäten.All Channels send Message Activities.
  • Bei Verwendung eines Dialogs sollten Nachrichtenaktivitäten im Allgemeinen immer an den Dialog übergeben werden.When using a Dialog, Message Activities should generally always be passed onto the Dialog.
  • Dies gilt wahrscheinlich nicht für das MessageReaction-Element, obwohl es sehr wohl Teil der Konversation ist.This is probably not true of the MessageReaction although they are very much part of the conversation.
  • Es gibt logischerweise zwei MessageReaction-Typen: „Hinzugefügt“ und „Entfernt“.There are logically two types of MessageReaction: Added and Removed

Tipp

Eine „Nachrichtenantwort“ ist beispielsweise die Zustimmung zu einem vorherigen Kommentar."Message Reactions" are things like a "thumbs up" on a previous comment. Nachrichtenantworten sind an keine bestimmte Reihenfolge gebunden und somit mit Schaltflächen vergleichbar.They can happen out of order, so they can be thought of as similar to buttons. Diese Aktivität wird derzeit vom Teams-Kanal gesendet.This Activity is currently sent by the Teams Channel.

WillkommenWelcome

\ Direct LineDirect Line Direct Line (Webchat)Direct Line (Web Chat) EmailEmail FacebookFacebook GroupMeGroupMe KikKik TeamsTeams PufferSlack SkypeSkype Skype BusinessSkype Business TelegramTelegram TwilioTwilio
ConversationUpdateConversationUpdate
ContactRelationUpdateContactRelationUpdate
  • Es ist üblich, dass Kanäle ConversationUpdate-Aktivitäten senden.It is common for Channels to send ConversationUpdate Activities.
  • Es gibt logischerweise zwei MessageReaction-Typen: „Hinzugefügt“ und „Entfernt“.There are logically two types of MessageReaction: Added and Removed
  • Die Annahme, dass das Begrüßungsverhalten des Bots einfach durch das Einrichten von „ConversationUpdate.Added“ implementiert werden kann, ist sehr verlockend. Manchmal funktioniert das auch.It is very tempting to assume bot "Welcome" behavior can be simply implemented by wiring up ConversationUpdate.Added and this sometimes works.
  • Dies ist jedoch eine Vereinfachung, und um ein zuverlässiges Begrüßungsverhalten zu gewährleisten, muss die Botimplementierung unter Umständen auch einen Zustand verwenden.However, this is a simplification, in order to produce a reliable "Welcome" behavior the bot implementation may also need to use state.

AnwendungserweiterungApplication Extensibility

\ Direct LineDirect Line Direct Line (Webchat)Direct Line (Web Chat) EmailEmail FacebookFacebook GroupMeGroupMe KikKik TeamsTeams PufferSlack SkypeSkype Skype BusinessSkype Business TelegramTelegram TwilioTwilio
Event.*Event.*
Event.CreateConversationEvent.CreateConversation
Event.ContinueConversationEvent.ContinueConversation
  • Ereignisaktivitäten sind ein Erweiterungsmechanismus in Direct Line (Webchat).Event Activities are an extensibility mechanism in Direct Line (aka Web Chat).
  • Eine Anwendung, die sowohl den Client als auch den Server besitzt, kann mithilfe dieser Ereignisaktivität eigene Ereignisse über den Dienst tunneln.An application that owns both the client and server may chose to tunnel their own events through the service using this Event Activity.

Microsoft TeamsMicrosoft Teams

\ Direct LineDirect Line Direct Line (Webchat)Direct Line (Web Chat) EmailEmail FacebookFacebook GroupMeGroupMe KikKik TeamsTeams PufferSlack SkypeSkype Skype BusinessSkype Business TelegramTelegram TwilioTwilio
Invoke.TeamsVerificationInvoke.TeamsVerification
Invoke.ComposeResponseInvoke.ComposeResponse
  • Zusammen mit einigen der anderen typisierten Aktivitäten definiert Microsoft Teams einige für Teams spezifische Aufrufaktivitäten.Along with a number of the other typed Activities, Microsoft Teams defines a few Teams specific Invoke Activities.
  • Aufrufaktivitäten gelten spezifisch für eine Anwendung und nicht für ein von einem Client definiertes Element.Invoke Activities are specific to an application and not something a client would define.
  • Es gibt keine allgemeine Angabe für aufrufspezifische Untertypen der Aktivität.There is no general notion of Invoke specific subtypes of the activity.
  • Die Aufrufaktivität ist derzeit die einzige Aktivität, die ein Anforderung-Antwort-Verhalten des Bots auslöst.Invoke is currently the only Activity that triggers a request-reply behavior on the bot.

Wichtig: Bei Verwendung von Dialogen muss die Aktivität „Invoke.TeamsVerification“ an den Dialog weitergeleitet werden, damit die OAuth-Eingabeaufforderung funktioniert.This is very important: if using Dialogs for the OAuth Prompt to work the Invoke.TeamsVerification Activity must be forwarded to the Dialog.

Aktualisierung einer NachrichtMessage Update

\ Direct LineDirect Line Direct Line (Webchat)Direct Line (Web Chat) EmailEmail FacebookFacebook GroupMeGroupMe KikKik TeamsTeams PufferSlack SkypeSkype Skype BusinessSkype Business TelegramTelegram TwilioTwilio
MessageUpdateMessageUpdate
MessageDeleteMessageDelete
  • Die Nachrichtenaktualisierung wird derzeit von Teams unterstützt.Message Update is currently supported by Teams.

OAuthOAuth

\ Direct LineDirect Line Direct Line (Webchat)Direct Line (Web Chat) EmailEmail FacebookFacebook GroupMeGroupMe KikKik TeamsTeams PufferSlack SkypeSkype Skype BusinessSkype Business TelegramTelegram TwilioTwilio
Event.TokenResponseEvent.TokenResponse

Wichtig: Bei Verwendung von Dialogen muss die Aktivität „Event.TokenResponse“ an den Dialog weitergeleitet werden, damit die OAuth-Eingabeaufforderung funktioniert.This is very important: if using Dialogs for the OAuth Prompt to work the Event.TokenResponse Activity must be forwarded to the Dialog.

Nicht kategorisiertUncategorized

\ Direct LineDirect Line Direct Line (Webchat)Direct Line (Web Chat) EmailEmail FacebookFacebook GroupMeGroupMe KikKik TeamsTeams PufferSlack SkypeSkype Skype BusinessSkype Business TelegramTelegram TwilioTwilio
EndOfConversationEndOfConversation
InstallationUpdateInstallationUpdate
EingabeTyping
HandoffHandoff

Veraltet (umfasst zahlungsspezifische Aufrufe)Out of Use (includes Payment specific Invoke)

  • DeleteUserDataDeleteUserData
  • Invoke.PaymentRequestInvoke.PaymentRequest
  • Invoke.AddressInvoke.Address
  • PingenPing

Zusammenfassung der pro Kanal unterstützten AktivitätenSummary of Activities supported per Channel

Direct LineDirect Line

  • MessageMessage
  • ConversationUpdateConversationUpdate
  • Event.TokenResponseEvent.TokenResponse
  • Event.*Event.*
  • Event.CreateConversationEvent.CreateConversation
  • Event.ContinueConversationEvent.ContinueConversation

EmailEmail

  • MessageMessage

FacebookFacebook

  • MessageMessage
  • Event.TokenResponseEvent.TokenResponse

GroupMeGroupMe

  • MessageMessage
  • ConversationUpdateConversationUpdate
  • Event.TokenResponseEvent.TokenResponse

KikKik

  • MessageMessage
  • ConversationUpdateConversationUpdate
  • Event.TokenResponseEvent.TokenResponse

TeamsTeams

  • MessageMessage
  • ConversationUpdateConversationUpdate
  • MessageReactionMessageReaction
  • MessageUpdateMessageUpdate
  • MessageDeleteMessageDelete
  • Invoke.TeamsVerificationInvoke.TeamsVerification
  • Invoke.ComposeResponseInvoke.ComposeResponse

PufferSlack

  • MessageMessage
  • ConversationUpdateConversationUpdate
  • Event.TokenResponseEvent.TokenResponse

SkypeSkype

  • MessageMessage
  • ContactRelationUpdateContactRelationUpdate
  • Event.TokenResponseEvent.TokenResponse

Skype BusinessSkype Business

  • MessageMessage
  • ContactRelationUpdateContactRelationUpdate
  • Event.TokenResponseEvent.TokenResponse

TelegramTelegram

  • MessageMessage
  • ConversationUpdateConversationUpdate
  • Event.TokenResponseEvent.TokenResponse

TwilioTwilio

  • MessageMessage

Übersichtstabelle: Alle Aktivitäten an alle KanäleSummary Table All Activities to All Channels

\ Direct LineDirect Line Direct Line (Webchat)Direct Line (Web Chat) EmailEmail FacebookFacebook GroupMeGroupMe KikKik TeamsTeams PufferSlack SkypeSkype Skype BusinessSkype Business TelegramTelegram TwilioTwilio
MessageMessage
MessageReactionMessageReaction
ConversationUpdateConversationUpdate
ContactRelationUpdateContactRelationUpdate
Event.*Event.*
Event.CreateConversationEvent.CreateConversation
Event.ContinueConversationEvent.ContinueConversation
Invoke.TeamsVerificationInvoke.TeamsVerification
Invoke.ComposeResponseInvoke.ComposeResponse
MessageUpdateMessageUpdate
MessageDeleteMessageDelete
Event.TokenResponseEvent.TokenResponse
EndOfConversationEndOfConversation
InstallationUpdateInstallationUpdate
EingabeTyping
HandoffHandoff

WebchatWeb Chat

Im Webchat wird Folgendes gesendet:Web Chat will send:

  • „message“ (Nachricht) mit Text (text) und/oder Anlagen (attachments)"message": with "text" and/or "attachments"
  • „event“ (Ereignis) mit Name (name) und Wert (value) (als JSON-Code/Zeichenfolge)"event": with "name" and "value" (as JSON/string)
  • „typing“ (Eingabe): Legt der Benutzer die Option „sendTypingIndicator“ fest, wird „contactRelationUpdate“ im Webchat nicht gesendet."typing": if the user set an option, namely "sendTypingIndicator" Web Chat will not send "contactRelationUpdate". Vom Webchat wird „messageReaction“ nicht unterstützt, da die Unterstützung dieses Features nicht ausdrücklich angefordert wurde.And Web Chat do not support "messageReaction", no one explicitly ask us to support this feature.

Vom Webchat wird standardmäßig Folgendes gerendert:By default, Web Chat will render:

  • „message“ (Nachricht) wird entweder als Karussell oder als Balken gerendert (abhängig von der Option in der Aktivität)."message": will render as either carousel or stacked, depends on the option in the activity
  • „typing“ (Eingabe): Wird fünf Sekunden lang bzw. bis zum Eingang der nächsten Aktivität angezeigt und dann ausgeblendet."typing": will render for 5s and hide it, or until next activity come in
  • conversationUpdate: Wird ausgeblendet."conversationUpdate": will hide
  • „event“ (Ereignis): Wird ausgeblendet."event": will hide
  • Übrige Angaben: Ein Warnfeld wird angezeigt (in der Produktion niemals sichtbar). Sie können diese Renderingpipeline anpassen, um benutzerdefinierte Renderings hinzuzufügen, zu entfernen oder zu ersetzen.Others: will show a warning box (we never see it in production) You can modify this render pipeline to add, remove, or replace any custom render.

Sie können im Webchat jeden Aktivitätstyp und jede Nutzlast senden. Für dieses Feature liegt weder eine Dokumentation noch eine Empfehlung vor.You can use Web Chat to send any activity type and payload, we neither document nor recommend this feature. Stattdessen sollten Sie eine Ereignisaktivität („event“) verwenden.You should use "event" activity instead.

Aktionsunterstützung nach KanalAction support by channel

Die folgende Tabelle zeigt die maximale Anzahl von vorgeschlagenen Aktionen und Kartenaktionen, die in jedem Kanal unterstützt werden.The following table shows the maximum number of Suggested Actions and Card Actions that are supported in each channel. Die Angabe „:x:“ bedeutet, dass die Aktion im jeweiligen Kanal überhaupt nicht unterstützt wird.The ❌ indicates that the action is not supported at all in the specified channel.

\ Direct LineDirect Line Direct Line (Webchat)Direct Line (Web Chat) EmailEmail FacebookFacebook GroupMeGroupMe KikKik ZeileLine TeamsTeams PufferSlack SkypeSkype Skype BusinessSkype Business TelegramTelegram TwilioTwilio
Vorgeschlagene AktionenSuggested Actions 100100 100100 1010 2020 1313 1010 100100
KartenaktionenCard Actions 100100 100100 33 2020 9999 33 100100 33

Weitere Informationen zu den Zahlen in der obigen Tabelle finden Sie im hier aufgeführten Code für die Kanalunterstützung.For more information about the numbers shown in the above table, refer to channel support code listed here.

Weitere Informationen zu vorgeschlagenen Aktionen finden Sie im Artikel Verwenden von Schaltflächen für die Eingabe.For more information on Suggested Actions, refer to the Use button for input article.

Weitere Informationen zu Kartenaktionen finden Sie im Artikel Hinzufügen von Medien zu Nachrichten im Abschnitt Senden einer Hero-Karte.For more information on Card Actions, refer to the Send a hero card section of the Add media to messages article.

Kartenunterstützung nach KanalCard Support by Channel

ChannelChannel Adaptive KarteAdaptive Card AnimationskarteAnimation Card AudiokarteAudio Card Hero-KarteHero Card QuittungskarteReceipt Card AnmeldekarteSignin Card MiniaturbildkarteThumbnail Card VideokarteVideo Card
EmailEmail 🔶 🌐🌐 🌐🌐 🌐🌐
FacebookFacebook ⚠🔶
GroupMeGroupMe 🔶 🌐🌐 🌐🌐 🌐🌐 🌐🌐 🌐🌐 🌐🌐 🌐🌐
KikKik 🔶 🌐🌐 🌐🌐
ZeileLine ⚠🔶 🌐🌐 🌐🌐
Microsoft TeamsMicrosoft Teams
SkypeSkype
PufferSlack 🔶 🌐🌐 🌐🌐 🌐🌐 🌐🌐
TelegramTelegram ⚠🔶 🌐🌐
TwilioTwilio 🔶 🌐🌐 🌐🌐 🌐🌐 🌐🌐 🌐🌐
WebchatWeb Chat

Hinweis: Der Direct Line-Kanal unterstützt technisch gesehen alle Karten, diese müssen jedoch vom Client implementiert werden.Note: The Direct Line channel technically supports all cards, but it's up to the client to implement them

  • ✔: Unterstützt: Die Karte wird vollständig unterstützt. Von einigen Kanälen wird jedoch unter Umständen nur eine Teilmenge der Kartenaktionen unterstützt und/oder die Anzahl zulässiger Aktionen für die einzelnen Karten eingeschränkt.✔: Supported - Card is supported fully with the exception that some channels only support a subset of CardActions and/or may limit the number of actions allowed on each card. Variiert je nach Kanal.Varies by channel.
  • ⚠: Teilweise unterstützt: Die Karte wird unter Umständen nicht angezeigt, wenn sie Eingaben und/oder Schaltflächen enthält.⚠: Partial Support - Card may not be displayed at all if it contains inputs and/or buttons. Variiert je nach Kanal.Varies by channel.
  • ❌: Keine Unterstützung❌: No Support
  • 🔶: Die Karte wird in ein Bild konvertiert.🔶: Card is Converted to Image
  • 🌐: Die Karte wird in unformatierten Text konvertiert. Links sind möglicherweise nicht klickbar, Bilder werden möglicherweise nicht angezeigt, und/oder Medien können möglicherweise nicht wiedergegeben werden.🌐: Card is Converted to Unformatted Text - Links may not be clickable, images may not display, and/or media may not be playable. Variiert je nach Kanal.Varies by channel.

Aufgrund der vielen möglichen Kombinationen aus Karten, Features und Kanälen sind diese Kategorien bewusst weit gefasst und erklären nicht im Detail, wie das jeweilige Kartenfeature in den einzelnen Kanälen unterstützt wird.These categories are intentionally broad and don't fully explain how every card feature is supported in each channel due to the many possible combinations of cards, features, and channels. Nutzen Sie diese Tabelle als Basisreferenz, aber testen Sie jede Ihrer Karten in den gewünschten Kanälen.Please use this table as a base reference, but test each of your cards in the desired channel(s).