Suscripciones

​

Descripción general

Una Suscripción representa un canal específico a través del cual un usuario puede recibir mensajes—como una dirección de email, número de teléfono o dispositivo. OneSignal soporta cuatro tipos de Suscripciones: Cada usuario puede tener múltiples Suscripciones. Usa el External ID para identificar al usuario a través de todas las Suscripciones. En la imagen de arriba, “userA” tiene 5 Suscripciones:

1. Mobile (iOS) creada después de instalar la app iOS. Llama a OneSignal.login para establecer el External ID y vincular la Suscripción al usuario.
2. SMS creada después del número de teléfono proporcionado dentro de la app iOS. Ver Suscripciones SMS abajo para detalles.
3. Web Push creada después de suscribirse a push en el sitio web. Puede recibir notificaciones push.
4. Email creada después de que se proporcionó la dirección de email. Para enviar mensajes de email.
5. Mobile (Android) creada después de instalar la app Android. Puede recibir notificaciones push, mensajes in-app y live activities.

---

​

Propiedades de Suscripción

Cada Suscripción tiene las siguientes propiedades:

​

Estados de suscripción

Generalmente, las Suscripciones pueden recibir mensajes (Subscribed) o no pueden recibir mensajes (Unsubscribed). Los detalles varían según el canal:

---

​

notification_types

Indica la capacidad de la Suscripción para recibir mensajes, incluyendo razones de fallos. Actualizado automáticamente vía nuestros SDKs frontend o manualmente vía API. Visible vía View User API o Export CSV.

Definiciones de Notification Types.

1 o número positivo = Subscribed.

• La Suscripción puede recibir mensajes en este canal.
• Puede usarse con la propiedad enabled si estás habilitando mensajes en nombre del usuario. Para Suscripciones push, aún debe establecerse un token válido para recibir notificaciones push. Ver nuestros docs de configuración SDK para detalles.

0, -99 = Never Subscribed.

• La Suscripción aún no se ha suscrito al canal.

-2 = Unsubscribed.

• La Suscripción no puede recibir mensajes en este canal.
• Puede usarse con la propiedad enabled establecida en false si estás desactivando mensajes en nombre del usuario. Valor recomendado al desactivar permisos de mensajes.
• Establecido automáticamente cuando el usuario cancela su suscripción.

-3, -5 = Android Support Library Error.Agrega o actualiza la Android Support Library de tu app.-4, -8, -11, -12 = Android Google Play Services Library Error.

• Verifica el logcat. Ver Obtener un Debug Log.
• Actualiza tu Google Play Services Library en tu app y verifica el logcat de la app para errores de Google Play Services. Ver Obtener un Debug Log.

-6 = Android Invalid Google Project Number.

• El FCMv1 Sender ID no coincide con el original al que pertenece este token. Verifica el logcat de la app. Ver Obtener un Debug Log.

-7, -9 = Android Outdated Google Play Services App

• Actualiza o habilita la app Google Play Services en el dispositivo.

-10 = Not Subscribed.

• La Suscripción Push desinstaló la app o canceló la suscripción en las configuraciones del dispositivo.
• Web push bloqueó notificaciones, limpió todos los datos y workers.

-13 = iOS missing_push_capability.

• Revisa los docs de configuración SDK para asegurarte de que todos los pasos estén implementados. Ver Configuración de canal.

-14, -16, -17 = iOS APNS Errors.

• El dispositivo tiene un problema conectándose a APNS. Consulta la guía Solución de problemas iOS y Obtener un Debug Log.

-15 = iOS Simulator Error.

• iOS Simulator requiere iOS 16.4+ Usa un simulador o dispositivo diferente.

-18 = Never Prompted.

• La Suscripción nunca fue solicitada para suscribirse. Esto solo rastrea el prompt de permiso requerido y no incluye mensajes in-app.

-19 = Prompted But Never Answered.

• La Suscripción fue solicitada pero no proporcionó una respuesta.

-20, -21 = temp_web_record. Web, permiso pushSubscriptionchange revocado-22 = Manually Unsubscribed via dashboard.

• El permiso fue revocado.

-23, -24 = Web Service Worker Error.

• Ver Solución de problemas Web SDK.

-31 = Disabled via REST API.-98 = SMS Subscription awaiting double opt-in.

---

​

Suscripciones Mobile

Las Suscripciones Mobile representan dispositivos iOS, Android, Huawei o Amazon y soportan:

• Notificaciones push
• Mensajes in-app
• Live Activities

Se crean automáticamente cuando un usuario instala y abre tu app con el OneSignal SDK.

​

Actualizar Suscripciones móviles

Se recomienda actualizar las propiedades de Suscripción Mobile vía el OneSignal mobile SDK.

• Solicitar permisos push y observar cambios de permiso/Suscripción
• Login usuarios para establecer External ID y Aliases
• Agregar Tags
• Establecer Language

Puedes actualizar tags, idioma y algunas otras propiedades vía la función CSV Import. Las Suscripciones Mobile también pueden crearse y actualizarse vía las APIs Users y Subscriptions, pero se recomienda el SDK móvil para la mayoría de casos de uso.

​

Manejo de desinstalaciones, cancelaciones de suscripción y tokens push inválidos

Las Suscripciones Mobile dejan de recibir notificaciones push si el usuario:

• Desinstala la app
• Deshabilita push en las configuraciones del dispositivo y nunca reabre la app
• El token push expira

En estos casos, el estado de Suscripción se establecerá como Unsubscribed al enviar notificaciones push. Ver abajo ¿Cuándo se actualizan los estados de suscripción push? para más detalles.

• Si el usuario reinstala la app en el mismo dispositivo o nuevo dispositivo, se creará una nueva Suscripción y necesitarán resuscribirse para recibir mensajes.
• Si el usuario rehabilita push en las configuraciones del dispositivo, el estado de Suscripción se establecerá como Subscribed y un token push se actualizará cuando abran la app.
• Si el token push expira, el estado de Suscripción y nuevo token push se actualizarán cuando el usuario abra la app en el mismo dispositivo.

Rastrea cambios vía:

• Event Streams - detecta cancelaciones de suscripción al enviar push
• Reportes push - detecta cancelaciones de suscripción al enviar push
• Usa el Subscription change listener del SDK - detecta cancelaciones de suscripción cuando el usuario deshabilita push en configuraciones del dispositivo y luego abre la app

---

​

Suscripciones Web push

Las Suscripciones Web push están vinculadas a un dispositivo específico, navegador y perfil de navegador. Un usuario que se suscribe en Chrome escritorio no recibirá push en Chrome móvil a menos que también se suscriba a tu sitio web desde ese dispositivo móvil—creando una Suscripción web push separada. Las nuevas Suscripciones web push se crean en estos escenarios:

• El usuario se suscribe a tu sitio web haciendo clic en “Permitir” en el prompt de permiso nativo a nivel de sistema del navegador. Esto genera un token push único y Subscription ID.
• El usuario limpia datos del navegador (historial, caché, cookies, almacenamiento local) y revisita tu sitio. Esto resulta en la creación de un nuevo Subscription ID único.

​

Actualizar Suscripciones web push

Se recomienda actualizar las propiedades de Suscripción Web push vía el OneSignal web SDK.

• Solicitar permisos push y observar cambios de permiso/Suscripción
• Login usuarios para establecer External ID y Aliases
• Agregar Tags
• Establecer Language

Puedes actualizar tags, idioma y algunas otras propiedades vía la función CSV Import. Las Suscripciones Web push no pueden crearse vía REST API pero pueden actualizarse con las APIs Users y Subscriptions, pero se recomienda el web SDK para la mayoría de casos de uso.

​

Manejo de cancelaciones de suscripción y tokens push inválidos

Las Suscripciones Web push dejan de recibir notificaciones push si el usuario:

• Limpia datos del navegador (historial, caché, cookies, almacenamiento local)
• Deshabilita push en las configuraciones del sistema del navegador
• El token push expira

En estos casos, el estado de Suscripción se establecerá como Unsubscribed al enviar notificaciones push. Ver abajo ¿Cuándo se actualizan los estados de suscripción push? para más detalles.

• Si el usuario regresa al sitio después de limpiar datos del navegador, se creará una nueva Suscripción y se resuscribirán automáticamente para recibir mensajes si tienes auto-resubscribe habilitado.
• Si el usuario rehabilita push en las configuraciones del navegador, el estado de Suscripción se establecerá como Subscribed cuando regresen al sitio.
• Si el token push expira, el estado de Suscripción y nuevo token push se actualizarán cuando el usuario regrese al sitio.

Rastrea cambios vía:

• Event Streams - detecta cancelaciones de suscripción al enviar push
• Reportes push - detecta cancelaciones de suscripción al enviar push
• Usa el Subscription change listener del SDK - detecta cancelaciones de suscripción cuando el usuario deshabilita push y regresa al sitio

---

​

Suscripciones Email

Las Suscripciones Email están basadas en la dirección de email y se usan únicamente para la entrega de emails. Esto es diferente de establecer un Tag. Crea Suscripciones Email vía:

1. Método SDK addEmail o prompt de email - usa estos métodos después de llamar a OneSignal.login para establecer el External ID y vincular la Suscripción al usuario.
2. API Create user o API Create email
3. Importador CSV del dashboard o agrega manualmente direcciones de email

​

Gestionar Suscripciones Email

Vincular a un usuario Asegúrate de establecer el external_id al crear Suscripciones Email para vincularlas a un User.

• Usando el SDK, llama al método login antes de llamar a addEmail para establecer el external_id y vincular la Suscripción de email al usuario.
• Usando el Importador CSV o la API REST, establece el identificador external_id con el email.

Estados de suscripción Las Suscripciones Email recién creadas se establecerán automáticamente como Subscribed a menos que se especifique lo contrario. Las Suscripciones Email pueden pasar a unsubscribed cuando:

• Al enviar emails, el usuario se da de baja vía el enlace de baja
• Estableciendo enabled en false vía la API
• Usando el dashboard para dar de baja la Suscripción vía el botón de opciones Las Suscripciones Email pueden volver a estar suscritas vía:
• Estableciendo enabled en true vía la API
• Usando el dashboard para suscribir la Suscripción vía el botón de opciones

Si un usuario se da de baja de emails, puedes mantenerlo como unsubscribed pero enviarle emails importantes enviando a emails dados de baja.

---

​

Suscripciones SMS

Las Suscripciones SMS están vinculadas a números de teléfono en formato E.164 (por ejemplo, +14155551234). Crea Suscripciones SMS vía:

1. Método SDK addSms o prompt SMS — llama primero a OneSignal.login para establecer el External ID y vincular la Suscripción al usuario.
2. API Create user o API Create SMS
3. Importador CSV del dashboard

​

Gestionar Suscripciones SMS

Vincular a un usuario Establece el external_id al crear Suscripciones SMS para vincularlas a un User.

• Usando el SDK, llama al método login antes de llamar a addSms para establecer el external_id y vincular la Suscripción SMS al usuario.
• Usando el Importador CSV o la API REST, establece el identificador external_id con el número de teléfono.

Estados de suscripción Las Suscripciones SMS recién creadas se establecen automáticamente como Subscribed a menos que se especifique lo contrario. Las Suscripciones SMS pueden pasar a unsubscribed cuando:

• El usuario responde con “STOP” u otra palabra clave de baja
• Estableces enabled en false vía la API
• Das de baja la Suscripción en el dashboard vía el botón de opciones

Las Suscripciones SMS pueden volver a estar suscritas cuando:

• El usuario responde con “START” u otra palabra clave de alta
• Estableces enabled en true vía la API
• Resuscribes la Suscripción en el dashboard vía el botón de opciones

---

​

Importar o migrar Suscripciones

Importa tokens push, direcciones de email y números de teléfono de otro proveedor usando:

• API Create user
• API Create Subscription

---

​

Eliminar Suscripciones

Las Suscripciones pueden eliminarse por:

• Privacidad de datos
• Limpieza de registros inactivos

---

​

FAQ

​

¿Cuándo se actualizan los estados de suscripción push?

Los estados de suscripción push se actualizan mediante dos mecanismos: 1. Cuando el usuario abre tu app o sitio El SDK de OneSignal verifica si el token push es válido y si los permisos de notificación siguen otorgados, luego actualiza el estado de la suscripción inmediatamente. Por ejemplo, si un usuario deshabilita las notificaciones push en la configuración de su dispositivo y luego reabre tu app, el SDK detecta el cambio y marca la suscripción como Unsubscribed de inmediato. Puedes capturar estos cambios con el Subscription Observer del SDK (móvil | web) para sincronizar el estado con tu propia base de datos. 2. Cuando envías notificaciones push Si un usuario desinstala tu app, limpia datos del navegador, o deshabilita push y nunca regresa, OneSignal no puede detectar el cambio hasta que envíes una notificación. El servicio push (FCM, APNs, HMS) reporta el token como inválido y OneSignal marca la suscripción como Unsubscribed. Esta detección típicamente requiere 2 o más mensajes porque el servicio push no rechaza inmediatamente un token inválido: Usa Event Streams para detectar cancelaciones de suscripción en tiempo real al enviar mensajes.

​

Si un usuario desactiva las notificaciones en la configuración de su dispositivo y nunca vuelve a abrir la app, ¿qué sucede?

La suscripción permanece marcada como Subscribed en OneSignal hasta que envíes una notificación a ese dispositivo. Después de 2 o más intentos de envío, el servicio push reporta el token como inválido y OneSignal marca la suscripción como Unsubscribed. Ver ¿Cuándo se actualizan los estados de suscripción push? arriba para la secuencia completa.

---

​

Páginas relacionadas