Integrationen — Task-Webhooks

Externe Task-Provider (Todoist, Linear, Things, Sonderanfragen, eigener Receiver) werden über Webhooks benachrichtigt, sobald der Action-Extractor neue Aufgaben aus einer Mail extrahiert. Authentifizierung via HMAC-SHA-256 über den JSON-Body (Header X-Mail-Agent-Signature: sha256=<hex>).

Neuen Webhook anlegen

Konfigurierte Webhooks

Kalender-Abo (iCal-Feed)

Erzeuge eine read-only Kalender-URL und abonniere sie in Apple Calendar, Outlook oder Thunderbird als „Internet-Kalender". Der Feed enthält alle Termine, denen du via Mail-Agent zugesagt hast (PARTSTAT=ACCEPTED).

Payload-Format

POST <deine-url>
Headers:
  Content-Type: application/json
  X-Mail-Agent-Signature: sha256=<hmac-hex>
  User-Agent: mail-agent-task-webhook/1.0

Body:
{
  "event": "task.created",
  "task": {
    "id": 123,
    "description": "Angebot bis Freitag senden",
    "source_quote": "bitte sende uns bis Freitag das Angebot",
    "due_at": "2026-05-16T12:00:00Z",
    "message_id": 456,
    "agent_name": "action-extractor"
  },
  "tenant_id": 1,
  "user_id": 1,
  "triggered_at": "2026-05-14T10:30:00.000Z"
}

Verifiziere die Signatur mit deinem Secret: hmac_sha256(secret, raw_body).hex() == <sig>