Email

El componente Email te permite interactuar con tu bandeja de Outlook directamente desde el dashboard de Nappai. Con él puedes leer mensajes, enviar nuevos correos, moverlos entre carpetas, marcar como leídos, eliminar o responder, y también obtener la lista de carpetas disponibles. Todo esto se hace a través de la API de Microsoft Outlook, por lo que necesitas una credencial configurada previamente.

¿Cómo funciona?

El componente se conecta a la API de Microsoft Outlook mediante la credencial que hayas creado en Azure. Cuando seleccionas una operación, el componente envía la solicitud correspondiente a la API y devuelve los datos en formato JSON. Si habilitas Mapping Mode, puedes procesar varios registros a la vez, enviando un lote de valores y recibiendo un lote de respuestas.

Operaciones

Este componente ofrece varias operaciones que puedes seleccionar según lo que necesites hacer. Solo puedes usar una operación a la vez:

• Get Message: Recupera el contenido de un correo específico.
• Get Folders: Obtiene la lista de carpetas de tu bandeja de Outlook.
• Send Message: Envía un nuevo correo electrónico.
• Delete Message: Elimina un correo existente.
• Move Message: Mueve un correo a otra carpeta.
• Mark as Read: Marca un correo como leído.
• Reply Message: Responde a un correo existente.

Para usar el componente, primero selecciona la operación que necesitas en el campo “Operation” (Operación).

Entradas

Modo de Mapeo (Mapping Mode)

Este componente cuenta con un modo especial llamado “Mapping Mode” (Modo de Mapeo). Cuando activas este modo mediante el interruptor, se habilita una entrada adicional llamada “Mapping Data” y cada campo de entrada te ofrece tres formas diferentes de proporcionar datos:

• Fixed (Fijo): Escribes el valor directamente en el campo.
• Mapped (Mapeado): Conectas la salida de otro componente para usar su resultado como valor.
• Javascript: Escribes código Javascript para calcular el valor dinámicamente.

Esta flexibilidad te permite crear flujos de trabajo más dinámicos y conectados.

Campos de Entrada

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

• Attachments: Email attachments ( File ID, File URL or File content )
  • Visible en: Send Message
• Operations: [DropdownInput] (requerido)
  • Visible en: Get Message, Get Folders, Send Message, Delete Message, Move Message, Mark as Read, Reply Message
• Body: Body content of the email
  • Visible en: Send Message, Reply Message
• Folder ID: ID of the Outlook folder
  • Visible en: Get Message, Move Message
• Folders: Outlook folders
  • Visible en: Get Message, Move Message
• Fetch Attachments: 📥 Download attachments found in the emails. If disabled, attachments will be ignored. This is required for processing attachments.
  • Visible en: Get Message, Move Message
• Mapping Mode: Enable mapping mode to process multiple data records in batch
  • Visible en: Get Message, Get Folders, Send Message, Delete Message, Move Message, Mark as Read, Reply Message
• Max Count: Maximum number of emails to retrieve
  • Visible en: Get Message
• Message ID: ID of the email message
  • Visible en: Get Message
• Message ID (para otras operaciones): ID of the email message
  • Visible en: Delete Message, Move Message, Mark as Read, Reply Message
• Selection Mode: [DropdownInput]
  • Visible en: Move Message
• Process Attachments: 📄 Requires ‘Fetch Attachments’. If enabled, attempts to extract text content from supported downloaded attachments (e.g., PDF, DOCX). If disabled, attachments are fetched but not processed for text.
  • Visible en: Get Message, Move Message
• Selection Mode (para Get Message): [DropdownInput]
  • Visible en: Get Message
• Receiver: Email address of the recipient
  • Visible en: Send Message
• Subject: Subject of the email
  • Visible en: Send Message, Reply Message
• Tool Name: The name of the tool that will be used when this component is connected as a tool. This name will be displayed to the agent when it selects tools to use.
  • Visible en: Get Message, Get Folders, Send Message, Delete Message, Move Message, Mark as Read, Reply Message
• Tool Description: A detailed description of what this tool does. This description will help the agent understand when and how to use this tool effectively.
  • Visible en: Get Message, Get Folders, Send Message, Delete Message, Move Message, Mark as Read, Reply Message
• Tools arguments metadata: Defines the arguments metadata for the tools.
  • Visible en: Get Message, Get Folders, Send Message, Delete Message, Move Message, Mark as Read, Reply Message

Nota: Antes de usar el componente, debes configurar una credencial de tipo Microsoft Outlook en la sección de credenciales de Nappai y luego seleccionarla en el campo “Credential” del componente.

Salidas

• Data: Tipo de datos: Data (método: perform_action). Contiene la información devuelta por la API, como el cuerpo del mensaje, la lista de carpetas, etc.
• Tool: Tipo de datos: Tool (método: to_toolkit). Permite que el componente sea usado como una herramienta por agentes de IA dentro de Nappai.

Ejemplo de Uso

Escenario: Enviar un correo a un cliente con un archivo adjunto.

1. Arrastra el componente Email al flujo de trabajo.
2. Selecciona la operación Send Message.
3. En el campo Receiver, escribe la dirección de correo del cliente.
4. En Subject, escribe “Actualización de proyecto”.
5. En Body, escribe el mensaje que deseas enviar.
6. En Attachments, selecciona el archivo que quieres adjuntar (puede ser un ID de archivo, una URL o el contenido del archivo).
7. Asegúrate de que la credencial “Microsoft Outlook” esté seleccionada.
8. Ejecuta el flujo. El componente enviará el correo y devolverá la respuesta en la salida Data.

Escenario: Obtener los últimos 5 correos de la bandeja de entrada.

1. Selecciona la operación Get Message.
2. En Max Count, escribe 5.
3. En Fetch Attachments, activa la casilla si quieres descargar los archivos adjuntos.
4. Ejecuta el flujo. Los correos se devolverán en la salida Data.

Componentes Relacionados

• OutlookFolderComponent – Permite crear, actualizar o eliminar carpetas de Outlook.
• OutlookCalendarComponent – Gestiona eventos y citas en el calendario de Outlook.

Consejos y Mejores Prácticas

• Usa Mapping Mode cuando necesites procesar varios correos a la vez; esto reduce el número de llamadas a la API.
• Limita el número de correos con Max Count para evitar tiempos de espera largos.
• Activa Fetch Attachments solo cuando realmente necesites los archivos; de lo contrario, desactívalo para ahorrar ancho de banda.
• Guarda los IDs de mensajes que envías o recibes para poder referenciarlos en operaciones posteriores (por ejemplo, para marcar como leído o mover).

Consideraciones de Seguridad

• La credencial de Microsoft Outlook contiene información sensible (Client ID, Client Secret, Tenant ID). Asegúrate de que solo usuarios autorizados tengan acceso a la sección de credenciales.
• Cuando envíes correos con archivos adjuntos, verifica que los archivos no contengan malware.
• Si utilizas Process Attachments, ten en cuenta que la extracción de texto puede consumir recursos; habilítalo solo cuando sea necesario.