Categorías
Cada correo que envías tiene una categoría que indica por qué lo envías, definida con el campo category en POST /v1/email/messages. Acepta uno de dos valores, marketing o transactional, y tiene un solo efecto: decide qué registros de supresión y preferencias de cancelación de suscripción pueden bloquear el mensaje.
Una cancelación de suscripción a un boletín dice algo sobre el correo de marketing y nada sobre los restablecimientos de contraseña. La categoría es la forma de distinguir esas dos intenciones.
Las dos categorías
- marketing: correo que el destinatario eligió recibir y puede dejar de recibir. Campañas, boletines, anuncios de producto, ofertas promocionales. Cualquier caso en el que "I don't want this anymore" sea una respuesta que debes respetar.
- transactional: correo que la propia acción del destinatario requiere. Restablecimientos de contraseña, verificación de correo electrónico, códigos de un solo uso, recibos de pedidos, alertas de seguridad y de cuenta. Estos tienen que llegar sin importar las preferencias de marketing del destinatario.
Pregúntate qué pasa si el mensaje nunca llega. Si un flujo que el destinatario inició se rompe, es transaccional. Si tú iniciaste la conversación, es marketing.
Estas dos son el conjunto completo: ningún API crea ni configura una categoría, y el campo se valida contra esos valores. Para una segmentación más detallada, usa etiquetas junto con la categoría.
Cómo la categoría determina la política de supresión
El contrato se resume en una línea: marketing es bloqueado por cualquier motivo de supresión y por cualquier cancelación, mientras que transactional se entrega a pesar de una supresión por queja o una cancelación solo de marketing. Los rebotes duros, las supresiones manuales y una cancelación registrada para todos los mensajes bloquean ambos.
La asimetría se explica por lo que significa cada motivo. Un rebote duro indica que la dirección no existe, así que enviar es inútil sea cual sea la categoría. Una supresión manual es una decisión de tu propio equipo, que nunca cuestionamos. Las quejas y cancelaciones de suscripción son preferencias sobre correo no deseado: detienen tus envíos marketing, mientras que un destinatario que reportó tu boletín como spam sigue recibiendo su restablecimiento de contraseña. La excepción también es deliberada: una cancelación puede registrarse para todos los mensajes en lugar de solo marketing (la opción Mensajes a detener del diálogo Registrar preferencia, o coverage: all en POST /v1/preferences), y eso es el destinatario pidiendo silencio, así que también bloquea el correo transaccional.
Los destinatarios bloqueados se rechazan donde puedes verlos, una línea por destinatario con el motivo adjunto. Supresiones contiene la tabla motivo por motivo y explica cómo las direcciones llegan a la lista.
El valor predeterminado y por qué los envíos transaccionales deben excluirse
Si omites category, el envío es marketing. Eso falla en la dirección segura: el correo enviado sin una categoría explícita respeta las cancelaciones de suscripción y las quejas e incluye un enlace de cancelación de suscripción, así que una campaña cumple la normativa sin trabajo adicional.
Dos rutas de envío toman su categoría de otro lugar. Un envío que usa una plantilla almacenada y omite category toma la clasificación propia de la plantilla, así que una plantilla creada como transactional se envía como transaccional. Establece category en el envío para clasificar un mensaje de forma diferente, y el valor del envío prevalece. El correo enviado a través de SMTP toma su categoría de la configuración SMTP de la clave API, que es transactional para una clave que no has configurado.
Así que el correo operativo tiene que excluirse. Un restablecimiento de contraseña enviado sin categoría se trata como marketing: lleva un enlace de cancelación de suscripción que no debería tener, y una cancelación de suscripción a un boletín lo bloquea aunque el destinatario lo haya solicitado. Establece category: "transactional" en recibos, restablecimientos, códigos de verificación y alertas de cuenta:
Ejemplo de código
{
"from": "no-reply@yourdomain.com",
"to": ["delivered@messagebird.dev"],
"subject": "Reset your password",
"html": "<p>Click the link below to reset your password...</p>",
"category": "transactional"
}Categorías como dimensión analítica
La categoría permanece en el mensaje y aparece en todos los lugares donde se muestra el mensaje, así que divide tus cifras de entrega, rebotes e interacción en tráfico de marketing y operativo sin que tengas que etiquetar cada envío. La lista de mensajes filtra por categoría, las estadísticas API desglosan las métricas por categoría, y el registro de correo del panel ofrece el mismo filtro.
Próximos pasos
- Envío de correo electrónico: el payload completo de POST /v1/email/messages, incluido category
- Supresiones: la lista de supresión, los tres motivos y la matriz completa de categorías
- Enlaces de cancelación de suscripción: los detalles de cancelación que incluye un envío marketing
- Referencia de API: esquemas completos de solicitud y respuesta
Recursos relacionados
Continúa con la documentación, guías y ejemplos sobre este tema. Los recursos están en inglés.
Ver la guíaGetting started with emailExplorar la funcionalidadEmailSeguir la ruta de aprendizajeBuild your first integrationGuía de implementaciónSend your first email
Prueba el ejercicio y obtén un resumen de implementación