--- title: "Notifiche push per la vostra app: una sola API, una sola piattaforma" description: "Inviate notifiche push agli utenti della vostra app con un'unica API REST, per ID utente, token, topic o segmento, con SMS o WhatsApp di riserva." canonical: "https://omnichannels.ai/it/channels/push-notifications/" language: "it" updated: "2026-11-04" publisher: "BroadNet Technologies" brand: "OmniChannels.ai" --- # Notifiche push per la vostra app: una sola API, una sola piattaforma Canonical: https://omnichannels.ai/it/channels/push-notifications/ Language: it Publisher: OmniChannels.ai by BroadNet Technologies 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. **Risposta breve:** 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? | 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. | | WhatsApp | 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 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. ## Fonti ufficiali - [Firebase Cloud Messaging — Firebase](https://firebase.google.com/docs/cloud-messaging) - [User Notifications — Apple Developer](https://developer.apple.com/documentation/usernotifications) Aggiornato: 2026-11-04