Qué es PushHub
Conceptos básicos para entender cómo PushHub envía notificaciones push a Android e iOS.
PushHub es un servicio de notificaciones push para apps Android e iOS. Tu app registra cada dispositivo y tu sistema (o tu equipo, desde el panel) envía notificaciones. PushHub se encarga de entregarlas a Firebase Cloud Messaging (FCM) y a Apple (APNs), con reintentos, programación, segmentación, multimedia y analítica.
PushHub funciona con cualquier framework: Android, iOS, Ionic/Capacitor, Cordova, Flutter, React Native, Expo, .NET MAUI, Unity o cualquier app que obtenga un token de FCM o de APNs.
Cómo funciona
- Tu app pide permiso al usuario y obtiene el token push del dispositivo, con la librería habitual de tu framework (Firebase o la de Apple).
- Tu app registra el dispositivo en PushHub con su llave pública (
pk_):POST /v1/devices. - Tu backend envía con su llave secreta (
sk_),POST /v1/notifications, o tu equipo lo hace desde el Panel del Cliente. - PushHub entrega a FCM y APNs con las credenciales que subiste, y reporta el resultado (enviada, aceptada, fallida, token inválido).
- Tu app reporta recepción, apertura y clics (
POST /v1/events), y ves la analítica en el panel.
Conceptos
| Concepto | Qué es |
|---|---|
| Empresa | Tu cuenta de trabajo. Tiene plan, equipo, facturación y una o varias apps. |
| App | Una aplicación móvil (puede tener Android e iOS). Cada app tiene sus credenciales, dispositivos, topics y plantillas. |
| Credencial | Lo que autoriza a PushHub a enviar a tu app: la cuenta de servicio de Firebase (Android, y también iOS vía FCM) o la llave .p8 / el certificado .p12 de Apple. Se guardan cifradas y nunca se muestran. |
| Dispositivo | Un teléfono con tu app instalada, identificado por su token. Puedes asociarlo a tu usuario (externalUserId), etiquetarlo (tags) y suscribirlo a topics. |
| Topic | Un tema al que se suscriben dispositivos, por ejemplo ofertas, y que recibe envíos a todos sus suscriptores. |
| Segmento | Un filtro guardado: idioma, país, plataforma, versión, tags, última actividad, etc. |
| Plantilla | Un contenido reutilizable con variables {{nombre}}. |
| Notificación | Un envío a un destino: dispositivos, usuarios, topic, segmento o todos. Puede ser inmediato, programado o en la hora local de cada dispositivo. |
| Campaña | Un envío recurrente (diario, semanal, mensual). |
| Llaves | pk_ (pública: va dentro de la app y solo registra dispositivos y eventos) y sk_ (secreta: solo en tu servidor; envía y consulta). Cada una en modo test o live. |
| Entorno iOS | sandbox (apps instaladas desde Xcode) o production (TestFlight y App Store). PushHub lo detecta y corrige solo. |
Qué sigue
- Primeros pasos: cuenta, app, credenciales y tu primera notificación en 15 minutos.
- Autenticación y llaves: cómo llamar a la API.
- Guías por framework: qué colocar en tu app.