Referencia de canalesChannels reference

Actividades clasificadas por canalCategorized activities by channel

se aplica a: SDK V4APPLIES TO: SDK v4

En las tablas siguientes se muestra qué eventos (actividades en la conexión) pueden proceder de qué canales.The following tables show what events (activities on the wire) can come from which channels.

Estos símbolos se usan en las tablas:These symbols are used in the tables:

SímboloSymbol SignificadoMeaning
El bot debe esperar recibir esta actividad.The bot should expect to receive this activity.
El bot nunca debería esperar recibir esta actividad.The bot should never expect to receive this activity.
Actualmente no se determina si el bot puede recibir esto.Currently undetermined whether the bot can receive this.

Las actividades se pueden dividir de forma significativa en categorías distintas.Activities can meaningfully be split into separate categories. Para cada categoría, tenemos una tabla de actividades posibles.For each category, we have a table of possible activities. Consulte el Bot Framework de actividad para obtener una descripción detallada de cada tipo de actividad y la información que contiene cada tipo de actividad.See the Bot Framework activity schema for a detailed description of each type of activity, and the information that each type of activity contains.

ConversacionalConversational

\ Direct LineDirect Line Direct Line (Chat en web)Direct Line (Web Chat) EmailEmail FacebookFacebook GroupMeGroupMe KikKik TeamsTeams SlackSlack SkypeSkype Skype EmpresarialSkype Business TelegramTelegram TwilioTwilio
message
messageReaction
  • Todos los canales envían actividades de mensaje.All channels send message activities.
  • Si el bot usa un cuadro de diálogo, reenvía las actividades del mensaje al diálogo.If your bot uses a dialog, forward message activities to the dialog.
  • No es necesario reenviar las reacción de los mensajes al diálogo, aunque forman parte en gran parte de la conversación.Message reactions don't need to be forwarded to the dialog, even though they're very much part of the conversation.
  • Lógicamente, hay dos tipos de reacción de mensaje: agregado y quitado.There are logically two types of message reactions: added and removed.

Sugerencia

Las reacción de los mensajes son cosas como un control sobre un comentario anterior.Message reactions are things like a thumbs up on a previous comment. Pueden producirse fuera de servicio y se pueden pensar como botones.They can happen out of order, and can be thought of as similar to buttons.

Pantalla de inicioWelcome

\ Direct LineDirect Line Direct Line (Chat en web)Direct Line (Web Chat) EmailEmail FacebookFacebook GroupMeGroupMe KikKik TeamsTeams SlackSlack SkypeSkype Skype EmpresarialSkype Business TelegramTelegram TwilioTwilio
conversationUpdate
contactRelationUpdate
  • Es habitual que los canales envíen actividades de actualización de conversación.It is common for channels to send conversation update activities.
  • Los principales tipos de actualizaciones de conversación son los miembros de conversación agregados y los miembros quitados.The main types of conversation updates are conversation members added and members removed.
  • Algunos canales envían la actualización de la conversación cuando el bot se agrega a una conversación y otros lo envían después del primer mensaje enviado al bot.Some channels send the conversation update when the bot is added to a conversation, and some send it after the first message sent to the bot.
  • Para generar un comportamiento de bienvenida confiable, incluya el estado de usuario en la lógica de bienvenida de los bots.To produce a reliable Welcome behavior, include user state in your bots welcome logic.

Extensibilidad de aplicacionesApplication extensibility

\ Direct LineDirect Line Direct Line (Chat en web)Direct Line (Web Chat) EmailEmail FacebookFacebook GroupMeGroupMe KikKik TeamsTeams SlackSlack SkypeSkype Skype EmpresarialSkype Business TelegramTelegram TwilioTwilio
event
name = CreateConversationname = CreateConversation
name = ContinueConversationname = ContinueConversation
  • Las actividades de evento transmiten información de programación de un cliente o un canal a un bot.Event activities communicate programmatic information from a client or channel to a bot. El significado de una actividad de evento se define en el campo name, que es significativo en el ámbito de un canal.The meaning of an event activity is defined by the name field, which is meaningful within the scope of a channel.
  • Una aplicación que posee el cliente y el servidor puede elegir tunelización de sus propios eventos a través del servicio mediante actividades de eventos.An application that owns both the client and server can chose to tunnel their own events through the service using event activities.

Microsoft TeamsMicrosoft Teams

  • Junto con otros tipos de actividad, Microsoft Teams define algunas Teams actividades específicas del invoke usuario.Along with other activity types, Microsoft Teams defines a few Teams-specific invoke activities. Consulte How Microsoft Teams bots work (Cómo funcionan los bots) para obtener más información.See How Microsoft Teams bots work for more information.
  • Las actividades de invocación transmiten información de programación de un cliente o un canal a un bot y tienen una carga de devolución correspondiente para su uso en el canal.Invoke activities communicate programmatic information from a client or channel to a bot, and have a corresponding return payload for use within the channel. El significado de una actividad de invocación se define en el campo name, que es significativo en el ámbito de un canal.The meaning of an invoke activity is defined by the name field, which is meaningful within the scope of a channel.

Actualización de mensajesMessage update

\ Direct LineDirect Line Direct Line (Chat en web)Direct Line (Web Chat) EmailEmail FacebookFacebook GroupMeGroupMe KikKik TeamsTeams SlackSlack SkypeSkype Skype EmpresarialSkype Business TelegramTelegram TwilioTwilio
messageUpdate
messageDelete
  • La actualización de mensajes es compatible actualmente con Teams.Message update is currently supported by Teams.

OAuthOAuth

\ Direct LineDirect Line Direct Line (Chat en web)Direct Line (Web Chat) EmailEmail FacebookFacebook GroupMeGroupMe KikKik TeamsTeams SlackSlack SkypeSkype Skype EmpresarialSkype Business TelegramTelegram TwilioTwilio
invoke

Importante

Para que los diálogos y los avisos de OAuth funcionen, debe reenviar las siguientes actividades de invocación al diálogo:For dialogs and OAuth prompts to work, you must forward the following invoke activities to the dialog:

  • signin/verifyState
  • signin/tokenExchange
  • tokens/response

Sin categoríaUncategorized

\ Direct LineDirect Line Direct Line (Chat en web)Direct Line (Web Chat) EmailEmail FacebookFacebook GroupMeGroupMe KikKik TeamsTeams SlackSlack SkypeSkype Skype EmpresarialSkype Business TelegramTelegram TwilioTwilio
endOfConversation
installationUpdate
typing

Fuera de usoOut of use

  • deleteUserData
  • handoff
  • invoke: solicitud de pagoinvoke: payment request
  • invoke: direccióninvoke: address
  • ping

Nota

La actividad de entrega es diferente del escenario de entrega a persona.The handoff activity is different from the handoff-to-human scenario. Consulte Transición de conversaciones de bot a humano para obtener más información.See Transition conversations from bot to human for more information.

Resumen de las actividades admitidas por canalSummary of activities supported per channel

Direct LineDirect Line

  • conversationUpdate
  • event
    • CreateConversation
    • ContinueConversation
  • invoke
    • signin/tokenExchange
    • signin/verifyState
    • tokens/response
  • message

EmailEmail

  • message

FacebookFacebook

  • invoke
    • tokens/response
  • message

GroupMeGroupMe

  • conversationUpdate
  • invoke
    • tokens/response
  • message

KikKik

  • conversationUpdate
  • invoke
    • tokens/response
  • message

TeamsTeams

  • conversationUpdate
  • invoke
  • message
  • messageDelete
  • messageReaction
  • messageUpdate

SlackSlack

  • conversationUpdate
  • invoke
    • tokens/response
  • message

SkypeSkype

  • contactRelationUpdate
  • invoke
    • tokens/response
  • message

Skype EmpresarialSkype Business

  • contactRelationUpdate
  • invoke
    • tokens/response
  • message

TelegramTelegram

  • conversationUpdate
  • invoke
    • tokens/response
  • message

TwilioTwilio

  • message

Tabla de resumen de todas las actividades a todos los canalesSummary table all activities to all channels

\ Direct LineDirect Line Direct Line (Chat en web)Direct Line (Web Chat) EmailEmail FacebookFacebook GroupMeGroupMe KikKik TeamsTeams SlackSlack SkypeSkype Skype EmpresarialSkype Business TelegramTelegram TwilioTwilio
contactRelationUpdate
conversationUpdate
endOfConversation
event
- CreateConversation
- ContinueConversation
installationUpdate
message
messageDelete
messageReaction
messageUpdate
typing

La compatibilidad con las actividades y varía según el nombre de la event actividad y varía según el invoke canal.Support for event and invoke activities varies by the activity's name and varies by channel.

Compatibilidad de acciones por canalAction support by channel

En la tabla siguiente se muestra el número máximo de acciones sugeridas y acciones de tarjeta que se admiten en cada canal.The following table shows the maximum number of suggested actions and card actions that are supported in each channel. El ❌ indica que la acción no se admite en absoluto en el canal especificado.The ❌ indicates that the action is not supported at all in the specified channel.

\ Direct LineDirect Line Direct Line (Chat en web)Direct Line (Web Chat) EmailEmail FacebookFacebook GroupMeGroupMe KikKik LíneaLine TeamsTeams SlackSlack SkypeSkype Skype EmpresarialSkype Business TelegramTelegram TwilioTwilio
Acciones sugeridasSuggested actions 100100 100100 1010 2020 1313 1010 100100
Acciones de tarjetaCard actions 100100 100100 33 2020 9999 33 100100 33

Para más información acerca de los números que se muestran en la tabla anterior, consulte el código de soporte de canal que se muestra aquí.For more information about the numbers shown in the above table, refer to channel support code listed here.

Para obtener más información sobre las acciones sugeridas, vea el artículo Uso del botón para la entrada.For more information on suggested actions, see how to Use button for input article.

Para obtener más información sobre las acciones de tarjeta, consulte la sección Enviar una tarjeta de imagen principal del artículo Agregar medios a mensajes.For more information on card actions, see the Send a hero card section of the Add media to messages article.

Compatibilidad con tarjetas por canalCard support by channel

CanalChannel Tarjeta adaptableAdaptive Card Tarjeta de animaciónAnimation card Tarjeta de audioAudio card Tarjeta de imagen principalHero card Tarjeta de recepciónReceipt card Tarjeta de inicio de sesiónSign-in card Tarjeta de miniaturasThumbnail card Tarjeta de vídeoVideo card
Correo electrónicoEmail 🖼🖼 📄📄 📄📄 📄📄
FacebookFacebook ⚠🖼⚠🖼
GroupMeGroupMe 🖼🖼 📄📄 📄📄 📄📄 📄📄 📄📄 📄📄 📄📄
KikKik 🖼🖼 📄📄 📄📄
LíneaLine ⚠🖼⚠🖼 📄📄 📄📄
Microsoft TeamsMicrosoft Teams
SkypeSkype
SlackSlack 🖼🖼 📄📄 📄📄 📄📄 📄📄
TelegramTelegram ⚠🖼⚠🖼 📄📄
TwilioTwilio 🖼🖼 📄📄 📄📄 📄📄 📄📄 📄📄
Chat en webWeb Chat

Nota

El Direct Line admite técnicamente todas las tarjetas, pero es el cliente el que las implementa.The Direct Line channel technically supports all cards, but it's up to the client to implement them.

  • ✔: se admite totalmente la tarjeta con la excepción de que algunos canales solo admiten un subconjunto de acciones de tarjeta o pueden limitar el número de acciones permitidas en cada tarjeta.✔: Supported - card is supported fully with the exception that some channels only support a subset of card actions or may limit the number of actions allowed on each card. Varía según el canal.Varies by channel.
  • ⚠: compatibilidad parcial: es posible que la tarjeta no se muestre en absoluto si contiene entradas o botones.⚠: Partial support - card may not be displayed at all if it contains inputs or buttons. Varía según el canal.Varies by channel.
  • ❌: No se admite❌: No support
  • 🖼: la tarjeta se convierte en una imagen🖼: Card is converted to an image
  • 📄: la tarjeta se convierte en texto sin formato: es posible que los vínculos no se puedan hacer clic, que las imágenes no se muestren y que los medios no se puedan reproducir.📄: Card is converted to unformatted text - links may not be clickable, images may not display, and media may not be playable. Varía según el canal.Varies by channel.

Estas categorías son amplias de forma intencionada y no explican completamente cómo se admite cada característica de la tarjeta en cada canal debido a las numerosas combinaciones posibles de tarjetas, características y canales.These categories are intentionally broad and don't fully explain how every card feature is supported in each channel due to the many possible combinations of cards, features, and channels. Use esta tabla como referencia base, pero pruebe cada una de las tarjetas en el canal deseado.Use this table as a base reference, but test each of your cards in the desired channel.