Teams Webhook

Este componente actúa como un asistente digital que escucha lo que ocurre dentro de Microsoft Teams. Su función principal es recibir notificaciones instantáneas cuando sucede algo importante en tus equipos, canales o conversaciones, como cuando se publica un nuevo mensaje, se crea un canal o se agrega un miembro. Al detectar estos cambios, el componente los captura de forma segura y los envía al resto de tu flujo de trabajo para que Nappai pueda actuar en consecuencia.

¿Cómo funciona?

Imagina que este componente es un monitor permanente conectado a tu ecosistema de Teams. Microsoft envía alertas cada vez que ocurre un cambio en los recursos que has seleccionado (mensajes, canales, chats o miembros). En lugar de que Nappai tenga que estar revisando constantemente si hay novedades, el componente espera pasivamente hasta recibir la notificación.

Una vez que llega la alerta, el componente la lee, verifica que sea legítima y extrae la información clave (quién escribió, qué cambió, cuándo, etc.). Todo este proceso ocurre en segundo plano de forma automática y segura. No necesitas preocuparte por mantener la conexión activa o renovar permisos; Nappai se encarga de ello internamente para garantizar que tu automatización nunca se interrumpa.

Conexión y Credenciales

Este componente requiere configurar previamente una credencial en el panel de Nappai para poder interactuar con el servicio externo:

Dirígete a la sección de Credenciales en tu panel de Nappai.
Crea una nueva credencial del tipo Microsoft Teams y guarda los campos requeridos (Client ID, Client Secret, Tenant ID y Microsoft Teams Scope).
En tu flujo de trabajo, selecciona la credencial guardada en el campo de entrada Credential de este nodo.

Entradas

Los siguientes campos están disponibles para configurar este componente. Cada campo puede estar visible en diferentes operaciones:

Event: Selecciona qué tipo de cambio en Microsoft Teams activará este flujo de trabajo. Puedes elegir entre nuevas conversaciones de equipo, nuevos mensajes en un canal específico, mensajes en chats individuales o cualquier chat futuro.
Team: El equipo al que deseas vigilar. Solo aparecerán los equipos a los que has tenido acceso previamente. Al cambiar esta opción, la lista de canales se actualiza automáticamente.
Channel: El canal específico dentro del equipo seleccionado donde se buscarán los nuevos mensajes. La lista se refresca sola cuando cambias de equipo.
Chat: Las conversaciones de chat que deseas monitorear. Puedes seleccionar una o varias conversaciones. El sistema mostrará información adicional según si son chats 1 a 1 o grupales.
Ignore Own Messages: Cuando esta opción está activada, el componente ignorará automáticamente los mensajes que envíes tú mismo. Esto evita bucles infinitos donde tu automatización reacciona a sus propias acciones.

Salidas

Al ejecutarse correctamente, este componente produce una salida estructurada llamada Data que contiene toda la información relevante del evento detectado en Teams. Este dato incluye metadatos sobre el tipo de cambio, la ruta del recurso modificado y el contenido original, permitiéndote conectar este resultado a otros nodos para tomar decisiones, guardar registros o disparar acciones.

Ejemplo de Respuesta JSONjson

{ “event_type”: “created”, “resource_url”: “/teams/19%3Aabc123%40thread.tacv2/channels/xyz/messages/1698765432100”, “client_state”: “flow_validation_001”, “status_code”: 202, “notification_payload”: { “id”: “1698765432100”, “createdDateTime”: “2024-01-15T14:30:00Z”, “from”: { “user”: { “displayName”: “María García”, “id”: “user_001” } }, “body”: { “contentType”: “text”, “content”: “¡Reunión reprogramada para mañana a las 10:00 AM! Por favor confirmar asistencia.” } } }

Conectividad

Este componente funciona como el punto de inicio de una automatización reactiva. Lógicamente, su salida Data se conecta a nodos de:

Procesamiento de IA (Nappai Assistant): Para analizar el contenido del mensaje o evento y determinar la mejor respuesta.
Almacenamiento de Datos: Para registrar historical de cambios, crear registros en bases de datos o CRM.
Notificaciones o Acciones: Para disparar respuestas automáticas, agregar tareas a listas de tareas o actualizar estados en otras aplicaciones. Su conexión está diseñada para fluir de izquierda a derecha en tu flujo, alimentando el resto del sistema con datos actualizados y accionables.

Ejemplo de Uso

Escenario: Monitorear el canal “Proyectos 2024” de un equipo de trabajo para responder automáticamente a nuevos mensajes.

Arrastra el componente Teams Webhook a tu lienzo.
En el campo Event, selecciona On new channel message.
En Team, elige tu equipo de trabajo y en Channel selecciona Proyectos 2024.
Activa Ignore Own Messages para evitar que el flujo reaccione a tus propios mensajes.
Conecta la salida Data al primer nodo de la automatización (por ejemplo, un asistente de IA que redacte una respuesta o un nodo que guarde la solicitud en una hoja de cálculo).
Guarda y activa el flujo. Ahora, cada vez que alguien publique en ese canal, la automatización se activará de forma automática sin intervención manual.

Consejos y Mejores Prácticas

Define con precisión el Team y Channel en el que deseas escuchar. Cuanto más específico sea el monitoreo, más eficiente y rápido será tu automatización.
Usa Event para filtrar solo los cambios que realmente te importan. Evita seleccionar “On any chat message” a menos que necesites una visibilidad total y sin filtros.
Mantén activado Ignore Own Messages en flujos reactivos para evitar que tu propia automatización se active repetidamente sobre la misma conversación.
Monitorea el rendimiento de tu flujo en la sección de métricas de Nappai. Si recibes demasiadas notificaciones, ajusta los filtros de entrada para optimizar el consumo de recursos.

Consideraciones de Seguridad

Todas las credenciales se almacenan de forma encriptada y solo son accesibles dentro del entorno seguro de Nappai.
El componente utiliza autenticación estándar de Microsoft para verificar que solo se procesen notificaciones legítimas procedentes de tu organización.
Los datos transmitidos por el webhook viajan sobre conexiones HTTPS cifradas. Solo los usuarios con permisos adecuados podrán visualizar o usar la información entregada por este nodo.
Se recomienda revisar periódicamente las credenciales y actualizarlas si tu organización cambia las políticas de acceso.