Qué hace un tema | AgentsMail.io Documentation

Un tema es una línea editorial duradera (freelancing, agentic) que un lector puede rechazar por separado. Rechazar un tema no da de baja a nadie: el contacto sigue recibiendo todo lo demás. Sin temas, la única salida es total. Un lector que vino por un asunto y recibe tres campañas sobre otro tiene un solo botón, y ese botón te cuesta el contacto entero.

Cómo se usa

Los temas pertenecen a la organización, no a una lista: una línea editorial atraviesa las listas. Los creas en Ajustes → Temas, y el nombre es único dentro de la organización. Una campaña lleva cero o un tema. Una secuencia también. No hay multitema: con varios, ni tú ni el lector sabrían qué excluye un rechazo. Para que el lector pueda rechazarlo, el email tiene que ofrecer el enlace. Pon {{topicOptOutUrl}} donde quieras en la plantilla, como un segundo enlace junto al de baja:

html

<a href="{{unsubscribeUrl}}">Unsubscribe</a> ·
<a href="{{topicOptOutUrl}}">No more emails about this topic</a>

Ambos actúan en un clic: llegar a la página es la respuesta, sin formulario que rellenar. Un lector que quiera ir más allá llega a su página de preferencias desde la página de baja: allí puede recuperar un tema que había rechazado, corregir su nombre y apellidos, o volver a suscribirse si se había ido.

Nada lleva el shortcode por ti. Las plantillas de la galería y el contenido por defecto dejan fuera {{topicOptOutUrl}} a propósito: una plantilla compartida que lo llevara rompería todas las campañas enviadas sin tema. Lo añades a tu propia plantilla el día que empieces a usar temas.

Hacerlo por API

Todo lo anterior tiene un equivalente en la API: Topics los lista, los crea, los renombra y los elimina, y topicId asocia uno a una campaña o a una secuencia. De ahí sale también el id para las dos llamadas que registran la preferencia de un lector en tu nombre.

Qué excluye, y cuándo

Un rechazo se comprueba en el momento del envío, no cuando eliges la audiencia. Un contacto que rechazó el tema se quita de los destinatarios y, en una secuencia, el contacto sale del recorrido: los pasos restantes nunca se envían. Eso significa que el recuento mostrado antes del envío puede ser mayor que el número de emails realmente enviados. Esa diferencia son los rechazos.

Qué se niega, y por qué

Dos situaciones, dos respuestas distintas: recibes una advertencia cuando pierdes algo y un error cuando el destinatario recibiría algo roto.

Situación	Qué pasa
La campaña tiene un tema, el contenido no tiene `{{topicOptOutUrl}}`	Advertencia. El email es válido y sale con su enlace de baja legal. Solo falta la salida del tema.
El contenido tiene `{{topicOptOutUrl}}`, la campaña no tiene tema	Se rechaza el envío. La variable quedaría vacía y el destinatario recibiría un enlace roto. Elige un tema o quita el shortcode.
Un paso de secuencia lleva `{{topicOptOutUrl}}` y la secuencia no tiene tema	Se rechaza la publicación, nombrando los pasos que fallan.
Quitar el tema de una secuencia publicada cuyos pasos llevan el shortcode	Rechazado. Abre un borrador, quita el shortcode, publica, o conserva un tema.

Eliminar un tema que todavía lleva una campaña o una secuencia también se rechaza, y el mensaje las nombra. Eliminar uno que nada usa es definitivo: los rechazos que expresaron las personas se pierden, y esas personas vuelven a recibir ese tema.

Lo que no es

Un tema no es una etiqueta. Tú pones las etiquetas en los contactos: segmentación positiva, "quién es esta persona". Un rechazo de tema lo pone el destinatario: "lo que esta persona ya no quiere". Dos autoridades sobre una misma tabla acabarían mal: una importación que reescribe las etiquetas borraría los rechazos. Un tema tampoco es segmentación. Una etiqueta o un segmento dice a quién envías; el tema es una exclusión aplicada por encima de eso. Y nunca sustituye a la baja legal. Las cabeceras List-Unsubscribe que exigen Gmail y Yahoo siguen apuntando a la ruta de un clic que da de baja por completo. Un rechazo de tema es una opción adicional, nunca un sustituto.