Documentación

Email

Email entrante (IMAP) y saliente. Preservación de hilos, análisis de adjuntos.

Email

El canal de email ingiere tus correos entrantes y permite que un pipeline responda, reenvíe o cree tareas aguas abajo.

Modelo

Dos módulos complementarios:

  • email_inbound — recepción (IMAP)
  • email_outbound — envío (operador configurado, o retransmisión vía tu SMTP)

Son independientes: puedes usar solo el módulo entrante (para triar sin responder), o solo el módulo saliente (para enviar notificaciones desde un pipeline disparado de otra forma).

Configuración

  1. Administración → Email → Buzones — conecta un buzón IMAP con sus credenciales.
  2. Asigna el buzón a un pipeline de destino.
  3. (Opcional) Configura un remitente (SMTP) para responder.

Para arquitecturas que necesitan mantener el control de sus servidores de correo, betool no reemplaza tu MTA: leemos y escribimos vía IMAP / SMTP estándar.

Qué recibe el pipeline

Por cada correo entrante, se crea un nuevo exchange con:

  • exchange.user_message — cuerpo del email (HTML → texto normalizado)
  • exchange.email.subject — línea de asunto
  • exchange.email.from — remitente normalizado
  • exchange.email.thread_id — identificador del hilo (útil para el contexto multi-turno)
  • exchange.email.attachments — lista de FileMetadata (adjuntos analizados)

Adjuntos

Los adjuntos se pasan al nodo file_transform para su extracción (texto plano, OCR para PDF escaneados, análisis estructurado para CSV / Excel). A partir de ahí, tu agente puede trabajar con ellos como si fueran texto nativo.

Hilos y contexto multi-turno

Cuando un cliente responde a una respuesta anterior, betool reconoce el thread_id y restaura el historial del hilo en el contexto del agente. Esto es transparente para el diseño del pipeline.

Limitaciones conocidas

  • Todavía sin soporte nativo para MS Exchange EWS (puedes exponer Exchange sobre IMAP).
  • Sin soporte para Microsoft Graph en Office 365 (en la hoja de ruta).
  • Analizar correos muy antiguos (RTF anidado de Outlook 2003) puede perder parte del formato.