Een gesprek starten in Direct Line API 1.1
Belangrijk
In dit artikel wordt beschreven hoe u een gesprek start met behulp van Direct Line API 1.1. Als u een nieuwe verbinding maakt tussen uw clienttoepassing en bot, gebruikt u in plaats daarvan Direct Line API 3.0.
Direct Line gesprekken expliciet worden geopend door clients en kunnen worden uitgevoerd zolang de bot en client deelnemen en geldige referenties hebben. Terwijl het gesprek is geopend, kunnen zowel de bot als de client berichten verzenden. Meerdere clients kunnen verbinding maken met een bepaald gesprek en elke client kan namens meerdere gebruikers deelnemen.
Een nieuw gesprek openen
Als u een nieuw gesprek met een bot wilt openen, geeft u deze aanvraag uit:
POST https://directline.botframework.com/api/conversations
Authorization: Bearer SECRET_OR_TOKEN
De volgende fragmenten bevatten een voorbeeld van de aanvraag en reactie van het gesprek starten.
Aanvraag
POST https://directline.botframework.com/api/conversations
Authorization: Bearer RCurR_XV9ZA.cwA.BKA.iaJrC8xpy8qbOF5xnR2vtCX7CZj0LdjAPGfiCpg4Fv0y8qbOF5xPGfiCpg4Fv0y8qqbOF5x8qbOF5xn
Antwoord
Als de aanvraag is geslaagd, bevat het antwoord een id voor het gesprek, een token en een waarde die het aantal seconden aangeeft totdat het token verloopt.
HTTP/1.1 200 OK
[other headers]
{
"conversationId": "abc123",
"token": "RCurR_XV9ZA.cwA.BKA.iaJrC8xpy8qbOF5xnR2vtCX7CZj0LdjAPGfiCpg4Fv0y8qbOF5xPGfiCpg4Fv0y8qqbOF5x8qbOF5xn",
"expires_in": 1800
}
Gesprek starten versus token genereren
De bewerking Gesprek starten (POST /api/conversations) is vergelijkbaar met de bewerking Token genereren (POST /api/tokens/conversation) in dat beide bewerkingen een token bewerking retourneren die kan worden gebruikt voor toegang tot één gesprek. De bewerking Gesprek starten start echter ook het gesprek en neemt contact op met de bot, terwijl de bewerking Token genereren geen van deze dingen doet.
Als u het gesprek onmiddellijk wilt starten, gebruikt u de bewerking Gesprek starten. Als u van plan bent het token te distribueren naar clients en wilt dat ze het gesprek starten, gebruikt u in plaats daarvan de bewerking Token genereren .