Freigeben über

Referenz zu Kanälen

  • Artikel

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.
No 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 No Nein Ja Ja Nr. Nein Ja Nr. Nr. Nr. No
Azure Communication Services No Ja Keine Ja Nr. Nein Ja Keine Ja Ja Ja
Direct Line No Ja Ja Ja Ja Keine Ja Nr. Nr. Nein Ja
Direct Line Speech Ja
E‑Mail No Nr. No Unbestimmt No Nein Ja Nr. Nr. Nr. Nein
Facebook No Ja Keine Ja Nr. Nein Ja Ja Nr. Nr. No
GroupMe No Ja No Unbestimmt No Nein Ja Nr. Nr. Nr. No
LINE No Ja Keine Ja Nr. Nein Ja Nr. Nr. Nr. No
Microsoft Teams No Ja No Unbestimmt No Ja Ja Ja Ja Ja No
Omnichannel Ja
Outlook (Vorschau) Ja
Suche (Vorschau) Ja
Slack No Ja No Unbestimmt No Nein Ja Keine Ja Ja No
Telegram No Ja No Unbestimmt No Nein Ja Keine Ja Unbestimmt No
Twilio (SMS) No Nr. No Unbestimmt No Nein Ja Nr. Nr. Nr. No
Webchat No Ja Ja Ja Ja Keine Ja Nr. Nr. 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.
No Die Karte wird in diesem Kanal nicht unterstützt.
Partial 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 No Nr. Nein Ja Keine Ja Nr. No
Azure Communication Services 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
Linie Bild, teilweise Ja Text Ja Ja Ja Ja Text
Microsoft Teams Ja Nr. Nein Ja Ja Ja Ja No
Omnichannel
Outlook (Vorschau)
Suche (Vorschau)
Slack Abbildung Ja Text Text Ja Ja Text Text
Telegram Bild, teilweise Ja Text Ja Ja Ja Ja Ja
Twilio (SMS) Abbildung Text No Text Text Text Text No
Webchat 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
Direct Line 100 100
Direct Line Speech 100 100
E‑Mail Keine Keine
Facebook 11 3
GroupMe Keine Keine
Linie 13 99
Microsoft Teams Keine 3
Omnichannel
Outlook (Vorschau)
Suche (Vorschau)
Slack Keine 100
Telegram 100 100
Twilio (SMS) Keine Keine
Webchat 100 100

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.

Konversation

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.