betool betool

Documentazione

Email

Email in entrata (IMAP) e in uscita. Preservazione dei thread, parsing degli allegati.

Email

Il canale email ingerisce le tue email in entrata e permette a una pipeline di rispondere, inoltrare o creare attività a valle.

Modello

Due moduli complementari:

  • email_inbound — ricezione (IMAP)
  • email_outbound — invio (operatore configurato, o relay tramite il tuo SMTP)

Sono indipendenti: puoi usare solo il modulo inbound (per smistare senza rispondere), oppure solo il modulo outbound (per inviare notifiche da una pipeline innescata in altro modo).

Configurazione

  1. Amministrazione → Email → Caselle di posta — collega una casella IMAP con le sue credenziali.
  2. Associa la casella a una pipeline di destinazione.
  3. (Facoltativo) Configura un mittente (SMTP) per rispondere.

Per le architetture che devono mantenere il controllo dei propri server di posta, betool non sostituisce il tuo MTA: leggiamo e scriviamo tramite IMAP / SMTP standard.

Cosa riceve la pipeline

Per ogni email in entrata, viene creato un nuovo exchange con:

  • exchange.user_message — corpo dell'email (HTML → testo normalizzato)
  • exchange.email.subject — oggetto
  • exchange.email.from — mittente normalizzato
  • exchange.email.thread_id — identificatore del thread (utile per il contesto multi-turno)
  • exchange.email.attachments — elenco di FileMetadata (allegati elaborati)

Allegati

Gli allegati vengono passati al nodo file_transform per l'estrazione (testo semplice, OCR per i PDF scansionati, parsing strutturato per CSV / Excel). Da lì, il tuo agent può lavorarci come se fossero testo nativo.

Thread e contesto multi-turno

Quando un cliente risponde a una risposta precedente, betool riconosce il thread_id e ripristina la cronologia del thread nel contesto dell'agent. Questo è trasparente per la progettazione della pipeline.

Limitazioni note

  • Nessun supporto nativo per MS Exchange EWS ancora (puoi esporre Exchange tramite IMAP).
  • Nessun supporto Microsoft Graph per Office 365 (nella roadmap).
  • Il parsing di email molto vecchie (RTF Outlook 2003 annidato) può perdere parte della formattazione.