Obtener mensaje

Información general

La actividad Obtener mensaje llama a la API GetChannelMessage o GetChatMessage de Microsoft Graph para recuperar un mensaje especificado (MessageId) de un chat (ChatId) o canal (ChannelId) y un equipo (TeamID).

Después de realizar la búsqueda, la actividad genera sus propiedades en un objeto ChatMessage (Mensaje) que puedes utilizar como variables de entrada en actividades posteriores (por ejemplo, ChatMessage.Id en Obtener respuestas de mensaje, Responder a mensaje, etc.).

La diferencia entre esta actividad y la actividad Obtener mensajes es el requisito de entrada de un mensaje específico (MessageId). Introducir el IdDeMensaje te permite recuperar un objeto ChatMessage específico en lugar de una matriz de objetos que se devuelve en la actividad Obtener mensajes .

Cómo funciona

Los siguientes pasos y diagrama de secuencia de mensajes son un ejemplo de cómo funciona la actividad desde el momento de diseño (es decir, las dependencias de la actividad y las propiedades de entrada / salida) hasta el tiempo de ejecución.

1. Completa los pasos de configuración .
2. Añade la actividad Ámbito de Microsoft Teams a tu proyecto.
3. Complete one of the following two options (A or B):

A. Añade una actividad o ejecuta un proceso externo que genere un valor Chat.Id (por ejemplo, Obtener chats).

B. Añade una actividad o ejecuta un proceso externo que genere un valor Team.Id (por ejemplo, Obtener equipos) Y una actividad o proceso externo que genere un valor Channel.Id (por ejemplo, Obtener canales).

1. Añade la actividad Obtener mensaje dentro de la actividad Ámbito de Microsoft Teams .
2. Introduce valores para las propiedades Canal O Chat y Entrada .
3. Crea e introduce una variable ChatMessage para tu propiedad Salida .
4. Ejecuta la actividad.

   • Los valores de propiedad de entrada se envían a la API ObtenerMensajeDeCanal o ObtenerMensajeDeChat .

   • La API devuelve el valor ChatMessage a su variable de propiedad de salida.

     

Propiedades

Los valores para las siguientes propiedades se especifican al agregar esta actividad a tu proyecto en UiPath Studio.

Común

NombreParaMostrar

El nombre para mostrar de la actividad.

Atributos	Detalles
Tipo	String
Obligatorio	Sí
Valor predeterminado	Obtener mensajes
Valores permitidos	Introduce una variable String o String .
Notas	N/D

Canal

ID del equipo

El ID del objeto Team que contiene el canal del que quieres obtener mensajes.

Atributos	Detalles
Tipo	String
Obligatorio	Sí (si ChatId está vacío)
Valor predeterminado	Vacío
Valores permitidos	Introduce una variable String o String .
Notas	Para obtener el valor Team.Id , utiliza un proceso o actividad externa que incluya el valor Team.Id en su salida (por ejemplo, Obtener Teams o una llamada a la API externa) Se requiere (ChatId) o (TeamId y ChannelId).

ID del canal

El ID del objeto Channel del que quieres obtener el mensaje.

Atributos	Detalles
Tipo	String
Obligatorio	Sí (si IDDeEquipo tiene un valor)
Valor predeterminado	Vacío
Valores permitidos	Introduce una variable String o String .
Notas	Para obtener el valor Channel.Id , utiliza un proceso o actividad externa que incluya el valor Channel.Id en su salida (por ejemplo, Obtener canales o llamada a la API externa) Se requiere (ChatId) o (TeamId y ChannelId).

Chat

ChatId

El ID del objeto Chat al que desea enviar el mensaje.

Atributos	Detalles
Tipo	String
Obligatorio	Sí (si TeamId y ChannelId están vacíos)
Valor predeterminado	Vacío
Valores permitidos	Introduce una variable String o String .
Notas	Para obtener el valor Chat.Id , utiliza un proceso o actividad externa que incluya el valor Chat.Id en su salida (por ejemplo, Obtener chats o llamada a la API externa) Se requiere (ChatId) o (TeamId y ChannelId).

Entrada

IdDeMensaje

El ID del mensaje que desea recuperar.

Atributos	Detalles
Tipo	String
Obligatorio	Sí
Valor predeterminado	Vacío
Valores permitidos	Introduce una variable String o String .
Notas	Para obtener el valor Message.Id , utiliza un proceso o actividad externa que incluya el valor Message.Id en su salida (por ejemplo, Obtener mensajes o una llamada a la API externa).

Otros

Privado

Si se selecciona, los valores de variables y argumentos no estarán registrados a un nivel detallado.

Atributos	Detalles
Tipo	Casilla de verificación
Obligatorio	No
Valor predeterminado	no seleccionados
Valores permitidos	Seleccionado o no seleccionado
Notas	N/D

Salida

Mensaje

El objeto ChatMessage que representa el mensaje especificado en la propiedad IdMensaje .

Atributos	Detalles
Tipo	ChatMessage
Obligatorio	No (obligatorio si planea utilizar los datos de salida en actividades posteriores)
Valor predeterminado	Vacío
Valores permitidos	Introduzca una variable ChatMessage .
Notas	La variable que crees para esta propiedad puede utilizarse como variable de entrada en actividades posteriores (p. ej., Obtener respuestas de mensajes , Responder a mensaje , etc.). El objeto ChatMessage incluye varias propiedades que puedes utilizar en otras actividades. La siguiente imagen de ejemplo muestra algunas de las propiedades que puedes devolver. Nota: algunas propiedades enumeradas en el diseñador no son aplicables al objeto ChatMessage (por ejemplo, ODatatType ). Para obtener una lista de las propiedades Team aplicables, visita los enlaces anteriores.

Ejemplo

La siguiente imagen muestra un ejemplo de la relación de dependencia de la actividad y los valores de las propiedades de entrada / salida.

Para obtener instrucciones paso a paso y ejemplos, consulta las guías de inicio rápido .