Saltar al contenido principal
Gestionar cómo los usuarios se dan de baja de tus emails es fundamental para cumplir con los estándares de email (como CAN-SPAM), asegurar una fuerte entregabilidad con proveedores como Gmail y Yahoo, y construir confianza con tu audiencia. OneSignal soporta tanto enlaces de cancelación de suscripción visibles como encabezados List-Unsubscribe, asegurando que tus emails sean completamente conformes mientras te da control sobre cuándo y cómo los usuarios pueden optar por no participar.

​
Estados de suscripción y lógica de supresión

Las Suscripciones de email son:
  • Suscritas – elegibles para recibir mensajes de email.
  • Desuscritas – excluidas de la mayoría de los envíos de email a menos que se anule explícitamente.
Para incluir Suscripciones desuscritas en tu email (por ejemplo, para mensajes transaccionales):
  • En el dashboard: Habilita Advanced Settings > Include sending to unsubscribed users al enviar un email.
  • En la API: Usa la propiedad include_unsubscribed en la API de crear notificación de email.

Habilitar envío a usuarios desuscritos

​
Cómo los usuarios se desucriben

El estado de suscripción de email se actualiza mediante:

​
Encabezado de cancelar suscripción vs enlace de cancelar suscripción

  • Encabezado List-Unsubscribe: Un encabezado de email oculto usado por proveedores de bandeja de entrada para mostrar botones nativos “Cancelar suscripción” (por ejemplo, Gmail, Yahoo).
  • Enlace de cancelar suscripción: Una URL cliqueable visible colocada en tu contenido de email usando el token [unsubscribe_url].

​
Comportamiento del encabezado List-Unsubscribe

OneSignal incluye un encabezado List-Unsubscribe en todos los emails excepto cuando habilitas “Include sending to unsubscribed users.” Esto ayuda a:
El encabezado List-Unsubscribe no se incluye si habilitas “Include sending to unsubscribed users.”Algunos proveedores de bandeja de entrada pueden ocultar este encabezado de la visualización a menos que cumplas ciertos umbrales de volumen de envío. Consulta los requisitos de Gmail y Yahoo.
Si un usuario hace clic en esto, su Suscripción de email será marcada como desuscrita en tu aplicación de OneSignal.

​
Agregar enlaces de cancelar suscripción en emails

OneSignal proporciona el token [unsubscribe_url], que inserta un enlace visible de cancelar suscripción en tu contenido de email. También puedes crear una experiencia de marca con tu propia página de cancelar suscripción. Consulta Crear una página personalizada de cancelar suscripción.

​
Editor HTML

Si usas nuestro editor HTML, la plantilla predeterminada incluye un enlace de cancelar suscripción automáticamente:

Editor HTML con enlace de cancelar suscripción predeterminado

Para agregarlo manualmente (por ejemplo, mediante API con email_body):
HTML
<a href="[unsubscribe_url]">Unsubscribe</a>

​
Editor de arrastrar y soltar

En un bloque de texto:
  1. Haz clic en Special Links > Suppression > Unsubscribe
  2. El marcador de posición [unsubscribe_url] se inserta
  3. Puedes resaltar texto antes de insertar para convertirlo en un enlace

Enlace de cancelar suscripción en editor de Arrastrar y Soltar

Siempre haz que los enlaces de cancelar suscripción sean muy visibles con tamaños de fuente legibles (al menos 12px) y fuerte contraste. Los enlaces ocultos o difíciles de encontrar pueden llevar a los usuarios a marcar tus mensajes como spam, dañando la entregabilidad futura.

​
Destinos de enlaces de cancelar suscripción personalizados

Puedes reemplazar [unsubscribe_url] con tu propia página de aterrizaje de cancelar suscripción. Para hacer esto:
Si usas un enlace personalizado, OneSignal no marcará automáticamente al usuario como desuscrito. Debes manejar eso mediante la API o comportamiento de la página.

​
FAQ

​
¿Por qué no funciona el enlace de cancelar suscripción en mi email de prueba?

Si tu dominio de envío de email de OneSignal aún no está verificado, los enlaces de cancelar suscripción en emails de prueba no serán funcionales. Verás texto de marcador de posición, pero ningún enlace real. Una vez que tu dominio esté verificado, los enlaces de cancelar suscripción se renderizarán y funcionarán correctamente.

​
¿Cómo resuscribo una dirección de email?

Los usuarios pueden ser resuscritos de tres maneras:
  1. Dashboard: Ve a Audience > Subscriptions > Options > Resubscribe to Email
  2. API: Establece enabled: true en las APIs de Create User o Update subscription
  3. Importación CSV: Establece subscribed = yes al importar direcciones de email
Si usas un proveedor de email de terceros (ESP), verifica su lista de supresión y elimina la dirección allí también.

​
¿Por qué hay dos enlaces de cancelar suscripción en mi email?

Si estás usando ESPs como Mailgun o SendGrid, pueden insertar su propio enlace de cancelar suscripción. Puedes deshabilitar esto en la configuración de tu ESP para evitar duplicación.

​
¿Los clics de cancelar suscripción cuentan para analytics?

  • Hacer clic en el [unsubscribe_url] personalizado de OneSignal no cuenta para los analytics de clics.
  • Hacer clic en una URL personalizada de cancelar suscripción se contará como un clic. Consulta URLs, Enlaces y Deep Links para más detalles.

​
Artículos relacionados