# Automazione webhook
SUMMARY: Attivi sistemi esterni quando le memorie cambiano — sync, notifiche, automazione.

Automazione webhook
I webhook permettono di attivare sistemi esterni quando si verificano eventi di
Synapse. Questa guida copre modelli di automazione comuni.
Modelli comuni
Modello 1: notifica su memoria critica
Invii un messaggio Slack quando una memoria critica viene salvata:
[CODE BLOCK]
Registri il webhook:
[CODE BLOCK]
Modello 2: sync a sistema esterno
Sincronizzi le memorie su Notion, Obsidian o qualsiasi KB esterno:
[CODE BLOCK]
Modello 3: attivazione CI/CD
Attivi un deployment quando viene salvata una memoria "release":
[CODE BLOCK]
Modello 4: svegli l'agente al messaggio dell'umano
Attivi un'esecuzione dell'agente LLM quando un umano invia un messaggio chat:
[CODE BLOCK]
Modello 5: aggrega metriche
Tracci la crescita della memoria, l'attività chat, il completamento delle attività:
[CODE BLOCK]
Verifica della firma
Verifichi sempre le firme dei webhook per prevenire spoofing:
[CODE BLOCK]
Logica di retry
Synapse ritenta i webhook falliti con backoff esponenziale. Il suo handler
dovrebbe:
1. Restituire 200 velocemente — non faccia lavoro pesante in modo sincrono
2. Accodare lavoro — usi un sistema di job in background
3. Essere idempotente — lo stesso evento può essere consegnato due volte
[CODE BLOCK]
Debug dei webhook
Verifichi la cronologia delle consegne
Le consegne dei webhook vengono loggate. Verifichi le consegne recenti del suo
webhook:
[CODE BLOCK]
Testi il webhook manualmente
[CODE BLOCK]
Problemi comuni
| Problema | Soluzione |
|-------|-----|
| Risposte 4xx | Verifichi che il suo handler restituisca 200 |
| Risposte 5xx | Errore del server — controlli i log della sua app |
| Timeout | Restituisca 200 velocemente, accodi lavoro async |
| Consegne duplicate | Renda l'handler idempotente |
| Mancata corrispondenza della firma | Verifichi che il secret sia corretto |
Best practice
> [!TIP]
> - Verifichi sempre le firme — non salti mai questo
> - Restituisca 200 velocemente — non blocchi Synapse
> - Sia idempotente — gestisca le consegne duplicate
> - Usi eventi specifici —  non 
> - Monitori i fallimenti di consegna — configuri alerting
Prossimi passi
- Webhooks API
- Cron & Scheduler
- Agente LLM persistente