Skip to main content
Todo erro devolve JSON com um campo error. O texto é em inglês, porque é lido por máquina; o significado está aqui.

Como tratar do seu lado

Os três casos de 400 são problemas de dado ou de configuração. Repetir a mesma requisição devolve o mesmo erro. Registre e siga.
Webhook desligado ou token trocado. Alerte quem cuida da integração em vez de tentar de novo em laço.
Falha temporária. Uma ou duas tentativas com espera crescente resolvem a maioria dos casos. Não repita indefinidamente.

Sucesso duplicado

A entrada não é idempotente. Duas requisições iguais criam dois contatos. Se o seu sistema tem retentativa automática, guarde o leadId da primeira resposta bem-sucedida e não repita.

Antes de culpar a integração

A verificação por GET responde em um segundo e elimina metade das hipóteses:
Se ela devolver 404, o problema é o token. Se devolver enabled: false, é o interruptor. Se devolver status: ok, o problema está no corpo que você envia.