Qué problema resuelve
Campañas permite enviar un correo comercial a clientes que ya tienen email registrado. Es una herramienta de envío segmentado, no el lugar donde se configuran las notificaciones transaccionales del negocio.
La pantalla usa el proveedor de email configurado para el tenant. Si no existe proveedor, la propia pantalla indica que primero hay que configurarlo en Configuración → Notificaciones.
Antes de crear una campaña
Necesitás:
- una cuenta de email configurada;
- clientes con email en el segmento elegido;
- un nombre interno;
- un asunto;
- un cuerpo HTML.
La disponibilidad de la pantalla también puede estar condicionada por el plan. Si la API responde con un bloqueo de plan, Structura muestra el estado bloqueado y no debe intentarse saltar la restricción desde la interfaz.
Proveedor de envío
La pantalla consulta la configuración de email del tenant y muestra el proveedor activo.
Los proveedores contemplados por el runtime son:
| Proveedor | Comportamiento visible |
|---|---|
| Gmail | envío por tandas; referencia operativa de hasta ~450/día en la interfaz |
| Resend | proveedor de email transaccional; el límite depende de Resend |
| SMTP | envío por tandas para respetar límites del servidor |
| Structura | usa el email de plataforma y consume la cuota mensual del plan |
Si no aparece ningún proveedor, no significa que la campaña esté rota: significa que primero hay que completar la configuración de email.
Cada destinatario recibe el correo individualmente, con su nombre y un enlace de desuscripción.
Nueva campaña
Nombre interno
Identifica la campaña dentro de Structura. Es administrativo y no reemplaza el asunto que verá el cliente.
Ejemplo: Promo agosto.
Asunto
Es el asunto del email. Es obligatorio para guardar el borrador.
Ejemplo: Novedades de la semana.
Segmento
Los valores disponibles en la pantalla son:
- Todos con email (
all): todos los clientes que tienen email. - Recurrentes (
recurring): clientes con al menos 2 pedidos. - Inactivos (
lapsed): clientes con más de 45 días sin actividad de compra.
El segmento se aplica tanto al preview de destinatarios como al envío de la campaña.
Cuerpo HTML
El cuerpo se edita directamente como HTML.
Variables disponibles:
| Variable | Se reemplaza por |
|---|---|
{{customerName}} | nombre del cliente; si falta, se usa Cliente |
{{tenantName}} | nombre de la tienda; si falta, se usa Tu tienda |
El HTML no debe considerarse enviado exactamente como se escribe: las variables se sustituyen durante la preparación del correo y el email real incorpora el header/footer de la marca.
Ver destinatarios
Ver destinatarios consulta el segmento seleccionado antes del envío.
La respuesta muestra:
- cantidad total de destinatarios;
- una muestra de destinatarios;
- nombre cuando existe;
- email;
- cantidad restante cuando la muestra no representa a todo el segmento.
Usá esta acción antes de enviar una campaña. Es la verificación más importante para detectar una segmentación demasiado amplia o demasiado pequeña.
Preview email
Preview email abre una previsualización del HTML con valores de ejemplo para las variables.
La preview sirve para revisar estructura y contenido, pero no prueba que el proveedor pueda entregar el correo ni que todos los destinatarios reciban el mensaje.
Guardar borrador
Para guardar un borrador son obligatorios:
- nombre interno;
- asunto;
- cuerpo.
Al guardar, Structura crea la campaña y vuelve a cargar el historial. El formulario se limpia después de una creación correcta.
Guardar un borrador no envía la campaña.
Historial y estados
Cada campaña del historial puede mostrar:
- nombre;
- asunto;
- segmento;
- estado;
- cantidad enviada;
- cantidad fallida;
- aperturas;
- clicks.
Estados visibles:
| Estado | Significado operativo |
|---|---|
| Borrador | todavía no se envió |
| Enviando | el envío está en curso |
| Enviada | el proceso terminó como envío |
| Con errores | el envío terminó con fallos |
Una campaña en Borrador o Con errores puede volver a mostrar la acción Enviar.
Enviar una campaña
El envío tiene una confirmación explícita. Antes de confirmar, Structura muestra a qué segmento se enviará.
El proceso se realiza por tandas para proteger la cuenta de email y puede tardar varios minutos cuando hay muchos destinatarios.
El resultado informa:
- enviados;
- fallidos;
- si se alcanzó el límite del proveedor;
- si se alcanzó el tope del plan;
- total de destinatarios;
- máximo procesado cuando corresponde.
Cuotas y límites
Hay dos tipos de límite que no deben confundirse:
- Límite del proveedor: por ejemplo, el límite diario de Gmail o las condiciones de tu SMTP/Resend.
- Límite del plan Structura: la cuota de campañas/email de tu suscripción cuando el envío usa el proveedor de plataforma.
Si el envío termina parcialmente por uno de estos límites, no lo interpretes como un error visual de la campaña.
Flujo recomendado
Configurar email → crear campaña → elegir segmento → ver destinatarios → revisar HTML → preview → guardar borrador → confirmar envío → revisar enviados/fallidos/aperturas/clicks.
Diagnóstico
No puedo enviar: revisá primero Configuración → Notificaciones y verificá que exista un proveedor de email.
Hay demasiados destinatarios: ejecutá Ver destinatarios y cambiá el segmento antes de guardar/enviar.
Las variables aparecen sin reemplazar: verificá que estén escritas exactamente como {{customerName}} o {{tenantName}}.
El envío se corta: distinguí si el resultado indica límite del proveedor o límite del plan.
Hay enviados y fallidos: revisá el contador de fallidos; la campaña puede haber terminado parcialmente sin que todo el lote sea inválido.
La campaña figura pero no se envía: una campaña en estado Borrador todavía requiere la acción Enviar.
Qué no hacer
- No envíes sin revisar primero la cantidad de destinatarios.
- No uses el preview como prueba de entregabilidad.
- No confundas guardar borrador con enviar.
- No dupliques una campaña porque el proveedor todavía está procesando un lote.
- No trates un límite de proveedor como si fuera una falla del editor.