Webhooks nativos
Em Configurações da equipe > Webhooks, configure uma URL HTTPS acessível, escolha os gatilhos e gere um segredo forte. Evite URLs que redirecionem e endereços privados não alcançáveis pelo serviço.
Autenticidade
Seção intitulada “Autenticidade”O webhook nativo envia o segredo configurado no cabeçalho técnico X-Documenso-Secret, mantido por compatibilidade. Compare-o em tempo constante com o valor armazenado no seu cofre. Nunca registre o segredo.
Esse cabeçalho não é uma assinatura HMAC do corpo. Não confunda o webhook nativo com o contrato de callbacks assinados da integração especializada, que ainda não está habilitada no sandbox.
Recebimento e conciliação
Seção intitulada “Recebimento e conciliação”- Valide o segredo antes de processar o evento.
- Grave duravelmente o evento antes de responder com sucesso.
- Faça deduplicação e aceite possíveis repetições ou eventos fora de ordem.
- Correlacione o documento com a sua transação usando os identificadores persistidos.
- Consulte o estado atual e baixe o documento final pela API autenticada.
Não presuma que o callback nativo inclui o PDF assinado ou todos os parâmetros comerciais do seu sistema. Implemente o download e a conciliação explícitos. Não use dados de um evento sem autenticação para liberar acesso ou marcar uma contratação como concluída.
O painel permite inspecionar/testar a configuração. Prazos e política de repetição precisam ser validados na versão em uso; não constituem SLA de entrega.