Starten einer Konversation in der Direct Line-API 1,1Start a conversation in Direct Line API 1.1

Wichtig

Dieser Artikel beschreibt, wie Sie eine Unterhaltung mit Direct Line API v1.1 starten.This article describes how to start a conversation using Direct Line API 1.1. Wenn Sie eine neue Verbindung zwischen Ihrer Clientanwendung und dem Bot herstellen, verwenden Sie stattdessen Direct Line API 3.0.If you are creating a new connection between your client application and bot, use Direct Line API 3.0 instead.

Direct Line-Unterhaltungen werden explizit von Clients geöffnet und können solange ausgeführt werden, wie Bot und Client daran teilnehmen und gültige Anmeldeinformationen aufweisen.Direct Line conversations are explicitly opened by clients and may run as long as the bot and client participate and have valid credentials. Solange die Unterhaltung geöffnet ist, können der Bot und der Client Nachrichten senden.While the conversation is open, both the bot and client may send messages. Es können mehrere Clients eine Verbindung mit einer bestimmten Unterhaltung herstellen, und jeder Client kann im Namen mehrerer Benutzer teilnehmen.More than one client may connect to a given conversation and each client may participate on behalf of multiple users.

Öffnen einer neuen UnterhaltungOpen a new conversation

Um eine neue Unterhaltung mit einem Bot zu öffnen, erstellen Sie diese Anforderung:To open a new conversation with a bot, issue this request:

POST https://directline.botframework.com/api/conversations
Authorization: Bearer SECRET_OR_TOKEN

Die folgenden Codeausschnitte enthalten ein Beispiel für die Anforderung zum Starten einer Unterhaltung und die Antwort darauf.The following snippets provide an example of the Start Conversation request and response.

AnforderungRequest

POST https://directline.botframework.com/api/conversations
Authorization: Bearer RCurR_XV9ZA.cwA.BKA.iaJrC8xpy8qbOF5xnR2vtCX7CZj0LdjAPGfiCpg4Fv0y8qbOF5xPGfiCpg4Fv0y8qqbOF5x8qbOF5xn

AntwortResponse

Wenn die Anforderung erfolgreich war, enthält die Antwort eine ID für die Unterhaltung, ein Token und einen Wert, der die Anzahl von Sekunden bis zum Ablauf des Tokens angibt.If the request is successful, the response will contain an ID for the conversation, a token, and a value that indicates the number of seconds until the token expires.

HTTP/1.1 200 OK
[other headers]
{
  "conversationId": "abc123",
  "token": "RCurR_XV9ZA.cwA.BKA.iaJrC8xpy8qbOF5xnR2vtCX7CZj0LdjAPGfiCpg4Fv0y8qbOF5xPGfiCpg4Fv0y8qqbOF5x8qbOF5xn",
  "expires_in": 1800
}

Starten einer Unterhaltung vs. Generieren eines TokensStart Conversation versus Generate Token

Der Vorgang „Unterhaltung starten“ (POST /api/conversations) ist vergleichbar mit dem Vorgang Token generieren (POST /api/tokens/conversation). Beide Vorgänge geben ein token zurück, mit dem auf eine einzelne Unterhaltung zugegriffen werden kann.The Start Conversation operation (POST /api/conversations) is similar to the Generate Token operation (POST /api/tokens/conversation) in that both operations return a token that can be used to access a single conversation. Der Vorgang zum Starten einer Unterhaltung beginnt jedoch die Unterhaltung und kontaktiert den Bot, wohingegen das Generieren eines Tokens weder eine Unterhaltung startet noch einen Bot kontaktiert.However, the Start Conversation operation also starts the conversation and contacts the bot, whereas the Generate Token operation does neither of these things.

Wenn Sie die Unterhaltung sofort beginnen möchten, verwenden Sie den Vorgang zum Starten einer Unterhaltung.If you intend to start the conversation immediately, use the Start Conversation operation. Wenn Sie beabsichtigen, das Token an Clients zu verteilen, und möchten, dass diese die Unterhaltung initiieren, verwenden Sie stattdessen den Vorgang Token generieren.If you plan to distribute the token to clients and want them to initiate the conversation, use the Generate Token operation instead.

Zusätzliche RessourcenAdditional resources