Dokumentation

E-Mail

Eingehende E-Mail (IMAP) und ausgehend. Thread-Erhalt, Analyse von Anhängen.

E-Mail

Der Kanal E-Mail nimmt Ihre eingehenden E-Mails auf und ermöglicht es einer Pipeline, zu antworten, weiterzuleiten oder nachgelagerte Aufgaben zu erstellen.

Modell

Zwei sich ergänzende Module:

  • email_inbound — Empfang (IMAP)
  • email_outbound — Versand (konfigurierter Betreiber oder Relay über Ihr SMTP)

Sie sind unabhängig: Sie können nur das Eingangsmodul nutzen (zum Sortieren ohne Antworten) oder nur das Ausgangsmodul (um Benachrichtigungen aus einer anderweitig ausgelösten Pipeline zu senden).

Einrichtung

  1. Administration → E-Mail → Postfächer — verbinden Sie ein IMAP-Postfach mit seinen Zugangsdaten.
  2. Ordnen Sie das Postfach einer Ziel-Pipeline zu.
  3. (Optional) Konfigurieren Sie einen Absender (SMTP) zum Antworten.

Für Architekturen, die die Kontrolle über ihre Mailserver behalten müssen, ersetzt betool Ihren MTA nicht: Wir lesen und schreiben über Standard-IMAP / -SMTP.

Was die Pipeline erhält

Für jede eingehende E-Mail wird ein neuer exchange erstellt mit:

  • exchange.user_message — E-Mail-Text (HTML → normalisierter Text)
  • exchange.email.subject — Betreffzeile
  • exchange.email.from — normalisierter Absender
  • exchange.email.thread_id — Thread-Kennung (nützlich für Mehrschritt-Kontext)
  • exchange.email.attachments — Liste von FileMetadata (analysierte Anhänge)

Anhänge

Anhänge werden zur Extraktion an den Knoten file_transform übergeben (Klartext, OCR für gescannte PDFs, strukturierte Analyse für CSV / Excel). Von dort kann Ihr Agent mit ihnen arbeiten, als wären sie nativer Text.

Threads & Mehrschritt-Kontext

Wenn ein Kunde auf eine frühere Antwort reagiert, erkennt betool die thread_id und stellt den Thread-Verlauf im Kontext des Agents wieder her. Dies ist für das Pipeline-Design transparent.

Bekannte Einschränkungen

  • Noch keine native MS-Exchange-EWS-Unterstützung (Sie können Exchange über IMAP bereitstellen).
  • Keine Microsoft-Graph-Unterstützung für Office 365 (auf der Roadmap).
  • Die Analyse sehr alter E-Mails (verschachteltes Outlook-2003-RTF) kann etwas Formatierung verlieren.