# 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 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
1. Vaya a la consola de administración de Google reCAPTCHA y registre un nuevo sitio.
2. Elija **reCAPTCHA v3** como tipo.
3. Añada el dominio o los dominios donde aparecerá su formulario.
4. 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
1. En el menú de la izquierda, vaya a **Creación de audiencia ▸ Formularios** y abra su formulario.
2. En el panel de ajustes del formulario, despliegue **Recaptcha (Recommended)**.
3. Pegue su **clave de sitio (Site Key)** en el campo **Site Key** y su **clave secreta (Secret Key)** en el campo **Secret**.
4. **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:
```json
{"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.
## Artículos relacionados
- [Crear un formulario](/es/docs/audience-building/working-with-forms) - Cree y publique el formulario
- [Configurar los correos de opt-in](/es/docs/audience-building/configuring-opt-in-emails) - Añada la confirmación de doble opt-in
- [Crear y gestionar una lista de contactos](/es/docs/audience/managing-contact-lists) - A dónde van los envíos