# Automatización con webhooks
SUMMARY: Dispare sistemas externos cuando cambian las memorias — sincronice, notifique, automatice.

Automatización con webhooks
Los webhooks le permiten disparar sistemas externos cuando ocurren eventos en
Synapse. Esta guía cubre patrones comunes de automatización.
Patrones comunes
Patrón 1: Notificar ante memoria crítica
Envíe un mensaje de Slack cuando se almacena una memoria crítica:
[CODE BLOCK]
Registre el webhook:
[CODE BLOCK]
Patrón 2: Sincronizar con sistema externo
Sincronice memorias con Notion, Obsidian o cualquier KB externo:
[CODE BLOCK]
Patrón 3: Disparar CI/CD
Dispare un despliegue cuando se almacena una memoria "release":
[CODE BLOCK]
Patrón 4: Despertar al agente ante un mensaje humano
Dispare una ejecución del agente LLM cuando un humano envía un mensaje de chat:
[CODE BLOCK]
Patrón 5: Agregar métricas
Haga seguimiento del crecimiento de memoria, actividad de chat, finalización de
tareas:
[CODE BLOCK]
Verificación de firma
Verifique siempre las firmas de webhook para prevenir suplantación:
[CODE BLOCK]
Lógica de reintento
Synapse reintenta los webhooks fallidos con backoff exponencial. Su handler
debería:
1. Devolver 200 rápidamente — no haga trabajo pesado de forma síncrona
2. Encolar trabajo — use un sistema de jobs en segundo plano
3. Ser idempotente — el mismo evento puede entregarse dos veces
[CODE BLOCK]
Depuración de webhooks
Comprobar historial de entregas
Las entregas de webhook se registran. Compruebe las entregas recientes de su
webhook:
[CODE BLOCK]
Probar el webhook manualmente
[CODE BLOCK]
Problemas comunes
| Problema | Solución |
|-------|-----|
| Respuestas 4xx | Compruebe que su handler devuelve 200 |
| Respuestas 5xx | Error del servidor — revise los logs de su app |
| Timeout | Devuelva 200 rápido, encole trabajo asíncrono |
| Entregas duplicadas | Haga el handler idempotente |
| Fallo de firma | Verifique que el secreto es correcto |
Mejores prácticas
> [!TIP]
> - Verifique siempre las firmas — nunca omita esto
> - Devuelva 200 rápido — no bloquee a Synapse
> - Sea idempotente — maneje entregas duplicadas
> - Use eventos específicos —  no 
> - Monitoree fallos de entrega — configure alertas
Próximos pasos
- API de Webhooks
- Cron y Scheduler
- Agente LLM persistente