Temas
Categorías de suscripción: los destinatarios se excluyen de un tipo de correo y siguen suscritos al resto. Un tema se puede ligar a un dominio de envío.
Un tema es una categoría de correo, como «Novedades del producto», «Boletín» o «Promociones». Los destinatarios pueden salirse de un tema y seguir suscritos al resto. Gestiona los temas en el panel, en Contactos → Temas, o con la API.
Cada tema tiene un default_subscription, que se define al crearlo y no se puede cambiar después:
opt_in: todos los contactos están suscritos salvo que se excluyan.opt_out: un contacto está suscrito solo después de aceptarlo.
Un tema también tiene una visibility. Un tema public aparece en la página de baja, y uno private solo aparece a través de su propio enlace.
Cómo se aplican los temas
- Envíos masivos. Un envío masivo puede dirigirse a un tema. Llega a los contactos suscritos a ese tema (por decisión propia o por el valor por defecto del tema). Los contactos dados de baja en todo el equipo, o que se dieron de baja del dominio de envío, siempre quedan fuera.
- Emails individuales. Envía un email con un
topic_idy respeta ese tema. Si todas las direcciones detose han excluido, el envío devuelve422 all_recipients_suppressed. - Página de baja. La página lista los temas públicos, así que un destinatario puede desactivar uno o dejar de recibir todo el correo de marketing de ese dominio. El correo enviado sin
topic_idy fuera de un envío masivo nunca se ve afectado. Consulta Bajas.
Un tema que usa un envío masivo, o que usó un email que aún espera a enviarse, no se puede eliminar: la llamada devuelve 409 conflict hasta que esos envíos hayan salido o se hayan cancelado.
curl -X POST "https://api.billionsend.com/topics" \
-H "Authorization: Bearer bs_..." \
-H "Content-Type: application/json" \
-d '{ "name": "Product updates", "default_subscription": "opt_in" }'
Defines las opciones de un contacto con PATCH /contacts/{id}/topics, pasando entradas como { "id": "<topic-id>", "subscription": "opt_in" }. GET /contacts/{id}/topics lista todos los temas con la subscription del contacto y una marca explicit (falsa cuando es el valor por defecto del tema).
Un tema por marca
Si cada uno de tus dominios es una marca distinta, liga un tema al dominio al que pertenece definiendo domain_id, al crearlo o después con PATCH /topics/{id}, o eligiendo el dominio en el panel.
- Un tema ligado aparece solo en la página de baja de ese dominio. La página de ningún otro dominio muestra su nombre.
- Un envío con ese
topic_iddebe salir de ese dominio. Desde cualquier otro,POST /emailsy las llamadas de envíos masivos devuelven422. - Un tema sin dominio aparece en la página de todos los dominios y se puede enviar desde cualquier dominio.
"domain_id": nullvuelve a hacer de un tema ligado un tema de todo el equipo. - Un dominio no se puede eliminar mientras haya temas ligados a él (
409).
Los segmentos se pueden ligar de la misma manera.
Claves de API limitadas a un dominio
Una clave de API limitada a un dominio solo puede crear temas ligados a ese dominio, y no puede crear uno de todo el equipo.