Starta en konversation i Direct Line API 1.1
Viktigt
Den här artikeln beskriver hur du startar en konversation med Direct Line API 1.1. Om du skapar en ny anslutning mellan klientprogrammet och roboten använder du Direct Line API 3.0 i stället.
Direct Line konversationer öppnas uttryckligen av klienter och kan köras så länge roboten och klienten deltar och har giltiga autentiseringsuppgifter. Medan konversationen är öppen kan både roboten och klienten skicka meddelanden. Fler än en klient kan ansluta till en viss konversation och varje klient kan delta för flera användares räkning.
Öppna en ny konversation
Om du vill öppna en ny konversation med en robot utfärdar du den här begäran:
POST https://directline.botframework.com/api/conversations
Authorization: Bearer SECRET_OR_TOKEN
Följande kodfragment innehåller ett exempel på begäran och svar för Starta konversation.
Förfrågan
POST https://directline.botframework.com/api/conversations
Authorization: Bearer RCurR_XV9ZA.cwA.BKA.iaJrC8xpy8qbOF5xnR2vtCX7CZj0LdjAPGfiCpg4Fv0y8qbOF5xPGfiCpg4Fv0y8qqbOF5x8qbOF5xn
Svarsåtgärder
Om begäran lyckas innehåller svaret ett ID för konversationen, en token och ett värde som anger antalet sekunder tills token upphör att gälla.
HTTP/1.1 200 OK
[other headers]
{
"conversationId": "abc123",
"token": "RCurR_XV9ZA.cwA.BKA.iaJrC8xpy8qbOF5xnR2vtCX7CZj0LdjAPGfiCpg4Fv0y8qbOF5xPGfiCpg4Fv0y8qqbOF5x8qbOF5xn",
"expires_in": 1800
}
Starta konversation kontra generera token
Åtgärden Starta konversation (POST /api/conversations) liknar åtgärden Generera token (POST /api/tokens/conversation) eftersom båda åtgärderna returnerar en token som kan användas för att komma åt en enda konversation. Men åtgärden Starta konversation startar även konversationen och kontaktar roboten, medan åtgärden Generera token inte gör något av detta.
Om du tänker starta konversationen omedelbart använder du åtgärden Starta konversation. Om du planerar att distribuera token till klienter och vill att de ska starta konversationen använder du åtgärden Generera token i stället.