Activity interface

Paket:

botframework-schema

Eine Aktivität ist der grundlegende Kommunikationstyp für das Bot Framework 3.0-Protokoll.

Eigenschaften

action	Gibt an, ob der Empfänger eines contactRelationUpdate hinzugefügt oder aus der Kontaktliste des Absenders entfernt wurde.
attachmentLayout	Der Layouthinweis für mehrere Anlagen. Standard: Liste. Mögliche Werte sind: 'list', 'Karussell'
attachments	Anhängsel
callerId	Eine Zeichenfolge, die einen URI enthält, der den Aufrufer eines Bots identifiziert. Dieses Feld soll nicht über das Kabel übertragen werden, sondern von Bots und Clients basierend auf kryptografisch überprüften Daten gefüllt werden, die die Identität der Aufrufer (z. B. Token) bestätigen.
channelData	Enthält kanalspezifische Inhalte.
channelId	Enthält eine ID, die den Kanal eindeutig identifiziert. Vom Kanal festgelegt.
code	Der Code für endOfConversation-Aktivitäten, der angibt, warum die Unterhaltung beendet wurde. Mögliche Werte sind: "unknown", "completedSuccessfully", "userCancelled", "botTimedOut", "botIssuedInvalidMessage", "channelFailed"
conversation	Identifiziert die Unterhaltung, zu der die Aktivität gehört.
deliveryMode	Ein Übermittlungshinweis, der dem Empfänger alternative Übermittlungspfade für die Aktivität signalisiert. Der Standardübermittlungsmodus ist "Standard". Mögliche Werte sind: "normal", "notification", "expectReplies", "ephemeral"
entities	Stellt die Entitäten dar, die in der Nachricht erwähnt wurden.
expiration	Der Zeitpunkt, zu dem die Aktivität als "abgelaufen" betrachtet werden sollte und dem Empfänger nicht angezeigt werden sollte.
from	Identifiziert den Absender der Nachricht.
historyDisclosed	Gibt an, ob der vorherige Verlauf des Kanals offengelegt wird.
id	Enthält eine ID, die die Aktivität im Kanal eindeutig identifiziert.
importance	Die Bedeutung der Aktivität. Mögliche Werte sind: "niedrig", "normal", "high"
inputHint	Gibt an, ob Ihr Bot Benutzereingaben akzeptiert, erwartet oder ignoriert, nachdem die Nachricht an den Client übermittelt wurde. Mögliche Werte sind: 'acceptingInput', 'ignoringInput', 'expectingInput'
label	Eine beschreibende Bezeichnung für die Aktivität.
listenFor	Liste der Ausdrücke und Verweise, auf die Sprach- und Sprachprimierungssysteme lauschen sollten
locale	Ein Gebietsschemaname für den Inhalt des Textfelds. Der Gebietsschemaname ist eine Kombination aus einem zwei- oder drei buchstabenigen ISO 639-Kulturcode, der einer Sprache zugeordnet ist, und einem zweiseitigen ISO 3166-Subkulturcode, der einem Land oder einer Region zugeordnet ist. Der Gebietsschemaname kann auch einem gültigen BCP-47-Sprachtag entsprechen.
localTimestamp	Enthält das lokale Datum und die Uhrzeit der Nachricht, ausgedrückt im ISO-8601-Format. Beispiel: 2016-09-23T13:07:49.4714686-07:00.
localTimezone	Enthält den Namen der lokalen Zeitzone der Nachricht, ausgedrückt im IANA Time Zone-Datenbankformat. Beispiel: Amerika/Los_Angeles.
membersAdded	Die Sammlung der Mitglieder, die der Unterhaltung hinzugefügt wurden.
membersRemoved	Die Sammlung von Mitgliedern, die aus der Unterhaltung entfernt wurden.
name	Der Name des Vorgangs, der einer Aufruf- oder Ereignisaktivität zugeordnet ist.
reactionsAdded	Die Sammlung von Reaktionen, die der Unterhaltung hinzugefügt wurden.
reactionsRemoved	Die Sammlung von Reaktionen, die aus der Unterhaltung entfernt wurden.
recipient	Identifiziert den Empfänger der Nachricht.
relatesTo	Ein Verweis auf eine andere Unterhaltung oder Aktivität.
replyToId	Enthält die ID der Nachricht, auf die diese Nachricht eine Antwort ist.
semanticAction	Eine optionale programmgesteuerte Aktion, die diese Anforderung begleitet
serviceUrl	Enthält die URL, die den Dienstendpunkt des Kanals angibt. Vom Kanal festgelegt.
speak	Der zu sprechende Text.
suggestedActions	Die vorgeschlagenen Aktionen für die Aktivität.
summary	Der anzuzeigende Text, wenn der Kanal keine Karten rendern kann.
text	Der Textinhalt der Nachricht.
textFormat	Format der Textfelder "Default:markdown". Mögliche Werte sind: "markdown", "plain", "xml"
textHighlights	Die Sammlung von Textfragmenten, die hervorgehoben werden sollen, wenn die Aktivität einen ReplyToId-Wert enthält.
timestamp	Enthält das Datum und die Uhrzeit, zu der die Nachricht in UTC gesendet wurde, ausgedrückt im ISO-8601-Format.
topicName	Der aktualisierte Themenname der Unterhaltung.
type	Enthält den Aktivitätstyp. Mögliche Werte sind: 'message', 'contactRelationUpdate', 'conversationUpdate', 'typing', 'endOfConversation', 'event', 'invoke', 'deleteUserData', 'messageUpdate', 'messageDelete', 'installationUpdate', 'messageReaction', 'suggestion', 'trace', 'handoff'
value	Ein Wert, der der Aktivität zugeordnet ist.
valueType	Der Typ des Wertobjekts der Aktivität.

Details zur Eigenschaft

action

Gibt an, ob der Empfänger eines contactRelationUpdate hinzugefügt oder aus der Kontaktliste des Absenders entfernt wurde.

action?: string

Eigenschaftswert

string

attachmentLayout

Der Layouthinweis für mehrere Anlagen. Standard: Liste. Mögliche Werte sind: 'list', 'Karussell'

attachmentLayout?: AttachmentLayoutTypes | string

Eigenschaftswert

AttachmentLayoutTypes | string

attachments

Anhängsel

attachments?: Attachment[]

Eigenschaftswert

Attachment[]

callerId

Eine Zeichenfolge, die einen URI enthält, der den Aufrufer eines Bots identifiziert. Dieses Feld soll nicht über das Kabel übertragen werden, sondern von Bots und Clients basierend auf kryptografisch überprüften Daten gefüllt werden, die die Identität der Aufrufer (z. B. Token) bestätigen.

callerId: string

Eigenschaftswert

string

channelData

Enthält kanalspezifische Inhalte.

channelData?: any

Eigenschaftswert

any

channelId

Enthält eine ID, die den Kanal eindeutig identifiziert. Vom Kanal festgelegt.

channelId: string

Eigenschaftswert

string

code

Der Code für endOfConversation-Aktivitäten, der angibt, warum die Unterhaltung beendet wurde. Mögliche Werte sind: "unknown", "completedSuccessfully", "userCancelled", "botTimedOut", "botIssuedInvalidMessage", "channelFailed"

code?: EndOfConversationCodes | string

Eigenschaftswert

EndOfConversationCodes | string

conversation

Identifiziert die Unterhaltung, zu der die Aktivität gehört.

conversation: ConversationAccount

Eigenschaftswert

ConversationAccount

deliveryMode

Ein Übermittlungshinweis, der dem Empfänger alternative Übermittlungspfade für die Aktivität signalisiert. Der Standardübermittlungsmodus ist "Standard". Mögliche Werte sind: "normal", "notification", "expectReplies", "ephemeral"

deliveryMode?: DeliveryModes | string

Eigenschaftswert

DeliveryModes | string

entities

Stellt die Entitäten dar, die in der Nachricht erwähnt wurden.

entities?: Entity[]

Eigenschaftswert

Entity[]

expiration

Der Zeitpunkt, zu dem die Aktivität als "abgelaufen" betrachtet werden sollte und dem Empfänger nicht angezeigt werden sollte.

expiration?: Date

Eigenschaftswert

Date

from

Identifiziert den Absender der Nachricht.

from: ChannelAccount

Eigenschaftswert

ChannelAccount

historyDisclosed

Gibt an, ob der vorherige Verlauf des Kanals offengelegt wird.

historyDisclosed?: boolean

Eigenschaftswert

boolean

id

Enthält eine ID, die die Aktivität im Kanal eindeutig identifiziert.

id?: string

Eigenschaftswert

string

importance

Die Bedeutung der Aktivität. Mögliche Werte sind: "niedrig", "normal", "high"

importance?: ActivityImportance | string

Eigenschaftswert

ActivityImportance | string

inputHint

Gibt an, ob Ihr Bot Benutzereingaben akzeptiert, erwartet oder ignoriert, nachdem die Nachricht an den Client übermittelt wurde. Mögliche Werte sind: 'acceptingInput', 'ignoringInput', 'expectingInput'

inputHint?: InputHints | string

Eigenschaftswert

InputHints | string

label

Eine beschreibende Bezeichnung für die Aktivität.

label: string

Eigenschaftswert

string

listenFor

Liste der Ausdrücke und Verweise, auf die Sprach- und Sprachprimierungssysteme lauschen sollten

listenFor: string[]

Eigenschaftswert

string[]

locale

Ein Gebietsschemaname für den Inhalt des Textfelds. Der Gebietsschemaname ist eine Kombination aus einem zwei- oder drei buchstabenigen ISO 639-Kulturcode, der einer Sprache zugeordnet ist, und einem zweiseitigen ISO 3166-Subkulturcode, der einem Land oder einer Region zugeordnet ist. Der Gebietsschemaname kann auch einem gültigen BCP-47-Sprachtag entsprechen.

locale?: string

Eigenschaftswert

string

localTimestamp

Enthält das lokale Datum und die Uhrzeit der Nachricht, ausgedrückt im ISO-8601-Format. Beispiel: 2016-09-23T13:07:49.4714686-07:00.

localTimestamp?: Date

Eigenschaftswert

Date

localTimezone

Enthält den Namen der lokalen Zeitzone der Nachricht, ausgedrückt im IANA Time Zone-Datenbankformat. Beispiel: Amerika/Los_Angeles.

localTimezone: string

Eigenschaftswert

string

membersAdded

Die Sammlung der Mitglieder, die der Unterhaltung hinzugefügt wurden.

membersAdded?: ChannelAccount[]

Eigenschaftswert

ChannelAccount[]

membersRemoved

Die Sammlung von Mitgliedern, die aus der Unterhaltung entfernt wurden.

membersRemoved?: ChannelAccount[]

Eigenschaftswert

ChannelAccount[]

name

Der Name des Vorgangs, der einer Aufruf- oder Ereignisaktivität zugeordnet ist.

name?: ActivityEventNames | string

Eigenschaftswert

ActivityEventNames | string

reactionsAdded

Die Sammlung von Reaktionen, die der Unterhaltung hinzugefügt wurden.

reactionsAdded?: MessageReaction[]

Eigenschaftswert

MessageReaction[]

reactionsRemoved

Die Sammlung von Reaktionen, die aus der Unterhaltung entfernt wurden.

reactionsRemoved?: MessageReaction[]

Eigenschaftswert

MessageReaction[]

recipient

Identifiziert den Empfänger der Nachricht.

recipient: ChannelAccount

Eigenschaftswert

ChannelAccount

relatesTo

Ein Verweis auf eine andere Unterhaltung oder Aktivität.

relatesTo?: ConversationReference

Eigenschaftswert

ConversationReference

replyToId

Enthält die ID der Nachricht, auf die diese Nachricht eine Antwort ist.

replyToId?: string

Eigenschaftswert

string

semanticAction

Eine optionale programmgesteuerte Aktion, die diese Anforderung begleitet

semanticAction?: SemanticAction

Eigenschaftswert

SemanticAction

serviceUrl

Enthält die URL, die den Dienstendpunkt des Kanals angibt. Vom Kanal festgelegt.

serviceUrl: string

Eigenschaftswert

string

speak

Der zu sprechende Text.

speak?: string

Eigenschaftswert

string

suggestedActions

Die vorgeschlagenen Aktionen für die Aktivität.

suggestedActions?: SuggestedActions

Eigenschaftswert

SuggestedActions

summary

Der anzuzeigende Text, wenn der Kanal keine Karten rendern kann.

summary?: string

Eigenschaftswert

string

text

Der Textinhalt der Nachricht.

text: string

Eigenschaftswert

string

textFormat

Format der Textfelder "Default:markdown". Mögliche Werte sind: "markdown", "plain", "xml"

textFormat?: TextFormatTypes | string

Eigenschaftswert

TextFormatTypes | string

textHighlights

Die Sammlung von Textfragmenten, die hervorgehoben werden sollen, wenn die Aktivität einen ReplyToId-Wert enthält.

textHighlights?: TextHighlight[]

Eigenschaftswert

TextHighlight[]

timestamp

Enthält das Datum und die Uhrzeit, zu der die Nachricht in UTC gesendet wurde, ausgedrückt im ISO-8601-Format.

timestamp?: Date

Eigenschaftswert

Date

topicName

Der aktualisierte Themenname der Unterhaltung.

topicName?: string

Eigenschaftswert

string

type

Enthält den Aktivitätstyp. Mögliche Werte sind: 'message', 'contactRelationUpdate', 'conversationUpdate', 'typing', 'endOfConversation', 'event', 'invoke', 'deleteUserData', 'messageUpdate', 'messageDelete', 'installationUpdate', 'messageReaction', 'suggestion', 'trace', 'handoff'

type: ActivityTypes | string

Eigenschaftswert

ActivityTypes | string

value

Ein Wert, der der Aktivität zugeordnet ist.

value?: any

Eigenschaftswert

any

valueType

Der Typ des Wertobjekts der Aktivität.

valueType: string

Eigenschaftswert

string