# Automatisation par webhooks
SUMMARY: Déclenchez des systèmes externes quand les mémoires changent — synchronisation, notification, automatisation.

Automatisation par webhooks
Les webhooks permettent de déclencher des systèmes externes quand des événements
Synapse se déclenchent. Ce guide couvre les schémas d'automatisation courants.
Schémas courants
Schéma 1 : notification sur mémoire critique
Envoyez un message Slack quand une mémoire critique est stockée :
[CODE BLOCK]
Enregistrez le webhook :
[CODE BLOCK]
Schéma 2 : synchronisation vers système externe
Synchronisez les mémoires vers Notion, Obsidian ou n'importe quelle KB externe :
[CODE BLOCK]
Schéma 3 : déclencher CI/CD
Déclenchez un déploiement quand une mémoire « release » est stockée :
[CODE BLOCK]
Schéma 4 : réveiller l'agent sur message humain
Déclenchez une exécution d'agent LLM quand un humain envoie un message de chat :
[CODE BLOCK]
Schéma 5 : agréger les métriques
Suivez la croissance de la mémoire, l'activité chat, la complétion des tâches :
[CODE BLOCK]
Vérification de signature
Vérifiez toujours les signatures de webhook pour empêcher l'usurpation :
[CODE BLOCK]
Logique de réessai
Synapse réessaie les webhooks échoués avec un backoff exponentiel. Votre gestionnaire
devrait :
1. Renvoyer 200 rapidement — ne pas faire de travail lourd de manière synchrone
2. Mettre en file le travail — utiliser un système de tâches en arrière-plan
3. Être idempotent — le même événement peut être livré deux fois
[CODE BLOCK]
Débogage des webhooks
Consulter l'historique de livraison
Les livraisons de webhook sont journalisées. Vérifiez les livraisons récentes de votre
webhook :
[CODE BLOCK]
Tester le webhook manuellement
[CODE BLOCK]
Problèmes courants
| Problème | Correction |
|-------|-----|
| Réponses 4xx | Vérifiez que votre gestionnaire renvoie 200 |
| Réponses 5xx | Erreur serveur — vérifiez les logs de votre application |
| Timeout | Renvoyez 200 rapidement, mettez le travail en file asynchrone |
| Livraisons en double | Rendez le gestionnaire idempotent |
| Non-correspondance de signature | Vérifiez que le secret est correct |
Bonnes pratiques
> [!TIP]
> - Toujours vérifier les signatures — ne jamais sauter cela
> - Renvoyer 200 rapidement — ne pas bloquer Synapse
> - Être idempotent — gérer les livraisons en double
> - Utiliser des événements spécifiques —  pas 
> - Surveiller les échecs de livraison — configurez l'alerting
Prochaines étapes
- API Webhooks
- Cron & Scheduler
- Agent LLM persistant