Docs  /  Crear un configurador  /  Protección antispam con Captcha

Protección antispam con Captcha

Última actualización: 20. octubre 2026

Un botón de acción que envía correos es un formulario público: quien encuentre la página puede lanzar correos automáticamente a través de él, a través de su servidor de correo. La característica Captcha le protege de ello. Funciona en segundo plano, no necesita ningún servicio de terceros y no instala cookies. Este artículo muestra cómo configurarlo y qué comprueba.

Cómo funciona el Captcha

configento.app utiliza Altcha, un Captcha basado en el principio de Proof-of-Work (prueba de trabajo):

  1. Al cargar el configurador, el navegador del cliente obtiene una tarea de cálculo de configento.app.
  2. El navegador resuelve la tarea por sí mismo. Según el dispositivo y la dificultad, tarda desde fracciones de segundo hasta unos pocos segundos.
  3. Cuando el cliente hace clic en el botón de acción, se envía la solución. El servidor la comprueba y solo entonces ejecuta la acción.

El cliente no tiene que hacer clic en imágenes ni teclear nada. Para un visitante individual la tarea apenas cuesta tiempo; para un programa que quiere enviar miles de solicitudes, resulta cara. Cada solución vale solo una vez y solo durante un tiempo limitado.

Requisito: motor de frontend V3

El Captcha solo existe en el motor de frontend V3. Por eso el tipo de dato se llama Captcha (solo V3).

Si un componente contiene un Captcha,

  • lleva en la vista general de componentes la etiqueta V3,
  • la configuración del componente muestra el aviso Requiere Frontend V3,
  • Magento 2 lo carga automáticamente con V3,
  • en Shopify funciona de todos modos con V3.

En Shopware 6 y en el fragmento HTML5 clásico siempre funciona el motor Legacy. Allí el Captcha no puede mostrarse, y aun así el servidor rechaza las acciones del componente porque falta la solución. No use allí ningún Captcha. Más información: Motor de frontend: Legacy o V3.

En la configuración del componente, en General, ponga el Motor en V3 (Beta). La vista previa del admin se rige por este ajuste: solo con V3 verá allí el Captcha.

Configurar el Captcha

  1. Abra el componente y cree una característica nueva.
  2. En Frontend, elija el tipo de dato Captcha (solo V3).
  3. Colóquelo en el mismo grupo que el botón de acción, idealmente justo encima.
  4. En Ajustes de Captcha, elija la Complejidad de Captcha (véase más abajo).
  5. Guarde, compruebe la vista previa y publique el componente.

Característica de tipo Captcha en un formulario de solicitud: ajustes de captcha con el proveedor Altcha y la complejidad

Como Proveedor de Captcha está fijado Altcha. Basta con un Captcha por componente, también con varios botones de acción.

Complejidad de Captcha

Complejidad de Captcha Efecto
Fácil (verificación rápida) Apenas perceptible, también en dispositivos lentos
Medio (predeterminado) La opción adecuada para la mayoría de las tiendas
Fuerte (más lento, mayor resistencia al spam) Aproximadamente cuatro veces más cálculo que Medio. En smartphones antiguos, resolverlo puede tardar de forma perceptible.

Empiece con Medio (predeterminado) y auméntelo solo si aun así llega spam.

Qué protege el Captcha

En cuanto un componente contiene un Captcha, el servidor comprueba la solución en cada clic en uno de sus botones de acción:

Acción del botón de acción Con Captcha en el componente
Enviar correo Solo con una solución válida
Enviar correo con PDF Solo con una solución válida
Generar PDF Solo con una solución válida
URL personalizada Solo con una solución válida, comprobada antes de reenviar los datos a su dirección

Sin una solución válida, el servidor responde con HTTP 403 y no ejecuta la acción.

También en el propio configurador cuenta el Captcha: mientras no esté resuelto, V3 muestra «Por favor, resuelve el captcha antes de enviar.» y retiene el botón de acción y el carrito. Como el navegador resuelve la tarea por sí solo al cargar, normalmente el cliente no nota nada. Tras cada acción, el Captcha resuelve una tarea nueva: si el cliente pulsa el botón de acción por segunda vez o lo intenta de nuevo tras un error, vuelve a tener una solución válida.

Todo sobre las acciones en sí: El botón de acción.

Avisos en el editor

En los ajustes de un botón de acción que envía correos aparece Riesgo de spam: ningún Captcha en este componente mientras el componente no tenga Captcha.

La comprobación previa a la publicación advierte además:

  • «Un botón de acción envía correos sin captcha: riesgo de spam en la tienda pública.»
  • «Hay un captcha, pero ningún botón de acción lo activa: nunca se comprueba.», cuando ningún botón de acción usa Enviar correo, Enviar correo con PDF o URL personalizada.

Las advertencias no bloquean la publicación.

Protección de datos

  • La tarea de cálculo procede del servidor de configento.app. No se cargan scripts, fuentes ni imágenes de terceros.
  • El Captcha no instala cookies ni sigue al visitante entre páginas. Solo calcula la tarea.
  • Solo se transmite la solución de la tarea, junto con los demás datos de la configuración.

Otros mecanismos de protección

El Captcha no es la única protección. Con independencia de él, configento.app limita con qué frecuencia puede lanzarse una acción y no envía la misma configuración varias veces en poco tiempo. Los límites figuran en el artículo El botón de acción.

Solución de problemas

  1. «Error al enviar: HTTP 403»: la solución faltaba o había caducado. Espere a que el Captcha haya resuelto una tarea nueva e inténtelo otra vez. Si el error se produce siempre, probablemente el componente funciona con el motor Legacy (Shopware 6, fragmento HTML5 clásico); allí el Captcha no puede resolverse.
  2. «No se pudo cargar el captcha. Por favor, recarga la página.»: el navegador no pudo obtener la tarea, por ejemplo por un bloqueador de anuncios o un cortafuegos. Compruebe si la página puede acceder a configento.app.
  3. El Captcha no aparece en la vista previa: el Motor del componente está en Legacy (predeterminado). Póngalo en V3 (Beta).
  4. Resolverlo tarda mucho en el smartphone: ponga la Complejidad de Captcha en Medio (predeterminado) o Fácil (verificación rápida).
  5. El botón del carrito reacciona tras un momento: el navegador todavía está resolviendo la tarea. Con Fuerte en dispositivos lentos puede notarse.
  6. Llega spam a pesar del Captcha: aumente la Complejidad de Captcha. Compruebe además si los correos llegan realmente a través de este componente y no a través de otro formulario de su sitio web.

Próximos pasos


← Todos los artículos Prueba gratuita 14 días