Canales y segmentación

Canales

Canal	Handler	Semántica de OneSignal
`push`	`handleNotificationPush`	`POST /notifications` con `contents`/`headings` + `target_channel: push`.
`in_app`	`handleNotificationInApp`	Push solo de datos (`content_available`, sin `contents`).
`sms`	`handleNotificationSms`	`POST /notifications` con `target_channel: sms` + teléfono E.164.
`live_activity`	`handleNotificationLiveActivity`	Live Activity `start` / `update` según `data.action`.

Categorías y supresión

Categoría	¿Opt-out?
`marketing`	Sí (suprimible)
`transactional`	No
`payment`	No
`system`	No

NON_SUPPRESSIBLE_CATEGORIES = ["payment", "system", "transactional"]. Los usuarios nunca pueden silenciar estas categorías; el gating solo aplica a las suprimibles (actualmente marketing).

Segmentación

Push / in-app / live activity

Segmentado por include_aliases.external_id = [auth.users.id]. El SDK móvil lo establece en el login.

SMS

Segmentado por include_phone_numbers con el teléfono E.164 resuelto desde user_metadata.phone / user_phone.

horizon-api no tiene tokens de dispositivo. El SDK móvil debe llamar a OneSignal.login(auth.users.id) para que OneSignal pueda resolver el external_id al que apunta el backend.

Clasificación de resultados

Situación	Resultado
OneSignal 2xx con `id`	Procesado (`context.oneSignalId`).
200 con `errors` como “no subscribed users”	Skip registrado (entrega no-op).
Teléfono ausente/inválido (SMS)	`NonRetryableNotificationError` → skip.
Error 5xx / de red	Error → reintento con backoff → DLQ.

Arquitectura Preferencias e inbox

Primeros pasos

Documentación de la API

OAuth e Identidad (IdP)

Monitoreo e Infraestructura

Realtime (Pusher)

Notificaciones (OneSignal)

Canales

Categorías y supresión

Segmentación

Push / in-app / live activity

SMS

Clasificación de resultados

​Canales

​Categorías y supresión

​Segmentación

Push / in-app / live activity

SMS

​Clasificación de resultados

Canales

Categorías y supresión

Segmentación

Clasificación de resultados