Iniciar una conversación en Direct line API 1,1Start a conversation in Direct Line API 1.1

Importante

En este artículo se describe cómo iniciar una conversación mediante Direct Line API 1.1.This article describes how to start a conversation using 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.If you are creating a new connection between your client application and bot, use Direct Line API 3.0 instead.

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.Direct Line conversations are explicitly opened by clients and may run as long as the bot and client participate and have valid credentials. Mientras la conversación está abierta, el bot y el cliente pueden enviar mensajes.While the conversation is open, both the bot and client may send messages. Más de un cliente puede conectarse a una conversación determinada y cada cliente puede participar en nombre de varios usuarios.More than one client may connect to a given conversation and each client may participate on behalf of multiple users.

Apertura de una nueva conversaciónOpen a new conversation

Para abrir una nueva conversación con un bot, emita esta solicitud:To open a new conversation with a bot, issue this request:

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.The following snippets provide an example of the Start Conversation request and response.

SolicitudRequest

POST https://directline.botframework.com/api/conversations
Authorization: Bearer RCurR_XV9ZA.cwA.BKA.iaJrC8xpy8qbOF5xnR2vtCX7CZj0LdjAPGfiCpg4Fv0y8qbOF5xPGfiCpg4Fv0y8qqbOF5x8qbOF5xn

ResponseResponse

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.If the request is successful, the response will contain an ID for the conversation, a token, and a value that indicates the number of seconds until the token expires.

HTTP/1.1 200 OK
[other headers]
{
  "conversationId": "abc123",
  "token": "RCurR_XV9ZA.cwA.BKA.iaJrC8xpy8qbOF5xnR2vtCX7CZj0LdjAPGfiCpg4Fv0y8qbOF5xPGfiCpg4Fv0y8qqbOF5x8qbOF5xn",
  "expires_in": 1800
}

Iniciar conversación frente a Generar tokenStart Conversation versus Generate 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.The Start Conversation operation (POST /api/conversations) is similar to the Generate Token operation (POST /api/tokens/conversation) in that both operations return a token that can be used to access a single conversation. 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.However, the Start Conversation operation also starts the conversation and contacts the bot, whereas the Generate Token operation does neither of these things.

Si quiere iniciar la conversación inmediatamente, use la operación Iniciar conversación.If you intend to start the conversation immediately, use the Start Conversation operation. 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.If you plan to distribute the token to clients and want them to initiate the conversation, use the Generate Token operation instead.

Recursos adicionalesAdditional resources