Configuración de un bot para ejecutarlo en uno o más canales

  • Artículo

SE APLICA A: SDK v4

Un canal es una conexión entre una aplicación de comunicación y un bot. Un bot registrado con Azure puede usar canales para ayudar al bot a comunicarse con los usuarios. Puede configurar un bot para conectarse a cualquiera de los canales estándar, como Alexa, Facebook Messenger y Slack. Para obtener más información, consulte Registro de Bot de Azure. También puede conectar el bot a una aplicación de comunicación mediante el canal Direct Line. Para obtener más información, consulte Conexión de un bot a Direct Line.

El Bot Framework le permite desarrollar un bot independientemente del canal mediante la normalización de los mensajes que el bot envía a un canal.

  • El servicio o un adaptador traducen la comunicación entre el esquema de actividad de Bot Framework y el esquema del canal.
  • Si el canal no es compatible con todos los aspectos del esquema de actividad, el Servicio de conector de bot intentará convertir el mensaje a un formato que sea compatible con el canal. Por ejemplo, si el bot envía al canal de correo electrónico un mensaje que contiene una tarjeta con los botones de acción, el conector puede enviar la tarjeta como imagen e incluir las acciones como vínculos en el texto del correo electrónico.
  • Para la mayoría de los canales, se debe proporcionar información de configuración de canal para ejecutar el bot en el canal. La mayoría de los canales requieren que un bot tenga una cuenta en el canal. Otros, como Facebook Messenger, requieren que un bot tenga una aplicación registrada con el canal.

Para configurar el bot para que se conecte a un canal, siga los pasos siguientes:

  1. Inicie sesión en Azure Portal.
  2. Seleccione el bot que quiera configurar.
  3. En el panel izquierdo, seleccione Canales en Configuración.
  4. En el panel derecho, haga clic en el icono del canal que desea agregar al bot. Es posible que tenga que desplazarse hacia abajo para ver la lista de todos los Canales disponibles.

Después de configurar el canal, los usuarios de ese canal pueden empezar a usar el bot.

Lista de canales

Los pasos de conexión son diferentes para cada canal. Consulte el artículo relacionado en la tabla a continuación para obtener más información:

Canal Descripción
Alexa Comunicarse con los usuarios a través de capacidades personalizadas de Alexa.
Azure Communication Services Utilice Azure Communication Services Chat para agregar un bot a las características de chat del sitio web.
Direct Line Integre un bot en una aplicación móvil, una página web u otras aplicaciones.
Email Habilite el bot para comunicarse con usuarios a través del correo electrónico de Microsoft 365.
Facebook El bot se puede conectar a Facebook Messenger y Facebook Workplace para comunicarse con usuarios de estas plataformas.
GroupMe Puede configurar el bot para que se comunique con los usuarios a través de GroupMe.
Kik Kik ya no admite el nuevo desarrollo de bots.
LINE Configure el bot para que se comunique con los usuarios a través de la aplicación LINE.
Microsoft Teams Configure el bot para que se comunique con los usuarios a través de Microsoft Teams.
Omnicanal Integre un bot para iniciar una conversación con un cliente, proporcionar respuestas automatizadas y, a continuación, cambiar la conversación a un agente humano si es necesario.
Outlook (vista previa) Configure un bot para comunicarse con los usuarios a través de acciones rápidas desde Outlook.
Búsqueda (vista previa) Habilite un bot para responder a las consultas de usuario a través de la búsqueda federada de Dynamics 365.
Skype Skype ya no admite el nuevo desarrollo de bots.
Slack Configure un bot para que se comunique con los usuarios a través de Slack.
Telegram Configure un bot para que se comunique con los usuarios a través de Telegram.
Telefonía La telefonía está en versión preliminar y actualmente no acepta clientes adicionales.
Twilio (SMS) Configure un bot para que se comunique con los usuarios mediante la plataforma de comunicaciones en la nube de Twilio.
WeChat Configure un bot para comunicarse con los usuarios mediante la plataforma WeChat.
Chat en web Se configura automáticamente al crear un bot con Bot Framework Service.
Canales adicionales Canales adicionales disponibles como adaptador a través de plataformas y repositorios de la comunidad proporcionados por Botkit.

Selección de la versión de transformación del esquema de protocolo

Como se ha descrito anteriormente, un canal convierte los mensajes entrantes de otros servicios al esquema del protocolo Bot Framework. Del mismo modo, los mensajes enviados por el bot a otros servicios se transforman desde el esquema nativo de Bot Framework al formato de estos servicios. Este proceso se denomina transformación de esquema. Bot Framework Service mantiene la compatibilidad con versiones anteriores del protocolo para evitar cambiar el comportamiento de los bots existentes.

En ocasiones, es necesario realizar un cambio en el proceso de transformación de esquemas que pueda, potencialmente, cambiar el comportamiento de los bots existentes. Un ejemplo de este cambio podría ser cualquier corrección de errores, si algunos de los usuarios han tomado una dependencia del comportamiento existente (sin embargo erróneo). Otro ejemplo de este cambio sería actualizaciones o mejoras en otros servicios que beneficiarían a los bots; sin embargo, la adopción de estas actualizaciones puede, potencialmente, cambiar el comportamiento existente.

Al controlar la versión de transformación del esquema de sus bots, los desarrolladores de bots pueden controlar cuándo (si es posible) habilitar el nuevo comportamiento. De manera predeterminada, los bots recién creados obtienen la versión de transformación de esquema más reciente. Los bots existentes se pueden actualizar a la versión más reciente cuando estén listos para aprovechar las mejoras introducidas en esta versión. Cualquier bot se puede actualizar o degradar en cualquier momento.

Puede cambiar la versión de transformación del esquema del bot en el panel Configuración bajo Configuración:

Campo Versión de transformación esquema en el panel Configuración

Versiones de transformación de esquema admitidas

  • Versión 1.3

    • Fecha de presentación: mayo de 2021
    • Cambios:
      • Direct Line: eliminar deserializar o reserializar de tarjetas adaptables. El contenido de tarjetas adaptables se pasará al cliente tal cual.

  • Versión 1.2

    • Fecha de presentación: abril de 2021
    • Cambios:
      • Canal de Slack: el nombre de los datos adjuntos se usa para el valor de texto del mensaje.
      • Canal de Facebook: actualice a Facebook Graph API v9.0.

  • Versión 1.1

    • Fecha de presentación: abril de 2021
    • Cambios:
      • Canal de Telegram: use la sintaxis de MarkdownV2 para todos los markdown.

  • Versión 1.0

    • Versión original

Conectar el bot a uno o varios canales

El proceso de publicación es diferente para cada canal. Para obtener más información, consulte el artículo para cada canal específico.

Pasos siguientes

El SDK incluye ejemplos que se pueden usar para crear bots. Visite el repositorio de ejemplos en GitHub para ver una lista de ejemplos.