# Webhook-Automation
SUMMARY: Externe Systeme triggern, wenn sich Memories ändern — synchronisieren, benachrichtigen, automatisieren.

Webhook-Automation
Webhooks ermöglichen das Triggern externer Systeme, wenn Synapse-Events feuern.
Dieser Guide behandelt häufige Automations-Patterns.
Häufige Patterns
Pattern 1: Bei kritischem Memory benachrichtigen
Slack-Nachricht senden, wenn ein kritischer Memory gespeichert wird:
[CODE BLOCK]
Webhook registrieren:
[CODE BLOCK]
Pattern 2: Zu externem System synchronisieren
Memories zu Notion, Obsidian oder jede andere externe KB synchronisieren:
[CODE BLOCK]
Pattern 3: CI/CD triggern
Ein Deployment auslösen, wenn ein „Release"-Memory gespeichert wird:
[CODE BLOCK]
Pattern 4: Agent bei Mensch-Nachricht aufwecken
Einen LLM-Agent-Lauf triggern, wenn ein Mensch eine Chat-Nachricht sendet:
[CODE BLOCK]
Pattern 5: Metriken aggregieren
Memory-Wachstum, Chat-Aktivität, Task-Abschluss tracken:
[CODE BLOCK]
Signatur-Verifikation
Verifiziere immer Webhook-Signaturen, um Spoofing zu verhindern:
[CODE BLOCK]
Retry-Logik
Synapse wiederholt fehlgeschlagene Webhooks mit exponentiellem Backoff. Dein
Handler sollte:
1. Schnell 200 zurückgeben — keine schwere Arbeit synchron erledigen
2. Arbeit in Queue stellen — ein Hintergrund-Job-System verwenden
3. Idempotent sein — dasselbe Event kann zweimal zugestellt werden
[CODE BLOCK]
Webhooks debuggen
Zustellhistorie prüfen
Webhook-Zustellungen werden protokolliert. Prüfe die letzten Zustellungen
deines Webhooks:
[CODE BLOCK]
Webhook manuell testen
[CODE BLOCK]
Häufige Probleme
| Issue | Fix |
|-------|-----|
| 4xx-Antworten | Prüfen, dass dein Handler 200 liefert |
| 5xx-Antworten | Server-Fehler — App-Logs prüfen |
| Timeout | 200 schnell zurückgeben, Arbeit async stellen |
| Duplikate | Handler idempotent machen |
| Signatur-Fehler | Secret auf Korrektheit prüfen |
Best Practices
> [!TIP]
> - Immer Signaturen verifizieren — niemals überspringen
> - Schnell 200 zurückgeben — Synapse nicht blockieren
> - Idempotent sein — Duplikat-Zustellungen behandeln
> - Spezifische Events verwenden —  nicht 
> - Zustellfehler überwachen — Alerting einrichten
Nächste Schritte
- Webhooks-API
- Cron & Scheduler
- Persistenter LLM-Agent
Conditional Trigger Patterns (v1.18.14)
Register a webhook that fires only when the event payload satisfies a
category/tag/priority combination — e.g. alert only on critical security facts:
[CODE BLOCK]
Filter fields (all optional, but at least one required):
| Field | Meaning |
|---|---|
|  | fire only if  is one of these |
|  | fire only if  contains the given tag(s) |
|  |  (default) = at least one tag matches;  = every listed tag must be present |
|  | fire only if payload priority rank ≥ this () |
Safe defaults: events whose payload has no category/tags (e.g. ,
chat events) never fire filtered webhooks; a corrupt  JSON is treated as
unfiltered (the webhook stays active);  ignores the filter
on purpose. Note: only  /  payloads carry
// — including the GET alternatives
(, ), which fire webhooks since
v1.18.14.