Cómo funcionan las notificaciones push: APNs y FCM explicados

Una notificación push desde fuera parece sencilla: algo ocurre en un servidor y, un segundo después, un teléfono se ilumina. Por medio hay dos redes de entrega, una de Apple y otra de Google, y ninguna notificación llega a un teléfono sin pasar por una de ellas.
- APNs, el servicio de notificaciones push de Apple, entrega cada push a iPhone, iPad, Mac y Apple Watch.
- FCM, Firebase Cloud Messaging, entrega a dispositivos Android con los servicios de Google Play, y también puede enviar a iOS pasando los mensajes a APNs.
Esta guía sigue una notificación desde tu servidor hasta la pantalla de bloqueo en ambas plataformas, con los detalles que solo aparecen cuando lo pones en producción. Nosotros ejecutamos los dos flujos detrás de Pocket Alert, así que los ejemplos salen de lo que realmente desplegamos.
Las cuatro partes
- Tu servidor, que Apple llama proveedor. Decide que hay que enviar algo.
- El servicio push, APNs o FCM. Acepta la petición y la enruta.
- El dispositivo. El sistema operativo mantiene una conexión cifrada y de larga duración con Apple o Google, y recibe por ella los push de todas las apps.
- La app. Se registró para notificaciones y es dueña del token al que va dirigido el push.
El tercer punto explica por qué push gasta poca batería. El teléfono nunca consulta a tu servidor. Una única conexión, compartida por todas las apps, permanece abierta, y el servicio push envía por ella cuando hay algo que entregar.
Paso 1: el dispositivo obtiene un token
Cuando una app se registra para notificaciones remotas, el sistema le entrega un token: una dirección opaca para "esta app en este dispositivo". La app envía el token a tu servidor, y tu servidor lo guarda.
- Un token de dispositivo de APNs es único para la app y el dispositivo. Apple recomienda no guardarlo en caché en la app: cambia cuando el usuario restaura desde una copia de seguridad, cambia de dispositivo o reinstala el sistema.
- Un token de registro de FCM cumple el mismo papel en Android, y FCM lo renueva según su propio calendario.
Los tokens caducan constantemente. Mantener actualizados los tokens guardados es una parte importante de operar push.
Paso 2: tu servidor demuestra quién es
APNs
APNs usa HTTP/2 sobre TLS 1.2 o superior, en api.push.apple.com para producción y api.sandbox.push.apple.com para compilaciones de desarrollo, en el puerto 443 o 2197. Hay dos formas de autenticarse:
- Basada en token. Creas una clave de firma
.p8en tu cuenta de desarrollador de Apple y firmas un JWT corto con ES256, que incluye tu Team ID y el ID de la clave. Apple quiere que ese JWT se renueve como máximo cada 20 minutos y como mínimo cada 60. Si envías uno caducado, recibes403 ExpiredProviderToken; si lo renuevas con demasiada frecuencia, recibes429 TooManyProviderTokenUpdates. - Basada en certificado. Un certificado de cliente TLS por app, válido un año, que luego hay que renovar.
La autenticación por token es la que conviene usar. Una sola clave sirve para todas tus apps y no caduca cada año.
FCM
La API HTTP v1 de FCM acepta un token de acceso OAuth 2.0 de corta duración, obtenido de una cuenta de servicio de Google, con el ámbito firebase.messaging. La API "legacy" anterior, con una clave de servidor estática, quedó obsoleta en 2023 y se desactivó a partir de julio de 2024, así que el código que todavía envía Authorization: key=... ya no funciona.
Paso 3: la petición
Envío a APNs
Cada push es una petición POST HTTP/2 a /3/device/<device token>, con unas cuantas cabeceras que cambian cómo se gestiona:
curl --http2 \
-H "authorization: bearer $APNS_JWT" \
-H "apns-topic: com.example.alerts" \
-H "apns-push-type: alert" \
-H "apns-priority: 10" \
-d '{"aps": {"alert": {"title": "Backup failed", "body": "db-01: pg_dump exited with code 1"}, "sound": "default", "interruption-level": "time-sensitive"}}' \
"https://api.push.apple.com/3/device/$DEVICE_TOKEN"
apns-topices el bundle ID de tu app.apns-push-typeindica qué tipo de push es:alertpara una notificación visible,backgroundpara un push de datos silencioso, y algunos otros.apns-priorityes10para entregar de inmediato,5para que el estado de energía del dispositivo decida, o1para priorizar el ahorro de energía y no despertar el dispositivo.apns-expirationdefine durante cuánto tiempo APNs debe seguir intentándolo.0significa un solo intento y ningún almacenamiento.apns-collapse-idpermite que una notificación nueva reemplace a una anterior con el mismo id.
El payload es JSON con un diccionario aps, y tiene un límite de 4 KB (5 KB para VoIP).
Envío a FCM
FCM acepta un mensaje JSON por petición:
curl -X POST "https://fcm.googleapis.com/v1/projects/$PROJECT_ID/messages:send" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
-d '{
"message": {
"token": "DEVICE_REGISTRATION_TOKEN",
"notification": { "title": "Backup failed", "body": "db-01: pg_dump exited with code 1" },
"android": { "priority": "high", "notification": { "channel_id": "alerts_high" } }
}
}'
Un mensaje notification lo muestra el sistema cuando la app está en segundo plano. Un mensaje data se entrega a la app para que lo procese. En ambos casos, el límite del payload es de 4.096 bytes.
Paso 4: la entrega, o la espera hasta que se produce
Si el teléfono tiene conexión, el push baja por la conexión abierta y aparece en cuestión de instantes. Si no la tiene:
- APNs guarda la notificación hasta 30 días, según
apns-expiration, pero conserva solo una notificación por app y por dispositivo. Si envías cinco mientras el teléfono está en modo avión, lo normal es que solo vea la última. Apple ni siquiera garantiza que sea la más reciente. - FCM conserva los mensajes durante su tiempo de vida, cuatro semanas por defecto y 28 días como máximo. Los mensajes colapsables se reemplazan entre sí, con hasta cuatro claves de colapso por dispositivo.
La prioridad también afecta al momento de la entrega. En iOS, los push con prioridad 5 y 1 pueden agruparse, limitarse o descartarse. En Android, los mensajes de prioridad normal pueden esperar hasta que el dispositivo salga de Doze, mientras que los de prioridad high se entregan de inmediato. FCM también vigila cómo usas ese privilegio: los mensajes de prioridad alta que no derivan en una notificación visible pueden rebajarse en silencio a normal con el tiempo.
Cuánto suena: niveles de interrupción y canales
Entregar una notificación es una cosa. Que el teléfono haga ruido es otra, y las dos plataformas lo gestionan de forma distinta.
iOS (15 y posteriores) asigna a cada notificación un nivel de interrupción:
passivela añade a la lista sin encender la pantalla ni reproducir sonido.activees el valor por defecto.time-sensitivepuede saltarse la Concentración y el resumen de notificaciones. Los usuarios pueden desactivarlo por app.criticalsiempre suena, incluso en No molestar y con el interruptor de silencio activado. Requiere un derecho (entitlement) que Apple concede a petición, tras revisión.
Android (8 y posteriores) pone cada notificación en un canal, y el canal decide la importancia: sonido, vibración, notificación emergente, comportamiento con No molestar. La app crea los canales, pero una vez que existe un canal, su comportamiento pertenece al usuario. La app no puede cambiarlo después.
Esa última regla tiene consecuencias reales. Cuando hicimos que las alertas críticas de Pocket Alert sonaran con el modo silencio activado, el canal crítico existente no se pudo cambiar después a audio de alarma. La solución fue un segundo canal con un id nuevo, y el servidor solo lo elige para las versiones de la app que lo crean, porque enviar a un canal que la app nunca creó significa que la notificación no se muestra en absoluto.
En Android 13 y posteriores hay una barrera más: la app necesita el permiso en tiempo de ejecución POST_NOTIFICATIONS, y en una instalación nueva las notificaciones permanecen desactivadas hasta que el usuario lo concede.
Lo que falla en producción
- Tokens caducados. APNs responde
410 Unregisteredpara un token que ya no es válido. Deja de enviarle y bórralo. - Entorno equivocado. El token de una compilación de desarrollo enviado al host de producción falla con
400 BadDeviceToken. - Payloads demasiado grandes.
413 PayloadTooLargeal superar 4 KB. Las líneas de log largas en el cuerpo de una alerta son la causa habitual. - Prioridad rebajada. Los mensajes Android de prioridad alta que nunca muestran nada pierden su prioridad.
- Notificaciones desactivadas. El push se entrega y el usuario nunca lo ve, porque rechazó el permiso o silenció el canal.
El atajo
Todo esto merece la pena construirlo cuando la app es tu producto y envías a sus usuarios. Para alertas para ti o tu equipo, es mucha infraestructura: una cuenta de desarrollador en cada plataforma, claves de firma, almacenamiento de tokens, dos formatos de petición y dos modelos de prioridad.
Un servicio de notificaciones push ejecuta los dos flujos por ti. Con Pocket Alert envías una sola petición, sin tokens ni certificados propios:
curl -X POST https://api.pocketalert.app/v1/messages \
-H "Token: $PA_KEY" \
-H 'Content-Type: application/json' \
-d '{"title": "Backup failed", "message": "db-01: pg_dump exited with code 1", "level": "high"}'
El campo level se traduce para cada plataforma:
silentes una notificación pasiva sin sonido en iPhone, y va a un canal silencioso en Android.lowes pasiva en iPhone y de importancia baja en Android.defaultes una notificación normal en ambas.highes sensible al tiempo en iPhone y de prioridad alta en Android.criticalsalta No molestar en Android. En iPhone llega como sensible al tiempo, y el sonido completo de alerta crítica se está implantando a medida que Apple concede el derecho.
Más sobre esto en alertas críticas, y sobre la API en sí en qué es una API de notificaciones push.
Preguntas frecuentes
¿APNs garantiza la entrega?
No. APNs y FCM son ambos de mejor esfuerzo. APNs solo guarda la última notificación para un dispositivo sin conexión, y ninguno de los dos servicios garantiza cuándo llega un mensaje. La documentación de Google va más allá y dice que FCM no debe usarse para alertas de emergencia que afecten a la vida. Para avisos de guardia, trata push como el canal más rápido, no como el único.
¿Por qué necesito tanto APNs como FCM?
Los iPhone solo aceptan push a través de APNs. Los dispositivos Android con los servicios de Google Play los reciben a través de FCM. Si tus usuarios están en ambas plataformas, tu servidor se comunica con las dos, directamente o a través de FCM, que puede reenviar a APNs por ti.
¿Puede FCM enviar notificaciones a un iPhone?
Sí. Subes tu clave de autenticación de APNs a Firebase, y FCM entrega a iOS pasando el mensaje a APNs. Los mensajes de datos a dispositivos Apple deben enviarse con prioridad normal.
¿Qué tamaño puede tener una notificación push?
4 KB para un payload de APNs (5 KB para push VoIP), y 4.096 bytes para un mensaje de FCM. El texto largo debe ir en tu app o en un enlace, no en el push.
¿Qué es un token de dispositivo?
Una dirección para una app en un dispositivo, emitida por Apple o Google. Tu servidor envía pushes a esa dirección. Puede cambiar en cualquier momento, así que los servidores deben aceptar los tokens actualizados y descartar los que APNs o FCM marquen como no válidos.
Crea una cuenta gratuita de Pocket Alert para no tener que gestionar claves ni tokens, o mira cómo se comparan otros servicios en las alternativas.