E-Mail Inbound

Die Email Inbound API verarbeitet eingehende E-Mails von externen Mail-Diensten (Mailgun) und stellt Endpunkte für den einheitlichen Posteingang bereit.

Endpunkte

Method	Path	Beschreibung
POST	/api/v1/email/inbound	Eingehende E-Mail vom Mailgun-Webhook empfangen
POST	/api/v1/inbox/upload	Dokumente in den einheitlichen Posteingang hochladen
GET	/api/v1/inbox/document/{id}/related	Zugehörige E-Mails und Dokumente zu einem Posteingangs-Dokument abrufen

Mailgun-Webhook

POST /api/v1/email/inbound

Dieser Endpunkt empfängt eingehende E-Mails von Mailgun. Die Authentifizierung erfolgt über Mailguns HMAC-Signatur-Verifizierung (nicht per API-Key). Das System:

1. Parst die E-Mail (Header, Body, Anhänge)
2. Erstellt einen Korrespondenz-Datensatz
3. Extrahiert Anhänge und speichert sie als Dokumente
4. Versucht, den Absender einer bestehenden Partei zuzuordnen
5. Führt KI-Triage aus (Kategorie, Priorität, vorgeschlagene Zuweisung)

Request (von Mailgun)

Der Request Body ist application/x-www-form-urlencoded mit Mailguns Standardfeldern:

Field	Beschreibung
from	Absender-E-Mail-Adresse
to	Empfänger-E-Mail-Adresse
subject	Betreffzeile
body-plain	Plain-Text-Body
body-html	HTML-Body
attachment-N	Angehängte Dateien (multipart)
timestamp	Mailgun-Zeitstempel
token	Mailgun-Token
signature	HMAC-SHA256-Signatur

Antwort

Liefert 200 OK bei erfolgreicher Verarbeitung. Die E-Mail wird asynchron verarbeitet.

In Posteingang hochladen

POST /api/v1/inbox/upload
Content-Type: multipart/form-data

Laden Sie ein oder mehrere Dokumente direkt in den einheitlichen Posteingang hoch. Dokumente durchlaufen dieselbe Verarbeitungspipeline wie per E-Mail eingegangene Dokumente.

Formularfelder

Field	Type	Required	Beschreibung
files	File[]	Yes	Eine oder mehrere hochzuladende Dateien
source	string	No	Quellenkennung (z. B. „scanner“, „drag-drop“)

Antwort

{
  "uploaded": [
    {
      "document_id": "doc_01ABCDEF",
      "filename": "contract.pdf",
      "status": "processing"
    }
  ]
}

Zugehörige Dokumente

GET /api/v1/inbox/document/{document_id}/related

Liefert alle E-Mails und Dokumente zu einem Posteingangs-Dokument -- E-Mails desselben Absenders, Dokumente derselben Akte usw.

Antwort

{
  "emails": [
    {
      "id": "corr_01",
      "subject": "RE: Contract Review",
      "from": "client@example.com",
      "received_at": "2026-05-20T14:00:00Z"
    }
  ],
  "documents": [
    {
      "id": "doc_01ABCDEF",
      "filename": "contract_v2.pdf",
      "case_id": "550e8400-..."
    }
  ]
}

Nächste Schritte

• E-Mail Outbound -- E-Mails senden und Entwürfe verwalten
• Dokumente -- Dokumentenverwaltung