Webhooks assinados (Helm)
Webhooks do Helm notificam sua infraestrutura sobre eventos do sistema. Disparamos um POST JSON para a URL configurada pelo escritório quando um contrato é fechado.
Ao cadastrar um segredo no webhook, cada envio leva a assinatura HMAC-SHA256 do corpo da mensagem no cabeçalho da requisição — é assim que a sua infraestrutura confirma que a chamada veio de nós. Recomendamos sempre cadastrar o segredo.
A configuração é feita em Configurações → Integrações. O envio sai por fila, e entregas que falharam podem ser reprocessadas. A URL passa por validação de segurança antes de ser aceita, para proteção contra ataques de SSRF.
{
"evento": "contrato.fechado",
"ocorrido_em": "2026-06-10T12:00:00Z",
"dados": {
"contrato_id": "con_827391",
"valor_mensal": 1500.00,
"cliente": {
"nome": "Empresa Exemplo LTDA",
"documento": "00.000.000/0001-00"
}
}
}Nota: com um segredo cadastrado, o corpo do POST JSON é assinado com HMAC-SHA256 usando essa chave.