Abre Automatizaciones en la barra lateral izquierda y entra a la pestaña Grupos de códigos. La página dice para qué sirve un grupo en una línea: "Códigos precargados que el nodo Entregar código de las automatizaciones y los formularios de captura reparten uno por contacto, hasta que se agota el grupo." Esta es la superficie detrás de promesas como los primeros 200 que comenten reciben un código: el grupo guarda los 200 y el flujo decide qué pasa con la persona 201.
Qué es realmente un grupo
Un grupo es una lista con nombre de cadenas de texto y nada más. IcloneU no crea el significado de los códigos, no sabe cuánto valen y nunca los canjea: solo lleva la cuenta de cuáles ya salieron y a quién. El canje ocurre donde nacieron los códigos: tu tienda, tu sistema de boletos, tu servidor de licencias.
- Un grupo es de tu equipo, no de un flujo ni de una cuenta de plataforma conectada. Un código se canjea igual sin importar si la conversación pasó en Instagram o en WhatsApp, así que una misma promoción puede correr en varias publicaciones y varios flujos tomando del mismo grupo.
- El tamaño del grupo es el límite. No hay una configuración de "tope" en ningún lado: si quieres que una promoción se detenga a las 200 personas, pon 200 códigos en el grupo.
- Los códigos son únicos dentro de un grupo. Agregar uno que ya está se omite en silencio en vez de tratarse como error, así que volver a pegar una lista superpuesta no rompe nada.
- Los códigos entregados nunca se borran. Una vez que un código salió, su fila se queda: IcloneU guarda quién lo recibió y cuándo, aunque la lista solo muestra cuándo; ese registro es la razón por la que esto es una pestaña y no un archivo de texto.
La pestaña es la puerta principal. La otra está dentro de un flujo: un nodo Entregar código sin grupos que elegir muestra "Aún no hay grupos de códigos — crea uno primero." y un enlace Abrir Grupos de códigos que abre esta página en una pestaña nueva, para que crees el grupo sin perder tu lugar en el editor.
Crear un grupo
Haz clic en Nuevo grupo
Arriba a la derecha de la pestaña. Se abre el diálogo Nuevo grupo de códigos con un campo de nombre, un panel de generación y una caja para pegar.
Ponle nombre
Nombre del grupo es el único campo obligatorio: Crear queda deshabilitado hasta que tenga algo escrito. El texto de ejemplo sugiere la forma útil: "p. ej. Buen Fin 2026 — primeros 100". Pon la campaña y el tamaño en el nombre, porque la tabla muestra cuentas pero no intención.
Trae los códigos, o genéralos
Códigos (uno por línea, opcional) es donde pegas los códigos que ya tienes, normalmente exportados del sistema que los va a canjear. Si necesitas códigos que no significan nada hasta que tú los conectes con algo, usa el panel de generación de arriba.
Haz clic en Crear
El grupo se crea y los códigos que hayas puesto se cargan en él. La confirmación cuenta lo que de verdad entró: "Grupo de códigos creado con {0} código(s)", donde el número son solo las filas nuevas: lo que era duplicado no está ahí.
Un código por línea. Cada línea se recorta, las líneas en blanco se descartan y los duplicados dentro de lo que pegaste se colapsan sin distinguir mayúsculas de minúsculas. Lo que sobrevive se inserta tal cual lo escribiste: los códigos pegados nunca pasan por el generador ni se reformatean. El diálogo lo dice: "Puedes agregar más códigos después. Los duplicados dentro de un grupo se omiten silenciosamente, así que volver a pegar una lista superpuesta es seguro."
Generar códigos en vez de traerlos
El panel Generar códigos aleatorios está arriba de la caja para pegar en los dos diálogos y llena esa caja por ti. Úsalo cuando el código solo tenga que ser único e imposible de adivinar —un número de rifa, un código de acceso que vas a revisar contra esta misma lista— y no cuando un sistema externo ya sepa de él.
- Cuántos y de qué largo. Las dos cajas numéricas se leen como una frase: N códigos de L caracteres. Hasta 10,000 códigos por vez, cada uno de entre 4 y 32 caracteres; el largo cuenta solo el cuerpo aleatorio, no el prefijo ni el carácter de verificación.
- Prefijo (opcional) — una cabecera legible como BF26-. No se revisa contra el alfabeto, así que puedes usar los caracteres que quieras.
- Agregar checksum — "Agrega un carácter de verificación para que un punto de redención pueda rechazar errores de tipeo sin consultar la base de datos". Vale la pena marcarlo si algo tuyo va a validar el código antes de buscarlo. El carácter de verificación cubre solo el cuerpo aleatorio, así que quien lo valide tiene que quitar el prefijo primero.
- Generar — llena la caja. Ojo con el verbo: reemplaza lo que haya en la caja, no lo agrega al final. Genera antes de pegar, nunca después.
Los códigos generados usan dígitos y mayúsculas dejando fuera la I, la L, la O y la U: así no hay una I que pueda ser un 1 ni una O que pueda ser un 0. Eso importa porque estos códigos se fotografían de un QR, se deletrean por teléfono y se teclean en una caja. Los códigos que pegas tú se guardan tal cual, así que esa protección es tuya y la puedes perder.
La tabla y cómo administrar los códigos de un grupo
La lista muestra Nombre, Disponibles, Entregados, Total y Creado, con el grupo más nuevo arriba. Las tres cuentas se calculan a partir de los códigos mismos cada vez que carga la página, así que no se pueden desfasar de la realidad.
Selecciona un grupo y la barra de herramientas ofrece Administrar códigos, Renombrar y Eliminar; el doble clic en una fila abre Administrar códigos directo. Dentro de ese diálogo, una línea de resumen dice "{0} de {1} códigos disponibles", seguida del mismo panel de generación, una caja Agregar más códigos (uno por línea) con un botón Agregar códigos, y la lista de códigos.
- Código es la cadena exactamente como se va a enviar.
- Estado es Disponible o Entregado. Los disponibles se listan primero.
- Entregado en es cuándo salió el código, en UTC (tiempo universal coordinado) y no en tu hora local, o un guion mientras sigue esperando.
- El botón de quitar aparece solo en las filas Disponible, y surte efecto de inmediato sin confirmación. Las filas entregadas no tienen botón de quitar: a propósito, para que el registro de quién recibió qué código no se pueda editar.
Dentro de Administrar códigos no hay paginación ni búsqueda, así que un grupo de varios miles de códigos es un scroll largo y un diálogo lento. Si trabajas a esa escala, deja el grupo para entregar y guarda tu propia copia de la lista para consultar.
Entregar códigos desde un flujo
Un grupo no hace nada hasta que algo toma de él: un nodo Entregar código en un flujo, como describe esta sección, o un formulario de captación en tu tienda (ve la nota al final de esta sección). En el editor de Flujos, agrega un nodo Entregar código y elige el grupo en su panel. El selector de nodos lo describe así: "Entrega un código único de un grupo finito, y al vaciarse enruta a la salida "agotado"." Hasta que elijas un grupo, el nodo aparece marcado como incompleto y su resumen dice "Selecciona un grupo de códigos".
El panel explica la elección del grupo en los mismos términos que esta guía: "Grupo del equipo del que se entregarán los códigos. El tamaño del grupo es el límite de cuántos contactos reciben un código; al vaciarse el nodo enruta a su salida "agotado"." También muestra la misma cuenta restante que la pestaña, así que puedes ver el grupo vaciarse sin salir del lienzo.
El nodo tiene dos salidas, y cablear las dos es justo el motivo de usar un grupo en vez de un mensaje fijo.
| Salida | Se toma cuando |
|---|---|
| Entregado | Se reclamó un código para este contacto. Cablea aquí tu mensaje de entrega. |
| Agotado | El grupo está vacío, o no se eligió ningún grupo. Cablea aquí el plan B honesto: una lista de espera, una disculpa, otra oferta. |
En la rama Entregado, el código queda disponible para todos los nodos siguientes como {{rv_issued_code}}. En ese mismo momento se genera y se sube una imagen QR del mismo código, y su dirección cae en {{rv_issued_code_qr_url}}, así que un elemento de imagen puede mandar el QR y el texto del código juntos. El panel plantea la forma habitual: "El código entregado queda expuesto a los nodos siguientes como {{rv_issued_code}} — normalmente lo usa un Enviar mensaje para armar la URL de la imagen del QR."
Si un contacto que ya tiene un código de este grupo vuelve a llegar al nodo —un comentario doble, un webhook reintentado, una segunda corrida del mismo flujo— se le entrega el mismo código, no uno nuevo. El grupo no se encoge. Eso es lo que evita que una ráfaga de eventos duplicados se coma una promoción. Ojo con qué significa contacto aquí: la identidad es por cuenta de plataforma, así que la misma persona escribiendo desde Instagram y desde WhatsApp son dos contactos y recibirán dos códigos distintos.
El código se reclama antes de armar el QR. Si generar o subir la imagen falla, el fallo se registra y el flujo continúa por la rama Entregado con {{rv_issued_code}} lleno y {{rv_issued_code_qr_url}} vacío. Un mensaje armado solo con la URL del QR saldría con un hueco, así que manda también el código como texto.
Un formulario de captación en tu tienda entrega códigos sin ningún flujo: elige el grupo en Cupón (grupo de códigos), en el editor del formulario (ve Enlaces de captación y códigos QR). Cada persona que se registra reclama un código, que se muestra en la pantalla de éxito del popup y llega al flujo del formulario como {{rv_issued_code}}. El mismo teléfono, o el mismo correo cuando no hay teléfono, siempre recibe de vuelta el mismo código. Cuando el grupo está vacío, el registro igual se hace, solo que sin código; así que un grupo que se vacía sin que ningún flujo lo use casi siempre es un formulario.
Probar un flujo y eliminar un grupo
El botón Probar de la barra del flujo corre el flujo con el motor real sin hacer nada real: "Ejecuta este flujo con el motor real usando una carga de ejemplo. No se envía nada: cada acción se intercepta y se registra." Entregar código se intercepta como todo lo demás.
En una corrida de prueba no se reclama nada y las cuentas no se mueven. El nodo igual toma la rama Entregado para que puedas seguir el resto del flujo, y {{rv_issued_code}} se llena con el marcador DRYRUN-CODE para que el mensaje siguiente se arme. Ver ese marcador en un registro significa que la prueba funcionó, no que algo esté mal configurado. Un nodo sin grupo elegido toma Agotado en una prueba, que es la forma más barata de revisar tu rama de respaldo.
Renombrar cambia el nombre del grupo y nada más: ningún flujo hay que reapuntarlo, porque los nodos se refieren al grupo en sí y no a su nombre.
Eliminar borra el grupo y todos sus códigos, incluidas las filas entregadas, y la confirmación nombra la consecuencia que agarra desprevenida a la gente: "No se puede deshacer, y cualquier automatización que lo use empezará a salir por la rama "agotado"." Un flujo en vivo no se rompe: desde entonces cada ejecución sale por Agotado, así que en silencio le manda tu mensaje de respaldo a todo el mundo —o, si no conectaste nada a Agotado, termina en ese nodo—, y un formulario de captación que usa el grupo sigue recibiendo registros pero deja de mostrar código. Cuando hay formularios de captación que usan el grupo, la confirmación los nombra: los activos después de Hay formularios de captura activos que entregan códigos de este grupo:, y los borradores después de También lo usan formularios en borrador:. Avisa pero no te detiene; igual puedes eliminarlo. Apunta el nodo, y cualquier formulario, a un grupo nuevo en la misma pasada, o pausa el flujo antes.
Preguntas frecuentes
Sí, y esa es la forma prevista de extenderla. Abre Administrar códigos, pega o genera más y haz clic en Agregar códigos. Los códigos nuevos quedan disponibles de inmediato, así que un flujo que ya estaba tomando la rama Agotado vuelve a entregar en su siguiente corrida.
No. Un grupo registra solo la entrega: qué código fue a qué contacto y cuándo. Si ese código se usó en tu caja es conocimiento que vive en el sistema que lo honra. La lista de entregados no se puede exportar: Administrar códigos muestra el Estado y el Entregado en de cada código, pero no quién lo recibió.
Sí. Los grupos son del equipo, así que varios flujos en varias publicaciones y plataformas pueden apuntar al mismo y tomar de una sola cuenta compartida. Así se topa una promoción completa en vez de cada punto de entrada por separado.
Recibe el mismo código que ya tenía, y el grupo no se encoge. Esto se sostiene incluso cuando los dos intentos llegan en el mismo instante, que es justo lo que produce una lluvia de comentarios.
Porque eliminarlo borraría el registro de quién lo recibió. Solo las filas Disponible tienen botón de quitar. Si un lote salió mal, quita los no entregados y agrega el lote corregido: el historial de entregas queda intacto.
Última actualización: octubre 4, 2026 · Automatizaciones
