Notifiche di Servizi di comunicazione
Gli SDK Servizi di comunicazione di Azure chat e chiamata creano un canale di messaggistica in tempo reale che consente il push dei messaggi di segnalazione ai client connessi in modo efficiente e affidabile. In questo modo è possibile integrare funzionalità avanzate di comunicazione in tempo reale nelle applicazioni senza la necessità di implementare una logica di polling HTTP complessa. Nelle applicazioni per dispositivi mobili però questo canale di segnalazione rimane connesso solo quando l'applicazione è attiva in primo piano. Per consentire agli utenti di ricevere chiamate in arrivo o messaggi di chat mentre l'applicazione è in background, occorre usare le notifiche push.
Le notifiche push permettono di inviare informazioni dall'applicazione ai dispositivi mobili degli utenti. È possibile usarle per visualizzare una finestra di dialogo, riprodurre un suono o visualizzare l'interfaccia utente delle chiamate in arrivo. Servizi di comunicazione di Azure supporta l'integrazione con Griglia di eventi di Azure e Hub di notifica di Azure che consentono di aggiungere notifiche push alle app.
Attivare le notifiche push tramite Griglia di eventi di Azure
L'integrazione tra Servizi di comunicazione di Azure e Griglia di eventi di Azure consente di inviare notifiche degli eventi in tempo reale in modo affidabile, scalabile e sicuro. È possibile sfruttare questa integrazione per creare un servizio di notifica che recapiti le notifiche push sui dispositivi mobili degli utenti creando una sottoscrizione di Griglia di eventi che attiva una funzione di Azure o un webhook.
Per altre informazioni, vedere Gestione degli eventi in Servizi di comunicazione di Azure.
Recapitare notifiche push con Hub di notifica di Azure
Importante
Hub di notifica di Azure ha annunciato che l'API legacy di Firebase Cloud Messaging (FCM) sarà deprecata a luglio 2024. Ciò influirà su tutte le applicazioni Di chiamata e Chat di Servizi di comunicazione di Azure che inviano notifiche push Android. I clienti interessati dovranno eseguire la migrazione delle registrazioni da FCM legacy a FCM v1 e possono iniziare a farlo a marzo 2024. Per altre informazioni, inclusi i passaggi di migrazione, vedere la documentazione relativa all'hub notifcation.
È possibile connettere un hub di notifica di Azure alla risorsa di Servizi di comunicazione per inviare automaticamente notifiche push al dispositivo mobile di un utente quando ricevono una chiamata in arrivo o per notificare l'attività di chat non riuscita. È consigliabile usare queste notifiche push per riattivare l'applicazione dallo sfondo e visualizzare l'interfaccia utente che consente all'utente di accettare o rifiutare la chiamata o leggere il messaggio di chat appena ricevuto.
Servizi di comunicazione usa Hub di notifica di Azure come servizio pass-through per comunicare con i vari servizi di notifica push specifici della piattaforma usando l'API di invio diretto. In questo modo è possibile riutilizzare le risorse e le configurazioni esistenti dell'hub di notifica di Azure per fornire notifiche affidabili e a bassa latenza alle applicazioni.
Nota
Attualmente le notifiche push di chiamate e chat sono supportate sia per Android che per iOS.
Provisioning di un hub di notifica
Per recapitare le notifiche push ai dispositivi client tramite Hub di notifica, creare un hub di notifica nella stessa sottoscrizione della risorsa di Servizi di comunicazione. È necessario configurare l'hub di notifica di Azure per il sistema PNS (Platform Notification System) che si vuole usare. Per informazioni su come ottenere notifiche push nell'app client da Hub di notifica, vedere Introduzione a Hub di notifica e selezionare la piattaforma client di destinazione dall'elenco a discesa nella parte superiore della pagina.
Nota
Attualmente sono supportate le piattaforme APN e FCM. La piattaforma Apple Push Notification Service deve essere configurata con la modalità di autenticazione tramite token. Attualmente la modalità di autenticazione del certificato non è supportata.
Una volta configurato l'hub di notifica, è possibile associarlo alla risorsa di Servizi di comunicazione fornendo la stringa di connessione dell'hub tramite il client di Azure Resource Manager o il portale di Azure. La stringa di connessione deve contenere le autorizzazioni Send. È consigliabile creare un altro criterio di accesso con le sole autorizzazioni Send specificamente per l'hub. Per altre informazioni, vedere Sicurezza di Hub di notifica.
Uso del client di Azure Resource Manager per collegare l'hub di notifica
Per accedere ad Azure Resource Manager, eseguire il comando seguente ed effettuare l'accesso con le proprie credenziali.
armclient login
Eseguire quindi il comando seguente per effettuare il provisioning dell'hub di notifica:
armclient POST /subscriptions/<sub_id>/resourceGroups/<resource_group>/providers/Microsoft.Communication/CommunicationServices/<resource_id>/linkNotificationHub?api-version=2020-08-20-preview "{'connectionString': '<connection_string>','resourceId': '<resource_id>'}"
Uso del portale di Azure per collegare l'hub di notifica
Nel portale passare alla risorsa Servizi di comunicazione di Azure.
All'interno della risorsa Servizi di comunicazione selezionare Notifiche push dal menu a sinistra della pagina Servizi di comunicazione e connettere l'hub di notifica di cui è stato effettuato il provisioning in precedenza.
Selezionare Connessione hub di notifica. Verrà visualizzato un elenco di hub di notifica disponibili per la connessione.
Selezionare l'hub di notifica che si vuole usare per questa risorsa.
- Se è necessario creare un nuovo hub, selezionare Crea nuovo hub di notifica per ottenere un nuovo hub di cui è stato effettuato il provisioning per questa risorsa.
A questo punto verrà visualizzato l'hub di notifica collegato allo stato connesso.
Se si vuole usare un hub diverso per la risorsa, selezionare Disconnetti e quindi ripetere i passaggi per collegare l'hub di notifica diverso.
Nota
Qualsiasi modifica sul modo in cui l'hub viene collegato si riflette nel piano dati (ovvero quando si invia una notifica) entro un periodo massimo di 10 minuti. Questo stesso comportamento si applica quando l'hub viene collegato per la prima volta, se le notifiche sono state inviate prima della modifica.
Registrazione dispositivo
Per informazioni su come registrare l'handle del dispositivo con Servizi di comunicazione, vedere la guida introduttiva alla chiamata vocale e la guida introduttiva alla chat.
Guida alla risoluzione dei problemi relativi alle notifiche push
Se le notifiche push non vengono visualizzate nel dispositivo, le cause possibili sono tre:
- Hub di notifica di Azure non ha accettato la notifica da Servizi di comunicazione di Azure
- Il sistema PNS (Platform Notification System), ad esempio il servizio APN e FCM, non ha accettato la notifica da Hub di notifica di Azure
- Il sistema Platform Notification System non ha recapitato la notifica al dispositivo.
La prima causa di mancato recapito di una notifica (Hub di notifica di Azure non ha accettato la notifica da Servizi di comunicazione di Azure) è illustrata di seguito. Per le altre due cause, vedere Diagnosticare i problemi relativi alle notifiche non recapitate in Hub di notifica di Azure.
Un modo per verificare se la risorsa Servizi di comunicazione invia notifiche a Hub di notifica di Azure consiste nell'esaminare la metrica incoming messages dalle metriche dell'hub di notifica di Azure collegate.
Di seguito sono descritti alcuni errori di configurazione che potrebbero essere la causa per cui l'hub di notifica di Azure non accetta le notifiche dalla risorsa Servizi di comunicazione.
L'hub di notifica di Azure non è collegato alla risorsa Servizi di comunicazione
È possibile che l'hub di notifica di Azure non sia stato collegato alla risorsa Servizi di comunicazione. Per informazioni su come collegarli, vedere la sezione Provisioning di un hub di notifica.
L'hub di notifica di Azure collegato non è configurato
È necessario configurare l'hub di notifica collegato con le credenziali del sistema Platform Notification System per la piattaforma (ad esempio iOS o Android) che si vuole usare. Per altre informazioni su come eseguire questa operazione, vedere Configurare notifiche push in un hub di notifica.
L'hub di notifica di Azure collegato non esiste
L'hub di notifica di Azure collegato alla risorsa Servizi di comunicazione non esiste più. Verificare che l'hub di notifica collegato esista ancora.
La piattaforma Apple Push Notification Service dell'hub di notifica di Azure è configurata con la modalità di autenticazione del certificato
Non è possibile usare la piattaforma Apple Push Notification Service con la modalità di autenticazione del certificato in quanto non è attualmente supportata. Occorre configurare la piattaforma Apple Push Notification Service con la modalità di autenticazione token come specificato in Configurare notifiche push in un hub di notifica.
La stringa di connessione collegata non ha l'autorizzazione Send
La stringa di connessione usata per collegare l'hub di notifica alla risorsa Servizi di comunicazione deve avere l'autorizzazione Send. Per altre informazioni su come creare una nuova stringa di connessione o visualizzare la stringa di connessione corrente dall'hub di notifica di Azure, vedere Sicurezza di Hub di notifica.
La stringa di connessione collegata o l'ID risorsa dell'hub di notifica di Azure non sono validi
Assicurarsi di configurare la risorsa Servizi di comunicazione con la stringa di connessione e l'ID risorsa dell'hub di notifica di Azure corretti
La stringa di connessione collegata è stata rigenerata
Se la stringa di connessione dell'hub di notifica di Azure collegato è stata rigenerata, è necessario aggiornare la stringa di connessione con quella nuova nella risorsa Servizi di comunicazione collegando di nuovo l'hub di notifica.
Passaggi successivi
- Per un'introduzione a Griglia di eventi di Azure, vedere Informazioni su Griglia di eventi
- Per altre informazioni sui concetti di Hub di notifica di Azure, vedere Documentazione di Hub di notifica di Azure