Conceptos clave de la API Direct Line 1.1 de Bot Framework

  • Artículo

Para habilitar la comunicación entre el bot y su propia aplicación cliente, use la API Direct Line.

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. 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.

Authentication

Direct Line las solicitudes de API 1.1 se pueden autenticar mediante un secreto que obtenga de la página de configuración del canal de Direct Line en el Azure Portal o mediante un token que obtenga en tiempo de ejecución. Para más información, consulte Autenticación.

Inicio de una conversación

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. Para obtener más información, consulte Inicio de una conversación.

Envío de mensajes

Con la API Direct Line 1.1, un cliente puede enviar mensajes a su bot mediante la emisión de solicitudes HTTP POST. Un cliente puede enviar un único mensaje por solicitud. Para más información, consulte Envío de una actividad al bot.

Recepción de mensajes

Con la API Direct Line 1.1, un cliente puede recibir mensajes mediante el sondeo de solicitudes HTTP GET. En respuesta a cada solicitud, un cliente puede recibir varios mensajes del bot como parte de MessageSet. Para obtener más información, consulte Receive messages from the bot (Recepción de mensajes del bot).

Recursos para desarrolladores

Biblioteca de cliente

Bot Framework proporciona una biblioteca cliente que facilita el acceso a la API Direct Line 1.1 a través de C#. Para usar la biblioteca cliente dentro de un proyecto de Visual Studio, instale el Microsoft.Bot.Connector.DirectLinepaquete NuGet v1.x.

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.