Übersicht über Pushbenachrichtigungen

Das Azure Communication Services Chat SDK und das Anruf-SDK erstellen einen Echtzeit-Messagingkanal, mit dem Signalnachrichten auf effiziente und zuverlässige Weise an verbundene Clients übertragen werden können. Mit dieser Möglichkeit können Sie umfangreiche Echtzeitkommunikationsfunktionen in Ihre Anwendungen erstellen, ohne komplizierte HTTP-Abruflogik implementieren zu müssen. Bei mobilen Anwendungen bleibt die Verbindung dieses Signalisierungskanals jedoch nur dann bestehen, wenn die Anwendung im Vordergrund aktiv ist. Wenn Sie möchten, dass Ihre Benutzer eingehende Anrufe oder Chatnachrichten empfangen, während sich die Anwendung im Hintergrund befindet, sollten Sie Pushbenachrichtigungen verwenden.

Mithilfe von Pushbenachrichtigungen können Sie Informationen von Ihrer Anwendung an die mobilen Geräte ihrer Benutzer senden. Sie können Pushbenachrichtigungen verwenden, um ein Dialogfeld anzuzeigen, einen Ton wiederzugeben oder die Benutzeroberfläche für eingehenden Anrufe anzuzeigen. Azure Communication Services bietet Integrationen in Azure Event Grid und Azure Notification Hubs, mit denen Sie zu Ihren Apps Pushbenachrichtigungen hinzufügen können.

Auslösen von Pushbenachrichtigungen über Azure Event Grid

Azure Communication Services ist in Azure Event Grid integriert, um zuverlässig, skalierbar und sicher Ereignisbenachrichtigungen in Echtzeit bereitzustellen. Sie können diese Integration verwenden, um einen Benachrichtigungsdienst zu erstellen, der Mobile Pushbenachrichtigungen an Ihre Benutzer übermittelt, indem Sie ein Event Grid-Abonnement erstellen, das eine Azure-Funktion oder einen Webhook auslöst.

Erfahren Sie mehr über die Ereignisbehandlung in Azure Communication Services.

Bereitstellen von Pushbenachrichtigungen über Azure Notification Hubs

Sie können einen Azure Notification Hub mit Ihrer Communication Services-Ressource verbinden, um automatisch Pushbenachrichtigungen an das mobile Gerät von Benutzer*innen zu senden, wenn diese einen eingehenden Anruf erhalten, oder sie über verpasste Chataktivitäten zu benachrichtigen. Verwenden Sie diese Pushbenachrichtigungen, um Ihre Anwendung im Hintergrund zu reaktivieren und die Benutzeroberfläche anzuzeigen, über die Benutzer*innen den Anruf annehmen bzw. ablehnen oder die neu empfangene Chatnachricht lesen können.

Communication Services verwendet Azure Notification Hub als Passthroughdienst, um mit den verschiedenen plattformspezifischen Pushbenachrichtigungsdiensten über die Direct Send-API zu kommunizieren. Mit diesem Feature können Sie Ihre vorhandenen Azure Notification Hub-Ressourcen und -Konfigurationen wiederverwenden, um Benachrichtigungen mit geringer Latenz und zuverlässiger Benachrichtigungen für Ihre Anwendungen bereitzustellen.

Bereitstellen von Notification Hub

Zum Übermitteln von Pushbenachrichtigungen an Clientgeräte mithilfe von Notification Hubs erstellen Sie einen Notification Hub innerhalb desselben Abonnements wie Ihre Communication Services-Ressource. Sie müssen den Azure Notification Hub für das Plattformbenachrichtigungssystem konfigurieren, das Sie verwenden möchten. Informationen zum Empfang von Pushbenachrichtigungen von Notification Hubs in Ihrer Client-App finden Sie unter Erste Schritte mit Notification Hubs. Wählen Sie dort in der Dropdownliste oben auf der Seite die Zielplattform für den Client aus.

Die APNs-Plattform muss mit dem Tokenauthentifizierungsmodus konfiguriert sein. Der Zertifikatauthentifizierungsmodus wird derzeit nicht unterstützt.

Nachdem Ihr Notification Hub konfiguriert wurde, können Sie ihn Ihrer Communication Services-Ressource zuweisen, indem Sie für den Hub mithilfe des Azure Resource Manager-Clients oder des Azure-Portals eine Verbindungszeichenfolge bereitstellen. Die Verbindungszeichenfolge muss Berechtigungen vom Typ Send enthalten. Wir empfehlen Ihnen, eine andere Zugriffsrichtlinie nur mit Berechtigungen vom Typ Send zu erstellen, die speziell für Ihren Hub gilt. Erfahren Sie mehr über die Sicherheit von Notification Hubs und Zugriffsrichtlinien.

Verwenden des Azure Resource Manager-Clients zum Herstellen einer Verknüpfung mit Ihrem Notification Hub

Führen Sie Folgendes aus, um sich bei Azure Resource Manager anzumelden, und melden Sie sich mit Ihren Anmeldeinformationen an.

armclient login

Nach erfolgreicher Anmeldung führen Sie Folgendes aus, um den Notification Hub bereitzustellen:

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

Verwenden des Azure-Portals zum Herstellen einer Verknüpfung mit Ihrem Notification Hub

1. Wechseln Sie im Azure-Portal zu Ihrer Azure Communication Services-Ressource.

2. Wählen Sie in der Communication Services-Ressource im linken Menü der Seite „Communication Services“ die Option Pushbenachrichtigungen aus, und stellen Sie eine Verbindung mit dem zuvor bereitgestellten Notification Hub her.

3. Wählen Sie Verbinden mit Notification Hub. Es wird eine Liste der Benachrichtigungshubs angezeigt, die für die Verbindung verfügbar sind.

4. Wählen Sie den Notification Hub aus, den Sie für diese Ressource verwenden möchten.

   • Wenn Sie einen neuen Hub erstellen müssen, wählen Sie Neuen Notification Hub erstellen aus, um einen neuen Hub für diese Ressource bereitzustellen.

   

Nun wird der Benachrichtigungshub angezeigt, den Sie mit dem Verbindungsstatus verknüpft haben.

Wenn Sie für die Ressource einen anderen Hub verwenden möchten, wählen Sie Trennen aus, und wiederholen Sie dann die Schritte zum Verknüpfen mit einem anderen Notification Hub.

Geräteregistrierung

Informationen zum Registrieren Ihres Gerätehandles bei Communication Services finden Sie unter Schnellstart: Hinzufügen von Sprachanrufen zu Ihrer App und Schnellstart: Hinzufügen von Chatfunktionen zu Ihrer App.

Leitfaden zur Problembehandlung für Pushbenachrichtigungen

Wenn Auf Ihrem Gerät keine Pushbenachrichtigungen angezeigt werden, gibt es drei Orte, an denen die Benachrichtigungen möglicherweise gelöscht werden:

• Die Benachrichtigung von Azure Communication Services wurde von Azure Notification Hubs nicht akzeptiert.
• Das Plattformbenachrichtigungssystem (z. B. APNs und FCM) hat die Benachrichtigung von Azure Notification Hubs nicht akzeptiert.
• Das Plattformbenachrichtigungssystem hat die Benachrichtigung nicht an das Gerät übertragen.

Der erste Ort, an dem eine Benachrichtigung gelöscht werden kann (Azure Notification Hubs haben die Benachrichtigungen von Azure Communication Services nicht akzeptiert) wird in der folgenden Beschreibung behandelt. Weitere Informationen erhalten Sie unter Diagnose entgangener Benachrichtigungen in Azure Notification Hubs.

Eine Möglichkeit zur Ermittlung, ob von Ihrer Communication Services-Ressource Benachrichtigungen an Azure Notification Hubs gesendet werden, ist die Metrik incoming messages, die Teil der verknüpften Azure Notification Hub-Metriken ist.

Unten sind einige häufige Fehlkonfigurationen angegeben, die der Grund dafür sein können, warum Azure Notification Hub die Benachrichtigungen von Ihrer Communication Services-Ressource nicht akzeptiert.

Azure Notification Hub ist nicht mit der Communication Services-Ressource verknüpft

Es kann sein, dass Sie Ihren Azure Notification Hub nicht mit Ihrer Communication Services-Ressource verknüpft haben. Informationen zur Vorgehensweise beim Verknüpfen finden Sie im Abschnitt Bereitstellen von Notification Hub.

Der verknüpfte Azure Notification Hub wurde nicht konfiguriert

Sie müssen den verknüpften Notification Hub mit den Plattformbenachrichtigungssystem-Anmeldeinformationen für die Plattform (z. B. iOS oder Android) konfigurieren, die Sie verwenden möchten. Weitere Informationen zur Vorgehensweise finden Sie unter Schnellstart: Einrichten von Pushbenachrichtigungen in einem Notification Hub.

Der verknüpfte Azure Notification Hub ist nicht vorhanden

Der Azure Notification Hub, der mit Ihrer Communication Services-Ressource verknüpft ist, ist nicht mehr vorhanden. Überprüfen Sie, ob der verknüpfte Notification Hub noch vorhanden ist.

Für die APNs-Plattform des Azure Notification Hubs wurde der Zertifikatauthentifizierungsmodus konfiguriert

Falls Sie die APNs-Plattform im Zertifikatauthentifizierungsmodus verwenden möchten, wird sie derzeit nicht unterstützt. Konfigurieren Sie für die APNs-Plattform den Tokenauthentifizierungsmodus, wie dies unter Schnellstart: Einrichten von Pushbenachrichtigungen in einem Notification Hub beschrieben ist.

Die verknüpfte Verbindungszeichenfolge verfügt nicht über die Send-Berechtigung

Die Verbindungszeichenfolge, die Sie zum Verknüpfen Ihres Notification Hubs mit Ihrer Communication Services-Ressource verwendet haben, muss über die Berechtigung vom Typ Send verfügen. Weitere Informationen dazu, wie Sie eine neue Verbindungszeichenfolge erstellen oder die aktuelle Verbindungszeichenfolge aus Ihrem Azure Notification Hub anzeigen können, finden Sie unter Benachrichtigungshub-Sicherheits- und Zugriffsrichtlinien

Die verknüpfte Verbindungszeichenfolge oder die Ressourcen-ID des Azure Notification Hubs ist ungültig

Stellen Sie sicher, dass Sie die Communication Services-Ressource mit der richtigen Verbindungszeichenfolge und Ressourcen-ID für den Azure Notification Hub konfigurieren.

Die verknüpfte Verbindungszeichenfolge wird erneut generiert

Wenn Sie die Verbindungszeichenfolge des verknüpften Azure Notification Hub neu generiert haben, müssen Sie die neue Verbindungszeichenfolge in Ihrer Kommunikationsdienst-Ressource aktualisieren, indem Sie den Benachrichtigungshub erneut verknüpfen.

Nächste Schritte

• Eine Einführung zu Azure Event Grid finden Sie unter Einführung in Azure Event Grid.
• Weitere Informationen zu den Konzepten des Azure Notification Hub finden Sie in der Dokumentation zu Azure Notification Hubs.