Temas y centro de preferencias

Deja que los contactos elijan qué tipos de email reciben — por tema y por canal — con un centro de preferencias alojado por-tema, double opt-in e historial de consentimiento completo

Un único interruptor "suscrito / de baja" se queda corto en cuanto envías más de un tipo de email. Los temas permiten que un contacto conserve tus alertas de seguridad y el resumen semanal mientras se da de baja de las promociones — en lugar de darse de baja de todo. Esta guía cubre la creación de temas, el centro de preferencias alojado, el double opt-in y el historial de consentimiento.

Temas

Un tema es un tipo de comunicación al que un contacto puede suscribirse de forma independiente — Novedades de producto, Alertas de seguridad, Resumen semanal, Promociones, Notificaciones de facturación, etc. Créalos y gestiónalos en Ajustes › Datos › Temas.

Cada tema tiene:

Campo	Qué hace
Nombre	Lo que ve el contacto en el centro de preferencias (p. ej. "Resumen semanal").
Clave	Identificador de máquina estable (p. ej. `weekly_digest`) — el contrato para la API y las importaciones. Inmutable una vez creado.
Canales	En qué canales se ofrece el tema (email, SMS). Por defecto, email.
Obligatorio	Temas de clase transaccional (seguridad, facturación). Se muestran bloqueados y siempre se entregan, incluso a un contacto que desactivó todo el marketing.
Suscrito por defecto	Si un contacto nuevo cuenta como suscrito a este tema opcional hasta que indique lo contrario.
Double opt-in	Requiere que el contacto confirme mediante un enlace por email antes de que la suscripción cuente (ver abajo).

Los temas son solo presentación y consentimiento — nunca cambian cómo se produce un evento ni cómo un workflow hace match. Un proyecto sin temas se comporta exactamente igual que antes.

Obligatorios vs opcionales

Los temas obligatorios se saltan el interruptor general. Son para correo del que un contacto no puede razonablemente darse de baja — una alerta de seguridad, un aviso de facturación. El centro los muestra como Siempre activo.
Los temas opcionales requieren el interruptor general del canal activado y un opt-in a nivel de tema. Es el caso normal.

El centro de preferencias alojado

Cada email de marketing (y headless) ya lleva un enlace personalizado a una página alojada — no construyes ni alojas nada. Con temas definidos, esa página se convierte en un centro por-tema y por-canal:

Un interruptor general para el email de marketing.
Un toggle por cada tema opcional.
Los temas obligatorios se muestran bloqueados ("Siempre activo").
Una opción de "darse de baja de todo" (el destino de un solo clic de la cabecera List-Unsubscribe).

Se accede mediante un token firmado — sin el id del contacto en la URL — y se renderiza en el idioma del contacto. Los enlaces que ya están en bandejas de entrada antiguas siguen funcionando.

Asignar un tema a una campaña

Cuando fijas el tema de una campaña, su audiencia se limita automáticamente a los contactos suscritos a ese tema. Una campaña sin tema mantiene el comportamiento de siempre (todos los suscritos al marketing).

Double opt-in

Activa Double opt-in en un tema y una suscripción deja de contar hasta que el contacto confirme:

El contacto se suscribe (desde el centro de preferencias o un formulario). Su estado pasa a pendiente — todavía no recibe correo del tema.
Bitelio envía un enlace de confirmación desde tu dominio de envío verificado.
Al hacer clic, pasa a suscrito y se sella la versión de consentimiento activa (a qué accedió, y cuándo).

Un contacto pendiente nunca recibe el correo del tema, así que una suscripción sin confirmar no puede colarse en un envío.

Historial de consentimiento

Cada cambio de consentimiento — un toggle en el centro, el envío de un formulario, un rebote, una queja, una importación — se escribe en un historial de consentimiento append-only. Abre un contacto y selecciona la pestaña Consent para leerlo: qué cambió, cuándo, el origen y el motivo. Es el registro al que acudir en una revisión de cumplimiento.

Construir tu propio centro de preferencias

No tienes por qué usar la página alojada. Genera un enlace para un contacto e incrústalo o maneja la API pública tú mismo:

# Generar un enlace del centro de preferencias para un contacto (autenticado, clave secreta)
POST /contacts/{id}/preference-link
→ { "token": "v1.…", "url": "https://app.…/preferences/v1.…" }

Luego lee y escribe preferencias contra el token — sin auth, el token es la capacidad:

GET  /preferences/{token}            # estado actual: interruptor de canal + temas
PUT  /preferences/{token}            # { topics: { weekly_digest: { email: true } }, channelMaster: { email: true } }
POST /preferences/{token}/unsubscribe-all

Suscribir a un contacto a un tema con double opt-in desde la API dispara el mismo flujo de confirmación.

Relacionado

Páginas de baja y preferencias — las variables de enlace inyectadas en cada envío.
Supresiones de email — la lista de no-enviar.
Importar consentimiento — trae el consentimiento de temas desde otra plataforma.