Overzicht van pushmeldingen

De Azure Communication Services Chat SDK en Calling SDK maken een realtime berichtenkanaal waarmee signaleringsberichten op een efficiënte, betrouwbare manier naar verbonden clients kunnen worden gepusht. Met deze mogelijkheid kunt u uitgebreide, realtime communicatiefunctionaliteit in uw toepassingen bouwen zonder dat u ingewikkelde HTTP-pollinglogica hoeft te implementeren. In mobiele apps blijft dit kanaal echter slechts verbonden zolang uw app actief is op de voorgrond. Als u wilt dat uw gebruikers inkomende oproepen of chatberichten ontvangen wanneer uw app op de achtergrond staat, moet u pushmeldingen gebruiken.

Met pushmeldingen kunt u gegevens van uw toepassing verzenden naar mobiele apparaten van gebruikers. U kunt pushmeldingen gebruiken om een dialoogvenster weer te geven, een geluid af te spelen of de gebruikersinterface voor binnenkomende oproepen weer te geven. Azure Communication Services biedt integraties met Azure Event Grid en Azure Notification Hubs waarmee u pushmeldingen kunt toevoegen aan uw apps.

Pushmeldingen activeren via Azure Event Grid

Azure Communication Services kan worden geïntegreerd met Azure Event Grid om realtime gebeurtenismeldingen te verzenden op een betrouwbare, schaalbare en veilige manier. U kunt deze integratie gebruiken om een meldingsservice te maken die mobiele pushmeldingen levert aan uw gebruikers door een Event Grid-abonnement te maken dat een Azure-functie of webhook activeert.

Lees meer over verwerking van gebeurtenissen in Azure Communication Services.

Pushmeldingen versturen via Azure Notification Hubs

Belangrijk

Azure Notification Hubs heeft aangekondigd dat de verouderde API van Firebase Cloud Messaging (FCM) in juli 2024 is afgeschaft. Dit is van invloed op alle Aanroepen en chattoepassingen van Azure Communication Services die Android-pushmeldingen verzenden. Klanten die getroffen zijn, moeten hun registraties migreren van FCM verouderd naar FCM v1 en kunnen dit in maart 2024 gaan doen. Zie de documentatie van Notification Hub voor meer informatie, waaronder migratiestappen.

U kunt een Azure Notification Hub verbinden met uw Communication Services-resource om automatisch pushmeldingen te verzenden naar het mobiele apparaat van een gebruiker wanneer ze een inkomende oproep ontvangen of om hen op de hoogte te stellen van gemiste chatactiviteiten. U moet deze pushmeldingen gebruiken om uw toepassing te activeren vanaf de achtergrond en de gebruikersinterface weer te geven waarmee de gebruiker het gesprek kan accepteren of weigeren of het zojuist ontvangen chatbericht kan lezen.

Communication Services maakt gebruik van Azure Notification Hub als een doorgeefservice om te communiceren met de verschillende platformspecifieke services voor pushmeldingen met behulp van de API Direct Send. Met deze functie kunt u uw bestaande Azure Notification Hub-resources en -configuraties opnieuw gebruiken om lage latentie, betrouwbare meldingen aan uw toepassingen te leveren.

Notitie

Momenteel worden oproepen en pushmeldingen voor chats ondersteund voor Android en iOS.

Notification Hub-inrichting

Als u pushmeldingen wilt aanbieden met behulp van Notification Hubs, maak dan een Notification Hub aan in hetzelfde abonnement als uw Communication Services-resource. Configureer Azure Notification Hub voor het Platform Notification System dat u wilt gebruiken. Zie Aan de slag met Notification Hubs en selecteer uw doelclientplatform in de vervolgkeuzelijst aan de bovenkant van de pagina voor meer informatie over het ophalen van pushmeldingen in uw client-app van Notification Hubs.

Notitie

Momenteel worden de APNs- en FCM-platforms ondersteund.

Het APNs-platform moet zijn geconfigureerd met de modus voor tokenverificatie. De verificatiemodus voor certificaten wordt momenteel niet ondersteund.

Zodra uw Notification Hub is geconfigureerd, kunt u deze koppelen met uw Communication Services-resource door een verbindingsreeks voor de hub op te geven met behulp van de Azure Resource Manager-client of via de Azure-portal. De verbindingsreeks moet Send-machtigingen bevatten. U wordt aangeraden een ander toegangsbeleid te maken met machtigingen voor Send alleen, specifiek voor uw hub. Meer informatie over het beveiligings- en toegangsbeleid van Notification Hubs

De Azure Resource Manager-client gebruiken om de Notification Hub te koppelen

Als u zich wilt aanmelden bij Azure Resource Manager, voert u het volgende uit en meldt u zich aan met uw referenties.

armclient login

Zodra u bent aangemeld, voert u het volgende uit om de Notification Hub in te richten:

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

Azure Portal gebruiken om de Notification Hub te koppelen

1. Ga in de portal naar uw Azure Communication Services-resource.

2. Selecteer in de Communication Services-resource pushmeldingen in het linkermenu van de pagina Communication Services en verbind de Notification Hub die u eerder hebt ingericht.

3. Selecteer Notification Hub verbinden. U ziet een lijst met notification hubs die beschikbaar zijn om verbinding te maken.

4. Selecteer de Notification Hub die u voor deze resource wilt gebruiken.

   • Als u een nieuwe hub wilt maken, selecteert u Nieuwe Notification Hub maken om een nieuwe hub in te richten voor deze resource.

   

Nu ziet u de Notification Hub die u hebt gekoppeld aan de verbonden staat.

Als u een andere hub voor de resource wilt gebruiken, selecteert u Verbinding verbreken en herhaalt u dan de stappen om een andere Notification Hub te koppelen.

Notitie

Wijzigingen in de manier waarop de hub is gekoppeld, worden weergegeven in het gegevensvlak (dat wil gezegd, wanneer een melding wordt verzonden) binnen een maximumperiode van 10 minuten. Hetzelfde gedrag is van toepassing wanneer de hub voor het eerst wordt gekoppeld, als er meldingen vóór de wijziging zijn verzonden.

Apparaatregistratie

Raadpleeg de quickstart voor spraakgesprekken en chat-quickstart om te leren hoe u uw apparaat-id kunt registreren bij Communication Services.

Probleemoplossingsgids voor pushmeldingen

Wanneer u geen pushmeldingen op uw apparaat ziet, zijn er drie plaatsen waar de meldingen kunnen worden verwijderd:

• De melding van Azure Communication Services is niet geaccepteerd door Azure Notification Hubs
• Platform Notification System (bijvoorbeeld APNs en FCM) hebben de melding van Azure Notification Hubs niet geaccepteerd
• Platform Notification System heeft de melding niet aan het apparaat geleverd.

De eerste plaats waar een melding kan worden verwijderd (Azure Notification Hubs accepteerde de meldingen van Azure Communication Services niet) wordt behandeld in de volgende beschrijving. Zie Verwijderde meldingen diagnosticeren in Azure Notification Hubs voor meer informatie.

Bekijk de incoming messages metriek van de gekoppelde Azure Notification Hubs-metrieken om te zien of uw Communication Services-resource meldingen naar Azure Notification Hubs stuurt.

Hierna volgen enkele veelvoorkomende onjuiste configuraties die mogelijk de oorzaak zijn waarom Azure Notification Hub geen meldingen van uw Communication Services-resource accepteert.

Azure Notification Hub is niet gekoppeld aan de Communication Services-resource

Het kan zijn dat u uw Azure Notification Hub niet hebt gekoppeld aan uw Communication Services-resource. Kijk in de sectie Notification Hub inrichten om te zien hoe u deze koppelt.

De gekoppelde Azure Notification Hub is niet geconfigureerd

U moet de gekoppelde Notification Hub configureren met de Platform Notification System-referenties voor het platform dat u wilt gebruiken (bijvoorbeeld iOS of Android). Kijk bijvoorbeeld eens in Pushmeldingen instellen in een Notification Hub voor meer informatie over hoe u dit kunt doen.

De gekoppelde Azure Notification Hub bestaat niet

De Azure Notification Hub die is gekoppeld aan uw Communication Service-resource, bestaat niet meer. Controleer of de gekoppelde Notification Hub nog bestaat.

Het APNs-platform van Azure Notification Hub is geconfigureerd met verificatiemodus voor certificaten

Als u het APNs-platform wilt gebruiken met de verificatiemodus voor certificaten, wordt dit momenteel niet ondersteund. U moet het APNs-platform configureren met de verificatiemodus voor tokens, zoals opgegeven in Pushmeldingen instellen in een Notification Hub.

De gekoppelde verbindingsreeks beschikt niet over een Send-machtiging

De verbindingsreeks die u hebt gebruikt om uw Notification Hub aan uw Communication Services-resource te koppelen, moet beschikken over de Send-machtiging. ** Voor meer informatie over hoe u een nieuwe verbindingsreeks kunt maken of de huidige verbindingsreeks van uw Azure Notification Hub kunt bekijken, raadpleegt u het beveiligings- en toegangsbeleid van Notification Hubs.

De gekoppelde verbindingsreeks of de Azure Notification Hub-resourceId is niet geldig

Zorg ervoor dat u de Communication Services-resource configureert met de juiste verbindingsreeks en Azure Notification Hub-resourceId

De gekoppelde verbindingsreeks wordt opnieuw gegenereerd

Als u de verbindingsreeks van uw gekoppelde Azure Notification Hub opnieuw hebt gegenereerd, moet u de verbindingsreeks bijwerken met de nieuwe in uw Communication Services-resource door de Notification Hub opnieuw te koppelen.

Volgende stappen

• Zie Wat is Event Grid? voor een inleiding tot Azure Event Grid.
• Zie de documentatie voor Azure Notification Hubs voor meer informatie over de concepten van Azure Notification Hubs.