Compartir vía

Referencia de canales

  • Artículo

SE APLICA A: SDK v4

En este artículo se describe la compatibilidad del canal con varias características de Bot Framework:

  • Los tipos de actividad que cada canal puede enviar o recibir.
  • Los tipos de tarjeta que puede mostrar cada canal, incluidas las tarjetas adaptables.
  • Acción de tarjeta y compatibilidad con acciones sugeridas en cada canal.
  • Una clasificación general de los distintos tipos de actividad.

Para obtener información detallada sobre la estructura de actividades y tarjetas en el nivel de protocolo, consulte los esquemas de actividad ytarjeta de Bot Framework.

Las tarjetas adaptables son una tecnología independiente. Para obtener más información, consulte adaptivecards.io.

Compatibilidad de actividad por canal

En la tabla siguiente se indica si un canal determinado puede enviar un tipo de actividad determinado al bot. En la tabla, los siguientes términos tienen los significados siguientes.

Término Significado
Sí El bot puede recibir esta actividad desde el canal.
No El bot no puede recibir esta actividad desde el canal.
Indeterminada Actualmente no se ha determinado.
Canal Actualización de la relación de contacto Actualización de la conversación Fin de la conversación Evento Actualización de la instalación Invocar Mensaje Reacción de los mensajes Actualización de mensajes Eliminación de mensajes Escritura
Alexa No No Sí Sí No No Sí No N.º N.º No
Azure Communication Services No Sí No Sí No No Sí No Sí Sí Sí
Direct Line No Sí Sí Sí Sí No Sí No N.º No Sí
Direct Line Speech Sí
Correo electrónico No N.º No Indeterminada No No Sí No N.º N.º No
Facebook No Sí No Sí No No Sí Sí No N.º No
GroupMe No Sí No Indeterminada No No Sí No N.º N.º No
LINE No Sí No Sí No No Sí No N.º N.º No
Microsoft Teams No Sí No Indeterminada No Sí Sí Sí Sí Sí No
Omnicanal Sí
Outlook (vista previa) Sí
Búsqueda (vista previa) Sí
Slack No Sí No Indeterminada No No Sí No Sí Sí No
Telegram No Sí No Indeterminada No No Sí No Sí Indeterminada No
Twilio (SMS) No N.º No Indeterminada No No Sí No N.º N.º No
Chat en web No Sí Sí Sí Sí No Sí No N.º No Sí

La compatibilidad con las actividades event y invoke varía según el nombre de la actividad y varía según el canal.

Soporte de tarjeta por canal

En la tabla siguiente se indica si un canal determinado puede representar un tipo de tarjeta determinado. Incluso si un canal puede representar un tipo de tarjeta, es posible que el canal no admita todas las características de la tarjeta. Antes de liberar el bot, pruebe el comportamiento de cada tarjeta que puede enviar el bot.

En la tabla, los siguientes términos tienen los significados siguientes.

Término Significado
Sí La tarjeta se admite en este canal; sin embargo, cualquier canal determinado solo puede admitir un subconjunto de acciones de tarjeta o puede limitar el número de acciones permitidas en cada tarjeta.
No La tarjeta no se admite en este canal.
Parcial La compatibilidad es parcial. Es posible que este canal no muestre la tarjeta si la tarjeta contiene entradas o botones. El nivel de compatibilidad varía según el canal.
Imagen La tarjeta se convierte en una imagen
Texto La tarjeta se convierte en texto sin formato. Es posible que no se pueda hacer clic en los vínculos, que las imágenes no se muestren o que los elementos multimedia no se puedan reproducir. El nivel de compatibilidad varía según el canal.
Canal Tarjeta adaptable Tarjeta de animación Tarjeta de audio Tarjeta de héroe Tarjeta de recibo Tarjeta de inicio de sesión Miniatura de tarjeta Tarjeta de vídeo
Alexa No N.º No Sí No Sí No No
Azure Communication Services Sí* Sí Sí Sí Sí Sí Sí Sí
Correo electrónico Imagen Texto Texto Sí Sí Sí Sí Texto
Facebook Imagen, parcial Sí Sí Sí Sí Sí Sí Sí
GroupMe Imagen Texto Texto Texto Texto Texto Texto Texto
LINE Imagen, parcial Sí Texto Sí Sí Sí Sí Texto
Microsoft Teams Sí No No Sí Sí Sí Sí No
Omnicanal
Outlook (vista previa)
Búsqueda (vista previa)
Slack Imagen Sí Texto Texto Sí Sí Texto Texto
Telegram Imagen, parcial Sí Texto Sí Sí Sí Sí Sí
Twilio (SMS) Imagen Texto No Texto Texto Texto Texto No
Chat en web Sí Sí Sí Sí Sí Sí Sí Sí

Nota:

  • El canal de Direct Line es compatible técnicamente con todas las tarjetas, pero es el cliente quien las implementa
  • *Para Azure Communication Services Chat, las tarjetas adaptables solo se admiten en los casos de uso de Azure Communication Services, y no para los casos de uso de interoperabilidad de Teams.

Compatibilidad de acciones de tarjeta por canal

En la tabla siguiente se muestra el número máximo de acciones sugeridas y acciones de tarjeta que se admiten en cada canal. Un valor de "None" indica que el tipo de acción no se admite en el canal.

Canal Acciones sugeridas Acciones de tarjeta
Alexa Ninguno Ninguno
Azure Communication Services
Direct Line 100 100
Direct Line Speech 100 100
Correo electrónico Ninguno Ninguno
Facebook 11 3
GroupMe Ninguno Ninguno
LINE 13 99
Microsoft Teams Ninguno 3
Omnicanal
Outlook (vista previa)
Búsqueda (vista previa)
Slack Ninguno 100
Telegram 100 100
Twilio (SMS) Ninguno Ninguno
Chat en web 100 100

Categorías de actividad

Las actividades se pueden dividir en categorías distintas. Para obtener una descripción detallada de cada tipo de actividad y la información que contiene cada tipo de actividad, consulte el esquema de actividad de Bot Framework.

Bienvenida

Esta categoría incluye las actividades conversationUpdate y contactRelationUpdate.

  • Muchos canales envían actividades de actualización de conversación.
    • A menudo, la actividad de actualización de conversación desencadena el comportamiento de bienvenida del bot. Sin embargo, producir un comportamiento de bienvenida confiable podría requerir el uso de la conversación o el estado del usuario.
  • Algunos canales envían actividades de actualización de relaciones de contacto.
    • Si el bot usa estos canales, es posible que tenga que incluir lógica para esta actividad en el comportamiento de bienvenida del bot.

Conversacional

Esta categoría incluye las actividades message, messageReaction y endOfConversation.

  • Todos los canales pueden enviar y recibir actividades de mensajes.
    • En el caso de los bots que usan diálogos, las actividades de mensaje generalmente deben pasarse al diálogo.
  • Algunos canales pueden enviar y recibir actividades de reacción de mensajes.
    • Según el diseño del bot, es posible que pase actividades de reacción de mensajes a un cuadro de diálogo.
    • Las actividades de reacción de mensajes hacen referencia a mensajes anteriores por identificador.
  • Las actividades de finalización de la conversación indican el final de una conversación desde la perspectiva del emisor.
    • Las actividades de fin de conversación se usan en la comunicación entre bots para aptitudes.

Sugerencia

Una reacción al mensaje es como un me gusta en un comentario anterior. Pueden producirse sin orden, por lo que se pueden considerar como similares a los botones. El canal de Teams envía este tipo de actividad.

Actualización y eliminación de mensajes

Esta categoría incluye las actividades messageUpdate y messageDelete.

  • Teams admite las actividades de actualización y eliminación de mensajes.

Extensibilidad de la aplicación

Esta categoría incluye las actividades event y invoke. El significado de una actividad se define mediante el campo name, que es significativo en el ámbito de un canal.

  • Una aplicación propietaria del cliente y el servidor puede usar actividades de eventos para comunicar información mediante programación entre el cliente y el servidor.
    • Las actividades de eventos, como la mayoría de los tipos de actividad, son asincrónicas.
    • Direct Line y Chat en web utilizan actividades de evento como un mecanismo de extensibilidad.
  • Las actividades de invocación son específicas de una aplicación y no es algo que un cliente definiría.
    • Las actividades de invocación, a diferencia de otros tipos de actividad, son sincrónicas. (Actualmente, la invocación es la única actividad que desencadena un comportamiento de solicitud-respuesta en el bot).
    • Microsoft Teams usa actividades de invocación y define algunas actividades de invocación específicas de Teams.

Autenticación

Para que el símbolo del sistema de OAuth funcione con diálogos, la actividad de invocación TeamsVerification se debe reenviar al cuadro de diálogo.

Sin categoría

Las actividades installationUpdate, typing y handoff no encajan significativamente en las otras categorías.

  • Las actividades de actualización de la instalación representan una instalación o desinstalación de un bot dentro de una unidad organizativa de un canal.
  • Las actividades de escritura representan la entrada continua de un usuario o un bot.
  • Las actividades de transferencia solicitan o indican un cambio en el foco entre los elementos dentro de un bot. La actividad de transferencia es diferente de una actividad de evento que tiene el nombre "handoff".

Fuera de uso (incluye la invocación específica del pago)

Estos tipos de actividad ya no están en uso:

  • deleteUserData
  • handoff
  • ping
  • invocar Address
  • invocar PaymentRequest

Información adicional

Todos los canales pueden enviar y recibir actividades message.

Sugerencia

Al agregar compatibilidad con un canal al bot, familiarícese con los documentos para desarrolladores del canal. Cada canal tiene limitaciones diferentes en varios aspectos de una conversación. Algunas de las diferencias son:

  • Cuánto tiempo tiene el bot para controlar cada solicitud HTTP.
  • Si un bot puede enviar una actividad que no está en respuesta a una actividad de usuario específica.
  • Cuántos mensajes puede enviar el bot dentro de un período de tiempo determinado.
  • Cómo se representa una tarjeta y qué tarjetas se admiten.