# 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