Compartir a través de

Creación de mensajes con Bot Connector API

El bot enviará objetos Activity de tipo mensaje para comunicar información a los usuarios y, del mismo modo, también recibirá actividades de mensajes de los usuarios. Algunos mensajes pueden simplemente constar de texto sin formato, mientras que otros pueden contener contenido más enriquecido, como acciones sugeridas, datos adjuntos multimedia, tarjetasenriquecidas y datos específicos del canal. En este artículo se describen algunas de las propiedades de mensaje usadas habitualmente.

Texto del mensaje y formato

El texto del mensaje se puede formatear mediante texto sin formato, markdown o xml. El formato predeterminado de la textFormat propiedad es Markdown e interpreta el texto mediante los estándares de formato Markdown. El nivel de compatibilidad con el formato de texto varía en todos los canales.

Sugerencia

Para obtener información sobre qué características se admiten en cada canal, consulte el artículo de referencia de canales .

La textFormat propiedad del objeto Activity se puede usar para especificar el formato del texto. Por ejemplo, para crear un mensaje básico que contenga solo texto sin formato, establezca la textFormat propiedad del Activity objeto en sin formato, establezca la text propiedad en el contenido del mensaje y establezca la locale propiedad en la configuración regional del remitente.

Datos adjuntos

La attachments propiedad del objeto Activity se puede usar para enviar datos adjuntos multimedia simples (imagen, audio, vídeo, archivo) y tarjetas enriquecidas. Para obtener más información, consulte Agregar datos adjuntos multimedia a mensajes y Agregar tarjetas enriquecidas a mensajes.

Entidades

La entities propiedad del objeto Activity es una matriz de objetos de tipo abierto de schema.org que permite el intercambio de metadatos contextuales comunes entre el canal y el bot.

Mencione entidades

Muchos canales admiten la posibilidad de que un bot o usuario "mencione" a alguien dentro del contexto de una conversación. Para mencionar a un usuario de un mensaje, rellene la propiedad del entities mensaje con un objeto Mention .

Posicionar entidades

Para transmitir información relacionada con la ubicación dentro de un mensaje, rellene la propiedad del entities mensaje con objetos Place .

Datos del canal

La channelData propiedad del objeto Activity se puede usar para implementar la funcionalidad específica del canal. Para obtener más información, consulte Implementación de la funcionalidad específica del canal.

Acciones recomendadas

La suggestedActions propiedad del objeto Activity se puede usar para presentar botones que el usuario puede pulsar para proporcionar entrada. A diferencia de los botones que aparecen en tarjetas enriquecidas (que permanecen visibles y accesibles para el usuario incluso después de pulsarse), los botones que aparecen en el panel de acciones sugeridas desaparecerán después de que el usuario realice una selección. Para obtener más información, consulte Adición de acciones sugeridas a los mensajes.

Recursos adicionales

  • Last updated on