Direct Line API 3.0에서 대화 시작
직접 회선 대화는 클라이언트에서 명시적으로 열고, 봇과 클라이언트가 참여하고 유효한 자격 증명이 있는 경우에만 실행될 수 있습니다. 대화가 열려 있는 동안 봇과 클라이언트 모두 메시지를 보낼 수 있습니다. 둘 이상의 클라이언트가 지정된 대화에 연결할 수 있으며 각 클라이언트는 여러 사용자를 대신하여 참여할 수 있습니다.
새 대화 열기
클라이언트에서 새 대화를 열려면 POST를 /v3/directline/conversations 엔드포인트로 실행합니다.
POST https://directline.botframework.com/v3/directline/conversations
Authorization: Bearer SECRET_OR_TOKEN
다음 코드 조각은 시작 대화 요청 및 응답의 예를 제공합니다.
요청
POST https://directline.botframework.com/v3/directline/conversations
Authorization: Bearer RCurR_XV9ZA.cwA.BKA.iaJrC8xpy8qbOF5xnR2vtCX7CZj0LdjAPGfiCpg4Fv0y8qbOF5xPGfiCpg4Fv0y8qqbOF5x8qbOF5xn
응답
요청이 성공하면 응답에는 대화 ID, 토큰, 토큰이 만료될 때까지의 시간(초)을 나타내는 값 및 클라이언트가 WebSocket 스트림을 통해 활동을 수신하는 데 사용할 수 있는 스트림 URL이 포함됩니다.
HTTP/1.1 201 Created
[other headers]
{
"conversationId": "abc123",
"token": "RCurR_XV9ZA.cwA.BKA.iaJrC8xpy8qbOF5xnR2vtCX7CZj0LdjAPGfiCpg4Fv0y8qbOF5xPGfiCpg4Fv0y8qqbOF5x8qbOF5xn",
"expires_in": 1800,
"streamUrl": "https://directline.botframework.com/v3/directline/conversations/abc123/stream?t=RCurR_XV9ZA.cwA..."
}
일반적으로 시작 대화 요청은 새 대화를 여는 데 사용되며 새 대화가 성공적으로 시작되면 HTTP 201 상태 코드가 반환됩니다. 그러나 클라이언트가 이전에 대화 시작 작업을 사용하여 대화를 시작하는 데 사용된 헤더에 Authorization Direct Line 토큰을 사용하여 시작 대화 요청을 제출하는 경우 HTTP 200 상태 코드가 반환되어 요청이 허용 가능하지만 대화가 만들어지지 않았음을 나타냅니다(이미 존재했기 때문에).
팁
WebSocket 스트림 URL에 연결하기까지 60초가 허용됩니다. 이 시간 동안 연결을 설정할 수 없는 경우 대화에 다시 연결하여 새 스트림 URL을 생성할 수 있습니다.
대화 시작 및 토큰 생성
대화 시작 작업(POST /v3/directline/conversations)은 두 작업 모두 단일 대화에 액세스하는 데 사용할 수 있는 토큰 생성 작업(POST /v3/directline/tokens/generate)과 유사합니다.token 그러나 대화 시작 작업은 대화를 시작하고, 봇에 연결하고, WebSocket 스트림 URL을 만드는 반면, 토큰 생성 작업은 이러한 작업을 수행하지 않습니다.
클라이언트와 즉시 대화를 시작하려면 대화 시작 작업을 사용합니다. 토큰을 클라이언트에 배포하고 대화를 시작하려는 경우 토큰 생성 작업을 대신 사용합니다.