Condividi tramite

Notifiche di Servizi di comunicazione

  • Articolo

Gli SDK di chat e chiamata di Servizi di comunicazione di Azure creano un canale di messaggistica in tempo reale che consente di eseguire 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.

Diagramma che mostra l'integrazione di Servizi di comunicazione con Griglia di eventi.

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 a partire da marzo 2024. Per altre informazioni, inclusi i passaggi di migrazione, vedere la documentazione relativa all’Hub di notifica.

È 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 riceve una chiamata in arrivo o per notificare di un’attività di chat. Usare queste notifiche push per riattivare l'applicazione dalla modalità in background e visualizzare l'interfaccia utente che consente all'utente di accettare o rifiutare la chiamata o leggere il messaggio di chat.

Diagramma che mostra l'integrazione di Servizi di comunicazione con Hub di notifica di Azure.

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. Questo consente di riutilizzare le risorse e le configurazioni esistenti di Hub di notifica di Azure per recapitare alle applicazioni notifiche affidabili e a bassa latenza.

Nota

Attualmente, le notifiche push di chiamata 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.

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>'}"

  1. Nel portale, passare alla risorsa di Servizi di comunicazione di Azure.

  2. All'interno della risorsa di Servizi di comunicazione, selezionare Notifiche push nel menu a sinistra della pagina di Servizi di comunicazione e connettere l'hub di notifica di cui è stato precedentemente effettuato il provisioning.

  3. Selezionare Connetti hub di notifica. Verrà visualizzato un elenco di hub di notifica disponibili per la connessione.

  4. 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.

    Screenshot che mostra le impostazioni di Notifiche push nel portale di Azure.

A questo punto, verrà visualizzato l'hub di notifica collegato con lo 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 apportata al collegamento dell'hub è si rifletterà sul piano dati (ossia quando viene inviata una notifica) entro un intervallo 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 l’avvio rapido alle chiamate vocali e l’avvio rapido 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