# Automação com webhooks
SUMMARY: Dispare sistemas externos quando as memórias mudam — sincronize, notifique, automatize.

Automação com webhooks
Webhooks permitem disparar sistemas externos quando eventos do Synapse
ocorrem. Este guia cobre padrões comuns de automação.
Padrões comuns
Padrão 1: notificar em memória crítica
Envie uma mensagem Slack quando uma memória crítica é armazenada:
[CODE BLOCK]
Registre o webhook:
[CODE BLOCK]
Padrão 2: sincronizar com sistema externo
Sincronize memórias com Notion, Obsidian ou qualquer KB externo:
[CODE BLOCK]
Padrão 3: disparar CI/CD
Dispare um deploy quando uma memória "release" é armazenada:
[CODE BLOCK]
Padrão 4: acordar agente em mensagem humana
Dispare uma execução de agente LLM quando um humano envia uma mensagem de chat:
[CODE BLOCK]
Padrão 5: agregar métricas
Rastreie crescimento de memória, atividade de chat, conclusão de tarefas:
[CODE BLOCK]
Verificação de assinatura
Sempre verifique assinaturas de webhook para evitar spoofing:
[CODE BLOCK]
Lógica de retry
O Synapse refaz webhooks falhados com backoff exponencial. Seu handler deve:
1. Retornar 200 rapidamente — não faça trabalho pesado sincronamente
2. Enfileirar trabalho — use um sistema de jobs em background
3. Ser idempotente — o mesmo evento pode ser entregue duas vezes
[CODE BLOCK]
Depurando webhooks
Verifique o histórico de entrega
Entregas de webhook são registradas. Confira as entregas recentes do seu
webhook:
[CODE BLOCK]
Teste o webhook manualmente
[CODE BLOCK]
Problemas comuns
| Problema | Correção |
|----------|----------|
| Respostas 4xx | Verifique se seu handler retorna 200 |
| Respostas 5xx | Erro de servidor — confira os logs do seu app |
| Timeout | Retorne 200 rápido, enfileire trabalho assíncrono |
| Entregas duplicadas | Torne o handler idempotente |
| Incompatibilidade de assinatura | Verifique se o secret está correto |
Melhores práticas
> [!TIP]
> - Sempre verifique assinaturas — nunca pule isso
> - Retorne 200 rápido — não bloqueie o Synapse
> - Seja idempotente — trate entregas duplicadas
> - Use eventos específicos —  em vez de 
> - Monitore falhas de entrega — configure alertas
Próximos passos
- API de Webhooks
- Cron & Agendador
- Agente LLM persistente