Chats

Chats trabaja con tus chats de Microsoft Teams: lista tus chats, todos o solo los que tienes con una persona, consulta quién participa en un chat y añade a alguien a un chat existente.

Es útil como paso previo de Chat Messages, para saber qué chats tienes con un cliente o un compañero, o para que un agente de IA te diga en qué conversaciones tienes mensajes pendientes.

Cuándo usarlo

Un agente de IA tiene que localizar tus conversaciones con una persona antes de leerlas.
Quieres saber quién participa en un chat de grupo antes de enviar un aviso.
Cuando alguien se incorpora a un proyecto, quieres añadirle al chat del equipo.
Quieres un resumen de tus chats con su último mensaje y si tienes mensajes sin leer.

Configuración

Necesitas una credencial Microsoft Teams, que se conecta iniciando sesión con tu cuenta de Microsoft. Consulta Credenciales.

Campo	Qué hace
Credential (obligatorio)	La credencial Microsoft Teams con la que se accede a tus chats. Al elegirla se cargan tus chats.
Operation (obligatorio)	Lo que hace el componente. Ver Operaciones. Por defecto, `Get User Chats`.
Chats with User Email	El correo de una persona para quedarte solo con tus chats con ella. Vacío, se devuelven todos tus chats. Solo en `Get User Chats`.
Number of Chats	Cuántos chats se consultan. Por defecto, 20. Solo en `Get User Chats`.
Chat ID	El chat con el que trabajas, elegido por su tema. Los chats sin tema aparecen como `Chat` seguido del principio de su identificador. En `Get Chat Members` y `Add Chat Member`.
User ID	El identificador de la persona que añades al chat. Puedes obtenerlo con `Get Chat Members` en otro chat o con Channel. Solo en `Add Chat Member`.
Member Role	La función de la persona en el chat: `guest` (invitado) u `owner` (propietario). Por defecto, `guest`. Solo en `Add Chat Member`.

Operaciones

Operación	Qué hace
`Get User Chats`	Lista tus chats, con su tema, tipo, miembros, fecha de la última actividad, su último mensaje y si tienes mensajes sin leer.
`Get Chat Members`	Lista los miembros de un chat, con su nombre, correo y función.
`Add Chat Member`	Añade una persona a un chat existente.

Resultado

La salida Data devuelve un elemento por cada chat o miembro encontrado, o un único elemento con la confirmación de que la persona se ha añadido.

Puedes pasar el chat a Chat Messages para leer o enviar mensajes, o conectar el resultado a un agente. El componente también se puede conectar a un Agente como herramienta, para que el agente decida cuándo consultar tus chats. Ver Tool Mode.

Ejemplo

La responsable de cuentas de una agencia quiere, cada mañana, un resumen de los chats pendientes con un cliente.

Añade Chats con la operación Get User Chats y la credencial Microsoft Teams de la responsable.
En Chats with User Email pon el correo del cliente.
Conecta la salida Data a un agente que revise el último mensaje de cada chat y los mensajes sin leer, y prepare el resumen.
Programa el flujo para que se ejecute cada mañana desde el Programador.

Componentes relacionados

Chat Messages: enviar y leer mensajes en chats.
Channel: consultar equipos y canales.