Freigeben über


Conversations class

Klasse, die eine Unterhaltung darstellt.

Konstruktoren

Conversations(ConnectorClientContext)

Erstellen Sie eine Unterhaltung.

Methoden

createConversation(ConversationParameters, RequestOptionsBase)

Erstellen Sie eine neue Unterhaltung. POST zu dieser Methode mit einer

  • Bot, der der Bot ist, der die Unterhaltung erstellt
  • IsGroup auf "true" festgelegt, wenn dies keine direkte Nachricht ist (Standardwert ist "false")
  • Array, das die Mitglieder enthält, die in die Unterhaltung aufgenommen werden sollen

Der Rückgabewert ist ein ResourceResponse,der eine Unterhaltungs-ID enthält, die für die Verwendung in der Nachrichtennutzlast und REST-API-URIs geeignet ist.

Die meisten Kanäle unterstützen nur die Semantik von Bots, die eine direkte Nachrichtenunterhaltung initiieren. Ein Beispiel dafür wäre:

const resource = await connector.conversations.createConversation({
    bot,
    members: [{ id: 'user1' }]
});
await connector.conversations.sendToConversation(resource.Id, ... );
createConversation(ConversationParameters, RequestOptionsBase, ServiceCallback<ConversationResourceResponse>)
createConversation(ConversationParameters, ServiceCallback<ConversationResourceResponse>)
deleteActivity(string, string, RequestOptionsBase)

Löschen einer vorhandenen Aktivität. In einigen Kanälen können Sie eine vorhandene Aktivität löschen, und wenn die Methode erfolgreich verläuft, wird die angegebene Aktivität entfernt.

deleteActivity(string, string, RequestOptionsBase, ServiceCallback<void>)
deleteActivity(string, string, ServiceCallback<void>)
deleteConversationMember(string, string, RequestOptionsBase)

Löscht ein Mitglied aus einer Unterhaltung. Diese REST-API akzeptiert eine ConversationId und eine MemberId (vom Typ Zeichenfolge) und entfernt dieses Mitglied aus der Unterhaltung. Wenn dieses Mitglied das letzte Mitglied der Unterhaltung war, wird die Unterhaltung ebenfalls gelöscht.

deleteConversationMember(string, string, RequestOptionsBase, ServiceCallback<void>)
deleteConversationMember(string, string, ServiceCallback<void>)
getActivityMembers(string, string, RequestOptionsBase)

Aufzählen der Mitglieder einer Aktivität. Diese REST-API akzeptiert eine ConversationId und eine ActivityId und gibt ein Array von ChannelAccount-Objekten zurück, die die Mitglieder der bestimmten Aktivität in der Unterhaltung darstellen.

getActivityMembers(string, string, RequestOptionsBase, ServiceCallback<ChannelAccount[]>)
getActivityMembers(string, string, ServiceCallback<ChannelAccount[]>)
getConversationMember(string, string, RequestOptionsBase | ServiceCallback<ChannelAccount[]>, ServiceCallback<ChannelAccount[]>)
getConversationMembers(string, RequestOptionsBase)

Aufzählen der Mitglieder einer Unterhaltung. Diese REST-API akzeptiert eine ConversationId und gibt ein Array von ChannelAccount-Objekten zurück, die die Mitglieder der Unterhaltung darstellen.

getConversationMembers(string, RequestOptionsBase, ServiceCallback<ChannelAccount[]>)
getConversationMembers(string, ServiceCallback<ChannelAccount[]>)
getConversationPagedMembers(string, ConversationsGetConversationPagedMembersOptionalParams)

Auflisten der Mitglieder einer Unterhaltung um jeweils eine Seite. Diese REST-API verwendet eine ConversationId. Optional kann ein pageSize- und/oder fortsetzungstoken bereitgestellt werden. Es gibt ein PagedMembersResult zurück, das ein Array von ChannelAccounts enthält, das die Mitglieder der Unterhaltung darstellt, und ein Fortsetzungstoken, das zum Abrufen weiterer Werte verwendet werden kann.

Eine Seite mit ChannelAccounts-Datensätzen wird mit jedem Anruf zurückgegeben. Die Anzahl der Datensätze auf einer Seite kann zwischen Kanälen und Anrufen variieren. Der pageSize-Parameter kann als Vorschlag verwendet werden. Wenn keine weiteren Ergebnisse vorhanden sind, enthält die Antwort kein Fortsetzungstoken. Wenn keine Mitglieder in der Unterhaltung vorhanden sind, sind die Mitglieder leer oder nicht in der Antwort vorhanden.

Eine Antwort auf eine Anforderung mit einem Fortsetzungstoken aus einer vorherigen Anforderung kann selten Mitglieder aus einer vorherigen Anforderung zurückgeben.

getConversationPagedMembers(string, ConversationsGetConversationPagedMembersOptionalParams, ServiceCallback<PagedMembersResult>)
getConversationPagedMembers(string, ServiceCallback<PagedMembersResult>)
getConversations(ConversationsGetConversationsOptionalParams)

Auflisten der Unterhaltungen, an denen dieser Bot teilgenommen hat. GET von dieser Methode mit einem Skip-Token

Der Rückgabewert ist ein ConversationsResult, das ein Array von ConversationMembers und ein Skip-Token enthält. Wenn das Skip-Token nicht leer ist, gibt es weitere Werte, die zurückgegeben werden sollen. Rufen Sie diese Methode erneut mit dem zurückgegebenen Token auf, um weitere Werte abzurufen.

Jedes ConversationMembers -Objekt enthält die ID der Unterhaltung und ein Array von ChannelAccounts, die die Mitglieder der Unterhaltung beschreiben.

getConversations(ConversationsGetConversationsOptionalParams, ServiceCallback<ConversationsResult>)
getConversations(ServiceCallback<ConversationsResult>)
replyToActivity(string, string, Partial<Activity>, RequestOptionsBase)

Mit dieser Methode können Sie auf eine Aktivität antworten. Dies unterscheidet sich geringfügig von SendToConversation().

  • SendToConversation(conversationId) – fügt die Aktivität entsprechend dem Zeitstempel oder der Semantik des Kanals an das Ende der Unterhaltung an.
  • ReplyToActivity(conversationId,ActivityId) – fügt die Aktivität als Antwort auf eine andere Aktivität hinzu, wenn der Kanal sie unterstützt. Wenn der Kanal keine geschachtelten Antworten unterstützt, greift ReplyToActivity auf SendToConversation zurück.

Verwenden Sie ReplyToActivity, wenn Sie auf eine bestimmte Aktivität in der Unterhaltung antworten.

Verwenden Sie SendToConversation in allen anderen Fällen.

replyToActivity(string, string, Partial<Activity>, RequestOptionsBase, ServiceCallback<ResourceResponse>)
replyToActivity(string, string, Partial<Activity>, ServiceCallback<ResourceResponse>)
sendConversationHistory(string, Transcript, RequestOptionsBase)

Mit dieser Methode können Sie die historischen Aktivitäten in die Unterhaltung hochladen. Der Absender muss sicherstellen, dass die historischen Aktivitäten eindeutige IDs und entsprechende Zeitstempel aufweisen. Die IDs werden vom Client verwendet, um doppelte Aktivitäten zu behandeln, und die Zeitstempel werden vom Client verwendet, um die Aktivitäten in der richtigen Reihenfolge zu rendern.

sendConversationHistory(string, Transcript, RequestOptionsBase, ServiceCallback<ResourceResponse>)
sendConversationHistory(string, Transcript, ServiceCallback<ResourceResponse>)
sendToConversation(string, Partial<Activity>, RequestOptionsBase)

Mit dieser Methode können Sie eine Aktivität an das Ende einer Unterhaltung senden. Dies unterscheidet sich geringfügig von ReplyToActivity().

  • SendToConversation(conversationId) – fügt die Aktivität entsprechend dem Zeitstempel oder der Semantik des Kanals an das Ende der Unterhaltung an.
  • ReplyToActivity(conversationId,ActivityId) – fügt die Aktivität als Antwort auf eine andere Aktivität hinzu, wenn der Kanal sie unterstützt. Wenn der Kanal keine geschachtelten Antworten unterstützt, greift ReplyToActivity auf SendToConversation zurück.

Verwenden Sie ReplyToActivity, wenn Sie auf eine bestimmte Aktivität in der Unterhaltung antworten.

Verwenden Sie SendToConversation in allen anderen Fällen.

sendToConversation(string, Partial<Activity>, RequestOptionsBase, ServiceCallback<ResourceResponse>)
sendToConversation(string, Partial<Activity>, ServiceCallback<ResourceResponse>)
updateActivity(string, string, Partial<Activity>, RequestOptionsBase)

Bearbeiten einer vorhandenen Aktivität. In einigen Kanälen können Sie eine vorhandene Aktivität bearbeiten, um den neuen Status einer Bot-Unterhaltung widerzuspiegeln.

Beispielsweise können Sie Schaltflächen entfernen, nachdem jemand auf die Schaltfläche "Genehmigen" geklickt hat.

updateActivity(string, string, Partial<Activity>, RequestOptionsBase, ServiceCallback<ResourceResponse>)
updateActivity(string, string, Partial<Activity>, ServiceCallback<ResourceResponse>)
uploadAttachment(string, AttachmentData, RequestOptionsBase)

Laden Sie eine Anlage direkt in den BLOB-Speicher eines Kanals hoch. Dies ist nützlich, da Sie Daten in einem kompatiblen Speicher speichern können, wenn es um Unternehmen geht.

Die Antwort ist eine ResourceResponse, die eine AttachmentId enthält, die für die Verwendung mit der Anlagen-API geeignet ist.

uploadAttachment(string, AttachmentData, RequestOptionsBase, ServiceCallback<ResourceResponse>)
uploadAttachment(string, AttachmentData, ServiceCallback<ResourceResponse>)

Details zum Konstruktor

Conversations(ConnectorClientContext)

Erstellen Sie eine Unterhaltung.

new Conversations(client: ConnectorClientContext)

Parameter

client
ConnectorClientContext

Verweisen auf den Dienstclient.

Details zur Methode

createConversation(ConversationParameters, RequestOptionsBase)

Erstellen Sie eine neue Unterhaltung. POST zu dieser Methode mit einer

  • Bot, der der Bot ist, der die Unterhaltung erstellt
  • IsGroup auf "true" festgelegt, wenn dies keine direkte Nachricht ist (Standardwert ist "false")
  • Array, das die Mitglieder enthält, die in die Unterhaltung aufgenommen werden sollen

Der Rückgabewert ist ein ResourceResponse,der eine Unterhaltungs-ID enthält, die für die Verwendung in der Nachrichtennutzlast und REST-API-URIs geeignet ist.

Die meisten Kanäle unterstützen nur die Semantik von Bots, die eine direkte Nachrichtenunterhaltung initiieren. Ein Beispiel dafür wäre:

const resource = await connector.conversations.createConversation({
    bot,
    members: [{ id: 'user1' }]
});
await connector.conversations.sendToConversation(resource.Id, ... );
function createConversation(parameters: ConversationParameters, options?: RequestOptionsBase): Promise<Models.ConversationsCreateConversationResponse>

Parameter

parameters

ConversationParameters

Parameter zum Erstellen der Unterhaltung aus

options

RequestOptionsBase

Gibt zurück

Promise<Models.ConversationsCreateConversationResponse>

Zusage<Models.ConversationsCreateConversationResponse>

createConversation(ConversationParameters, RequestOptionsBase, ServiceCallback<ConversationResourceResponse>)

function createConversation(parameters: ConversationParameters, options: RequestOptionsBase, callback: ServiceCallback<ConversationResourceResponse>)

Parameter

parameters

ConversationParameters

Parameter zum Erstellen der Unterhaltung aus

options

RequestOptionsBase

Die optionalen Parameter

callback

ServiceCallback<ConversationResourceResponse>

Der Rückruf

createConversation(ConversationParameters, ServiceCallback<ConversationResourceResponse>)

function createConversation(parameters: ConversationParameters, callback: ServiceCallback<ConversationResourceResponse>)

Parameter

parameters

ConversationParameters

Parameter zum Erstellen der Unterhaltung aus

callback

ServiceCallback<ConversationResourceResponse>

Der Rückruf

deleteActivity(string, string, RequestOptionsBase)

Löschen einer vorhandenen Aktivität. In einigen Kanälen können Sie eine vorhandene Aktivität löschen, und wenn die Methode erfolgreich verläuft, wird die angegebene Aktivität entfernt.

function deleteActivity(conversationId: string, activityId: string, options?: RequestOptionsBase): Promise<RestResponse>

Parameter

conversationId

string

Unterhaltungs-ID

activityId

string

activityId to delete

options

RequestOptionsBase

Gibt zurück

Promise<RestResponse>

Zusage<msRest.RestResponse>

deleteActivity(string, string, RequestOptionsBase, ServiceCallback<void>)

function deleteActivity(conversationId: string, activityId: string, options: RequestOptionsBase, callback: ServiceCallback<void>)

Parameter

conversationId

string

Unterhaltungs-ID

activityId

string

activityId to delete

options

RequestOptionsBase

Die optionalen Parameter

callback

ServiceCallback<void>

Der Rückruf

deleteActivity(string, string, ServiceCallback<void>)

function deleteActivity(conversationId: string, activityId: string, callback: ServiceCallback<void>)

Parameter

conversationId

string

Unterhaltungs-ID

activityId

string

activityId to delete

callback

ServiceCallback<void>

Der Rückruf

deleteConversationMember(string, string, RequestOptionsBase)

Löscht ein Mitglied aus einer Unterhaltung. Diese REST-API akzeptiert eine ConversationId und eine MemberId (vom Typ Zeichenfolge) und entfernt dieses Mitglied aus der Unterhaltung. Wenn dieses Mitglied das letzte Mitglied der Unterhaltung war, wird die Unterhaltung ebenfalls gelöscht.

function deleteConversationMember(conversationId: string, memberId: string, options?: RequestOptionsBase): Promise<RestResponse>

Parameter

conversationId

string

Unterhaltungs-ID

memberId

string

ID des Mitglieds, das aus dieser Unterhaltung gelöscht werden soll

options

RequestOptionsBase

Gibt zurück

Promise<RestResponse>

Zusage<msRest.RestResponse>

deleteConversationMember(string, string, RequestOptionsBase, ServiceCallback<void>)

function deleteConversationMember(conversationId: string, memberId: string, options: RequestOptionsBase, callback: ServiceCallback<void>)

Parameter

conversationId

string

Unterhaltungs-ID

memberId

string

ID des Mitglieds, das aus dieser Unterhaltung gelöscht werden soll

options

RequestOptionsBase

Die optionalen Parameter

callback

ServiceCallback<void>

Der Rückruf

deleteConversationMember(string, string, ServiceCallback<void>)

function deleteConversationMember(conversationId: string, memberId: string, callback: ServiceCallback<void>)

Parameter

conversationId

string

Unterhaltungs-ID

memberId

string

ID des Mitglieds, das aus dieser Unterhaltung gelöscht werden soll

callback

ServiceCallback<void>

Der Rückruf

getActivityMembers(string, string, RequestOptionsBase)

Aufzählen der Mitglieder einer Aktivität. Diese REST-API akzeptiert eine ConversationId und eine ActivityId und gibt ein Array von ChannelAccount-Objekten zurück, die die Mitglieder der bestimmten Aktivität in der Unterhaltung darstellen.

function getActivityMembers(conversationId: string, activityId: string, options?: RequestOptionsBase): Promise<Models.ConversationsGetActivityMembersResponse>

Parameter

conversationId

string

Unterhaltungs-ID

activityId

string

Aktivitäts-ID

options

RequestOptionsBase

Gibt zurück

Promise<Models.ConversationsGetActivityMembersResponse>

Promise<Models.ConversationsGetActivityMembersResponse>

getActivityMembers(string, string, RequestOptionsBase, ServiceCallback<ChannelAccount[]>)

function getActivityMembers(conversationId: string, activityId: string, options: RequestOptionsBase, callback: ServiceCallback<ChannelAccount[]>)

Parameter

conversationId

string

Unterhaltungs-ID

activityId

string

Aktivitäts-ID

options

RequestOptionsBase

Die optionalen Parameter

callback

ServiceCallback<ChannelAccount[]>

Der Rückruf

getActivityMembers(string, string, ServiceCallback<ChannelAccount[]>)

function getActivityMembers(conversationId: string, activityId: string, callback: ServiceCallback<ChannelAccount[]>)

Parameter

conversationId

string

Unterhaltungs-ID

activityId

string

Aktivitäts-ID

callback

ServiceCallback<ChannelAccount[]>

Der Rückruf

getConversationMember(string, string, RequestOptionsBase | ServiceCallback<ChannelAccount[]>, ServiceCallback<ChannelAccount[]>)

function getConversationMember(conversationId: string, memberId: string, options?: RequestOptionsBase | ServiceCallback<ChannelAccount[]>, callback?: ServiceCallback<ChannelAccount[]>): Promise<Models.ConversationsGetConversationMemberResponse>

Parameter

conversationId

string

Unterhaltungs-ID

memberId

string

MemberId für den Benutzer

options

RequestOptionsBase | ServiceCallback<ChannelAccount[]>

Die optionalen Parameter

callback

ServiceCallback<ChannelAccount[]>

Der Rückruf

Gibt zurück

Promise<Models.ConversationsGetConversationMemberResponse>

getConversationMembers(string, RequestOptionsBase)

Aufzählen der Mitglieder einer Unterhaltung. Diese REST-API akzeptiert eine ConversationId und gibt ein Array von ChannelAccount-Objekten zurück, die die Mitglieder der Unterhaltung darstellen.

function getConversationMembers(conversationId: string, options?: RequestOptionsBase): Promise<Models.ConversationsGetConversationMembersResponse>

Parameter

conversationId

string

Unterhaltungs-ID

options

RequestOptionsBase

Gibt zurück

Promise<Models.ConversationsGetConversationMembersResponse>

Promise<Models.ConversationsGetConversationMembersResponse>

getConversationMembers(string, RequestOptionsBase, ServiceCallback<ChannelAccount[]>)

function getConversationMembers(conversationId: string, options: RequestOptionsBase, callback: ServiceCallback<ChannelAccount[]>)

Parameter

conversationId

string

Unterhaltungs-ID

options

RequestOptionsBase

Die optionalen Parameter

callback

ServiceCallback<ChannelAccount[]>

Der Rückruf

getConversationMembers(string, ServiceCallback<ChannelAccount[]>)

function getConversationMembers(conversationId: string, callback: ServiceCallback<ChannelAccount[]>)

Parameter

conversationId

string

Unterhaltungs-ID

callback

ServiceCallback<ChannelAccount[]>

Der Rückruf

getConversationPagedMembers(string, ConversationsGetConversationPagedMembersOptionalParams)

Auflisten der Mitglieder einer Unterhaltung um jeweils eine Seite. Diese REST-API verwendet eine ConversationId. Optional kann ein pageSize- und/oder fortsetzungstoken bereitgestellt werden. Es gibt ein PagedMembersResult zurück, das ein Array von ChannelAccounts enthält, das die Mitglieder der Unterhaltung darstellt, und ein Fortsetzungstoken, das zum Abrufen weiterer Werte verwendet werden kann.

Eine Seite mit ChannelAccounts-Datensätzen wird mit jedem Anruf zurückgegeben. Die Anzahl der Datensätze auf einer Seite kann zwischen Kanälen und Anrufen variieren. Der pageSize-Parameter kann als Vorschlag verwendet werden. Wenn keine weiteren Ergebnisse vorhanden sind, enthält die Antwort kein Fortsetzungstoken. Wenn keine Mitglieder in der Unterhaltung vorhanden sind, sind die Mitglieder leer oder nicht in der Antwort vorhanden.

Eine Antwort auf eine Anforderung mit einem Fortsetzungstoken aus einer vorherigen Anforderung kann selten Mitglieder aus einer vorherigen Anforderung zurückgeben.

function getConversationPagedMembers(conversationId: string, options?: ConversationsGetConversationPagedMembersOptionalParams): Promise<Models.ConversationsGetConversationPagedMembersResponse>

Parameter

conversationId

string

Unterhaltungs-ID

Gibt zurück

Promise<Models.ConversationsGetConversationPagedMembersResponse>

Promise<Models.ConversationsGetConversationPagedMembersResponse>

getConversationPagedMembers(string, ConversationsGetConversationPagedMembersOptionalParams, ServiceCallback<PagedMembersResult>)

function getConversationPagedMembers(conversationId: string, options: ConversationsGetConversationPagedMembersOptionalParams, callback: ServiceCallback<PagedMembersResult>)

Parameter

conversationId

string

Unterhaltungs-ID

callback

ServiceCallback<PagedMembersResult>

Der Rückruf

getConversationPagedMembers(string, ServiceCallback<PagedMembersResult>)

function getConversationPagedMembers(conversationId: string, callback: ServiceCallback<PagedMembersResult>)

Parameter

conversationId

string

Unterhaltungs-ID

callback

ServiceCallback<PagedMembersResult>

Der Rückruf

getConversations(ConversationsGetConversationsOptionalParams)

Auflisten der Unterhaltungen, an denen dieser Bot teilgenommen hat. GET von dieser Methode mit einem Skip-Token

Der Rückgabewert ist ein ConversationsResult, das ein Array von ConversationMembers und ein Skip-Token enthält. Wenn das Skip-Token nicht leer ist, gibt es weitere Werte, die zurückgegeben werden sollen. Rufen Sie diese Methode erneut mit dem zurückgegebenen Token auf, um weitere Werte abzurufen.

Jedes ConversationMembers -Objekt enthält die ID der Unterhaltung und ein Array von ChannelAccounts, die die Mitglieder der Unterhaltung beschreiben.

function getConversations(options?: ConversationsGetConversationsOptionalParams): Promise<Models.ConversationsGetConversationsResponse>

Parameter

Gibt zurück

Promise<Models.ConversationsGetConversationsResponse>

Promise<Models.ConversationsGetConversationsResponse>

getConversations(ConversationsGetConversationsOptionalParams, ServiceCallback<ConversationsResult>)

function getConversations(options: ConversationsGetConversationsOptionalParams, callback: ServiceCallback<ConversationsResult>)

Parameter

options
ConversationsGetConversationsOptionalParams

Die optionalen Parameter

callback

ServiceCallback<ConversationsResult>

Der Rückruf

getConversations(ServiceCallback<ConversationsResult>)

function getConversations(callback: ServiceCallback<ConversationsResult>)

Parameter

callback

ServiceCallback<ConversationsResult>

Der Rückruf

replyToActivity(string, string, Partial<Activity>, RequestOptionsBase)

Mit dieser Methode können Sie auf eine Aktivität antworten. Dies unterscheidet sich geringfügig von SendToConversation().

  • SendToConversation(conversationId) – fügt die Aktivität entsprechend dem Zeitstempel oder der Semantik des Kanals an das Ende der Unterhaltung an.
  • ReplyToActivity(conversationId,ActivityId) – fügt die Aktivität als Antwort auf eine andere Aktivität hinzu, wenn der Kanal sie unterstützt. Wenn der Kanal keine geschachtelten Antworten unterstützt, greift ReplyToActivity auf SendToConversation zurück.

Verwenden Sie ReplyToActivity, wenn Sie auf eine bestimmte Aktivität in der Unterhaltung antworten.

Verwenden Sie SendToConversation in allen anderen Fällen.

function replyToActivity(conversationId: string, activityId: string, activity: Partial<Activity>, options?: RequestOptionsBase): Promise<Models.ConversationsReplyToActivityResponse>

Parameter

conversationId

string

Unterhaltungs-ID

activityId

string

activityId, auf die die Antwort lautet (OPTIONAL)

activity

Partial<Activity>

Zu sendende Aktivität

options

RequestOptionsBase

Gibt zurück

Promise<Models.ConversationsReplyToActivityResponse>

Zusage<Models.ConversationsReplyToActivityResponse>

replyToActivity(string, string, Partial<Activity>, RequestOptionsBase, ServiceCallback<ResourceResponse>)

function replyToActivity(conversationId: string, activityId: string, activity: Partial<Activity>, options: RequestOptionsBase, callback: ServiceCallback<ResourceResponse>)

Parameter

conversationId

string

Unterhaltungs-ID

activityId

string

activityId, auf die die Antwort lautet (OPTIONAL)

activity

Partial<Activity>

Zu sendende Aktivität

options

RequestOptionsBase

Die optionalen Parameter

callback

ServiceCallback<ResourceResponse>

Der Rückruf

replyToActivity(string, string, Partial<Activity>, ServiceCallback<ResourceResponse>)

function replyToActivity(conversationId: string, activityId: string, activity: Partial<Activity>, callback: ServiceCallback<ResourceResponse>)

Parameter

conversationId

string

Unterhaltungs-ID

activityId

string

activityId, auf die die Antwort lautet (OPTIONAL)

activity

Partial<Activity>

Zu sendende Aktivität

callback

ServiceCallback<ResourceResponse>

Der Rückruf

sendConversationHistory(string, Transcript, RequestOptionsBase)

Mit dieser Methode können Sie die historischen Aktivitäten in die Unterhaltung hochladen. Der Absender muss sicherstellen, dass die historischen Aktivitäten eindeutige IDs und entsprechende Zeitstempel aufweisen. Die IDs werden vom Client verwendet, um doppelte Aktivitäten zu behandeln, und die Zeitstempel werden vom Client verwendet, um die Aktivitäten in der richtigen Reihenfolge zu rendern.

function sendConversationHistory(conversationId: string, history: Transcript, options?: RequestOptionsBase): Promise<Models.ConversationsSendConversationHistoryResponse>

Parameter

conversationId

string

Unterhaltungs-ID

history

Transcript

Historische Aktivitäten

options

RequestOptionsBase

Gibt zurück

Promise<Models.ConversationsSendConversationHistoryResponse>

Promise<Models.ConversationsSendConversationHistoryResponse>

sendConversationHistory(string, Transcript, RequestOptionsBase, ServiceCallback<ResourceResponse>)

function sendConversationHistory(conversationId: string, history: Transcript, options: RequestOptionsBase, callback: ServiceCallback<ResourceResponse>)

Parameter

conversationId

string

Unterhaltungs-ID

history

Transcript

Historische Aktivitäten

options

RequestOptionsBase

Die optionalen Parameter

callback

ServiceCallback<ResourceResponse>

Der Rückruf

sendConversationHistory(string, Transcript, ServiceCallback<ResourceResponse>)

function sendConversationHistory(conversationId: string, history: Transcript, callback: ServiceCallback<ResourceResponse>)

Parameter

conversationId

string

Unterhaltungs-ID

history

Transcript

Historische Aktivitäten

callback

ServiceCallback<ResourceResponse>

Der Rückruf

sendToConversation(string, Partial<Activity>, RequestOptionsBase)

Mit dieser Methode können Sie eine Aktivität an das Ende einer Unterhaltung senden. Dies unterscheidet sich geringfügig von ReplyToActivity().

  • SendToConversation(conversationId) – fügt die Aktivität entsprechend dem Zeitstempel oder der Semantik des Kanals an das Ende der Unterhaltung an.
  • ReplyToActivity(conversationId,ActivityId) – fügt die Aktivität als Antwort auf eine andere Aktivität hinzu, wenn der Kanal sie unterstützt. Wenn der Kanal keine geschachtelten Antworten unterstützt, greift ReplyToActivity auf SendToConversation zurück.

Verwenden Sie ReplyToActivity, wenn Sie auf eine bestimmte Aktivität in der Unterhaltung antworten.

Verwenden Sie SendToConversation in allen anderen Fällen.

function sendToConversation(conversationId: string, activity: Partial<Activity>, options?: RequestOptionsBase): Promise<Models.ConversationsSendToConversationResponse>

Parameter

conversationId

string

Unterhaltungs-ID

activity

Partial<Activity>

Zu sendende Aktivität

options

RequestOptionsBase

Gibt zurück

Promise<Models.ConversationsSendToConversationResponse>

Promise<Models.ConversationsSendToConversationResponse>

sendToConversation(string, Partial<Activity>, RequestOptionsBase, ServiceCallback<ResourceResponse>)

function sendToConversation(conversationId: string, activity: Partial<Activity>, options: RequestOptionsBase, callback: ServiceCallback<ResourceResponse>)

Parameter

conversationId

string

Unterhaltungs-ID

activity

Partial<Activity>

Zu sendende Aktivität

options

RequestOptionsBase

Die optionalen Parameter

callback

ServiceCallback<ResourceResponse>

Der Rückruf

sendToConversation(string, Partial<Activity>, ServiceCallback<ResourceResponse>)

function sendToConversation(conversationId: string, activity: Partial<Activity>, callback: ServiceCallback<ResourceResponse>)

Parameter

conversationId

string

Unterhaltungs-ID

activity

Partial<Activity>

Zu sendende Aktivität

callback

ServiceCallback<ResourceResponse>

Der Rückruf

updateActivity(string, string, Partial<Activity>, RequestOptionsBase)

Bearbeiten einer vorhandenen Aktivität. In einigen Kanälen können Sie eine vorhandene Aktivität bearbeiten, um den neuen Status einer Bot-Unterhaltung widerzuspiegeln.

Beispielsweise können Sie Schaltflächen entfernen, nachdem jemand auf die Schaltfläche "Genehmigen" geklickt hat.

function updateActivity(conversationId: string, activityId: string, activity: Partial<Activity>, options?: RequestOptionsBase): Promise<Models.ConversationsUpdateActivityResponse>

Parameter

conversationId

string

Unterhaltungs-ID

activityId

string

activityId to update

activity

Partial<Activity>

Ersetzungsaktivität

options

RequestOptionsBase

Gibt zurück

Promise<Models.ConversationsUpdateActivityResponse>

Zusage<Models.ConversationsUpdateActivityResponse>

updateActivity(string, string, Partial<Activity>, RequestOptionsBase, ServiceCallback<ResourceResponse>)

function updateActivity(conversationId: string, activityId: string, activity: Partial<Activity>, options: RequestOptionsBase, callback: ServiceCallback<ResourceResponse>)

Parameter

conversationId

string

Unterhaltungs-ID

activityId

string

activityId to update

activity

Partial<Activity>

Ersetzungsaktivität

options

RequestOptionsBase

Die optionalen Parameter

callback

ServiceCallback<ResourceResponse>

Der Rückruf

updateActivity(string, string, Partial<Activity>, ServiceCallback<ResourceResponse>)

function updateActivity(conversationId: string, activityId: string, activity: Partial<Activity>, callback: ServiceCallback<ResourceResponse>)

Parameter

conversationId

string

Unterhaltungs-ID

activityId

string

activityId to update

activity

Partial<Activity>

Ersetzungsaktivität

callback

ServiceCallback<ResourceResponse>

Der Rückruf

uploadAttachment(string, AttachmentData, RequestOptionsBase)

Laden Sie eine Anlage direkt in den BLOB-Speicher eines Kanals hoch. Dies ist nützlich, da Sie Daten in einem kompatiblen Speicher speichern können, wenn es um Unternehmen geht.

Die Antwort ist eine ResourceResponse, die eine AttachmentId enthält, die für die Verwendung mit der Anlagen-API geeignet ist.

function uploadAttachment(conversationId: string, attachmentUpload: AttachmentData, options?: RequestOptionsBase): Promise<Models.ConversationsUploadAttachmentResponse>

Parameter

conversationId

string

Unterhaltungs-ID

attachmentUpload

AttachmentData

Anlagendaten

options

RequestOptionsBase

Gibt zurück

Promise<Models.ConversationsUploadAttachmentResponse>

Promise<Models.ConversationsUploadAttachmentResponse>

uploadAttachment(string, AttachmentData, RequestOptionsBase, ServiceCallback<ResourceResponse>)

function uploadAttachment(conversationId: string, attachmentUpload: AttachmentData, options: RequestOptionsBase, callback: ServiceCallback<ResourceResponse>)

Parameter

conversationId

string

Unterhaltungs-ID

attachmentUpload

AttachmentData

Anlagendaten

options

RequestOptionsBase

Die optionalen Parameter

callback

ServiceCallback<ResourceResponse>

Der Rückruf

uploadAttachment(string, AttachmentData, ServiceCallback<ResourceResponse>)

function uploadAttachment(conversationId: string, attachmentUpload: AttachmentData, callback: ServiceCallback<ResourceResponse>)

Parameter

conversationId

string

Unterhaltungs-ID

attachmentUpload

AttachmentData

Anlagendaten

callback

ServiceCallback<ResourceResponse>

Der Rückruf