> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Enlaces de cancelación de suscripción y encabezados de email

> Aprende cómo gestionar el comportamiento de cancelación de suscripción de email en OneSignal, incluyendo enlaces de cancelación de suscripción, encabezados List-Unsubscribe, reglas de supresión y flujos de resuscripción.

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](./subscriptions) 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](/reference/email).

<Frame caption="Habilitar envío a usuarios desuscritos">
  <img src="https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/72d0ed1-f246c05-Screenshot_2023-01-18_at_10.06.54_AM.png?fit=max&auto=format&n=jBdBk5XvQR5eKOks&q=85&s=5bddf440aae0717dc518b8a43789d3da" width="906" height="616" data-path="images/docs/72d0ed1-f246c05-Screenshot_2023-01-18_at_10.06.54_AM.png" />
</Frame>

***

## Cómo los usuarios se desucriben

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

* El usuario haciendo clic en un enlace de cancelar suscripción o encabezado List-Unsubscribe
* Tú [importando un CSV de direcciones de email](./import) y estableciendo `subscribed` a `no`.
* Tú estableciendo `enabled : false` mediante las APIs de [Create user](/reference/create-user), [Update user](/reference/update-user), o [Update subscription](/reference/update-subscription).
* Tú desuscribiendo manualmente desde **Audience > Subscriptions > Options > Unsubscribe from Email**

***

## 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:

* Prevenir que tus emails sean marcados como spam
* Cumplir con las [reglas de Gmail/Yahoo 2024](https://onesignal.com/blog/guide-to-2024-gmail-and-yahoo-requirements-for-email-senders/).

<Warning>
  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](https://support.google.com/a/answer/81126?visit_id=638683263663552218-2680312485\&rd=1#requirements-5k\&zippy=%2Crequirements-for-sending-or-more-messages-per-day) y [Yahoo](https://senders.yahooinc.com/best-practices/).
</Warning>

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](./create-custom-unsubscribe-page).

#### Editor HTML

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

<Frame caption="Editor HTML con enlace de cancelar suscripción predeterminado">
  <img src="https://mintcdn.com/onesignal/0qspEXXeJ8zJbkJ-/images/docs/8b10e10-default_code.png?fit=max&auto=format&n=0qspEXXeJ8zJbkJ-&q=85&s=0c996973cd6335a81dd8854c8e0e355d" width="1309" height="562" data-path="images/docs/8b10e10-default_code.png" />
</Frame>

Para agregarlo manualmente (por ejemplo, mediante API con `email_body`):

```html HTML theme={null}
<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

<Frame caption="Enlace de cancelar suscripción en editor de Arrastrar y Soltar">
  <img src="https://mintcdn.com/onesignal/0qspEXXeJ8zJbkJ-/images/docs/7f78d2e-Screenshot_2023-01-18_at_9.59.12_AM.png?fit=max&auto=format&n=0qspEXXeJ8zJbkJ-&q=85&s=46180061304abd272dbcef4c85b3b710" width="1114" height="230" data-path="images/docs/7f78d2e-Screenshot_2023-01-18_at_9.59.12_AM.png" />
</Frame>

<Info> 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. </Info>

***

## 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:

* Sigue los pasos en [Crear una Página Personalizada de Cancelar Suscripción](./create-custom-unsubscribe-page).
* Reemplaza `[unsubscribe_url]` en tu email con la URL de tu página personalizada de cancelar suscripción.

<Warning>
  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.
</Warning>

***

## 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](/reference/create-user) o [Update subscription](/reference/update-subscription)
3. Importación CSV: Establece `subscribed = yes` al importar direcciones de email

<Warning> Si usas un proveedor de email de terceros (ESP), verifica su lista de supresión y elimina la dirección allí también. </Warning>

### ¿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](./links) para más detalles.

***

## Artículos relacionados

* [Crear una Página Personalizada de Cancelar Suscripción](./create-custom-unsubscribe-page)
* [Mensajería de Email](./email-messaging)
* [API de Email](/reference/email)
* [URLs, Enlaces y Deep Links](./links)

***