Códigos de cupón
Un código de cupón es una cadena corta que un miembro introduce en la Web app o la app móvil. Al introducirlo se dispara el disparador Introduce un código de cupón en una Regla de Campañas inteligentes, que entonces hace algo — normalmente Etiquetar miembro (para subgrupos con descuentos de personal) o Añadir créditos (para tarjetas regalo). La superficie de gestión de Códigos de cupón genera los códigos en sí y decide sus parámetros: cuántos códigos existen y cuánto mide cada uno. La Regla que reacciona al canje se configura por separado en Campañas inteligentes.
Las capturas de pantalla de esta página muestran la configuración de un comercio (etiquetas en español). Tu Hub muestra las etiquetas y los contenidos que configures para tu propio programa.
Dos patrones cubren la mayoría de los casos: etiquetar subgrupos (p. ej. "todos los empleados de la Empresa X tienen un 20 % de descuento") y tarjetas regalo (p. ej. "100 € de crédito, vendidos como regalo físico o digital"). La mecánica es la misma en ambos lados — el canje dispara una Regla — pero la historia de gestión y la acción que premia difieren. Esta página cubre ambos, además de la decisión único-vs-genérico que se cruza en los dos.
Cómo funciona un código de cupón de extremo a extremo
Tres piezas:
- Los códigos en sí, generados y gestionados en Marketing → Códigos de cupón. Tú decides cuántos códigos existen, cuánto miden y qué caracteres usan. Cada código se canjea una sola vez.
- La Regla que reacciona al canje, configurada en Campañas inteligentes con el disparador Introduce un código de cupón y una condición Código de cupón. En la condición eliges el registro de códigos de una lista (p. ej. Tarjeta regalo digital | 100 €), no escribes el código: la Regla reacciona entonces a todos los códigos de ese registro. Sin esta Regla el código no hace nada — es solo una cadena.
- La superficie de canje del lado del miembro en la Web app o la app móvil, donde el miembro escribe el código (la página "Código de activación" / "Activation code"). Cuando el miembro envía, la plataforma resuelve el código a su configuración, dispara el disparador y ejecuta la Regla o Reglas que coincidan.

La página del lado del miembro se renderiza con los colores y el idioma de la marca. Los miembros que pulsan el icono de escaneo QR a la derecha del campo pueden escanear un código en lugar de escribirlo — útil para tarjetas impresas o cartelería en tienda con un código codificado en QR.
Los dos patrones
Patrón 1 — Etiquetado de subgrupos (p. ej. descuento para empleados de la Empresa X)
El patrón: el negocio quiere que un grupo específico de personas (empleados de la Empresa X, miembros de una asociación colaboradora, asistentes a un evento) reciba una oferta especial en caja. No puedes pedirle a cada cajero que memorice quién trabaja en qué empresa, así que el sistema de fidelización tiene que saberlo. Los códigos de cupón son la forma de que las personas correctas se identifiquen a sí mismas.
Flujo de extremo a extremo:
- Genera los códigos en Marketing → Códigos de cupón. Bien N códigos únicos (uno por empleado) o un mismo código importado N veces — ver la decisión único-vs-genérico abajo.
- Distribuye los códigos al subgrupo (Recursos Humanos envía un mailing combinado, el partner lo comparte internamente, el organizador del evento pone un código en las acreditaciones, etc. — ver notas de distribución abajo).
- Construye una Regla de Campañas inteligentes con el disparador Introduce un código de cupón, una condición Código de cupón con este registro de códigos y la acción Etiquetar miembro con una etiqueta como
CompanyX_Employee. - Construye una Oferta automática aparte (una Oferta automática de Campañas inteligentes, no una Regla) dirigida a los miembros etiquetados con
CompanyX_Employee. Este es el descuento real — una vez que un miembro tiene la etiqueta, la Oferta automática se aplica automáticamente al cerrar cada cuenta siempre que el cajero lo identifique. El miembro nunca tiene que volver a mencionar el código.
La separación — la Regla escribe la etiqueta, la Oferta automática la lee — es lo que hace que esto sea limpio. Los nuevos beneficios para el mismo subgrupo llegan como nuevas Ofertas automáticas dirigidas a la misma etiqueta; la distribución del código de cupón no necesita cambiar.
Notas de distribución:
Para códigos únicos, la distribución requiere emparejar cada código con una persona. Las dos vías en la práctica:
- Manual — para empresas pequeñas (un puñado de empleados), Recursos Humanos o el dueño del negocio envía a cada persona su código por correo, uno a uno.
- Mailing combinado automatizado — para listas más grandes, Recursos Humanos vuelca los códigos en una hoja de cálculo junto con las direcciones de correo de los empleados y usa una herramienta de mailing combinado para enviar a cada persona su código único automáticamente.
Para códigos genéricos, la distribución es simplemente compartir el código internamente — fíjalo en el chat de la empresa, escríbelo en la pizarra de la oficina, como sea que la empresa se comunique normalmente. El riesgo es que los empleados lo reenvíen a amigos y familiares; el límite a ese riesgo es cuántas copias del código hayas importado.
Patrón 2 — Tarjetas regalo
El patrón: el negocio vende crédito prepagado como producto de regalo. El comprador adquiere una tarjeta; la tarjeta lleva un código; el destinatario introduce el código en su cartera de fidelización para cargar el crédito. Una implementación típica vende tarjetas regalo en variantes físicas y digitales y en varias denominaciones (100 €, 150 €, 200 €, 300 €).


Flujo de extremo a extremo:
- Genera los códigos — normalmente códigos únicos (cada tarjeta regalo tiene su propio código que se usa una vez). Un registro de código de cupón por denominación (100 €, 200 €, etc.) con tantos códigos únicos como quieras vender.
- Construye una Regla de Campañas inteligentes por denominación con el disparador Introduce un código de cupón, una condición Código de cupón con el registro de códigos que corresponde y la acción Añadir créditos con la cantidad correspondiente. Cada denominación es una Regla — la tarjeta de 100 € tiene su propia Regla que añade 100 €; la de 200 € tiene la suya. Constrúyela antes de vender la primera tarjeta.
- Para las tarjetas digitales, prepara el correo (ver El correo de las tarjetas digitales más abajo): una plantilla de correo que lleva el código, enviada por una Regla sobre el disparador Evento externo enviado.
- Vende las tarjetas a través de la superficie de pedidos en línea que use tu comercio:
- Tarjeta física — el código se imprime en una tarjeta y se envía por correo postal al destinatario.
- Tarjeta digital — el sistema de pedidos publica un evento con el correo del destinatario y su texto personal; la Regla del paso 3 envía el correo, y el correo toma el siguiente código no enviado del registro.
- El destinatario introduce el código en la página "Código de activación" de la Web app de fidelización; el crédito aterriza en su saldo.
El correo de las tarjetas digitales
El código llega al destinatario a través de una plantilla de correo. En el editor de la plantilla, abre Seleccionar enlaces mágicos, despliega Códigos de cupón, elige el registro de códigos de esa denominación y copia en el correo uno de estos dos elementos:
- Código de cupón — el código en sí, como texto (p. ej. ADYWEK6T2V).
- Enlace de código de cupón — un enlace que lleva el código.
Cada vez que se envía el correo, la plataforma toma el siguiente código del registro que no está ni usado ni enviado, lo pone en ese correo y lo marca como Enviado. El destinatario aparece en la columna Comprado por, con la fecha. Así cada correo lleva un código distinto y ningún código sale dos veces.
De ahí salen dos cosas. Mantén suficientes códigos sin enviar en el registro (genera o importa más antes de que se acaben). Y si repartes tú algunos códigos, impresos o en mano, usa Marcar como enviado con ellos para que el correo nunca los elija.
Para la vía digital, normalmente tendrás dos Reglas por denominación — una sobre Introduce un código de cupón (el lado del canje: añadir créditos) y otra sobre Evento externo enviado (el lado de la venta: enviar el correo con el código). La captura de abajo muestra cómo se ve la lista de Campañas inteligentes de una implementación real — muchas Reglas en paralelo, una por denominación × método de entrega:

La convención de nombrado de la captura — Tarjeta regalo | denominación | acción — es una buena plantilla si construyes esto desde cero. Mantiene la lista escaneable a medida que crece.
Códigos únicos vs genéricos
Cada fila de código se canjea exactamente una vez, así que la decisión que tomas al generar un código de cupón es cuántas filas crear y si llevan cadenas distintas o la misma. Los dos extremos:
- Muchos códigos únicos, 1 uso cada uno — generas, digamos, 1.000 códigos de longitud 10, cada uno canjeable una vez. Distribuyes uno por destinatario. Más seguro (un código filtrado te cuesta exactamente un canje); más difícil (necesitas una forma de entregar un código por persona).
- Un código genérico, N usos — todo el mundo usa la misma cadena y se puede canjear N veces en total. Más fácil de compartir; más arriesgado (cualquiera puede pasarlo, y el límite es solo el contador de canjes — no "solo las personas que querías"). Esto se construye importando el mismo código N veces.
Existen híbridos (10 códigos × 100 usos cada uno, por ejemplo) pero la mayoría de los clubs aterriza en uno de los dos extremos.
Un código, muchos usos: importa el mismo código N veces
¿Quieres una sola cadena compartible que funcione, digamos, 100 veces? Cada fila de código es de un solo uso, así que crea el registro con Quantity = el número de usos que quieres y luego importa un CSV con ese mismo código repetido una vez por línea. Acabas con 100 filas que ponen todas HELLO, cada una válida para un solo canje. Para el miembro se comporta como un código con 100 usos; para ti son 100 canjes registrados por separado.
Pasos
- Prepara el CSV. Una columna, sin cabecera, el código repetido una vez por uso. 100 usos = 100 líneas idénticas. Cualquier hoja de cálculo lo exporta en segundos (escribe el código, arrastra hacia abajo, guarda como CSV).
- Crea el registro de código en Marketing → Códigos de cupón y rellena el formulario Special code:
- Name — describe la promo y el truco, para que quien lo vea después entienda el registro de un vistazo, p. ej.
Café gratis - 100 usos. - Length — el número de caracteres de tu código (
HELLO= 5). - Quantity — cuántos usos quieres (100).
- Name — describe la promo y el truco, para que quien lo vea después entienda el registro de un vistazo, p. ej.
- Guarda, luego pulsa Import codes y sube el CSV.
- Construye la Regla con el disparador Introduce un código de cupón y la condición acotada a este registro, igual que con cualquier otro código de cupón. Sin ella el código no hace nada.
El resultado — 100 códigos idénticos en un registro, dos ya canjeados por miembros distintos en momentos distintos:

Por qué una fila por uso
- Cada canje tiene su propia fila, así que Used by y Used at te dicen quién canjeó y cuándo, una línea por persona.
- El saldo restante se lee de un vistazo: las filas sin usar son los usos que te quedan.
- Recargar es simplemente otra importación del mismo código — sin tocar los parámetros del registro.
La contrapartida: el comportamiento para el miembro es idéntico, pero Quantity ahora significa "usos", no "códigos distintos". Dilo en el nombre del registro para que nadie lea mal la vista de lista.
Cuándo elegir cada uno
- Grupo pequeño, canal de confianza — los códigos únicos son sobreingeniería. Genérico con un tope de canjes bajo (50, 100) está bien.
- Grupo más grande, confianza mixta — códigos únicos vía mailing combinado. La entrega por destinatario es el coste; el límite por filtración es el beneficio.
- Cualquier cosa vendida por dinero (tarjetas regalo) — siempre únicos. Cada tarjeta lleva un valor ligado a una venta, y los códigos con valor que se pueden canjear varias veces son un riesgo de devolución.
Dónde gestionarlos
Marketing → Códigos de cupón en el menú lateral abre la lista de registros de códigos — cada fila es el lote de códigos de una campaña (p. ej. "Tarjeta regalo digital | 100 €" con 3.000 códigos de longitud 10). Añadir nuevo ofrece dos tipos:
- Código especial — el tipo del que trata esta página: códigos que un miembro con sesión iniciada introduce en la página de activación y que disparan el disparador Introduce un código de cupón.
- Código de registro — un código que se escribe en el campo de código de invitación (
joiningCode) del formulario de registro al darse de alta. Un código incorrecto detiene el registro, así que funciona como filtro de entrada (p. ej. un alta abierta solo al personal de una empresa). La columna Kind de la lista indica cuál es cuál.

Las columnas capturan la decisión único-vs-genérico de un vistazo:
- Length — cuántos caracteres tiene cada código.
- Quantity — cuántas filas de código existen en este registro. Cada fila se canjea una vez, así que Quantity es también el total de canjes posibles.
Un registro con Quantity 3000 y 3.000 cadenas distintas es modo único. Un registro con Quantity 100 donde las 100 filas llevan la misma cadena es modo genérico — ver Un código, muchos usos.
Haz clic en una fila para ver los códigos en sí y para generar / importar / exportar:

Las operaciones de la pantalla de detalle:
- Generar códigos — produce un lote de códigos aleatorios. Elige la Longitud (de 4 a 10 caracteres), la Cantidad (hasta 10.000 por lote) y el Conjunto de caracteres: cualquier combinación de Números (0-9), Mayúsculas (A-Z) y Minúsculas (a-z). Úsalo cuando configures el registro por primera vez, o cuando recargues un registro existente para una nueva distribución.
- Importar códigos — sube un CSV con los códigos que tú elijas. Un archivo cada vez, de hasta 2 MB, con 10.000 códigos como máximo y cada código de 36 caracteres como máximo. Los códigos que superan los límites se saltan, y la pantalla te dice cuántos son antes de que confirmes. Dos usos: migrar desde un sistema de fidelización anterior (tarjetas ya impresas con códigos específicos que tienen que seguir funcionando) y hacer que un código se pueda canjear muchas veces repitiéndolo una vez por línea.
- Añadir código único — el botón pequeño junto a Exportar códigos: escribe un código a mano. Si el código ya existe, se rechaza.
- Export codes — descarga los códigos como CSV para distribución offline (mailing combinado, traspaso al partner). La exportación incluye el estado de canje — usado / no usado, quién lo usó, cuándo.
- Marcar como enviado — marca como Enviado los códigos que selecciones, para los códigos que hayas repartido tú. El correo de tarjeta regalo nunca elige un código enviado. No rellena Comprado por.
- Eliminar — borra un código. Solo se puede eliminar un código que nadie ha usado; un código usado se queda como registro de su canje.
Las columnas Used / Used At / Used By facilitan auditar qué códigos se han canjeado y por quién — particularmente útil para programas de descuento de personal donde quieres detectar códigos filtrados (p. ej. un código canjeado veinte veces en una semana por miembros que no son empleados).
Trampas
6 cosas a vigilar al ejecutar campañas de códigos de cupón
- Un código sin Regla no hace nada. La superficie de gestión de Códigos de cupón genera la cadena y registra los canjes; la Regla con el disparador Introduce un código de cupón es la que de verdad recompensa al miembro. Construye la Regla antes de distribuir el código, o los miembros introducirán códigos y no verán ningún efecto.
- Una fila, un canje. No hay ningún ajuste de multiuso en una fila de código — el campo Available per code que había en el formulario se ha eliminado. El comportamiento multiuso sale de importar el mismo código una vez por uso.
- Los códigos genéricos pueden agotarse a mitad de la distribución. Si importaste 100 copias y el código alcanza 100 canjes antes de que la última persona lo haya usado, las entradas tardías dan error. Amplía el número, o importa más copias en el mismo registro; cambia a códigos únicos si la audiencia es más grande de lo que el número permite.
- Una vez compartidos, los códigos genéricos se filtran. Acota el riesgo con el número de copias que importas, pero asume que cualquier código genérico llega a una audiencia más allá de tu objetivo. La columna Used By en el detalle del código es tu superficie de auditoría — revísala para detectar canjes de no miembros o fuera del segmento.
- La condición Código de cupón de la Regla es lo que delimita el alcance de la acción. Una Regla con el disparador pero sin condición se dispara con cada introducción de cupón en todo el tenant — la acción equivocada se ejecuta para los miembros equivocados. Pon siempre en la condición el registro de códigos al que la Regla debe reaccionar.
- Los códigos no caducan solos. A menos que construyas la caducidad en la Regla (p. ej. mediante una condición de tiempo o poniendo la Regla en Pausada después de una fecha), los códigos antiguos pueden seguir canjeándose años después. Para campañas estacionales, planifica el cierre.