Wenn Sie Zendesk Chat über Ihre eigene mobile App anbieten, können Sie Push-Benachrichtigungen aktivieren, um Kunden auf Antworten und Aktualisierungen in ihren Chats hinzuweisen.
Bei Zendesk Chat-Konten mit kostenpflichtigen Plänen können Push-Benachrichtigungen so konfiguriert werden, dass der Benutzer auch dann benachrichtigt wird, wenn die App auf dem Mobilgerät im Hintergrund läuft. Diese Benachrichtigungen können bei Bedarf für mehrere mobile Apps aktiviert werden.
In diesem Beitrag werden die Aufgaben beschrieben, die Administratoren ausführen müssen, um Push-Benachrichtigungen für Zendesk Chat in ihren mobilen Apps zu aktivieren. Er enthält die folgenden Themen:
- Vorbereitungen zum Hinzufügen der App
- Aktivieren der Push-Benachrichtigungen in einer mobilen App
- Bearbeiten der Informationen einer App
- Deaktivieren der Push-Benachrichtigungen in einer App
- Testen von Push-Benachrichtigungen
- Hinweis für Benutzer von Chat Mobile SDK v1
Vorbereitungen zum Hinzufügen der App
Bevor Entwickler Push-Benachrichtigungen aktivieren können, muss ein Chat-Administrator FCM-Server-Credentials (für Android) bzw. ein PEM-Zertifikat (für iOS) in das Zendesk Chat-Konto hochladen.
Die FCM-Server-Credentials bzw. die Datei mit dem PEM-Zertifikat müssen vom Entwicklungsteam bereitgestellt werden. Die folgenden Dokumente im Zendesk Developer Portal enthalten relevante Informationen für Entwickler:
Aktivieren der Push-Benachrichtigungen in einer mobilen App
Zum Aktivieren der Push-Benachrichtigungen müssen Administratoren ihre mobilen Apps zu der Mobile SDK-Liste hinzufügen, auf die über Ihr Chat-Dashboard zugegriffen wird. Beim Hinzufügen einer App zu dieser Liste wird eine App-ID generiert und an Ihr Entwicklungsteam weitergegeben.
So fügen Sie eine App zur Mobile SDK-Liste hinzu
- Gehen Sie in Ihrem Chat-Dashboard zu Einstellungen > Konto > API und SDKs.
- Klicken Sie unter „Mobile SDK“ auf App hinzufügen.
- Geben Sie auf der Seite App hinzufügen die folgenden Daten zu Ihrer App ein:
- Name: Ein Name, an dem Entwickler und andere Administratoren die App erkennen können.
- Beschreibung: Eine kurze Erklärung der Funktionsweise der App.
- (Für Android) Laden Sie den privaten Schlüssel des Dienstkontos hoch, die die privaten Credentials, die Client-E-Mail-Adresse (auch „Service Account Email“ genannt) und die Projekt-ID enthält. Klicken Sie dazu in der Firebase-Konsole auf Generate New Private Key. Weitere Informationen finden Sie unter Initialize the SDK in non-Google environments. Außerdem müssen Sie
google-services.json
zu Ihrem Android-Projekt hinzufügen. Weitere Informationen finden Sie unter Push-Benachrichtigungen.In den meisten Migrationsszenarien ist die Firebase Cloud Messaging (FCM) v1 API standardmäßig aktiviert. Wenn bei der Kontaktaufnahme mit dem Endpunkt Fehler auftreten, stellen Sie sicher, dass die Firebase Cloud Messaging API in der Liste der APIs und Dienste in der Google Cloud-Konsole aktiviert ist.
- (für iOS) Laden Sie ein PEM-Zertifikat hoch.
- Klicken Sie auf Änderungen speichern.
Die App wird erstellt und erhält eine App-ID.
Informieren Sie das Entwicklungsteam, dass die Credentials oder das Zertifikat hochgeladen wurden. Nach Erhalt dieser Bestätigung müssen die Entwickler den App-Code ändern, um Push-Benachrichtigungen zu aktivieren. Weitere Informationen sind in den oben aufgeführten Dokumenten für Entwickler zu finden.
Bearbeiten der Informationen einer App
Weitere Informationen zum Bearbeiten des Namens und der Beschreibung Ihrer mobilen App finden Sie unter Aktivieren der Push-Benachrichtigungen in einer mobilen App.
So bearbeiten Sie die Einstellungen einer vorhandenen App
- Gehen Sie im Dashboard zu Einstellungen > Konto > API und SDKs.
- Klicken Sie unter „Mobile SDK“ auf die App, die Sie bearbeiten möchten.
- Nehmen Sie auf der Seite „App bearbeiten“ die gewünschten Änderungen vor und klicken Sie dann auf Änderungen speichern.
Deaktivieren der Push-Benachrichtigungen in einer App
Wenn Sie für eine mobile App keine Chat Push-Benachrichtigungen mehr anbieten möchten, können Sie sie aus der Mobile SDK-Liste entfernen.
Nachdem eine App gelöscht wurde, erhalten Besucher, die die betreffende App-ID nutzen, keine weiteren Push-Benachrichtigungen von Ihrem Service. Sie können keine weitere mobile SDK-App mit derselben App-ID erstellen und die Löschung nicht rückgängig machen.
So löschen Sie eine oder mehrere Apps
- Gehen Sie im Dashboard zu Einstellungen > Konto > API und SDKs.
- Wählen Sie unter „Mobile SDK“ die App(s) aus, die Sie löschen möchten.
- Klicken Sie auf Ausgewählte löschen.
Testen von Push-Benachrichtigungen
Wenn Ihre App auf iOS-Geräten läuft, können Sie die Push-Benachrichtigungen testen, bevor Sie sie über Ihre aktive Anwendung bereitstellen.
So senden Sie Push-Benachrichtigungen an die Testumgebung (nur iOS)
- Gehen Sie im Dashboard zu Einstellungen > Konto > API und SDKs.
- Klicken Sie unter „Mobile SDK“ auf die App, die Push-Benachrichtigungen an die Testumgebung senden soll.
- Klicken Sie unter „iOS“ auf Für APNs-Sandbox.
- Klicken Sie auf die Schaltfläche Änderungen speichern.
Hinweis für Benutzer von Chat Mobile SDK v1
Wenn Sie bisher das Chat Mobile SDK v1 verwendet haben, enthält Ihr Konto möglicherweise eine App namens „App 1“, die Sie nicht löschen können.
Wenn Sie eine App nutzen, die mit dem Mobile SDK v1 mit den alten Mobile SDK-Einstellungen erstellt wurde, haben wir die vorhandene App auf das neue System umgestellt. Sie ist an dem vorgegebenen Namen „App 1“ zu erkennen (der Name kann in den Einstellungen der App geändert werden).
Diese App kann im Dashboard nicht gelöscht werden, da sie die ältere Mobile SDK-Version nutzt und deshalb nicht mehr als neue App hinzugefügt werden kann, falls sie versehentlich gelöscht wird.
So können Sie diese App bei Bedarf deaktivieren:
- Klicken Sie unter „Mobile SDK“ auf App 1.
- Klicken Sie auf App bearbeiten.
- Entfernen Sie den FCM-Serverschlüssel und/oder die PEM-Datei.
- Klicken Sie auf Änderungen speichern.