Chat Messages
Chat Messages trabaja con los mensajes de los chats de Microsoft Teams: envía mensajes a un chat, lee sus últimos mensajes, trae un mensaje concreto y responde a uno existente. También envía mensajes directos a una persona a partir de su correo y lee tus conversaciones directas.
Úsalo para que tus flujos avisen a una persona concreta por Teams, o para que un agente de IA atienda los mensajes que te llegan por chat.
Cuándo usarlo
- Quieres avisar por Teams al comercial asignado cada vez que entra un cliente nuevo.
- Un agente de IA tiene que leer tus chats recientes con una persona y resumirte lo pendiente.
- Quieres responder automáticamente en un chat de grupo a las preguntas frecuentes.
- Necesitas enviar a un compañero, por mensaje directo, el documento que ha generado el flujo.
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 envía y se lee. Los mensajes se envían en nombre de esa cuenta. Al elegirla se cargan tus chats. |
| Operation (obligatorio) | Lo que hace el componente. Ver Operaciones. Por defecto, Send Chat Message. |
| Chat ID | El chat con el que trabajas. Los chats individuales aparecen con el nombre de la otra persona y los de grupo con su tema o sus miembros. En Send Chat Message, Get Chat Messages, Get Chat Message y Reply to Message. |
| Recipient Email | El correo de la persona. En Send Direct Message es el destinatario. En Get Direct Messages limita la lectura a tus chats con esa persona; vacío, se leen todos tus chats. |
| Message Text | El texto del mensaje o de la respuesta. En Send Chat Message, Reply to Message y Send Direct Message. |
| Content Type | text (texto sin formato) o html (admite formato sencillo, como negritas o enlaces). Por defecto, html. En las mismas operaciones que Message Text. |
| Message ID | El identificador del mensaje que lees o al que respondes. En Get Chat Message y Reply to Message. |
| Message Count | Cuántos mensajes se leen. Por defecto, 20. En Get Chat Messages y Get Direct Messages. |
| Attachments | Los archivos que se adjuntan al mensaje directo. Conecta la salida de un componente que entregue archivos o escribe la dirección web de un archivo. En Send Direct Message. |
Operaciones
| Operación | Qué hace |
|---|---|
Send Chat Message | Envía un mensaje al chat elegido. |
Get Chat Messages | Devuelve los últimos mensajes del chat. |
Get Chat Message | Devuelve un mensaje concreto, con su contenido, su autor y su fecha. |
Reply to Message | Responde a un mensaje del chat. |
Get Direct Messages | Devuelve los mensajes recientes de tus chats, todos o solo los que tienes con la persona de Recipient Email, del más nuevo al más antiguo. |
Send Direct Message | Envía un mensaje a una persona por su correo. Usa el chat que ya tienes con ella o, si no existe, abre uno nuevo. |
Resultado
La salida Data devuelve un elemento por cada mensaje leído, o un único elemento con el resultado: el mensaje enviado o la respuesta, con su identificador, el chat y la fecha.
Puedes conectar el resultado a un agente para que lea la conversación, o a otro componente que guarde los mensajes. El componente también se puede conectar a un Agente como herramienta, para que el agente decida cuándo escribir o leer chats. Ver Tool Mode.
Ejemplo
Una inmobiliaria quiere que cada agente reciba por Teams los datos de los clientes que piden visita en la web.
- El formulario de la web llega al flujo con los datos del cliente y el correo del agente asignado.
- Añade Chat Messages con la operación
Send Direct Messagey la credencial Microsoft Teams de la oficina. - En Recipient Email pon el correo del agente y en Message Text el nombre, el teléfono y la vivienda que interesa al cliente.
Buenas prácticas
- Si el flujo escucha esos chats con Teams Webhook, activa allí Ignore Own Messages para que no reaccione a sus propios mensajes.
- Usa
Send Direct Messagecuando solo conoces el correo de la persona: no necesitas buscar antes el chat.
Componentes relacionados
- Chats: consultar tus chats y sus miembros.
- Channel Messages: publicar en canales de Teams.
- Teams Webhook: iniciar un flujo cuando llega un mensaje.