Notificaciones push para su app: una API, una plataforma
Envíe notificaciones push a los usuarios de su app con la misma API REST que usa para SMS, WhatsApp y RCS, y llegue por otro canal a quienes no han abierto la app.
curl -X POST https://api.broadnet.me/push/message/send \
-H "Authorization: Bearer $BROADNET_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"userRefs": ["user-10293"],
"title": "Your order has shipped",
"body": "Tap to track your parcel.",
"deepLink": "https://example.com/orders/8842",
"category": "UTILITY",
"priority": "HIGH",
"ttl": 3600
}'Una solicitud de notificación push a la API de OmniChannels.ai. Los valores son datos de ejemplo.
Respuesta breve
Actualizado
OmniChannels.ai es un servicio y una API de notificaciones push para apps móviles. Usted llama a POST /push/message/send con un título, un texto y una audiencia: ID de usuario, tokens de dispositivo, temas o un segmento. Las notificaciones pueden incluir imágenes, enlaces profundos y botones de acción, usar plantillas guardadas, programarse y validarse antes con una prueba en seco. Nuestro equipo conecta su proyecto de Firebase Cloud Messaging y, en iOS, sus credenciales de APNs durante la puesta en marcha.
Qué hace la API de notificaciones push
Segmentación por usuario, token, tema o segmento
Dirija los envíos a sus propios ID de usuario (userRefs), a tokens de dispositivo FCM concretos, a temas de FCM o a un segmento definido por país, ciudad, idioma y etiquetas.
Notificaciones enriquecidas
Añada una imagen HTTPS, un enlace profundo que se abre al tocar y botones de acción como Confirmar o Reprogramar.
Plantillas guardadas
Cree, previsualice, pruebe y publique plantillas con historial de versiones, y envíelas por templateId con sus propias variables.
Prioridad, tiempo de vida y programación
Marque como alta prioridad los mensajes urgentes, fije un tiempo de vida, reemplace notificaciones anteriores con una clave de colapso o programe el envío.
Prueba en seco antes de enviar
Active dryRun para validar una carga completa sin entregar nada a usuarios reales.
Control de lotes
Liste los lotes, consulte sus detalles y pause, reanude o cancele un lote con los endpoints de lotes.
Notificaciones por ubicación
Las geovallas pueden activar notificaciones según la ubicación. Nuestro equipo habilita las geovallas para su app a petición.
Estados de entrega por webhook
Siga los estados de entrega en la URL de webhook configurada en su cuenta, igual que en los demás canales.
Push, SMS o WhatsApp: ¿cuál conviene usar?
El push llega a quienes tienen su app instalada. El SMS y WhatsApp llegan a un número de teléfono. La mayoría de las empresas usa los tres, en este orden de preferencia para cada mensaje.
| Canal | Llega a | Ideal para | Nota |
|---|---|---|---|
| Notificación push | Usuarios que instalaron su app y registraron un dispositivo | Actividad de la app: estado de pedidos, recordatorios, ofertas dentro de la app, reactivación | Úsela como primer paso cuando el usuario está en su app. |
| Clientes con consentimiento, por número de teléfono | Conversaciones enriquecidas, plantillas, atención al cliente y comprobantes | Úselo cuando necesite una conversación o contenido multimedia. | |
| SMS | Cualquier número móvil | Códigos OTP, alertas urgentes y clientes sin la app ni WhatsApp | Úselo como respaldo universal. |
Cómo empezar a enviar notificaciones push
El push funciona sobre Firebase Cloud Messaging y, en iOS, sobre APNs de Apple, por lo que primero hay un breve paso de puesta en marcha.
- 1
Conecte su app
Nuestro equipo conecta su proyecto de Firebase Cloud Messaging y, en iOS, sus credenciales de APNs, y le entrega el ID de su app.
- 2
Registre los dispositivos con sus ID de usuario
Su app registra cada dispositivo con su propio identificador, el userRef, de modo que pueda enviar a personas en lugar de a tokens.
- 3
Compruebe una carga con una prueba en seco
Llame a POST /push/message/send con dryRun en true y confirme que la solicitud es válida antes de que algún usuario real vea nada.
- 4
Envíe o programe
Envíe a userRefs, tokens, temas o un segmento, o programe el envío. Guarde los mensajes repetidos como plantillas.
- 5
Añada un respaldo
Decida qué mensajes necesitan un segundo canal, por ejemplo SMS para un OTP o un aviso de entrega, y defina el orden para cada caso de uso.
¿Cuándo es el push el canal adecuado?
Encaja bien cuando
- Tiene una app móvil y quiere llegar a los usuarios instalados sin necesitar sus números de teléfono.
- Los mensajes están ligados a la actividad en la app, como el estado de un pedido, recordatorios de citas o alertas de la cuenta.
- Quiere una sola API y un solo formato de webhook para push, SMS, WhatsApp y los demás canales.
- Quiere enviar por su propio ID de usuario en lugar de gestionar tokens de dispositivo.
Conviene saber antes de empezar
- El push solo llega a quienes instalaron su app y permitieron las notificaciones.
- La API documentada cubre el push de apps móviles mediante FCM y APNs. Consulte a nuestro equipo cualquier otro caso antes de planificar en torno a él.
- No dependa solo del push para códigos OTP ni alertas críticas: añada SMS o voz como respaldo.
- Las geovallas se habilitan a petición para su app.
Preguntas sobre el servicio de notificaciones push
¿Qué es un servicio de notificaciones push?
Un servicio de notificaciones push entrega mensajes breves desde sus servidores a los dispositivos de los usuarios, incluso con la app cerrada. En Android la entrega pasa por Firebase Cloud Messaging y en iOS por APNs de Apple. Un servicio como OmniChannels.ai se sitúa delante de ambos y le ofrece una sola API.
¿Cómo funciona una API de notificaciones push?
Su app registra cada dispositivo con un token. Su backend llama después a la API con la audiencia y el contenido, y el servicio entrega la notificación a FCM o APNs. Con OmniChannels.ai llama a POST /push/message/send y puede dirigirse a usuarios por sus propios ID.
¿Qué diferencia hay entre las notificaciones push y el SMS?
El push llega a quienes instalaron su app y permitieron las notificaciones, y necesita conexión de datos. El SMS llega a cualquier número móvil sin app. El push se adapta a las novedades y la interacción dentro de la app. El SMS, a códigos OTP, alertas urgentes y clientes sin su app.
¿Puedo enviar una notificación push a un segmento de usuarios?
Sí. Además de ID de usuario, tokens de dispositivo y temas, la API acepta un objeto de segmento con criterios como país, ciudad, idioma y etiquetas, junto con el ID de su app. También puede programar el envío y etiquetarlo con el nombre de una campaña.
¿Puedo probar una notificación push antes de enviarla?
Sí. Active dryRun para validar la solicitud sin entregar nada. En las plantillas puede previsualizar con datos de ejemplo y enviar una prueba a su propio dispositivo antes de publicar una versión.
¿Puedo añadir imágenes, enlaces y botones?
Sí. Las notificaciones pueden incluir una imagen HTTPS, un enlace profundo que se abre al tocar, datos personalizados para su app y botones de acción, cada uno con un ID, un título y una acción. También puede enviar mensajes solo de datos y silenciosos.
¿Qué pasa si el usuario no ha abierto la app o desactivó las notificaciones?
El push no puede llegar a esa persona. Para los mensajes importantes, configure un respaldo en otro canal, como SMS o WhatsApp. El orden de respaldo se define para cada caso de uso y los estados de entrega llegan en un solo formato de webhook.
¿Cómo empiezo?
Solicite una demostración. Nuestro equipo conecta su proyecto de Firebase y sus credenciales de APNs durante la puesta en marcha, le entrega el ID de su app y después podrá llamar a la API con su token. La documentación para desarrolladores enumera todos los endpoints de push.
Guías sobre este tema
- OmnicanalEstrategia de respaldo entre canales: WhatsApp, RCS y SMS12 min de lectura
- SMS y OTPWhatsApp, SMS o RCS: ¿qué canal usar para OTP y marketing?8 min de lectura
- IntegraciónGuía de integración de API de mensajería: REST, SMPP y webhooks9 min de lectura
- CumplimientoOpt-in y consentimiento en campañas de WhatsApp, SMS y email8 min de lectura
- OmnicanalMensajería omnicanal: qué es, arquitectura y ejemplos10 min de lectura
Descubra más de la plataforma
Añada el push a su pila de mensajería
Cuéntenos sobre su app. Conectaremos FCM y APNs y le mostraremos el push junto al SMS y WhatsApp.
Cuéntenos qué tecnologías utiliza y qué desea conectar. Un ingeniero de soluciones se pondrá en contacto con usted.