Referenz zu Kanälen

GILT FÜR: SDK v4

In diesem Artikel wird die Kanalunterstützung für verschiedene Bot Framework-Features beschrieben:

• Die Aktivitätstypen, die jeder Kanal senden oder empfangen kann.
• Die Kartentypen, die jeder Kanal anzeigen kann, einschließlich adaptiver Karten.
• Kartenaktion und vorgeschlagene Aktionsunterstützung für jeden Kanal.
• Eine allgemeine Klassifizierung der verschiedenen Aktivitätstypen.

Ausführliche Informationen zur Struktur von Aktivitäten und Karte auf Protokollebene finden Sie in den Bot Framework-Aktivitäten und Karte Schemas.

Adaptive Karten sind eine separate Technologie. Weitere Informationen finden Sie unter adaptivecards.io.

Aktionsunterstützung nach Kanal

Die folgende Tabelle gibt an, ob ein bestimmter Kanal einen bestimmten Aktivitätstyp an Ihren Bot senden kann. In der Tabelle haben die folgenden Begriffe die folgenden Bedeutungen.

Begriff	Bedeutung
Ja	Der Bot kann diese Aktivität vom Kanal empfangen.
Nein	Der Bot kann diese Aktivität nicht vom Kanal empfangen.
Unbestimmt	Zurzeit nicht festgelegt.

Kanal	Aktualisierung der Kontaktbeziehung	Konversationsaktualisierung	Ende der Konversation	Ereignis	Installationsupdate	Invoke	`Message`	Nachrichtenantwort	Nachrichtenaktualisierung	Nachrichtenlöschung	Eingabe
Alexa	Nein	Nein	Ja	Ja	Nein	Nein	Ja	Nein	Nein	Nein	Nein
Azure Communication Services Chat	Nein	Ja	Nein	Ja	Nein	Nein	Ja	Nein	Ja	Ja	Ja
Direct Line	Nein	Ja	Ja	Ja	Ja	Nein	Ja	Nein	Nein	Nein	Ja
Direct Line Speech							Ja
E‑Mail	Nein	Nein	Nein	Unbestimmt	Nein	Nein	Ja	Nein	Nein	Nein	Nein
Facebook	Nein	Ja	Nein	Ja	Nein	Nein	Ja	Ja	Nein	Nein	Nein
GroupMe	Nein	Ja	Nein	Unbestimmt	Nein	Nein	Ja	Nein	Nein	Nein	Nein
LINE	Nein	Ja	Nein	Ja	Nein	Nein	Ja	Nein	Nein	Nein	Nein
Microsoft Teams	Nein	Ja	Nein	Unbestimmt	Nein	Ja	Ja	Ja	Ja	Ja	Nein
Omnichannel							Ja
Outlook (Vorschau)							Ja
Search (Vorschau)							Ja
Slack	Nein	Ja	Nein	Unbestimmt	Nein	Nein	Ja	Nein	Ja	Ja	Nein
Telegram	Nein	Ja	Nein	Unbestimmt	Nein	Nein	Ja	Nein	Ja	Unbestimmt	Nein
Twilio (SMS)	Nein	Nein	Nein	Unbestimmt	Nein	Nein	Ja	Nein	Nein	Nein	Nein
Web-Chat	Nein	Ja	Ja	Ja	Ja	Nein	Ja	Nein	Nein	Nein	Ja

Die Unterstützung für event und invoke Aktivitäten variiert je nach Name der Aktivität und je nach Kanal.

Kartenunterstützung nach Kanal

In der folgenden Tabelle wird angegeben, ob ein bestimmter Kanal einen bestimmten Kartentyp rendern kann. Auch wenn ein Kanal einen Kartentyp rendern kann, unterstützt der Kanal möglicherweise nicht alle Features der Karte. Bevor Sie Ihren Bot freigeben, testen Sie das Verhalten jeder Karte, die Ihr Bot senden kann.

In der Tabelle haben die folgenden Begriffe die folgenden Bedeutungen.

Begriff	Bedeutung
Ja	Die Karte wird in diesem Kanal unterstützt. Jeder angegebene Kanal kann jedoch nur eine Teilmenge von Kartenaktionen unterstützen oder die Anzahl der für jede Karte zulässigen Aktionen einschränken.
Nein	Die Karte wird in diesem Kanal nicht unterstützt.
Teilweise	Teilweise unterstützt. In diesem Kanal wird die Karte möglicherweise nicht angezeigt, wenn sie Eingaben oder Schaltflächen enthält. Der Umfang der Unterstützung variiert je nach Kanal.
Abbildung	Die Karte wird in ein Bild konvertiert.
Text	Karte wird zu unformatiertem Text konvertiert. Links sind möglicherweise nicht anklickbar, Bilder werden möglicherweise nicht angezeigt und Medien können möglicherweise nicht wiedergegeben werden. Der Umfang der Unterstützung variiert je nach Kanal.

Kanal	Adaptive Karte	Animationskarte	Audiokarte	Heldenkarte	Quittungskarte	Anmeldungskarte	Miniaturansichtkarte	Videokarte
Alexa	Nein	Nein	Nein	Ja	Nein	Ja	Nein	Nein
Azure Communication Services Chat	Ja*	Ja	Ja	Ja	Ja	Ja	Ja	Ja
E‑Mail	Abbildung	Text	Text	Ja	Ja	Ja	Ja	Text
Facebook	Bild, teilweise	Ja	Ja	Ja	Ja	Ja	Ja	Ja
GroupMe	Abbildung	Text	Text	Text	Text	Text	Text	Text
LINE	Bild, teilweise	Ja	Text	Ja	Ja	Ja	Ja	Text
Microsoft Teams	Ja	Nein	Nein	Ja	Ja	Ja	Ja	Nein
Omnichannel
Outlook (Vorschau)
Search (Vorschau)
Slack	Abbildung	Ja	Text	Text	Ja	Ja	Text	Text
Telegram	Bild, teilweise	Ja	Text	Ja	Ja	Ja	Ja	Ja
Twilio (SMS)	Abbildung	Text	Nein	Text	Text	Text	Text	Nein
Web-Chat	Ja	Ja	Ja	Ja	Ja	Ja	Ja	Ja

Hinweis

• Der Direct Line-Kanal unterstützt technisch gesehen alle Karten, diese müssen jedoch vom Client implementiert werden.
• Für Azure Communication Services Chat werden Adaptive Karten nur in Azure Communication Services-Anwendungsfällen unterstützt und nicht für Azure Communication Services-Anwendungsfälle in Teams.

Karten-Aktionsunterstützung nach Kanal

Die folgende Tabelle zeigt die maximale Anzahl von vorgeschlagenen Aktionen und Kartenaktionen, die in jedem Kanal unterstützt werden. Der Wert „None“ gibt an, dass der Aktionstyp im Kanal nicht unterstützt wird.

Kanal	Empfohlene Aktivitäten	Kartenaktionen
Alexa	Keine	Keine
Azure Communication Services Chat
Direct Line	100	100
Direct Line Speech	100	100
E‑Mail	Keine	Keine
Facebook	11	3
GroupMe	Keine	Keine
LINE	13	99
Microsoft Teams	Keine	3
Omnichannel
Outlook (Vorschau)
Search (Vorschau)
Slack	Keine	100
Telegram	100	100
Twilio (SMS)	Keine	Keine
Web-Chat	100	100

• Weitere Informationen zu Kartenaktionen finden Sie unter Prozessereignisse in relevanten Karten im Artikel Medien zu Nachrichten hinzufügen.
• Weitere Informationen zu vorgeschlagenen Aktionen finden Sie unter Verwenden von Schaltflächen für Eingaben.

Aktivitätskategorien

Aktivitäten können auf sinnvolle Weise in separate Kategorien aufgeteilt werden. Eine detaillierte Beschreibung der einzelnen Aktivitätstypen und informationen, die jeder Aktivitätstyp enthält, finden Sie im Bot Framework-Aktivitätsschema.

Willkommen

Diese Kategorie umfasst die conversationUpdate und contactRelationUpdate Aktivitäten.

• Viele Kanäle senden Konversations-Aktualisierungsaktivitäten.
  • Häufig wird das Willkommensverhalten des Bots durch die Aktualisierungsaktivität der Konversation ausgelöst. Die Erstellung eines zuverlässigen Willkommensverhaltens erfordert jedoch möglicherweise die Verwendung des Konversations- oder Benutzerstatus.
• Einige Kanäle senden Kontaktbeziehungs-Aktualisierungsaktivitäten.
  • Wenn Ihr Bot diese Kanäle verwendet, müssen Sie möglicherweise Logik für diese Aktivität in das Willkommensverhalten Ihres Bots einschließen.

Unterhaltung

Diese Kategorie umfasst die message, messageReactionund endOfConversation Aktivitäten.

• Alle Kanäle können Nachrichtenaktivitäten senden und empfangen.
  • Für Bots, die Dialogfelder verwenden, sollten Nachrichtenaktivitäten im Allgemeinen in das Dialogfeld übergeben werden.
• Einige Kanäle können Nachrichten-Antwort-Aktivitäten senden und empfangen.
  • Je nach Design Ihres Bots können Sie Nachrichten-Antwort-Aktivitäten in ein Dialogfeld übergeben.
  • Nachrichten-Antwort-Aktivitäten verweisen auf vorherige Nachrichten nach ID.
• Aktivitäten zum Beenden einer Konversation signalisieren das Ende einer Konversation aus Sicht des Empfängers.
  • Das Ende der Unterhaltungsaktivitäten wird in der Bot-zu-Bot-Kommunikation für Skills verwendet.

Tipp

Eine Nachrichtenantwort beinhaltet beispielsweise die Zustimmung zu einem vorherigen Kommentar. Nachrichtenantworten sind an keine bestimmte Reihenfolge gebunden und somit mit Schaltflächen vergleichbar. Diese Aktivitätsart kann vom Teams-Kanal gesendet werden.

Nachrichtenaktualisierung und -löschung

Diese Kategorie umfasst die messageUpdate und messageDelete Aktivitäten.

• Teams unterstützt Aktualisieren und Löschen von Nachrichten.

Anwendungserweiterbarkeit

Diese Kategorie umfasst die event und invoke Aktivitäten. Die Bedeutung einer Aktivität wird durch das Feld name definiert, das innerhalb des Bereichs eines Kanals gilt.

• Eine Anwendung, die sowohl den Client als auch den Server besitzt, kann Ereignisaktivitäten verwenden, um programmgesteuerte Informationen zwischen dem Client und dem Server zu kommunizieren.
  • Ereignisaktivitäten wie die meisten Aktivitätstypen sind asynchron.
  • Direct Line und Webchat nutzen Ereignisaktivitäten als Erweiterungsmechanismus.
• Aufrufaktivitäten gelten spezifisch für eine Anwendung und nicht für ein von einem Client definiertes Element.
  • Aufrufaktivitäten sind im Gegensatz zu anderen Aktivitätstypen synchron. (Die Aufrufaktivität ist derzeit die einzige Aktivität, die ein Anforderung-Antwort-Verhalten des Bots auslöst.)
  • Microsoft Teams verwendet Aufrufaktivitäten und definiert einige teamsspezifische Aufrufaktivitäten.

Authentifizierung

Damit die OAuth-Eingabeaufforderung mit Dialogfeldern funktioniert, muss die TeamsVerification Aufrufaktivität an das Dialogfeld weitergeleitet werden.

Nicht kategorisiert

Die installationUpdate, typing und handoff Aktivitäten passen nicht sinnvoll in die anderen Kategorien.

• Aktivitäten zur Aktualisierung der Installation stellen die Installation oder Deinstallation eines Bots in einer Organisationseinheit eines Kanals dar.
• Eingabeaktivitäten (typing) stellen eine fortlaufende Eingabe durch einen Benutzer oder Bot dar.
• Übergabeaktivitäten fordern oder signalisieren eine Änderung des Fokus zwischen Elementen innerhalb eines Bots. Die Übergabeaktivität unterscheidet sich von einer Ereignisaktivität mit dem Namen „Übergabe“.

Veraltet (umfasst zahlungsspezifische Aufrufe)

Diese Aktivitätstypen werden nicht mehr verwendet:

• deleteUserData
• handoff
• ping
• Address aufrufen
• PaymentRequest aufrufen

Weitere Informationen

Alle Kanäle können message Aktivitäten senden und empfangen.

Tipp

Wenn Sie Support für einen Kanal zu Ihrem Bot hinzufügen, machen Sie sich mit den Entwicklerdokumenten des Kanals vertraut. Jeder Kanal hat unterschiedliche Einschränkungen für verschiedene Aspekte einer Unterhaltung. Einige der Hauptunterschiede sind folgende:

• Wie viel Zeit der Bot zum Verarbeiten jeder HTTP-Anforderung hat.
• Gibt an, ob ein Bot eine Aktivität senden kann, die nicht als Reaktion auf eine bestimmte Benutzeraktivität gilt.
• Wie viele Nachrichten der Bot innerhalb eines bestimmten Zeitraums senden kann.
• Wie eine Karte gerendert wird und welche Karten unterstützt werden.