Volver al blog

¿Qué es una API de notificaciones push y cuándo la necesitas?

¿Qué es una API de notificaciones push y cuándo la necesitas?

Una API de notificaciones push es un servicio web que muestra un mensaje en la pantalla de bloqueo del teléfono cuando tu código lo pide. Envías una petición HTTP con un título y un cuerpo, el servicio la entrega a Apple o Google, y el teléfono la muestra en segundos, tengas o no una app abierta.

Esa es la idea completa. Los detalles están en quién recibe la notificación y en cuánto de la cadena de envío quieres controlar tú.

Dos cosas distintas comparten el nombre

Si buscas "push notification API" encontrarás dos tipos de producto que apenas se solapan.

Plataformas que envían notificaciones a tus usuarios. Firebase Cloud Messaging, Apple Push Notification service, OneSignal y similares. Creas una app móvil, la publicas en App Store y Google Play, recoges un token de dispositivo de cada instalación y envías notificaciones de producto o de marketing a miles de personas. La API es el último paso de un proyecto largo.

Servicios que te envían notificaciones a ti. Pocket Alert, Pushover, ntfy y otros. La app ya existe: la instalas en tu propio teléfono, obtienes una clave de API y envías alertas desde scripts, servidores y otros servicios. No hay nada que publicar ni tokens que recoger. Un despliegue terminó, una copia de seguridad falló, llegó un pago.

Esta guía trata del segundo tipo. Si estás creando una app de consumo y necesitas llegar a sus usuarios, te interesa el primer tipo, y gran parte de lo que sigue no te aplicará.

Qué pasa cuando envías una

Cuatro saltos, la mayoría invisibles:

  1. Tu código envía una petición HTTPS al servicio con un título, un mensaje y tu clave de API.
  2. El servicio comprueba la clave, guarda el mensaje y decide adónde va: a cuáles de tus dispositivos y con qué prioridad.
  3. Entrega la notificación a la red push de la propia plataforma: APNs para iPhone y Firebase Cloud Messaging para Android.
  4. Apple o Google la entregan por la conexión que cada teléfono ya mantiene abierta con ellos, y el teléfono la muestra.

Los saltos 3 y 4 explican por qué push funciona con la app cerrada y sin agotar la batería: el teléfono nunca consulta a nadie. El recorrido completo está en Cómo funcionan las notificaciones push: APNs y FCM.

¿Por qué no hablar directamente con Apple y Google?

Puedes hacerlo, si tienes una app propia en ambas tiendas. Para enviar notificaciones a tu propio teléfono sin intermediarios necesitarías:

  • Una membresía del Apple Developer Program y una app de iOS creada con el permiso de push, además de un proyecto de Firebase y una app de Android para la otra mitad.
  • Una clave de firma de APNs y una cuenta de servicio de Firebase, y código que firme las peticiones para cada una.
  • Una forma de recoger los tokens de dispositivo desde la app y mantenerlos actualizados cuando cambien.
  • Dos formatos de petición, dos modelos de prioridad y dos conjuntos de códigos de error.

Es un proyecto razonable cuando la app es tu producto. Para "avísame cuando falle la tarea cron" es demasiada maquinaria. Un servicio de notificaciones push ya lo ha resuelto una vez, para todos.

Cómo es una petición

Con Pocket Alert, enviar una notificación es un único POST autenticado:

curl -X POST https://api.pocketalert.app/v1/messages \
  -H 'Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"title": "Deploy finished", "message": "api v2.4.1 is live"}'

La respuesta es 201 Created con el mensaje guardado y la prioridad con la que salió. La misma petición funciona desde cualquier lenguaje con un cliente HTTP, y Enviar notificaciones push con curl tiene más ejemplos para la terminal.

Solo title y message son obligatorios. Los campos opcionales que más importan en las alertas:

  • level define con qué intensidad llega: silent, low, default, high o critical.
  • actions añade hasta tres botones a la notificación: abrir una URL, lanzar una petición HTTP o copiar un valor.
  • send_at o delay la entrega más tarde en lugar de ahora (planes de pago).
  • application_id y device_id indican a qué proyecto pertenece y qué teléfono la recibe.

Tres formas de entrada, no solo la API

Una API de notificaciones push es más útil cuando no tienes que escribir código para cada origen.

  • La API HTTP para tus propios scripts, tareas y apps.
  • URLs de webhook para servicios que ya envían webhooks. GitHub, Stripe, Grafana o Sentry envían su propio JSON a un webhook de Pocket Alert, y marcadores como %repository.name% extraen campos de ese JSON hacia la notificación, sin código intermedio. Crea tu primera URL de webhook lo explica paso a paso.
  • La CLI y el servidor MCP para la terminal y para agentes de IA: pocketalert send "Build done" "All tests passed" desde una shell (CLI), o una herramienta create_message que Claude o Cursor llaman cuando termina una tarea larga (MCP).

Dónde usarla

La mayoría de las alertas caen en unos pocos grupos:

El hilo común es un evento que alguien debe conocer ahora, no la próxima vez que abra un panel o su bandeja de entrada.

Qué revisar antes de elegir una

Todos los servicios de este ámbito envían una notificación push a partir de una petición HTTP. Las diferencias están en todo lo que rodea a eso:

  • Plataformas. Algunas son solo para iPhone (Bark, The Notification App), y la única app oficial de Gotify es para Android. Si quien necesita la alerta lleva el otro teléfono, eso decide la cuestión.
  • Niveles de prioridad. ¿Puede una copia de seguridad fallida sonar distinto a un registro nuevo? ¿Puede una alerta crítica saltarse el modo No molestar?
  • Webhooks de entrada. ¿Puede un servicio enviar su propio JSON, o cada origen necesita un script que lo reformatee?
  • Historial y registros. Cuando una alerta no llegó, ¿hay un registro de la llamada y de lo que le pasó?
  • Límites y precios. Por día, por mes o de por vida, y qué pasa cuando alcanzas el límite.
  • Quién lo gestiona. Un servicio alojado, o un servidor que mantienes tú mismo.

Comparamos Pocket Alert con Pushover, ntfy, Pushbullet, Bark, Gotify y otros exactamente en estos puntos en Alternativas, incluyendo en qué caso cada uno es la mejor opción.

Preguntas frecuentes

¿Una API de notificaciones push es lo mismo que Firebase Cloud Messaging?

FCM es una API de notificaciones push: la que ofrece Google para las apps que creas y publicas. Servicios como Pocket Alert se apoyan en FCM y APNs y se encargan de la app, las claves y los tokens de dispositivo, así que tú solo haces la petición HTTP.

¿Necesito crear una app móvil?

No para recibir alertas tú o tu equipo. Instalas una app existente, como Pocket Alert para iPhone o Android, y envías a ella. Necesitas una app propia solo si quieres enviar notificaciones a tus propios usuarios.

¿Es gratis?

Muchos servicios tienen un plan gratuito. El de Pocket Alert permite 50 mensajes al día sin tarjeta, lo que cubre la mayoría de las alertas personales, y los planes de pago empiezan en 6 $ al mes por 1.000 al día. Detalles en la página de precios.

¿Qué tan rápida es la entrega?

Normalmente unos segundos desde la petición hasta la pantalla de bloqueo. Apple y Google no garantizan el tiempo, sin embargo: un teléfono sin señal o en un modo de ahorro de batería estricto recibe la notificación cuando vuelve a conectarse.

¿Push, SMS o correo?

Push para lo que necesita atención ahora, correo para resúmenes y registros, y SMS cuando la persona no tiene ninguna app en su smartphone. Las ventajas e inconvenientes están en Notificaciones push frente a SMS y Notificaciones push frente a alertas por correo.

Crea una cuenta gratuita, copia tu clave de API, y el comando curl de arriba será tu primera notificación.

Comparte este artículo