Compartir a través de

Conceptos clave en Direct Line API 3.0

  • Artículo

Para habilitar la comunicación entre el bot y su propia aplicación cliente, use la API Direct Line. En este artículo se presentan los conceptos clave de Direct Line API 3.0 y se proporciona información acerca de los recursos pertinentes para desarrolladores. Puede crear un cliente mediante el SDK, la API REST o Web Chat.

Autenticación

Las solicitudes de Direct Line API 3.0 se pueden autenticar mediante un secreto que obtenga de la página de configuración del canal de Direct Line en 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.

Enviar mensajes

Con Direct Line API 3.0, 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 obtener más información, consulte Envío de una actividad al bot.

Recepción de mensajes

Con Direct Line API 3.0, un cliente puede recibir mensajes de su bot mediante streaming de WebSocket o mediante la emisión de solicitudes HTTP GET. Con cualquiera de estas técnicas, un cliente puede recibir varios mensajes desde el bot a la vez como parte de un ActivitySet. Para más información, consulte Recepción de actividades del bot.

Recursos para desarrolladores

Bibliotecas de cliente

Bot Framework proporciona bibliotecas cliente que facilitan el acceso a Direct Line API 3.0 mediante C# y Node.js.

  • Para usar la biblioteca cliente de .NET dentro de un proyecto de Visual Studio, instale el Microsoft.Bot.Connector.DirectLine paquete NuGet.s.

  • Para usar la biblioteca cliente de Node.js, instale la biblioteca botframework-directlinejs mediante NPM (o descargue el origen).

Control Chat en web

Bot Framework proporciona un control que le permite insertar un bot con tecnología de Direct Line en la aplicación cliente. Para obtener más información, consulte Control Chat en web de Microsoft Bot Framework.