Bajas y marcas
Las bajas se guardan por dominio de envío, así que cada marca tiene su propia lista, su propia página de baja y su propio host de enlaces.
Una baja significa «no más correo de marketing». BillionSend la registra para el dominio de envío cuyo email llevaba el enlace, de modo que un equipo con varias marcas nunca mezcla sus listas. Quien se da de baja de una marca sigue recibiendo correo de las demás.
El email transaccional (el correo enviado sin un tema y fuera de un envío masivo) nunca se ve afectado por una baja.
Tres ámbitos
| Ámbito | Quién lo define | Qué detiene |
|---|---|---|
| Dominio | El destinatario, con el enlace de baja o el botón de un clic de su cliente de correo | El correo de marketing del dominio que envió ese email |
| Todo el equipo | Tú, poniendo unsubscribed de un contacto en true (API, panel o importación CSV) |
El correo de marketing de todos los dominios de tu equipo |
| Tema | El destinatario, en la página de baja | El correo enviado con ese tema |
La baja del propio destinatario nunca cambia la marca unsubscribed del contacto. Se guarda como un registro del dominio, identificado por la dirección de email, así que sobrevive a eliminar y volver a importar el contacto.
Los envíos masivos y los envíos por tema omiten a un destinatario que se ha excluido del dominio de envío, de todo el equipo o del tema. Un email individual detenido de esta manera termina como suppressed con el motivo domain_unsubscribed, contact_unsubscribed o topic_unsubscribed.
Las bajas no son supresiones. La lista de supresión contiene las direcciones que rebotaron, presentaron una queja o que tú bloqueaste, y detiene todos los emails, el transaccional incluido. Una baja detiene solo el correo de marketing.
La página de baja
Todo email de un envío masivo o por tema lleva las cabeceras List-Unsubscribe de un clic (RFC 8058) y un enlace a una página de baja alojada. Escribe {{{UNSUBSCRIBE_URL}}} en un cuerpo y se convierte en ese mismo enlace para cada destinatario. La página se abre en el idioma del navegador del destinatario (catorce idiomas, con el inglés como alternativa). Además de dejar de recibir todo el correo de marketing del dominio, el destinatario puede activar y desactivar temas individuales.
Un destinatario que hizo clic por error puede pulsar Volver a suscribirme en la página de confirmación. Solo deshace de lo que ese enlace lo excluyó. Un escáner de correo que abre el enlace nunca vuelve a suscribir a nadie. Cuando defines tú mismo unsubscribed: true, la página no tiene botón de volver a suscribirse.
Cada dominio tiene su propio aspecto
La página se parece al dominio que envió el email. Cada dominio puede definir:
- un nombre de marca, un logo y el radio de las esquinas del logo,
- los colores de fondo, de texto y de acento,
- el texto sobre el botón y el texto que se muestra tras guardar la elección,
- una URL de redirección que se abre tras darse de baja, en lugar del mensaje de la página.
En el panel, abre el dominio y usa la pestaña Marca, que muestra una vista previa del resultado. Un campo que dejas vacío recurre a los Valores por defecto de la marca del equipo (Configuración) y, después, al aspecto sencillo de BillionSend. La página muestra solo lo que pertenece a ese dominio: nunca nombra otro dominio de tu equipo, y lista solo los temas ligados a ese dominio más los temas sin dominio.
Con la API, envía los campos en unsubscribe_page en PATCH /domains/{id}. Un null borra un campo. El logo se sube en el panel y en la API es de solo lectura.
curl -X PATCH "https://api.billionsend.com/domains/$DOMAIN_ID" \
-H "Authorization: Bearer bs_..." \
-H "Content-Type: application/json" \
-d '{
"unsubscribe_page": {
"brand_name": "Acme",
"message": "Sorry to see you go. Unsubscribe from Acme emails?",
"success_message": "You are unsubscribed from Acme.",
"accent_color": "#0a7d5a",
"logo_radius": "rounded"
}
}'
Un enlace creado fuera de un email, como el de POST /contacts/{id}/preferences-link, abre la página por defecto del equipo, y darse de baja allí excluye al contacto de todos los dominios.
Tu propio subdominio de baja
Por defecto, los enlaces se abren en un host de BillionSend. Para abrirlos en tu propio dominio, dale al dominio un subdominio de baja en su pestaña Enlaces, o con unsubscribe_subdomain en POST /domains o PATCH /domains/{id} (una etiqueta como unsubscribe para unsubscribe.yourdomain.com; null la borra). Funciona como el subdominio de rastreo; consulta Dominios.
- Añade el CNAME que muestra la pestaña DNS del dominio, apuntando a
cname.billiondns.com, como solo DNS (nube gris en Cloudflare). - El certificado se emite automáticamente cuando el CNAME se resuelve, normalmente en pocos minutos.
unsubscribe_statuspasa dependingaactive, yunsubscribe_errorindica el motivo cuando no lo hace. - El correo nuevo usa entonces tu host en el enlace y en la cabecera
List-Unsubscribe. Hasta que esté activo, y tras un resultadofailed(72 horas sin activarse), se usa el host compartido.
Un enlace ya enviado conserva el host con el que se envió, así que deja de funcionar si más tarde quitas el CNAME. Un subdominio tuyo abre solo los enlaces de su propio dominio; cualquier otro enlace responde 404.
Puedes usar una misma etiqueta para el rastreo y la baja, pero es más seguro usar nombres distintos: los bloqueadores de anuncios bloquean los hosts de rastreo, y un nombre compartido se llevaría consigo el enlace de baja.
Leer y cambiar las bajas
GET /contacts/{id} devuelve unsubscribed (la marca de todo el equipo) y unsubscribed_domains. En el panel, la página de un contacto lista ambos y te permite quitar la baja de un dominio. La pestaña Bajas de Contactos lista todos los registros.
# List, newest first. domain_id narrows to one domain.
curl "https://api.billionsend.com/unsubscribes?domain_id=$DOMAIN_ID" \
-H "Authorization: Bearer bs_..."
# Record an opt-out from one domain (leave domain_id out for every domain)
curl -X POST "https://api.billionsend.com/unsubscribes" \
-H "Authorization: Bearer bs_..." \
-H "Content-Type: application/json" \
-d '{ "email": "ada@example.org", "domain_id": "'"$DOMAIN_ID"'" }'
# Remove one record
curl -X DELETE "https://api.billionsend.com/unsubscribes/$UNSUBSCRIBE_ID" \
-H "Authorization: Bearer bs_..."
Un registro con domain_id y domain ambos en null excluye la dirección de todos los dominios. El POST es idempotente: un registro existente se devuelve sin cambios. Las mismas llamadas existen como las herramientas MCP list_unsubscribes, add_unsubscribe y delete_unsubscribe.
Qué levanta qué:
PATCH /contacts/{id}conunsubscribed: falselevanta solo la baja de todo el equipo. Las bajas de dominios concretos se mantienen.DELETE /unsubscribes/{id}quita ese registro.
Si eliminas un dominio y lo vuelves a añadir con el mismo nombre, las bajas de sus destinatarios se aplican de nuevo.
Quién puede cambiarlas
Los propietarios, los administradores y los miembros de marketing, y las claves de API de acceso total, pueden registrar bajas. Solo los propietarios y los administradores pueden retirar una. Consulta Roles del equipo.
Una clave de API limitada a un dominio gestiona solo las bajas de ese dominio: los demás dominios devuelven 403 restricted_api_key.
Importar una lista desde CSV
Para traer una lista de bajas de otro proveedor, abre Contactos → Bajas en el panel y elige Importar CSV.
email,domain
ada@example.com,
grace@example.com,news.example.org
alan@example.com,*
emailes obligatorio.domaines opcional. La fila de encabezado también es opcional.domaines uno de tus dominios y limita la baja al correo de ese dominio.*significa todos los dominios. Una celda vacía usa el Dominio por defecto que eliges en el diálogo.- Se omite una fila con un dominio desconocido o una dirección no válida.
El diálogo muestra cuántas bajas se añadieron, cuántas ya existían y por qué se omitieron filas. Importar el mismo archivo dos veces es seguro.
Eventos
La baja de un destinatario dispara contact.unsubscribed con source en hosted_page o one_click, además de domain_id y domain_name (ambos null en una baja de todo el equipo). Retirarla dispara contact.resubscribed. Consulta Webhooks.
Límites
| Free | Starter, Pro, Scale | |
|---|---|---|
| Aspecto de la página de baja (logo, colores, fuente, radio del logo) | Aspecto por defecto | Tu propio aspecto por dominio |
| Subdominio de baja propio | No (host compartido) | Sí |
| «Powered by BillionSend» en la página | Se muestra | Oculto |
En Free, definir un subdominio devuelve 403 plan_limit_reached. Puedes guardar un aspecto de página, pero los destinatarios ven el aspecto por defecto hasta que mejores de plan. Tras bajar de plan, los aspectos guardados se conservan y se aplican de nuevo cuando mejoras, y los subdominios que ya definiste siguen funcionando.