Communication Services-meldingen
De Chat- en bel-SDK's van Azure Communication Services maken een realtime berichtenkanaal waarmee signaleringsberichten op een efficiënte, betrouwbare manier naar verbonden clients kunnen worden gepusht. Zo kunt u uitgebreide, realtime communicatiefuncties in uw toepassingen inbouwen zonder dat u complexe logica voor HTTP-polling moet 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 informatie verzenden van uw toepassing naar de 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 sturen op een betrouwbare, schaalbare en veilige manier. U kunt deze integratie gebruiken om een service te maken die mobiele pushmeldingen stuurt naar gebruikers door een Event Grid-abonnement te maken dat een Azure-functie of een 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 wordt afgeschaft. Dit is van invloed op alle Aanroepen en chattoepassingen van Azure Communication Services die Android-pushmeldingen verzenden. Klanten die hiervan last hebben, 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. Hiermee kunt u uw bestaande Azure Notification Hub-resources en -configuraties opnieuw gebruiken om lage latentie en 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
Ga in de portal naar uw Azure Communication Services-resource.
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.
Selecteer Notification Hub verbinden. U ziet een lijst met notification hubs die beschikbaar zijn om verbinding te maken.
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 status.
Als u een andere hub voor de resource wilt gebruiken, selecteert u Verbinding verbreken en herhaalt u de stappen om de verschillende 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 voor meer informatie over het registreren van uw apparaatafhandeling bij Communication Services.
Probleemoplossingsgids voor pushmeldingen
Wanneer u geen pushmeldingen op uw apparaat ziet, zijn er drie locaties waar de meldingen kunnen zijn neergezet:
- 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 plek waar een melding kan worden neergezet (Azure Notification Hubs heeft de meldingen van Azure Communication Services niet geaccepteerd) wordt hieronder behandeld. Zie Een diagnose stellen voor verwijderde meldingen in Azure Notification Hubs voor de andere twee locaties.
Bekijk de metrische gegevenswaarde van incoming messages van de gekoppelde metrische gegevens van Azure Notification Hub om te zien of de 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 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
Houd er rekening mee dat als u het APNs-platform wilt gebruiken met de verificatiemodus voor certificaten, 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. Kijk in Beveiligings- en toegangsbeleid voor Notification Hubs voor meer informatie over het maken van een nieuwe verbindingsreeks of als u de huidige verbindingsreeks vanuit de Azure Notification Hub wilt weergeven
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 reeks 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.
- Bekijk de Azure Notification Hubs-documentatie voor meer informatie over de concepten van de Azure Notification Hub.