Conceptos clave de la API Direct Line 1.1 de Bot FrameworkKey concepts in Direct Line API 1.1

Para habilitar la comunicación entre el bot y su propia aplicación cliente, use la API Direct Line.You can enable communication between your bot and your own client application by using the Direct Line API.

Importante

En este artículo se presentan los conceptos clave de la API Direct Line 1.1 y se proporciona información acerca de los recursos pertinentes para desarrolladores.This article introduces key concepts in Direct Line API 1.1 and provides information about relevant developer resources. 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.

AuthenticationAuthentication

Las solicitudes de Direct Line API 1.1 se pueden autenticar ya sea mediante un secreto, que se obtiene en la página de configuración del canal de Direct Line en Azure Portal, o mediante un token que se obtiene en el entorno en tiempo de ejecución.Direct Line API 1.1 requests can be authenticated either by using a secret that you obtain from the Direct Line channel configuration page in the Azure Portal or by using a token that you obtain at runtime. Para más información, consulte Autenticación.For more information, see Authentication.

Inicio de una conversaciónStarting a conversation

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. Para obtener más información, consulte Inicio de una conversación.For more information, see Start a conversation.

Envío de mensajesSending messages

Con la API Direct Line 1.1, un cliente puede enviar mensajes a su bot mediante la emisión de solicitudes HTTP POST.Using Direct Line API 1.1, a client can send messages to your bot by issuing HTTP POST requests. Un cliente puede enviar un único mensaje por solicitud.A client may send a single message per request. Para más información, consulte Envío de una actividad al bot.For more information, see Send a message to the bot.

Recepción de mensajesReceiving messages

Con la API Direct Line 1.1, un cliente puede recibir mensajes mediante el sondeo de solicitudes HTTP GET.Using Direct Line API 1.1, a client can receive messages by polling with HTTP GET requests. En respuesta a cada solicitud, un cliente puede recibir varios mensajes del bot como parte de MessageSet.In response to each request, a client may receive multiple messages from the bot as part of a MessageSet. Para obtener más información, consulte Receive messages from the bot (Recepción de mensajes del bot).For more information, see Receive messages from the bot.

Recursos para desarrolladoresDeveloper resources

Biblioteca de clienteClient library

Bot Framework proporciona una biblioteca cliente que facilita el acceso a la API Direct Line 1.1 a través de C#.The Bot Framework provides a client library that facilitates access to Direct Line API 1.1 via C#. Para usar la biblioteca cliente dentro de un proyecto de Visual Studio, instale el paquete de NuGet v1.x Microsoft.Bot.Connector.DirectLine.To use the client library within a Visual Studio project, install the Microsoft.Bot.Connector.DirectLine v1.x NuGet package.

Como alternativa al uso de la biblioteca cliente de C#, puede generar su propia biblioteca cliente en el lenguaje que quiera mediante el archivo Swagger de la API Direct Line 1.1.As an alternative to using the C# client library, you can generate your own client library in the language of your choice by using the Direct Line API 1.1 Swagger file.