E-Mail Inbound

OpsWeave kann eingehende E-Mails automatisch in Tickets umwandeln und Antworten bestehenden Tickets als Kommentare zuordnen.

Konfiguration

E-Mail-Konfigurationen werden unter Einstellungen → E-Mail verwaltet.

Provider-Typen

Typ	Beschreibung
imap	IMAP-Polling (periodischer Abruf)
webhook_mailgun	Mailgun Inbound-Webhook
webhook_sendgrid	SendGrid Inbound-Parse
smtp_gateway	SMTP-Gateway (eigener MX)

IMAP-Konfiguration

{
  "host": "imap.example.com",
  "port": 993,
  "secure": true,
  "username": "support@example.com",
  "password": "..."
}

Thread-Matching

OpsWeave erkennt, ob eine eingehende E-Mail eine Antwort auf ein bestehendes Ticket ist:

Prioritaet 1: In-Reply-To / References Header → bekannte message_id?

Prioritaet 2: Betreff enthaelt Ticket-Nummer (z. B. Re: [INC-2026-00042] Server nicht erreichbar)

Treffer gefunden: E-Mail wird als externer Kommentar an das Ticket angefuegt.

Kein Treffer: Ein neues Ticket wird erstellt (Ticket-Typ aus Konfiguration, Gruppe aus target_group_id).

Auto-Ticket

Neue E-Mails ohne Thread-Treffer erstellen automatisch ein Ticket:

• Titel: E-Mail-Betreff
• Beschreibung: E-Mail-Body (Textversion)
• Quelle: email
• Typ: Konfigurierbar pro E-Mail-Konfiguration (incident oder change)
• Gruppe: target_group_id aus Konfiguration
• Melder: E-Mail-Absender (als Text gespeichert)

Webhook-Eingang

Fuer Mailgun und SendGrid wird ein oeffentlicher Webhook-Endpunkt genutzt:

POST /api/v1/email/webhook?provider=mailgun&config_id=<id>
POST /api/v1/email/webhook?provider=sendgrid&config_id=<id>

REST API

GET    /api/v1/email/configs           # E-Mail-Konfigurationen
POST   /api/v1/email/configs           # Konfiguration erstellen
GET    /api/v1/email/configs/:id        # Detail
PUT    /api/v1/email/configs/:id        # Aktualisieren
DELETE /api/v1/email/configs/:id        # Loeschen
POST   /api/v1/email/configs/:id/test   # Verbindungstest (IMAP)
GET    /api/v1/email/messages           # Empfangene E-Mails (paginiert)
GET    /api/v1/email/messages/:id        # E-Mail-Detail
POST   /api/v1/email/webhook            # Webhook-Endpunkt (oeffentlich)

IMAP-Poller

Der IMAP-Poller ist als Konfiguration vollstaendig implementiert. Der Hintergrund-Worker fuer aktives IMAP-Polling wird in einer spaeteren Version aktiviert. Webhook-basierte Provider (Mailgun, SendGrid) funktionieren sofort.