Referencia de canales

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	No	No	No
Azure Communication Services Chat	No	Sí	No	Sí	No	No	Sí	No	Sí	Sí	Sí
Direct Line	No	Sí	Sí	Sí	Sí	No	Sí	No	No	No	Sí
Direct Line Speech							Sí
Email	No	No	No	Indeterminada	No	No	Sí	No	No	No	No
Facebook	No	Sí	No	Sí	No	No	Sí	Sí	No	No	No
GroupMe	No	Sí	No	Indeterminada	No	No	Sí	No	No	No	No
LINE	No	Sí	No	Sí	No	No	Sí	No	No	No	No
Microsoft Teams	No	Sí	No	Indeterminada	No	Sí	Sí	Sí	Sí	Sí	No
Omnicanal							Sí
Outlook (versión preliminar)							Sí
Search (versión preliminar)							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	No	No	Indeterminada	No	No	Sí	No	No	No	No
Chat en web	No	Sí	Sí	Sí	Sí	No	Sí	No	No	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	No	No	Sí	No	Sí	No	No
Azure Communication Services Chat	Sí*	Sí	Sí	Sí	Sí	Sí	Sí	Sí
Email	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 (versión preliminar)
Search (versión preliminar)
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	None	None
Azure Communication Services Chat
Direct Line	100	100
Direct Line Speech	100	100
Email	None	None
Facebook	11	3
GroupMe	None	None
LINE	13	99
Microsoft Teams	None	3
Omnicanal
Outlook (versión preliminar)
Search (versión preliminar)
Slack	None	100
Telegram	100	100
Twilio (SMS)	None	None
Chat en web	100	100

• Para obtener más información sobre las acciones de tarjeta, consulte Procesamiento de eventos dentro de tarjetas enriquecidas en el artículo Agregar elementos multimedia a mensajes.
• Para obtener más información sobre las acciones sugeridas, consulte cómo Utilizar botones para la entrada.

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.

Bienvenido

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.

Conversación

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.