Aktivieren von Push-Benachrichtigungen für den mobilen Chat - Amazon Connect
Schritt 1: Abrufen von Anmeldeinformationen von den APNs von Apple und der FCM-Konsole von GoogleSchritt 2: Erstellen einer Serviceanwendung von AWS End User Messaging mithilfe der AWS-Konsole und Aktivieren des Push-Benachrichtigungskanals für FCM oder APNsSchritt 3: Zuordnen der Anwendung AWS End User Messaging zu einer Instance von Amazon ConnectSchritt 4: Abrufen von Geräte-Token mit FCM oder APNs SDK und Registrieren des Tokens bei Amazon ConnectSchritt 5: Empfangen von Push-Benachrichtigungen in Ihren mobilen AnwendungenÜberwachen Ihrer Nutzung von Push-Benachrichtigungen

Aktivieren von Push-Benachrichtigungen für den mobilen Chat

Push-Benachrichtigungen für den mobilen Chat werden über AWS End User Messaging konfiguriert. Sie können Push-Benachrichtigungen für den mobilen Chat auf iOS- oder Android-Geräten aktivieren, sodass Sie Kunden auch dann über neue Nachrichten informieren können, wenn diese Ihre mobile Anwendung nicht aktiv verwenden. Sie können dieses Feature in Ihrer vorhandenen App aktivieren, die in die mobilen SDKs von Amazon Connect, einer Webview-Lösung oder einer benutzerdefinierten systemeigenen Lösung integriert ist.

Die folgenden Schritte und Ressourcen helfen Ihnen bei den ersten Schritten mit der Integration von Push-Benachrichtigungen von Amazon Connect in Ihre nativen mobilen Anwendungen:

Schritt 1: Abrufen von Anmeldeinformationen von den APNs von Apple und der FCM-Konsole von Google

Damit Sie Amazon Connect so einrichten können, dass Push-Benachrichtigungen an Ihre Apps gesendet werden, müssen Sie zunächst Anmeldeinformationen von APNs von Apple und der FCM-Konsole von Google abrufen, damit AWS End User Messaging Benachrichtigungen an Ihre mobilen Anwendungen senden kann. Welche Anmeldeinformationen Sie angeben, hängt davon ab, welches Push-Benachrichtigungssystem Sie verwenden:

Schritt 2: Erstellen einer Serviceanwendung von AWS End User Messaging mithilfe der AWS-Konsole und Aktivieren des Push-Benachrichtigungskanals für FCM oder APNs

Bevor Sie Amazon Connect für das Senden von Push-Benachrichtigungen aktivieren können, müssen Sie zunächst eine Anwendung von AWS End User Messaging erstellen und den Push-Benachrichtigungskanal in der AWS-Konsole aktivieren.

Folgen Sie diesen Anweisungen, um eine Anwendung zu erstellen und einen der Push-Kanäle zu aktivieren. Zum Abschließen dieses Verfahrens müssen Sie nur einen Anwendungsnamen eingeben. Sie können alle Push-Kanäle zu einem späteren Zeitpunkt aktivieren oder deaktivieren:

  1. Öffnen Sie die Push-Konsole für AWS End User Messaging unter https://console.aws.amazon.com/push-notifications/

  2. Wählen Sie Create application aus.

  3. Geben Sie unter Anwendungsname den Namen Ihrer Anwendung ein.

  4. (Optional) Folgen Sie diesem optionalen Schritt, um den Apple Push Notification Service (APNs) zu aktivieren.

    1. Wählen Sie für Apple Push Notification Service (APNs) die Option Aktivieren aus.

    2. Wählen Sie für Standard-Authentifizierungstyp eine der folgenden Optionen aus:

      1. Wenn Sie Schlüssel-Anmeldeinformationen auswählen, stellen Sie die folgenden Informationen aus Ihrem Apple-Developer-Konto bereit. AWS End User Messaging Push benötigt diese Informationen, um Authentifizierungstoken zu erstellen.

        1. Schlüssel-ID – Die Ihrem Signaturschlüssel zugeordnete ID.

        2. Bundle-ID – Die Ihrer iOS-App zugeordnete ID.

        3. Team-ID – Die Ihrem Apple-Developer-Kontoteam zugewiesene ID.

        4. Authentifizierungsschlüssel – Die .p8-Datei, die Sie von Ihrem Apple-Developer-Konto herunterladen, wenn Sie einen Authentifizierungsschlüssel erstellen.

      2. Wenn Sie die Option Certificate credentials (Zertifikatanmeldeinformationen) auswählen, geben Sie die folgenden Informationen an:

        1. SSL certificate (SSL-Zertifikat) – Die .p12-Datei für Ihr TLS-Zertifikat.

        2. Zertifikatpasswort – Wenn Sie Ihrem Zertifikat ein Passwort zugewiesen haben, geben Sie es hier ein.

        3. Typ des Zertifikats – Wählen Sie den zu verwendenden Zertifikattyp aus.

  5. (Optional) Folgen Sie diesem optionalen Schritt, um Firebase Cloud Messaging (FCM) zu aktivieren.

    1. Wählen Sie für Firebase Cloud Messaging (FCM) die Option Aktivieren aus.

    2. Wählen Sie Token-Anmeldeinformationen für den Standardauthentifizierungstyp und dann Ihre Service-JSON-Datei aus.

  6. Wählen Sie Create application aus.

Schritt 3: Zuordnen der Anwendung AWS End User Messaging zu einer Instance von Amazon Connect

Zum Aktivieren von Push-Benachrichtigungen für eine Instance von Amazon Connect müssen Sie eine Anwendung AWS End User Messaging mit einer Instance von Amazon Connect verknüpfen, indem Sie die CreateIntegrationAssociation-API mit dem IntegrationType PINPOINT_APP aufrufen. Sie können diese API mit der AWS CLI oder dem Amazon Connect SDK für alle unterstützten Sprachen aufrufen. Dies ist ein einmaliger Onboarding-Schritt, der für jede Integration zwischen einer Anwendung AWS End User Messaging und einer Instance von Amazon Connect erforderlich ist.

Schritt 4: Abrufen von Geräte-Token mit FCM oder APNs SDK und Registrieren des Tokens bei Amazon Connect

Sie müssen das Geräte-Token abrufen und damit ein Endbenutzer-Mobilgerät mit einem Chat-Kontakt von Amazon Connect registrieren, um Push-Benachrichtigungen für neue Nachrichten im Chat zu senden. In der folgenden FCM/APNs-Entwicklerdokumentation erfahren Sie, wie das Geräte-Token generiert und von der mobilen Anwendung abgerufen wird.

Wir empfehlen folgende Schritte, um das Gerät mit einem Chat-Kontakt zu registrieren:

  1. Wenn die mobile Anwendung die StartChatContact-API aufruft, übergeben Sie das deviceToken und den deviceType als Kontaktattribute. Weitere Informationen für Benutzer von Webview und gehosteten Kommunikations-Widgets finden Sie unter So übergeben Sie Kontaktattribute an das Kommunikations-Widget.

  2. Betten Sie einen Aufruf der Aktion CreatePushNotificationRegistration in eine Lambda-Funktion im Kontaktablauf ein. Der Flow-Block sollte deviceToken sowie deviceType aus den benutzerdefinierten Kontaktattributen und die initialContactId aus den Systemattributen lesen und diese Werte dann an die Lambda-Funktion übergeben.

    1. Platzieren Sie die Lambda-Funktion je nach Anwendungsfall entweder unmittelbar nach dem Start des Chats (am Anfang des Ablaufs), wenn Sie möchten, dass der Endbenutzer Push-Benachrichtigungen sofort erhält, oder kurz bevor Sie den Kontakt in eine Warteschlange weiterleiten, sodass er den Kontakt nur dann erhält, wenn der Kundendienstmitarbeiter dem Chat beitreten möchte. Sobald der API-Aufruf erfolgt ist, empfängt das Gerät Push-Benachrichtigungen, wenn eine neue Nachricht vom Kundendienstmitarbeiter oder System eingeht. Standardmäßig werden Push-Benachrichtigungen für alle System- und Kundendienstmitarbeiter-Nachrichten gesendet.

      Rufen Sie den Lambda-Funktionsablaufblock im Flow-Designer der Admin-Website von Amazon Connect auf.

  1. (optional) Betten Sie einen Aufruf der Aktion DeletePushNotificationRegistration in eine Lambda-Funktion in einem Ablauf ein. Sobald der API-Aufruf erfolgt ist, empfängt das Gerät keine Push-Benachrichtigungen mehr, wenn eine neue Nachricht vom Kundendienstmitarbeiter oder System eingeht.

Schritt 5: Empfangen von Push-Benachrichtigungen in Ihren mobilen Anwendungen

Sehen Sie sich unser Projekt mit den Beispielen für Chat-Benutzeroberflächen von Amazon Connect an sowie unsere Beispiele für Chat-Webview für iOS und Android an, die zeigen, wie Sie Amazon Connect APIs für das Onboarding und den Empfang von Push-Benachrichtigungen integrieren können.

Überwachen Ihrer Nutzung von Push-Benachrichtigungen

Damit die Zuverlässigkeit, Verfügbarkeit und Leistung Ihrer Push-Benachrichtigungen sichergestellt werden, ist es wichtig, deren Nutzung zu überwachen. Sie können diese Informationen über mehrere Kanäle verfolgen:

  1. AWS bietet umfassende Überwachungstools für Push-Benachrichtigungen. Weitere Informationen finden Sie unter Überwachen von AWS End User Messaging Push.

  2. Je nachdem, welchen Push-Benachrichtigungsservice Sie verwenden, können Sie über die jeweiligen Konsolen auf zusätzliche Nutzungsdaten zugreifen.

    1. Firebase Cloud Messaging (FCM): In der FCM-Dokumentation zum Thema Grundlegendes zur Nachrichtenzustellung finden Sie Einblicke in Ihre FCM-Nutzung.

    2. Apple Push Notification Service (APNs): Lesen Sie in der APNs-Dokumentation den Abschnitt zum Anzeigen des Status von Push-Benachrichtigungen mithilfe von Metriken und APNs, um Ihren Benachrichtigungsstatus zu überwachen.