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 (ChatId) o canal (IDDeCanal) y equipo (IDDeEquipo) especificados.

Después de realizar la búsqueda, la actividad genera las propiedades en un objeto ChatMessage[] (Mensaje) que puedes usar 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. Agrega la actividad de Ámbito de Microsoft Teams a tu proyecto.
3. Complete una de las siguientes dos opciones (A o B):

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

B. Añadir una actividad o ejecutar 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. Agrega la actividad Obtener mensajes dentro de la actividad Ámbito de Microsoft Teams .
2. Introduce valores para las propiedades del canal O del chat .
3. Crea e introduce una variable ChatMessage[] para tu propiedad de salida .

4. Ejecuta la actividad.

   • Los valores de tus propiedades de entrada se envían a la API ListChatMessages o ListChannelMessages .
   • 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 , use un proceso o actividad externos que incluya el valor Team.Id en su salida (p. Ej., Obtener equipos o llamada a una API externa) Se requiere (ChatId) o (TeamId y CanalId).

ID del canal

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

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

Chat

ChatId

El ID del objeto Chat del que quieres obtener los mensajes.

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

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 se puede utilizar como variable de entrada en actividades posteriores (por ejemplo, ChatMessage(0).Id en Obtener respuestas de mensaje, Responder a mensaje, etc.). * Cuando use esta variable como valor de propiedad de entrada, especifique el elemento en la matriz que desea usar (por ejemplo, misMensajes (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 ver 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 .