Notifiche push per la vostra app: una sola API, una sola piattaforma
Inviate notifiche push agli utenti della vostra app con la stessa API REST che usate per SMS, WhatsApp e RCS, poi raggiungete su un altro canale chi non ha aperto l'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 richiesta di notifica push all'API di OmniChannels.ai. I valori sono dati di esempio.
Risposta breve
Aggiornato
OmniChannels.ai è un servizio di notifiche push con API per app mobile. Chiamate POST /push/message/send indicando titolo, testo e destinatari: ID utente, token del dispositivo, topic o un segmento. Le notifiche possono contenere immagini, deep link e pulsanti di azione, usare modelli salvati, essere programmate e verificate prima con un dry run. Il nostro team collega il vostro progetto Firebase Cloud Messaging e, per iOS, le credenziali APNs durante l'attivazione (onboarding).
Cosa fa l'API per le notifiche push
Destinatari per utente, token, topic o segmento
Indirizzate i vostri ID utente (userRefs), token FCM espliciti, topic FCM o un segmento definito per paese, città, lingua e tag.
Notifiche ricche
Aggiungete un'immagine HTTPS, un deep link che si apre al tocco e pulsanti di azione come Conferma o Riprogramma.
Modelli salvati
Create, visualizzate in anteprima, inviate in prova e pubblicate modelli con cronologia delle versioni, poi inviateli con templateId e le vostre variabili.
Priorità, durata di validità e programmazione
Impostate alta priorità per i messaggi urgenti, definite una durata di validità, sostituite le notifiche precedenti con una collapse key oppure programmate l'invio.
Dry run prima dell'invio
Impostate dryRun su true per convalidare un payload da capo a fondo senza recapitare nulla a utenti reali.
Controllo dei batch
Elencate i batch, leggetene i dettagli e metteteli in pausa, riprendeteli o interrompeteli con gli endpoint dedicati.
Notifiche attivate dalla posizione
I geofence possono attivare notifiche in base alla posizione. Il nostro team abilita il geofencing per la vostra app su richiesta.
Stati di consegna via webhook
Seguite gli stati di consegna sull'URL webhook configurato sul vostro account, come per gli altri canali.
Push, SMS o WhatsApp: quale usare?
Le notifiche push raggiungono chi ha installato la vostra app. SMS e WhatsApp raggiungono un numero di telefono. La maggior parte delle aziende li usa tutti e tre, in quest'ordine di preferenza per ogni messaggio.
| Canale | Raggiunge | Ideale per | Nota |
|---|---|---|---|
| Notifica push | Utenti che hanno installato la vostra app e registrato un dispositivo | Attività nell'app: stato degli ordini, promemoria, offerte in-app, riattivazione | Usatela come primo passo quando l'utente è nella vostra app. |
| Clienti con consenso, tramite numero di telefono | Conversazioni ricche, modelli, assistenza e ricevute | Usatelo quando serve una conversazione o un contenuto multimediale. | |
| SMS | Qualsiasi numero di cellulare | Codici OTP, avvisi urgenti e clienti senza app o WhatsApp | Usatelo come fallback universale. |
Come iniziare a inviare notifiche push
Le notifiche push passano da Firebase Cloud Messaging e, per iOS, da APNs di Apple, quindi si parte con una breve fase di attivazione.
- 1
Collegate la vostra app
Il nostro team collega il vostro progetto Firebase Cloud Messaging e, per iOS, le credenziali APNs, e vi fornisce il vostro ID app.
- 2
Registrate i dispositivi sui vostri ID utente
La vostra app registra ogni dispositivo con un identificativo vostro, lo userRef, così inviate alle persone invece che ai token.
- 3
Verificate un payload con un dry run
Chiamate POST /push/message/send con dryRun su true e controllate che la richiesta sia valida prima che gli utenti reali vedano qualcosa.
- 4
Inviate o programmate
Inviate a userRefs, token, topic o a un segmento, oppure programmate l'invio. Salvate come modelli i messaggi ripetuti.
- 5
Aggiungete un fallback
Decidete quali messaggi richiedono un secondo canale, per esempio SMS per un OTP o un avviso di consegna, e impostate l'ordine per ogni caso d'uso.
Quando le notifiche push sono il canale giusto?
È la scelta giusta quando
- Avete un'app mobile e volete raggiungere gli utenti che l'hanno installata senza bisogno dei loro numeri di telefono.
- I messaggi sono legati all'attività nell'app, come stato degli ordini, promemoria di appuntamenti o avvisi sull'account.
- Volete un'unica API e un unico formato webhook per push, SMS, WhatsApp e gli altri canali.
- Volete inviare con il vostro ID utente invece di gestire i token dei dispositivi.
Da sapere prima di iniziare
- Le notifiche push raggiungono solo chi ha installato la vostra app e ha consentito le notifiche.
- L'API documentata copre le push per app mobile tramite FCM e APNs. Chiedete al nostro team qualsiasi altra esigenza prima di pianificarla.
- Non affidatevi alle sole push per codici OTP o avvisi critici: aggiungete SMS o voce come fallback.
- Il geofencing viene abilitato su richiesta per la vostra app.
Domande sul servizio di notifiche push
Che cos'è un servizio di notifiche push?
Un servizio di notifiche push recapita brevi messaggi dai vostri server ai dispositivi degli utenti, anche quando l'app è chiusa. Su Android la consegna passa da Firebase Cloud Messaging, su iOS da APNs di Apple. Un servizio come OmniChannels.ai si colloca davanti a entrambi e vi offre un'unica API da chiamare.
Come funziona un'API per notifiche push?
La vostra app registra ogni dispositivo con un token. Il vostro backend chiama poi l'API indicando destinatari e contenuto, e il servizio affida la notifica a FCM o APNs per la consegna. Con OmniChannels.ai chiamate POST /push/message/send e potete indirizzare gli utenti con i vostri ID utente.
Qual è la differenza tra notifiche push e SMS?
Le notifiche push raggiungono chi ha installato la vostra app e consentito le notifiche, e richiedono una connessione dati. Gli SMS raggiungono qualsiasi numero di cellulare senza app. Le push sono adatte ad aggiornamenti in-app e coinvolgimento; gli SMS a codici OTP, avvisi urgenti e clienti senza la vostra app.
Posso inviare una notifica push a un segmento di utenti?
Sì. Oltre a ID utente, token dei dispositivi e topic, l'API accetta un oggetto segmento con criteri come paese, città, lingua e tag, insieme al vostro ID app. Potete anche programmare l'invio e associarvi il nome di una campagna.
Posso testare una notifica push prima di inviarla?
Sì. Impostate dryRun su true per convalidare la richiesta senza recapitare nulla. Per i modelli potete vedere un'anteprima con dati di esempio e inviare una prova al vostro dispositivo prima di pubblicare una versione.
Posso aggiungere immagini, link e pulsanti?
Sì. Le notifiche possono includere un'immagine HTTPS, un deep link che si apre al tocco, dati personalizzati per la vostra app e pulsanti di azione, ciascuno con ID, titolo e azione. Potete inviare anche messaggi solo dati e messaggi silenziosi.
E se l'utente non ha aperto l'app o ha disattivato le notifiche?
La push non può raggiungerlo. Per i messaggi importanti configurate un fallback su un altro canale, come SMS o WhatsApp. L'ordine di fallback si imposta per ogni caso d'uso e gli stati di consegna arrivano in un unico formato webhook.
Come si comincia?
Richiedete una demo. Il nostro team collega il vostro progetto Firebase e le credenziali APNs durante l'attivazione, vi fornisce il vostro ID app e poi potete chiamare l'API con il vostro token. La documentazione per sviluppatori elenca ogni endpoint push.
Guide su questo argomento
- OmnicanaleStrategia di fallback tra canali: WhatsApp, RCS e SMS12 min di lettura
- SMS e OTPWhatsApp, SMS o RCS: quale canale per OTP e marketing?8 min di lettura
- IntegrazioneIntegrare una API di messaggistica: REST, SMPP e webhook9 min di lettura
- ConformitàConsenso (opt-in) per campagne WhatsApp, SMS ed email8 min di lettura
- OmnicanaleCos'è la messaggistica omnicanale? Architettura e vantaggi10 min di lettura
Scoprite altre funzioni della piattaforma
Aggiungete le push al vostro stack di messaggistica
Parlateci della vostra app. Colleghiamo FCM e APNs e vi mostriamo le push accanto a SMS e WhatsApp.
Descriveteci i vostri sistemi e cosa volete collegare. Un solution engineer vi ricontatterà.