OutlookEmailWebhook

Bienvenido al componente OutlookEmailWebhook. Este nodo actúa como un “oyente” inteligente que vigila tu buzón de Outlook y captura automáticamente la información cuando llega un correo nuevo o se elimina uno. Su objetivo es tomar esos datos brutos y convertirlos en un formato limpio y ordenado, listo para ser usado en el resto de tu flujo de automatización dentro de Nappai.

¿Cómo funciona?

Este componente se conecta de forma segura a la infraestructura de Microsoft para consultar tu buzón de forma periódica (similar a una sincronización automática). Cuando detecta una acción relevante (como la recepción de un mensaje o su eliminación), extrae los detalles clave: asunto, remitente, cuerpo del mensaje, fecha de recepción, estado de lectura y si tiene archivos adjuntos.

Luego, organiza toda esta información en una estructura clara y legible. Esta salida estructurada es la que viaja hacia los siguientes nodos de tu flujo, permitiendo que otras herramientas de Nappai la lean, analicen o almacenen sin necesidad de que te preocupes por el formato técnico original.

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 Outlook y guarda los campos requeridos (Client ID, Client Secret, Tenant ID y Microsoft Outlook Access). Puedes generar estos datos fácilmente en el Portal de Microsoft Azure registrando una aplicación y otorgando los permisos necesarios para acceder a tu correo.
En tu flujo de trabajo, selecciona la credencial guardada en el campo de entrada Credential de este nodo.

Entradas

Campos de Entrada

Events: Permite elegir qué tipo de acciones de correo deseas monitorear en tu buzón. Puedes activar “Message Received” para detectar correos nuevos o “Message Deleted” para saber cuándo se elimina un mensaje. Si no seleccionas nada, el sistema usará automáticamente la opción de correos nuevos.
Mail Folder: Define en qué carpeta de tu buzón de Outlook debe buscar el sistema. Por defecto está configurado en “Inbox” (Bandeja de entrada), pero puedes cambiarlo si necesitas revisar otras carpetas específicas.

Salidas

El componente devuelve toda la información procesada en un formato estructurado listo para ser consumido por los siguientes pasos de tu flujo:

Data: Contiene un resumen detallado del evento de correo detectado. Si se detecta más de un evento a la vez, devolverá una lista con todos ellos; si es solo uno, lo devolverá directamente como un objeto único.

Ejemplo de Respuesta JSONjson

{ “event_type”: “received”, “id”: “AAMkADkxNjE4MzQ2…”, “subject”: “Reunión de equipo - Agenda”, “bodyPreview”: “Hola equipo, adjunto la agenda para la reunión de mañana…”, “receivedDateTime”: “2024-05-12T09:15:00Z”, “isRead”: false, “hasAttachments”: true, “from”: { “emailAddress”: { “address”: “ana.garcia@empresa.com” } }, “toRecipients”: [ { “emailAddress”: { “address”: “mi.cuenta@empresa.com” } } ] }

Conectividad

Como este componente funciona como un punto de entrada para datos de correo, lo más habitual es conectar su salida Data a:

Asistentes de IA o Analizadores de Texto: Para que Nappai pueda leer, resumir, clasificar o redactar respuestas automáticas basándose en el contenido del correo.
Sistemas de Registro o Bases de Datos: Para archivar la actividad de tu buzón, crear tickets de soporte automáticos o mantener un historial de correos.
Flujos de Notificación: Para alertar a miembros del equipo cuando llegue un mensaje de prioridad alta o se detecte un evento específico.

Ejemplo de Uso

Imagina que quieres automatizar la revisión de correos entrantes sin perder tiempo revisando el buzón manualmente. Configuras este componente en la carpeta Inbox y activas la opción Message Received. Cada vez que llegue un correo nuevo, el flujo capturará automáticamente los datos y los enviará a un nodo de IA para clasificarlos por categoría (ej. “Facturas”, “Solicitudes”, “Urgentes”). La salida Data fluirá entonces hacia un sistema de registro donde se guardarán los detalles, o hacia un asistente que redactará una respuesta inicial según reglas predefinidas.

Consejos y Mejores Prácticas

Revisa que tu credencial de Microsoft Outlook tenga los permisos correctos asignados en Azure para evitar interrupciones en la recepción de eventos.
Si solo necesitas monitorear correos nuevos, deja Events en su valor predeterminado para optimizar el rendimiento del sistema.
Conecta la salida a nodos de texto, IA o bases de datos para aprovechar al máximo la automatización de tu flujo.
Mantén un intervalo de sondeo razonable en la configuración del flujo para evitar exceder los límites de uso de la API de Microsoft.

Consideraciones de Seguridad

La credencial almacena información de acceso sensible; asegúrate de compartir el flujo solo con usuarios autorizados y evita publicar credenciales en entornos públicos.
Los datos de correo procesado pueden contener información confidencial o personal; verifica que el flujo cumpla con las políticas de privacidad y seguridad de datos de tu organización.
Microsoft Graph API tiene límites de frecuencia de uso; un sondeo muy agresivo o mal configurado podría ralentizar la recepción de eventos o activar advertencias de rate limiting en tu cuenta de Microsoft.