Visión general (Bulk / Marketing)

El módulo bulk (marketing) es independiente del transaccional. Usa la misma autenticación — Authorization: Bearer $MAILERDASH_API_KEY — pero opera con un canal diferente (X-Md-Channel: bulk). No necesitas agregar ese header en tus llamadas REST: el bulk-worker lo agrega automáticamente al despachar las campañas. Tu interacción con la API es siempre para gestionar datos (contactos, listas, plantillas, campañas, sequences), no para disparar envíos directamente.

Modelo de datos

El flujo general es:

Contactos → se agregan a Listas → Campañas (o Sequences) apuntan a una Lista + una Plantilla → el bulk-worker despacha los envíos.

Recursos

Contactos

Registros individuales con email, name y metadata arbitraria. Cada contacto tiene un status que refleja su estado de entregabilidad:

• active — puede recibir correos.
• unsubscribed — se dio de baja; no recibirá más mensajes.
• bounced — hubo un bounce permanente (5.x.x); excluido de futuros envíos.
• complained — marcó el correo como spam vía FBL; excluido de futuros envíos.

Los contactos son la fuente de verdad de tus suscriptores.

Listas

Grupos de contactos. Una campaña apunta a exactamente una lista. Puedes tener listas separadas por producto, segmento o canal (newsletter, onboarding, reactivación). Los contactos pueden pertenecer a varias listas.

Plantillas

Contenido HTML y/o texto plano reutilizable, con su propio subject. Las campañas y sequences las referencian por ID, lo que te permite actualizar el contenido sin modificar las campañas ya configuradas.

Campañas

Envío masivo one-shot a una lista. Ciclo de vida:

• draft — en borrador, editable.
• send — encolada para despacho inmediato.
• sent — el bulk-worker terminó de procesar todos los contactos.

Una vez enviada, la campaña no es modificable.

Sequences

Automatizaciones drip. Una sequence define pasos (steps) con un delay entre cada uno (horas o días), y tiene subscribers que son contactos que avanzan por los pasos en el tiempo configurado. Son útiles para onboarding, nurturing y follow-ups automatizados.

Supresiones

Todas las rutas bulk respetan la lista de supresión global de la cuenta. Los contactos con status bounced, complained o unsubscribed se omiten automáticamente al momento del envío — no tienes que filtrarlos manualmente.

Consulta la guía de supresiones para ver cómo gestionar la lista y qué ocurre cuando un contacto es suprimido desde distintas fuentes.

Bounces y quejas modifican el status del contacto

Cuando el sistema procesa un bounce permanente o una queja FBL, el contacto asociado cambia automáticamente a bounced o complained. A partir de ese momento queda excluido de todos los envíos futuros, en cualquier lista y campaña, sin necesidad de intervención manual.

Guías por recurso

Recurso	Guía
Contactos	Crear, importar y gestionar contactos
Listas	Organizar contactos en listas
Plantillas	Crear plantillas reutilizables
Campañas	Enviar campañas masivas
Sequences	Automatizar con sequences (drip)