Aktivieren Sie Push-Benachrichtigungen für den mobilen Chat

PDFRSS

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 sie Ihre mobile Anwendung nicht aktiv verwenden. Sie können diese Funktion in Ihrer vorhandenen App, die in das Amazon Connect Handy integriert ist SDKs, einer Webview-Lösung oder einer benutzerdefinierten systemeigenen Lösung aktivieren.

Die folgenden Schritte und Ressourcen helfen Ihnen beim Einstieg in die Integration von Amazon Connect Push-Benachrichtigungen in Ihre nativen mobilen Anwendungen:

Schritt 1: Besorgen Sie sich die Anmeldeinformationen von der FCM-Konsole von Apple APNs und Google

Um es Amazon Connect so einzurichten, dass Push-Benachrichtigungen an Ihre Apps gesendet werden können, müssen Sie zunächst Anmeldeinformationen von der FCM-Konsole von Apple APNs und 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:

• Informationen zu den Anmeldedaten für den Apple Push Notification Service (APNs) finden Sie in der Apple Developer-Dokumentation unter Einen Verschlüsselungsschlüssel und eine Schlüssel-ID von Apple beziehen und Ein Anbieterzertifikat von Apple beziehen.

• Die Anmeldeinformationen für Firebase Cloud Messaging (FCM) von Google können über die Firebase-Konsole abgerufen werden, siehe Firebase Cloud Messaging.

Schritt 2: Erstellen Sie mithilfe der AWS Konsole eine AWS End User Messaging-Dienstanwendung und aktivieren Sie den Push-Benachrichtigungskanal 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 AWS Endbenutzer-Messaging-Anwendung 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. Um dieses Verfahren abzuschließen, müssen Sie nur einen Anwendungsnamen eingeben. Sie können jeden der Push-Kanäle zu einem späteren Zeitpunkt aktivieren oder deaktivieren:

1. Öffnen Sie die AWS Endbenutzer-Nachrichten-Push-Konsole unter https://console.aws.amazon.com/push-notifications/

2. Wählen Sie Create application aus.

3. Geben Sie unter Anwendungsname den Namen für Ihre Anwendung ein.

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

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

   2. Wählen Sie als Standard-Authentifizierungstyp entweder:

      1. Wenn Sie Key Credentials wählen, geben Sie die folgenden Informationen aus Ihrem Apple-Entwicklerkonto ein. 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 wählen Sie dann Ihre Dienst-JSON-Datei aus.

6. Wählen Sie Create application aus.

Schritt 3: Ordnen Sie die AWS End User Messaging-Anwendung einer Amazon Connect Instanz zu

Um Push-Benachrichtigungen auf einer Amazon Connect Instanz zu aktivieren, müssen Sie eine AWS Endbenutzer-Messaging-Anwendung mit einer Amazon Connect Instanz verknüpfen, indem Sie die CreateIntegrationAssociationAPI mit der aufrufen PINPOINT_APP IntegrationType. Sie können diese API mit AWS CLIoder dem Amazon Connect SDK für alle unterstützten Sprachen aufrufen. Dies ist ein einmaliger Onboarding-Schritt, der für jede Integration zwischen einer AWS Endbenutzer-Messaging-Anwendung und einer Amazon Connect Instance erforderlich ist.

Schritt 4: Holen Sie sich das Geräte-Token mit FCM oder APNs SDK und registrieren Sie es bei Amazon Connect

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

• Informationen zum Apple Push Notification Service (APN) finden Sie unter App registrieren bei APNs in der Apple-Dokumentation für Entwickler.

• Informationen zu Firebase Cloud Messaging (FCM) finden Sie unter Bewährte Methoden für die Verwaltung von FCM-Registrierungstoken.

Um das Gerät mit einem Chat-Kontakt zu registrieren, empfehlen wir Ihnen, Folgendes zu tun:

1. Wenn die mobile Anwendung die StartChatContactAPI aufruft, übergeben Sie die Kontaktattribute deviceToken unddeviceType. 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 zur CreatePushNotificationRegistrationAktion in eine Lambda-Funktion in einen Kontaktablauf ein. Der Flow-Block sollte deviceType aus den benutzerdefinierten Kontaktattributen und initialContactId aus den Systemattributen lesen deviceToken und diese Werte dann an die Lambda-Funktion übergeben.

   1. Platzieren Sie die Lambda-Funktion je nach Ihrem Anwendungsfall entweder unmittelbar nach dem Start des Chats (am Anfang des Flows), wenn Sie möchten, dass der Endbenutzer sofort Push-Benachrichtigungen erhält, oder direkt vor dem Weiterleiten des Kontakts in eine Warteschlange, sodass er den Kontakt nur erhält, wenn der Agent beitreten will. Sobald der API-Aufruf erfolgt ist, empfängt das Gerät Push-Benachrichtigungen, wenn eine neue Nachricht vom Agenten oder System eingeht. Standardmäßig werden Push-Benachrichtigungen für alle System- und Agentennachrichten gesendet.

      

3. (optional) Betten Sie einen Aufruf der DeletePushNotificationRegistrationAktion in eine Lambda-Funktion in einen Flow ein. Sobald der API-Aufruf erfolgt ist, empfängt das Gerät keine Push-Benachrichtigungen mehr, wenn eine neue Nachricht vom Agenten oder System eingeht.

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

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

Überwachen Sie Ihre Nutzung von Push-Benachrichtigungen

Um die Zuverlässigkeit, Verfügbarkeit und Leistung Ihrer Push-Benachrichtigungen zu gewährleisten, 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 Überwachung von Push-Nachrichten für AWS Endbenutzer.

2. Je nachdem, welchen Push-Benachrichtigungsdienst 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-Benachrichtigungsdienst (APNs): Lesen Sie den APNs Dokumentationsabschnitt zum Anzeigen des Status von Push-Benachrichtigungen mithilfe von Metriken und APNs zur Überwachung Ihres Benachrichtigungsstatus.