Pular para o conteúdo principal
As respostas de erro seguem o formato de detalhes de problema da RFC 9457: type, title, status e, em alguns casos, detail.
As respostas de erro não contêm um ID de requisição. Somente uma resposta bem-sucedida 202 contém esse identificador. Se precisar de suporte, informe a URL da página e o horário aproximado.

Todas as respostas

Somente a primeira falha é informada. As verificações seguem esta ordem: workspace e chave de captura, telefone, consentimento, marca, CAPTCHA e, por último, domínio. Corrigir um erro pode revelar o próximo.

Sobre a rejeição do CAPTCHA

CAPTCHA_REJECTED abrange quatro situações. Verifique como a integração trata o token antes de atribuir a rejeição à pontuação:
  • O token expirou. Ele foi gerado cedo demais. Um token reCAPTCHA v3 dura cerca de dois minutos; gere-o quando o formulário for enviado, não no carregamento da página.
  • O token já foi usado. Cada token pode ser verificado uma única vez. Se você repetiu um envio malsucedido sem gerar outro token, a repetição é rejeitada.
  • Nenhum token foi enviado. Verifique se o cliente obtém um token e o inclui em recaptchaToken em todos os envios.
  • A pontuação foi muito baixa. A verificação contra bots rejeitou essa tentativa. Não contorne essa proteção.
As quatro situações retornam o mesmo código, portanto a resposta sozinha não identifica a causa. Primeiro, confirme que o token foi incluído, gerado no momento do envio e renovado a cada tentativa.

Sobre o erro 422

É uma falha temporária do nosso lado: não conseguimos acessar o provedor de CAPTCHA e, por isso, não foi possível decidir se o envio era legítimo. É seguro tentar novamente. O lead é preservado quando isso acontece, e uma nova tentativa não pode gerar uma mensagem duplicada. Gere um novo token de CAPTCHA para a tentativa, como faria em qualquer outro envio.

Sobre o erro de domínio

A ordem das verificações merece atenção. O domínio da página é comparado com os domínios cadastrados para o workspace. Porém, o domínio verificado é o informado pelo provedor de CAPTCHA, não o que aparece nos cabeçalhos da própria requisição. Essa verificação ocorre depois que o token é validado. Na prática, uma página hospedada em um domínio não cadastrado falha na etapa de CAPTCHA com ORIGIN_NOT_ALLOWED, não com um erro de CORS. Se isso acontecer mesmo quando o restante da integração funciona, o domínio não está na configuração do workspace. Entre em contato com o Bridge para cadastrá-lo.