# API de Webhooks
SUMMARY: Registre callbacks HTTP para eventos de memória, chat e tarefa — seja notificado quando os dados mudarem.

KEY CONTEXT:
Auth: Mind Key
Register: POST /webhooks { url, events, secret? }
List: GET /webhooks
Get: GET /webhooks/:id
Update: PUT /webhooks/:id { url?, events?, secret?, enabled? }
Delete: DELETE /webhooks/:id
Events: memory.*, memory.store, memory.update, memory.delete, chat.*, chat.message_received, task.*, task.created, task.completed
Secret: HMAC-SHA256 signed payload, sent in X-Synapse-Signature header
Pattern: register webhook → receive POST → process event → call Synapse API

API de Webhooks
Webhooks permitem receber callbacks HTTP quando eventos acontecem no Synapse.
Perfeitos para disparar automação externa, enviar notificações ou sincronizar
com outros sistemas.
Endpoints
POST /webhooks
Registra um novo webhook.
[CODE BLOCK]
Resposta:
[CODE BLOCK]
GET /webhooks
Lista todos os webhooks do mind atual.
[CODE BLOCK]
GET /webhooks/:id
Obtém um único webhook.
[CODE BLOCK]
PUT /webhooks/:id
Atualiza um webhook (URL, eventos, secret ou flag enabled).
[CODE BLOCK]
DELETE /webhooks/:id
Exclui um webhook.
[CODE BLOCK]
Tipos de evento
| Padrão | Dispara quando |
|--------|----------------|
|  | Qualquer evento de memória |
|  | Nova memória armazenada |
|  | Memória atualizada |
|  | Memória excluída |
|  | Qualquer evento de chat |
|  | Nova mensagem do humano |
|  | Qualquer evento de tarefa |
|  | Nova tarefa criada |
|  | Tarefa marcada como concluída |
|  | Todos os eventos |
Payload do webhook
Quando um evento dispara, o Synapse faz POST para sua URL:
[CODE BLOCK]
Verificação de assinatura
Se você definir um , o Synapse assina cada payload com HMAC-SHA256:
[CODE BLOCK]
Verifique no seu handler:
[CODE BLOCK]
Padrão: sincronização em tempo real
[CODE BLOCK]
Próximos passos
- Cron & Agendador
- Guia de automação com webhooks