Inicio de una conversación en Direct Line API 1.1
Importante
En este artículo se describe cómo iniciar una conversación mediante Direct Line API 1.1. Si va a crear una nueva conexión entre la aplicación cliente y el bot, use Direct Line API 3.0 en su lugar.
Los clientes pueden abrir las conversaciones de Direct Line explícitamente y estas se pueden ejecutar siempre y cuando el cliente y el bot participen y tengan credenciales válidas. Mientras la conversación está abierta, el bot y el cliente pueden enviar mensajes. Más de un cliente puede conectarse a una conversación determinada y cada cliente puede participar en nombre de varios usuarios.
Apertura de una nueva conversación
Para abrir una nueva conversación con un bot, emita esta solicitud:
POST https://directline.botframework.com/api/conversations
Authorization: Bearer SECRET_OR_TOKEN
Los fragmentos de código siguientes proporcionan un ejemplo de la solicitud y respuesta de Iniciar conversación.
Solicitud
POST https://directline.botframework.com/api/conversations
Authorization: Bearer RCurR_XV9ZA.cwA.BKA.iaJrC8xpy8qbOF5xnR2vtCX7CZj0LdjAPGfiCpg4Fv0y8qbOF5xPGfiCpg4Fv0y8qqbOF5x8qbOF5xn
Response
Si la solicitud es correcta, la respuesta contendrá un identificadorpara la conversación, un token y un valor que indica el número de segundos hasta que el token expira.
HTTP/1.1 200 OK
[other headers]
{
"conversationId": "abc123",
"token": "RCurR_XV9ZA.cwA.BKA.iaJrC8xpy8qbOF5xnR2vtCX7CZj0LdjAPGfiCpg4Fv0y8qbOF5xPGfiCpg4Fv0y8qqbOF5x8qbOF5xn",
"expires_in": 1800
}
Iniciar conversación frente a Generar token
La operación Iniciar conversación (POST /api/conversations) se parece a la operación Generar token (POST /api/tokens/conversation) en que ambas operaciones devuelven un token que puede usarse para acceder a una única conversación. Sin embargo, la operación Iniciar conversación también inicia la conversación y se pone en contacto con el bot, mientras que la operación Generar token no hace ninguna de estas cosas.
Si quiere iniciar la conversación inmediatamente, use la operación Iniciar conversación. Si va a distribuir el token a los clientes y quiere que inicien la conversación, use en su lugar la operación Generar token.