Obtener mensajes

Recupera todos los mensajes de un chat o canal de Microsoft Teams utilizando la actividad Obtener mensajes.

Información general

La actividad Obtener mensajes llama a la API ListChatMessages o ListChannelMessages de Microsoft Graph para recuperar todos los mensajes de un chat especificado (ChatId) o canal (ChannelId) y equipo (TeamID).

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

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 mensajes dentro de la actividad Ámbito de Microsoft Teams .
2. Introduce valores para las propiedades Canal O Chat .
3. Crea e introduce una variable ChatMessage[] para tu propiedad Salida .
4. Ejecuta la actividad.

   • Los valores de las propiedades de entrada se envían a la API ListarMensajesDeChat o ListarMensajesDeCanal .

   • 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 del que quieres obtener los mensajes.

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).

Opciones

Límite

El número máximo de mensajes recientes para recuperar.

Atributos	Detalles
Tipo	Int32
Obligatorio	Sí
Valor predeterminado	Vacío
Valores permitidos	Introduce una variable Int32 o Int32 .
Notas	N/D

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

Mensajes

Una matriz de mensajes (objeto ChatMessage[] ) del chat o canal especificado.

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., ChatMessage(0).Id en Obtener respuestas de mensajes , Responder a mensaje , etc.). * Al utilizar esta variable como valor de propiedad de entrada, especifica el elemento de la matriz que deseas utilizar (por ejemplo, myMessages(0) ). 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 .