Starten einer Unterhaltung in Direct Line API 1.1
Wichtig
Dieser Artikel beschreibt, wie Sie eine Unterhaltung mit Direct Line API v1.1 starten. Wenn Sie eine neue Verbindung zwischen Ihrer Clientanwendung und Ihrem Bot erstellen, verwenden Sie stattdessen Direct Line API 3.0.
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. Solange die Unterhaltung geöffnet ist, können der Bot und der Client Nachrichten senden. Es können mehrere Clients eine Verbindung mit einer bestimmten Unterhaltung herstellen, und jeder Client kann im Namen mehrerer Benutzer teilnehmen.
Öffnen einer neuen Unterhaltung
Um eine neue Unterhaltung mit einem Bot zu öffnen, erstellen Sie diese Anforderung:
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.
Anforderung
POST https://directline.botframework.com/api/conversations
Authorization: Bearer RCurR_XV9ZA.cwA.BKA.iaJrC8xpy8qbOF5xnR2vtCX7CZj0LdjAPGfiCpg4Fv0y8qbOF5xPGfiCpg4Fv0y8qqbOF5x8qbOF5xn
Antwort
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.
HTTP/1.1 200 OK
[other headers]
{
"conversationId": "abc123",
"token": "RCurR_XV9ZA.cwA.BKA.iaJrC8xpy8qbOF5xnR2vtCX7CZj0LdjAPGfiCpg4Fv0y8qbOF5xPGfiCpg4Fv0y8qqbOF5x8qbOF5xn",
"expires_in": 1800
}
Starten einer Unterhaltung vs. Generieren eines Tokens
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. 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.
Wenn Sie die Unterhaltung sofort beginnen möchten, verwenden Sie den Vorgang zum Starten einer Unterhaltung. Wenn Sie beabsichtigen, das Token an Clients zu verteilen, und möchten, dass diese die Unterhaltung initiieren, verwenden Sie stattdessen den Vorgang Token generieren.