Zum Hauptinhalt springen
connic

E-Mail

Von connic
InboundOutbound

Starte einen Agenten bei jeder neuen E-Mail in einem IMAP-Postfach, samt Anhängen, und versende seine Antworten per SMTP von deiner eigenen Adresse.

Publisher
Von connic
Modi
Inbound, Outbound
Einrichtung
Dashboard oder connectors/*.yaml
Dokumentation
E-Mail Docs

Jede neue E-Mail startet einen Run

connic prüft das Postfach per IMAP und übergibt jede neue Nachricht als strukturierte Felder an jeden verknüpften Agenten.

Geparste Felder
Absender, Betreff, Message-ID, Text- und HTML-Body sowie Anhänge kommen als eigene Felder an.
Filter vor dem Run
Überwache einen Ordner, standardmäßig INBOX, und beschränke ihn auf ungelesene Mails, eine Absenderadresse oder Domain oder einen Text im Betreff. Mails, die nicht passen, starten keinen Run.
Gelesen-Markierung
connic markiert jede Nachricht als gelesen, sobald ihre Runs in der Warteschlange stehen. So siehst du im Mailprogramm, was der Agent übernommen hat. Schalte das ab, wenn die Markierungen bleiben sollen, wie sie sind.
email-payload.json
{
  "from": "Jana Weber <jana@example.com>",
  "from_address": "jana@example.com",
  "to": "support@example.com",
  "subject": "Order ord_8812 arrived damaged",
  "date": "Tue, 13 Oct 2026 09:12:04 +0200",
  "message_id": "<c41f9a@mail.example.com>",
  "body_text": "Hi, the lamp in my order arrived broken.",
  "body_html": "<p>Hi, the lamp in my order arrived broken.</p>",
  "has_attachments": true,
  "attachments": [
    {
      "filename": "lamp.jpg",
      "content_type": "image/jpeg",
      "size_bytes": 182044,
      "content": "/9j/4AAQSkZJRgABAQ...",
      "encoding": "base64"
    }
  ],
  "_email": {
    "connector_id": "550e8400-e29b-41d4-a716-446655440000",
    "mailbox": "INBOX",
    "uid": "4127",
    "timestamp": "2026-10-13T07:12:31.204518"
  }
}

Anhänge kommen lesbar an

Unterstützte Anhänge bringen ihren Inhalt mit, damit der Agent das PDF oder Foto im selben Run verarbeiten kann.

Bis zu 10 Dateien
Pro E-Mail kommen bis zu 10 unterstützte Anhänge an, mit 10 MiB pro Datei und 10 MiB insgesamt. Textformate kommen als Text, alles andere base64-codiert.
Unterstützte Formate
Bilder, PDFs, Text, CSV, Markdown, JSON, XML, HTML sowie Word-, Excel- und PowerPoint-Dateien.
Übersprungene Dateien
Tracking-Pixel, Favicons und Signaturbilder fallen weg. Jeder andere übersprungene Anhang bleibt mit content: null in der Liste, der Grund steht in file_issues, und die E-Mail erreicht den Agenten trotzdem.
payload["attachments"]
[
  {
    "filename": "invoice-2041.pdf",
    "content_type": "application/pdf",
    "size_bytes": 48213,
    "content": "JVBERi0xLjcKJeLjz9MK...",
    "encoding": "base64"
  },
  {
    "filename": "delivery-note.csv",
    "content_type": "text/csv",
    "size_bytes": 25,
    "content": "sku,qty\nLMP-20,1\nLMP-21,2",
    "encoding": "text"
  },
  {
    "filename": "budget.numbers",
    "content_type": "application/octet-stream",
    "size_bytes": 96512,
    "content": null,
    "content_omitted": true,
    "file_issue": {
      "code": "unsupported_file_type",
      "message": "File type is not supported.",
      "retryable": false,
      "name": "budget.numbers",
      "size_bytes": 96512
    }
  }
]

Halte das Postfach neben deinen Agenten

Deklariere die Verbindung in connectors/. Die Zugangsdaten für IMAP und SMTP liegen in einer Connection, die die Datei nur beim Namen nennt. So bleiben Passwörter aus deinem Code, und jedes Environment kann ein eigenes Postfach nutzen.

connectors/support-inbox.yaml
type: email
mode: inbound
name: Support inbox
connection: support-mailbox
config:
  mailbox: Support
agents:
  - support-triage
environments:
  Staging:
    connection: support-mailbox-staging
  Production: {}
create: connectors/support-inbox.yaml (email)

Antworte von deiner eigenen Adresse

Eine ausgehende E-Mail-Verbindung macht aus dem Output des Agenten eine E-Mail, sendet sie über den SMTP-Server aus deiner Connection und versucht es erneut, wenn der Versand fehlschlägt.

Antworten finden den Absender
Ohne Feld to nimmt connic den Standardempfänger der Verbindung, danach den Absender der E-Mail, die den Run gestartet hat. Ohne eigenen Betreff übernimmt die Antwort den ursprünglichen mit Re: davor.
Text oder JSON
Reiner Text wird zum Body. Mit JSON setzt der Agent to, cc, bcc, subject, html_body und reply_to. Sende nach jedem Run, als Tool, das das Modell aufruft, oder aus Middleware.
Private Mailserver
Leite IMAP- und SMTP-Verkehr über eine Bridge, wenn der Mailserver nur in deinem Netzwerk erreichbar ist.
output.json
{
  "body": "Sorry about the lamp, Jana. A replacement ships today."
}
sent.eml
From: Example Support <support@example.com>
To: jana@example.com
Subject: Re: Order ord_8812 arrived damaged

Sorry about the lamp, Jana. A replacement ships today.

Wo E-Mail passt

Wähle ein Szenario und sieh, was ankommt, welcher Agent läuft und was verschickt wird.

Kunden schreiben an deine Support-Adresse, und die Antwort des Agenten geht per SMTP an sie zurück.

Support-Postfach
Inbound E-Mail
support-triage
Antwort an den Absender
email-payload.json
{
  "from_address": "sam@example.com",
  "subject": "Change delivery address for ord_9035",
  "body_text": "Please ship it to my office instead.",
  "has_attachments": false,
  "attachments": []
}
reply.eml
From: Example Support <support@example.com>
To: sam@example.com
Subject: Re: Change delivery address for ord_9035

Done. Order ord_9035 now ships to your office.

Lieferanten schicken PDF-Rechnungen per E-Mail, und die Kreditorenbuchhaltung bekommt die ausgelesenen Summen per Mail.

Lieferantenrechnungen
Inbound E-Mail
invoice-extractor
Zusammenfassung an die Buchhaltung
email-payload.json
{
  "from_address": "billing@supplier.example",
  "subject": "Invoice INV-2041",
  "has_attachments": true,
  "attachments": [
    {
      "filename": "INV-2041.pdf",
      "content_type": "application/pdf",
      "size_bytes": 48213,
      "content": "JVBERi0xLjcKJeLjz9MK...",
      "encoding": "base64"
    }
  ]
}
output.json
{
  "to": "ap@example.com",
  "subject": "INV-2041: 3 items, EUR 1,284.50",
  "body": "Due Nov 12. Line items and VAT add up to the total."
}

Der Agent erledigt Routineanfragen und gibt den Rest über ein E-Mail-Tool an dein Team ab.

Gemeinsames Postfach
Inbound E-Mail
support-agent
Übergabe an dein Team
email-payload.json
{
  "from_address": "lea@example.com",
  "subject": "Refund for a cancelled booking",
  "body_text": "I cancelled booking B-5521 within 24 hours.",
  "has_attachments": false,
  "attachments": []
}
tool-call.json
{
  "to": "support-leads@example.com",
  "subject": "Refund decision needed: booking B-5521",
  "body": "Lea cancelled within 24 hours and asks for a full refund."
}

Ein Zeitplan startet den Agenten jeden Montag, und der Bericht erreicht dein Team als HTML-Mail.

Montags um 08:00
Cron-Scheduler
weekly-report
Bericht per E-Mail
cron-payload.json
{
  "trigger": "cron",
  "schedule": "0 8 * * 1",
  "triggered_at": "2026-10-12T08:00:00.000Z",
  "prompt": "Write the weekly support report"
}
output.json
{
  "to": ["lead@example.com", "ops@example.com"],
  "subject": "Support report, week 41",
  "body": "412 tickets, median first reply 38 minutes.",
  "html_body": "<h2>Week 41</h2><p>412 tickets, median first..."
}

FAQ zu E-Mail

Ja. Verknüpfe den Agenten mit einer eingehenden und einer ausgehenden E-Mail-Verbindung. Die Antwort geht an den Absender, außer der Output setzt to oder die Verbindung hat einen Standardempfänger. Ohne eigenen Betreff übernimmt sie den ursprünglichen mit Re: davor. Reiner Text wird zum Body.

Ja. Aktiviere die Zwei-Faktor-Authentifizierung für das Google-Konto, erstelle ein App-Passwort für Mail und nutze es mit imap.gmail.com oder smtp.gmail.com anstelle des Kontopassworts.

Bis zu 10 unterstützte Anhänge pro E-Mail, mit 10 MiB pro Datei und 10 MiB insgesamt: Bilder, PDFs, Text, CSV, Markdown, JSON, XML, HTML sowie Word-, Excel- und PowerPoint-Dateien. Textformate kommen als Text an, der Rest base64-codiert. Tracking-Pixel und Signaturbilder fallen weg, jede andere übersprungene Datei steht in file_issues.

Ja, wenn sie zu den Filtern passen. Mit Unread Only, der Standardeinstellung, holt die erste Prüfung jede ungelesene Nachricht im Ordner ab. Markiere ältere Mails als gelesen oder nutze einen eigenen Ordner, bevor du den Agenten verknüpfst.

Ja. Hinterlege an der Verbindung eine Bridge, dann leitet connic den IMAP- oder SMTP-Verkehr über die Bridge in deinem Netzwerk.