Configuración de un bot para que se ejecute en uno o varios canales

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, usa 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 más información, consulte Registro de Azure Bot. También puede conectar un bot a la aplicación de comunicación mediante Direct Line como canal. Para más información, consulte Conexión de un bot a Direct Line.

Bot Framework permite desarrollar un bot de forma independiente del canal mediante la normalización de 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 admite todos los aspectos del esquema de actividad, Bot Connector Service intenta convertir el mensaje en un formato que admite el canal. Por ejemplo, si el bot envía un mensaje que contiene una tarjeta con botones de acción al canal de correo electrónico, el conector podría enviar la tarjeta como una imagen e incluir las acciones como vínculos en el cuerpo del correo electrónico.
  • Para la mayoría de los canales, debe proporcionar información de configuración de canal para ejecutar un 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 un bot para conectarse a un canal, complete 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, seleccione el icono del canal que quiere 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 de la tabla siguiente más información.

Canal Descripción
Alexa Comunicarse con los usuarios a través de aptitudes personalizadas de Alexa.
chat de Azure Communication Services (versión preliminar) Use Azure Communication Services Chat para agregar un bot a las características de chat de su sitio web.
Direct Line Integre un bot en una aplicación móvil, una página web u otras aplicaciones.
Correo electrónico Permitir que un bot se comunique con los usuarios a través del correo electrónico de Microsoft 365.
Facebook Conecte un bot tanto a Facebook Messenger como a Facebook Workplace, para que pueda comunicarse con los usuarios en ambas plataformas.
GroupMe Configure un bot para comunicarse con los usuarios a través de GroupMe.
Kik Kik ya no admite el nuevo desarrollo de bots.
LINE Configure un bot para comunicarse con los usuarios a través de la aplicación LINE.
Microsoft Teams Configure un bot para comunicarse con los usuarios a través de Microsoft Teams.
Omnichannel 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 (versión preliminar) Configure un bot para comunicarse con los usuarios a través de acciones rápidas desde Outlook.
Search (versión preliminar) Habilite un bot para responder a las consultas de usuario a través de Dynamics 365 búsqueda federada.
Skype Skype ya no admite el nuevo desarrollo de bots.
Slack Configure un bot para comunicarse con los usuarios a través de Slack.
Telegram Configure un bot para comunicarse 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 comunicarse con los usuarios a través de la plataforma de comunicación 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 Botkit proporcionan plataformas y repositorios de la comunidad.

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 en el esquema del protocolo de 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 del esquema 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 alguna vez) habilitar el nuevo comportamiento. De forma 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 en Configuración:

El campo Versión de transformación de 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: Quitar deserializar o volver a serializar de tarjetas adaptables. El contenido de las tarjetas adaptables se pasará al cliente tal y como está.
  • 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:
  • Versión 1.0

    • Versión original

Conexión del 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.