Saltar al contenido principal
Las respuestas de error usan el formato de detalles de problemas de RFC 9457: type, title, status y, en algunos casos, detail.
Las respuestas de error no incluyen un identificador de solicitud. Solo lo incluye una respuesta 202 exitosa. Si necesitas ayuda de soporte, informa la URL de la página y la hora aproximada.

Todas las respuestas

Solo se informa el primer fallo. Las comprobaciones se ejecutan en este orden: espacio de trabajo y clave de captura, teléfono, consentimiento, marca, CAPTCHA y, por último, dominio. Corregir un error puede dejar al descubierto el siguiente.

Sobre el rechazo de CAPTCHA

CAPTCHA_REJECTED cubre cuatro situaciones distintas. Revisa cómo maneja los tokens tu integración antes de atribuir el rechazo a la puntuación:
  • El token venció. Se generó demasiado pronto. Un token de reCAPTCHA v3 dura alrededor de dos minutos: genéralo al enviar el formulario, no al cargar la página.
  • El token ya se usó. Un token se verifica una sola vez. Si reintentas una solicitud fallida sin generar un token nuevo, se rechaza su reutilización.
  • No se envió ningún token. Asegúrate de que el cliente obtenga un token y lo incluya en recaptchaToken en cada envío.
  • La puntuación fue demasiado baja. La comprobación contra bots rechazó este intento. No la omitas.
Las cuatro situaciones devuelven el mismo código, por lo que la respuesta por sí sola no identifica la causa. Primero comprueba que se incluya un token, que se genere al enviar el formulario y que sea nuevo para cada intento.

Sobre el 422

Es un fallo transitorio de nuestro lado: no pudimos comunicarnos con el proveedor de CAPTCHA y, por tanto, no pudimos determinar si el envío era legítimo. Es seguro reintentar. El lead se conserva cuando esto ocurre y el reintento no puede generar un mensaje duplicado. Genera un token de CAPTCHA nuevo para ese reintento, como en cualquier otro intento.

Sobre el error de dominio

El orden de estas comprobaciones puede resultar poco intuitivo, por eso conviene explicarlo. Comprobamos que el dominio de tu página esté registrado para tu espacio de trabajo, pero el dominio evaluado es el que informa el proveedor de CAPTCHA, no el que aparece en los encabezados de la solicitud. Esta comprobación ocurre después de verificar el token. En consecuencia, una página alojada en un dominio no registrado falla en la etapa de CAPTCHA con ORIGIN_NOT_ALLOWED, no con un error de CORS. Si esto ocurre y el resto de tu integración funciona, falta registrar el dominio en la configuración del espacio de trabajo: contacta a Bridge para agregarlo.