Webhooks
Webhooks permitem que sistemas externos recebam notificações em tempo real quando eventos acontecem no SalesOS.Como funcionam
Quando um evento ocorre (ex: lead criado, deal ganho), o SalesOS envia uma requisição HTTP POST para a URL configurada, contendo os dados do evento em formato JSON.Eventos disponíveis
| Evento | Descrição |
|---|---|
lead.created | Novo lead criado |
lead.updated | Lead atualizado |
lead.status_changed | Status do lead alterado |
lead.assigned | Lead atribuído a um vendedor |
deal.created | Nova oportunidade criada |
deal.stage_changed | Oportunidade mudou de etapa |
deal.won | Deal marcado como ganho |
deal.lost | Deal marcado como perdido |
deal.updated | Oportunidade atualizada |
activity.created | Nova atividade registrada |
Configurando webhooks
Via interface
Adicione um webhook
Clique em Novo webhook e preencha:
- URL — Endpoint que receberá os eventos
- Eventos — Selecione quais eventos disparam o webhook
- Secret — Chave para validação de assinatura (gerada automaticamente)
Via API
Formato do payload
Verificação de assinatura
Cada requisição inclui o headerX-SalesOS-Signature com uma assinatura HMAC-SHA256 do payload usando o secret configurado:
Retentativas
Se o endpoint retornar um erro (status >= 400) ou não responder em 10 segundos, o SalesOS faz retentativas:| Tentativa | Intervalo |
|---|---|
| 1a retentativa | 1 minuto |
| 2a retentativa | 5 minutos |
| 3a retentativa | 30 minutos |
| 4a retentativa | 2 horas |
| 5a retentativa | 24 horas |
Logs de webhook
Acesse Configurações > Webhooks > Logs para visualizar:- Histórico de entregas
- Status de cada requisição (sucesso ou falha)
- Payload enviado
- Resposta recebida
- Tempo de resposta

