Webhooks permitem que a Vendaze notifique seu aplicativo quando eventos ocorrem no workspace. Em vez de fazer polling continuamente, seu servidor recebe uma notificação HTTP assim que algo muda.Documentation Index
Fetch the complete documentation index at: https://developers.vendaze.com/llms.txt
Use this file to discover all available pages before exploring further.
Webhooks são configurados pelo cliente da Vendaze no painel da plataforma, não via API pública.
Este guia explica como receber e validar as notificações.
Como funciona
- O cliente da Vendaze configura um webhook no painel: define a URL de destino e os eventos desejados
- O Vendaze gera um
webhook_secretúnico para aquele endpoint - Quando um evento ocorre, a Vendaze faz um
POSTpara a URL configurada com o payload assinado - Seu servidor valida a assinatura e processa o evento
Eventos disponíveis
| Evento | Quando ocorre |
|---|---|
person.created | Uma nova pessoa é criada |
person.updated | Uma pessoa é atualizada |
company.created | Uma nova empresa é criada |
company.updated | Uma empresa é atualizada |
deal.created | Um novo negócio é criado |
deal.updated | Um negócio é atualizado |
activity.created | Uma nova atividade é registrada |
activity.updated | Uma atividade é atualizada |
task.created | Uma nova tarefa é criada |
task.updated | Uma tarefa é atualizada |
product.created | Um novo produto é criado |
product.updated | Um produto é atualizado |
Formato do payload
Validar a assinatura
Cada entrega é assinada com HMAC-SHA256 usando owebhook_secret. Valide antes de processar.
Headers enviados pelo Vendaze:
Política de reenvio
Se seu servidor não retornar status2xx em 10 segundos, a Vendaze tenta novamente:
| Tentativa | Espera |
|---|---|
| 2 | 1 minuto |
| 3 | 5 minutos |
| 4 | 30 minutos |
| 5 | 2 horas |
suspended. O cliente reativa no painel.
Boas práticas
- Responda rapidamente: retorne
200imediatamente e processe em background. - Seja idempotente: o mesmo evento pode chegar mais de uma vez. Use o
iddo payload para deduplicar. - Guarde os logs: armazene os payloads recebidos para facilitar debug e auditoria.