Creación de audiencia

Configurar reCAPTCHA en sus formularios

Por qué es importante

Los formularios públicos atraen bots que envían registros falsos o basura. Esas direcciones falsas perjudican la calidad de su lista, su entregabilidad y sus informes. Añadir la protección de reCAPTCHA v3 mantiene su lista limpia al filtrar de forma discreta los envíos automatizados, sin obligar a los suscriptores reales a resolver un acertijo.

reCAPTCHA en sus formularios usa sus propias claves de Google reCAPTCHA, así que las creará primero en Google y luego las pegará en los ajustes de su formulario.

Antes de comenzar

Necesita una cuenta de Google.
El formulario utiliza reCAPTCHA v3 (no v2). Asegúrese de crear un sitio v3 en Google, o las claves no funcionarán.
Tenga a mano el dominio de su sitio web (el dominio donde se incrustará el formulario).

reCAPTCHA requiere que el formulario esté en su propio dominio

reCAPTCHA solo valida cuando el formulario se ejecuta en un dominio que usted ha registrado en Google. Añádalo a un formulario que incruste en su propio sitio web (Static HTML Code o Dynamic Embed Snippet), y registre ese dominio en la consola de Google. El Enlace autoalojado (Self-Hosted Link) se sirve en el dominio de la plataforma, no en el suyo, así que sus claves reCAPTCHA no pueden validar ahí. Use el Enlace autoalojado para pruebas o para compartir rápido, e incruste el formulario en su sitio para un registro protegido por reCAPTCHA.

Cree sus claves de reCAPTCHA en Google

Vaya a la consola de administración de Google reCAPTCHA y registre un nuevo sitio.
Elija reCAPTCHA v3 como tipo.
Añada el dominio o los dominios donde aparecerá su formulario.
Envíe. Google le proporciona dos claves: una clave de sitio (Site Key) y una clave secreta (Secret Key). Mantenga esta página abierta, copiará ambas en el siguiente paso.

Añada sus claves al formulario

En el menú de la izquierda, vaya a Creación de audiencia ▸ Formularios y abra su formulario.
En el panel de ajustes del formulario, despliegue Recaptcha (Recommended).
Pegue su clave de sitio (Site Key) en el campo Site Key y su clave secreta (Secret Key) en el campo Secret.
Publique el formulario. reCAPTCHA permanece inactivo hasta que el formulario se publica con claves válidas.

Error "Recaptcha error" al enviar un formulario

El problema de reCAPTCHA más frecuente es un envío rechazado con una respuesta como esta:

Code
{"detail":[{"msg":"Recaptcha error","type":"bad_request","code":2064}]}

Significa que el envío llegó al servidor, pero su verificación de reCAPTCHA falló, así que el contacto no se agrega a su lista. Estas son las causas frecuentes y cómo corregir cada una.

El envío no llevaba un token de reCAPTCHA válido

Es la causa habitual. Solo una carga real de la página del formulario publicado genera un token de reCAPTCHA. Verá el error si:

abre la URL de envío (Submission URL) (o el endpoint form_submission en bruto) directamente en un navegador para "probarlo", o
envía una solicitud a ese endpoint desde una integración personalizada sin generar primero un token de reCAPTCHA v3.

Solución: envíe a través del formulario publicado (el Enlace autoalojado (Self-Hosted Link), el Fragmento de incrustación dinámica (Dynamic Embed Snippet) o el Código HTML estático (Static HTML Code) en su dominio registrado). Para una integración personalizada, genere un token de reCAPTCHA v3 en la página y envíelo con el envío.

El dominio no está registrado en Google

Si la página que aloja el formulario no está en su sitio de reCAPTCHA v3, Google no emitirá un token que pase la verificación.

Solución: en la consola de Google reCAPTCHA, añada el dominio exacto (y cualquier subdominio) donde se ejecuta el formulario. Si movió el formulario a un nuevo dominio, añádalo también. Tenga en cuenta que el Enlace autoalojado (Self-Hosted Link) se ejecuta en el dominio de la plataforma, no en el suyo, así que sus claves nunca coincidirán ahí; incruste el formulario en su propio sitio.

El script de reCAPTCHA no se cargó

Los bloqueadores de anuncios, las extensiones de privacidad, una Content-Security-Policy estricta o simplemente estar sin conexión pueden bloquear el script de Google, así que no se genera ningún token.

Solución: pruebe en un navegador limpio con las extensiones desactivadas, y permita el script de Google reCAPTCHA en la Content-Security-Policy de su sitio.

El token expiró o se reutilizó

Los tokens de reCAPTCHA v3 son de un solo uso y de corta duración. Una página en caché, un envío muy lento o un doble envío pueden mandar un token caducado.

Solución: recargue el formulario y envíelo de nuevo de inmediato.

Las claves son incorrectas o no coinciden

Claves v2 en un formulario v3, la Site Key y el Secret intercambiados, o claves copiadas de otro sitio de reCAPTCHA fallarán en la verificación.

Solución: use claves v3, vuelva a copiarlas de la consola de Google (un carácter de menos o de más las rompe), y confirme que cada clave está en el campo correcto.

Otras cosas que revisar

reCAPTCHA sigue apareciendo como "inactivo"

Asegúrese de haber hecho clic en Publicar después de introducir las claves. Los cambios solo surten efecto una vez que el formulario está publicado.
Confirme que tanto el campo Site Key como el Secret están completos.

El formulario funciona en la vista previa pero no en su sitio web

En la consola de Google reCAPTCHA, confirme que el dominio donde el formulario está incrustado figura en ese sitio.

Los bots siguen pasando

reCAPTCHA v3 puntúa el tráfico en lugar de bloquearlo directamente. Combínelo con la doble suscripción (double opt-in) en su formulario para una protección más fuerte.

Si el envío sigue fallando después de revisar todo lo anterior, contacte a nuestro equipo de Soporte con el mensaje de error exacto y el dominio donde se ejecuta el formulario.