- Startseite
- /
- Artikel
Danke für Ihr Feedback.
In diesem Artikel
Feedback?Erstellen und konfigurieren Sie ein digitales Chat-Asset in Control Hub für Webex Connect, Webex Contact Center oder Webex Contact Center Enterprise.
Übersicht
Verwenden Sie digitale Kanäle in Control Hub, um ein Chat-Asset für Web (Live-Chat), Mobil (In-App-Messaging) und Push-Benachrichtigungen zu erstellen und zu konfigurieren. Die für die Konfiguration verfügbaren Einstellungen hängen von dem Dienst ab, den Sie unter Zuweisen zu ausgewählt haben, und davon, ob Sie Web, Mobil oder beides auswählen.
Dieser Artikel beschreibt den kompletten Asset-Konfigurationsprozess, einschließlich unterstützter Funktionen, Messaging, Push-Provider-Anmeldeinformationen, JSON Web Token (JWT) -Autorisierung, JSON Web Keys (JWKs), Transportprotokolle, Mehrbenutzerregistrierung und dienstspezifische Konfiguration nach der Erstellung des Assets.
Unterstützte Funktionen
| Funktion | Webex Connect | Webex Contact Center | Webex Kontaktzentrum Enterprise |
|---|---|---|---|
| Web-Live-Chat | Unterstützt | Unterstützt | Unterstützt |
| In-App-Nachrichten auf Mobilgeräten | Unterstützt | Unterstützt | Unterstützt |
| Web und Mobile in einem einzigen Asset | Unterstützt | Nicht unterstützt | Nicht unterstützt |
| Mobil — Android-Push-Benachrichtigungen | Unterstützt | Unterstützt | Unterstützt |
| Mobil — iOS-Push-Benachrichtigungen | Unterstützt | Unterstützt | Unterstützt |
| Web-Push-Benachrichtigungen | Unterstützt (Chrome und Firefox) | Nicht unterstützt | Nicht unterstützt |
| JWT - Handy | Unterstützt | Unterstützt und erforderlich | Unterstützt und erforderlich |
| JWT - Internet | Unterstützt | Nicht unterstützt | Nicht unterstützt |
| Registrierungen für mehrere Benutzer | Unterstützt | Unterstützt | Unterstützt |
| Serverseitiger Posteingang | Unterstützt | Nicht zutreffend | Nicht zutreffend |
| Datenstrom | Unterstützt | Nicht zutreffend | Nicht zutreffend |
Vorbereitungen
- Melden Sie sich bei Control Hub als Volladministrator oder Contact Center-Administrator an, der digitale Ressourcen verwalten kann.
- Stellen Sie sicher, dass Webex Connect digitale Dienste, Webex Contact Center oder Contact Center Enterprise für das Unternehmen bereitgestellt werden. Ohne den Anspruch sind digitale Vermögenswerte nicht verfügbar.
- Identifizieren Sie den Kontaktcenter-Eintrittspunkt und den Flow, der neue Chat-Konversationen empfangen wird.
- Wenn die Bereitstellung mobile Push-Benachrichtigungen verwendet, bereiten Sie die Firebase-, Huawei- oder Apple-Anmeldeinformationen vor, die für die gewählte Plattform erforderlich sind.
- Wenn Sie planen, die JWT-Autorisierung zu verwenden, bereiten Sie das öffentliche JWK vor, das zur Überprüfung der von Ihrem vertrauenswürdigen Backend ausgegebenen Token verwendet wird.
Das Chat-Asset konfigurieren
Um ein Chat-Asset zu konfigurieren:
| 1 | |
| 2 |
Gehen Sie zu Dienste > Digitale Vermögenswerte. |
| 3 |
Wählen Sie Asset erstellen aus. |
| 4 |
Geben Sie unter Anlagendetails konfigurieren die folgenden Werte ein:
|
| 5 |
Wählen Sie in Messaging die Plattform aus und konfigurieren Sie Live-Chat/ In-App-Messaging und alle erforderlichen Push-Benachrichtigungen. Die angezeigten Optionen hängen von der ausgewählten Plattform ab. Android- und iOS-Benachrichtigungseinstellungen sind verfügbar, wenn Mobil ausgewählt ist. Web Push ist verfügbar, wenn Web für ein Asset ausgewählt ist, dem zugewiesen istWebex Connect. |
Nachrichtenübermittlung konfigurieren
Wählen Sie in Messaging die Plattform aus und konfigurieren Sie die Messaging-Funktionen für das Asset.
Um das Messaging zu konfigurieren:
Das primäre und das sekundäre Transportprotokoll müssen unterschiedlich sein. Wenn das SDK keine Verbindung über das primäre Protokoll herstellen kann, verwendet es das sekundäre Protokoll als Fallback.
| 1 |
Plattform: Wählen Sie für Webex Connect Web, Mobil oder beides. Wählen Sie für Mobil Android, iOS oder beides. Wählen Sie für Webex Contact Center oder Webex Contact Center Enterprise entweder Web oder Mobil. |
| 2 |
Live-Chat/ In-App-Messaging: FürWebex Connect, es ist für Web und Handy verfügbar. Für Webex Contact Center oder Webex Contact Center Enterprise bietet Web Live-Chat und Mobile bietet In-App-Messaging. |
| 3 |
Primäres Transportprotokoll: Wählen Sie MQTT oder Web Socket. |
| 4 |
Sekundäres Transportprotokoll: Wählen Sie das Protokoll aus, das nicht als primär ausgewählt wurde. |
Push-Benachrichtigungen konfigurieren
Aktivieren Sie Push-Benachrichtigungen zulassen, wenn die Anwendung Benachrichtigungen über einen konfigurierten Push-Anbieter erhalten muss. Die angezeigten Benachrichtigungsbereiche hängen von der ausgewählten Plattform ab.
Die folgenden Push-Provider-Optionen sind verfügbar:
- Android: Firebase Cloud Messaging (FCM), Huawei oder beides. Gilt für Webex Contact Center und Webex Contact Center Enterprise. Webex Connect
- iOS: FCM, Apple Push Notification Service (APNS) oder Token-basierte Authentifizierung für APNS. Gilt für Webex Contact Center und Webex Contact Center Enterprise. Webex Connect
- Internet: Firebase Cloud Messaging. Gilt Webex Connect nur für.
Wählen Sie die Plattform aus und konfigurieren Sie den entsprechenden Anbieter im entsprechenden Thema.
Holen Sie sich das Firebase-Dienstkonto JSON
Webex verwendet eine JSON-Datei für ein Firebase-Dienstkonto, um Serveranfragen an Firebase Cloud Messaging zu authentifizieren. Verwenden Sie das Firebase-Projekt, das mit Ihrer Anwendung verknüpft ist.
Um das Firebase-Dienstkonto JSON abzurufen und hochzuladen:
Sicherheit: Das Firebase-Dienstkonto JSON enthält vertrauliche Anmeldeinformationen. Speichern Sie es sicher und laden Sie nur die Datei für das vorgesehene Firebase-Projekt hoch.
Anweisungen zur Konfiguration von Firebase Cloud Messaging finden Sie unter Senden einer Nachricht mithilfe der FCM-HTTP-v1-API.
| 1 |
Öffnen Sie die Firebase-Konsole und wählen Sie das Firebase-Projekt aus, das von Ihrer Anwendung verwendet wird. |
| 2 |
Öffnen Sie Projekteinstellungen > Dienstkonten. |
| 3 |
Wählen Sie Neuen privaten Schlüssel generieren und bestätigen Sie den Download. |
| 4 |
Speichern Sie die heruntergeladene JSON-Datei sicher. Die Datei enthält Zugangsdaten mit privatem Schlüssel. |
| 5 |
Laden Sie im Control Hub die JSON-Datei unter Upload Firebase Service Account JSON für die entsprechende Android-, iOS- oder Web-Benachrichtigungskonfiguration hoch. |
Android-Push-Benachrichtigungen konfigurieren
Der Abschnitt Android-Benachrichtigungen wird angezeigt, wenn Mobil, Android und Push-Benachrichtigungen zulassen ausgewählt sind. Wählen Sie mindestens einen Anbieter aus. Firebase und Huawei können einzeln oder zusammen konfiguriert werden. Diese Konfiguration ist für Webex Connect Webex Contact Center- und Webex Contact Center Enterprise Mobile-Assets verfügbar.
Anbieterdokumentation: Huawei — Push Kit einrichten und testen
| 1 |
Wählen Sie Mobil, Android und Push-Benachrichtigungen zulassen aus. Der Android-Benachrichtigungsbereich wird angezeigt. |
| 2 |
Wählen Sie Firebase Cloud Messaging und laden Sie die erforderliche JSON-Datei für das Firebase-Dienstkonto aus dem Firebase-Projekt hoch. |
| 3 |
Wenn die App Geräte unterstützt, die Huawei Mobile Services verwenden, wählen Sie Huawei aus und geben Sie die In-App-ID und den In-App-Secret von AppGallery Connect ein. Huawei-Ausnahme: Die Huawei-Konfiguration kann übersprungen werden, wenn die App Geräte ohne Google Play Services nicht unterstützt. Die aktuelle Webex Connect Anleitung unterstützt EMUI 10.x und höher. |
iOS-Push-Benachrichtigungen konfigurieren
Der Abschnitt iOS-Benachrichtigungen wird angezeigt, wenn Mobil, iOS und Push-Benachrichtigungen zulassen ausgewählt sind. Wählen Sie einen Push-Anbieter aus. Diese Konfiguration ist für Webex Connect Webex Contact Center- und Webex Contact Center Enterprise Mobile-Assets verfügbar.
Anweisungen zur Konfiguration zertifikatbasierter APNs finden Sie unter Herstellen einer zertifikatsbasierten Verbindung zu APNs.
Anweisungen zur Konfiguration von tokenbasierten APNs finden Sie unter Herstellen einer tokenbasierten Verbindung zu APNs.
| 1 |
Wählen Sie Mobil, iOS und Push-Benachrichtigungen zulassen aus. Der iOS-Benachrichtigungsbereich wird angezeigt. |
| 2 |
Wählen Sie einen Push-Anbieter aus. |
| 3 |
Laden Sie für Firebase Cloud Messaging die JSON-Datei für das Firebase-Dienstkonto hoch, die Sie vom Firebase-Projekt heruntergeladen haben. |
| 4 |
Geben Sie für den Apple Push Notification Service (APNS) das Zertifikatspasswort ein, wählen Sie Sandbox oder Production, laden Sie das APNS-Zertifikat hoch, geben Sie einen Namen ein und validieren Sie die Konfiguration. Nur das .p12-Zertifikatsformat wird unterstützt. |
| 5 |
Für die tokenbasierte APNS-Authentifizierung geben Sie die Schlüssel-ID, die Team-ID und die App-Paket- oder Bundle-ID ein, wählen Sie Sandbox oder Production aus und laden Sie die private APNS-Schlüsseldatei hoch. Gateway-Auswahl: Verwenden Sie Sandbox für eine Entwicklungs-App und Production für eine produktionsreife App. Speichern Sie den privaten APNS-Schlüssel sicher; Apple erlaubt, dass die heruntergeladene.p8-Schlüsseldatei nur einmal abgerufen wird. |
| 6 |
Ersetzen Sie das Apple-Anbieterzertifikat, bevor es abläuft, um eine Unterbrechung der Push-Lieferung zu vermeiden. |
Web-Push-Benachrichtigungen konfigurieren
Web-Push-Benachrichtigungen sind nur für Assets verfügbar, Webex Connect denen Web zugewiesen ist. Chrome und Firefox werden unterstützt. Safari Web Push wird derzeit nicht unterstützt.
Web-Push-Benachrichtigungen werden für Assets, die Webex Contact Center oder Webex Contact Center Enterprise zugewiesen sind, nicht unterstützt.
Um Web-Push-Benachrichtigungen zu konfigurieren:
| 1 |
Bestätigen Sie, dass das Asset zugewiesen ist Webex Connect und dass Web ausgewählt ist. |
| 2 |
Verwenden Sie Chrome oder Firefox, um auf die Website zuzugreifen und Web-Push-Benachrichtigungen zu erhalten. |
| 3 |
Website-URL (erforderlich): Geben Sie die URL der Website ein, die Web-Push-Benachrichtigungen erhalten soll. |
| 4 |
Benachrichtigungssymbol (erforderlich): Geben Sie den Pfad zum Benachrichtigungssymbol ein. Das Symbol muss 80 x 80 Pixel groß sein. |
| 5 |
Konfigurieren Sie Firebase Cloud Messaging (FCM) für Ihre Webanwendung, indem Sie der Firebase-Dokumentation folgen. |
| 6 |
Firebase-Dienstkonto JSON (erforderlich): Laden Sie die JSON-Datei für das Firebase-Dienstkonto hoch, die den privaten Schlüssel enthält, der für die Nutzung der Firebase Cloud Messaging-HTTP v1-API erforderlich ist. |
JSON-Web-Token-Autorisierung konfigurieren
Für die JWT-Autorisierung muss die SDK-Kommunikation mit einem gültigen JSON-Web-Token autorisiert werden. Für neue Ressourcen ist der Verschlüsselungstyp Asymmetrisch.
Die JWT-Unterstützung ist wie folgt:
- Webex Connect: Unterstützt für Mobil und Web im selben Asset.
- Webex Contact Center und Webex Contact Center Enterprise — Web: Nicht unterstützt.
- Webex Contact Center und Webex Contact Center Enterprise — Mobile: Unterstützt und erforderlich für die mobile Asset-Konfiguration.
Konfigurieren Sie die folgenden Einstellungen:
- Verschlüsselungstyp: Asymmetrisch für neue Vermögenswerte.
- Ablauf des Tokens (erforderlich): Geben Sie ein, wie lange das JWT gültig bleibt, bevor ein neues Benutzeridentität-Token erforderlich ist. Gültiger Bereich: 5—360 Minuten. Standard: 60 Minuten.
- JSON-Webschlüssel (erforderlich): Laden Sie das öffentliche JWK hoch, das zur Überprüfung der Token verwendet wird. Sie können einen zweiten Schlüssel für die Rotation hinzufügen. Maximal: zwei Schlüssel.
Fügen Sie den öffentlichen JSON-Webschlüssel hinzu und bereiten Sie ihn vor, wie in den untergeordneten Themen beschrieben.
Bereiten Sie das öffentliche JWK vor
Die hochgeladene Datei muss den öffentlichen RSA-Bestätigungsschlüssel enthalten. Webex validiert die folgenden JWK-Eigenschaften.
JWK-Eigenschaften sind in RFC 7517, Abschnitt 4 definiert. Algorithmusspezifische Eigenschaften sind in RFC 7518 definiert.
| Name der Immobilie | Beschreibung |
|---|---|
| Alg | Identifiziert den kryptografischen Algorithmus, der mit dem Schlüssel verwendet wurde. Der erforderliche Wert ist RS256, was RSASSA-PKCS1- unter Verwendung von SHA-256 angibt. v1_5 |
| e | Der Exponent für den öffentlichen RSA-Schlüssel, dargestellt als Base64URLInt-codierter Wert. |
| key_ops | Gibt den Vorgang an, für den der Schlüssel bestimmt ist. Der unterstützte Wert ist verify, was bedeutet, dass der Schlüssel zur Überprüfung digitaler Signaturen verwendet wird. Siehe RFC 7517, Abschnitt 4.3. |
| kty | Identifiziert die Familie der kryptografischen Algorithmen, die mit dem Schlüssel verwendet wurden. Der Wert muss RSA sein. Siehe RFC 7517, Abschnitt 4.1. |
| n | Der Modulus für den öffentlichen RSA-Schlüssel, dargestellt als Base64URLInt-codierter Wert. |
| verwenden | Gibt den Verwendungszweck des öffentlichen Schlüssels an. Der Wert muss sig sein, was bedeutet, dass der Schlüssel für die Signaturüberprüfung vorgesehen ist. Siehe RFC 7517, Abschnitt 4.2. |
| Kind | Identifiziert den Schlüssel und wird verwendet, um einen bestimmten Schlüssel abzugleichen, z. B. bei der Schlüsselrotation. Siehe RFC 7517, Abschnitt 4.5. |
Fügen Sie einen JSON-Webschlüssel hinzu
Um einen öffentlichen JSON-Webschlüssel hinzuzufügen:
| 1 |
Wählen Sie Schlüssel hinzufügen. |
| 2 |
Geben Sie einen JSON-Webschlüsselnamen ein. |
| 3 |
Geben Sie den JSON Web Key Issuer ein. Dieser Wert muss mit dem Aussteller übereinstimmen, den das vertrauenswürdige Backend bei der Generierung des JWT verwendet hat. |
| 4 |
Laden Sie die öffentliche JWK-Datei hoch. |
| 5 |
Wählen Sie Speichern. |
Mehrbenutzerregistrierungen konfigurieren
Aktivieren Sie die Option Mehrbenutzerregistrierungen auf demselben Gerät zulassen, wenn sich mehrere Benutzer auf demselben physischen Gerät registrieren können.
- Push-Benachrichtigungen werden sowohl für aktive als auch für inaktive registrierte Benutzer zugestellt.
- Live-Chat oder In-App-Nachrichten werden an den aktuell aktiven Benutzer gesendet. Nachrichten für inaktive Benutzer werden in die Warteschlange gestellt, bis der Benutzer wieder aktiv wird.
Zusätzliche Webex Connect Einstellungen konfigurieren
- Einzelgerät pro Benutzer: Beschränkt einen Benutzer auf ein registriertes Gerät. Durch die Registrierung auf einem neuen Gerät wird die Push-Übertragung auf das ältere Gerät beendet.
- Serverseitiger Posteingang: Speichert eine serverseitige Kopie der Posteingangsdaten zum späteren Abrufen.
- Datenstrom: Sendet entsprechende Ereignisdaten für Nachrichten, die über die Messaging-API gesendet wurden, an die gewählte Webex Connect Integration.
Speichern, um das Asset zu erstellen
Nachdem Sie das entsprechende Messaging, die JWT-Autorisierung, die Mehrbenutzerregistrierung und die Webex Connect Einstellungen konfiguriert haben, speichern Sie die Konfiguration, um das Chat-Asset zu erstellen.
|
Wählen Sie Speichern, um das Asset zu erstellen. Warten Sie auf die Bestätigung, dass das Asset erfolgreich erstellt wurde.
|
Vollständige Serviceintegration
Nachdem Sie das Chat-Asset erstellt haben, schließen Sie die Integration für den Dienst ab, den Sie unter Zuweisen an ausgewählt haben. Folgen Sie dem geltenden Verfahren für Webex Connect Webex Contact Center oder Webex Contact Center Enterprise.
Vollständige Webex Connect Integration
Füllen Sie für ein Asset, das zugewiesen Webex Connect wurde, die Servicezuweisung und die Flow-Konfiguration in abWebex Connect. Eine Node-Autorisierung ist nicht erforderlich.
Sie können einen Startknoten, ein benutzerdefiniertes Ereignis oder einen benutzerdefinierten Webhook verwenden, um eingehende Ereignisse zu erfassen und einen Flow auszulösen. Weitere Informationen finden Sie unter Startknoten, Benutzerdefiniertes Ereignis und Benutzerdefinierter Webhook.
| 1 |
Melden Sie sich an beiWebex Connect. |
| 2 |
Vervollständigen Sie die entsprechende Service-Zuordnung und Flow-Konfiguration für das Chat-Asset. |
| 3 |
Notieren Sie die generierte App-ID und den Client-Schlüssel. |
| 4 |
Laden Sie die SDK-Konfigurationsdatei für jede ausgewählte Plattform herunter. |
Vollständige Webex Contact Center-Integration
Ordnen Sie für ein Asset, das Webex Contact Center zugewiesen ist, das Asset einem Contact Center-Einstiegspunkt zu und schließen Sie dann die Webex Contact Center-Knotenautorisierung ab.
| 1 |
Öffnen Sie die Contact Center-Konfiguration in Control Hub. |
| 2 |
Erstellen oder öffnen Sie den Einstiegspunkt, der Chat-Konversationen empfängt. |
| 3 |
Wählen Sie in Flow Mapping das Chat-Asset und den erforderlichen Ablauf zur Kundeneingabe aus. |
| 4 |
Speichern Sie den Einstiegspunkt und überprüfen Sie das Asset- und Flow-Mapping. |
| 5 |
Schließen Sie die Webex Contact Center-Knotenautorisierung in Webex Connect ab. Anweisungen finden Sie unter Webex CC Task Integration Nodes and Node Authorizations. |
| 6 |
Für eine Web-Bereitstellung konfigurieren Sie das Live-Chat-Widget und rufen Sie den Einbettungscode der Website in Control Hub ab. |
Vollständige Webex Contact Center Enterprise-Integration
Für ein Asset, das Webex Contact Center Enterprise zugewiesen ist, schließen Sie die CCE-Knotenautorisierung ab, Webex Connect bevor Sie den Routing-Flow konfigurieren.
| 1 |
Melden Sie sich an beiWebex Connect. |
| 2 |
Vollständige CCE-Knotenautorisierung. Anweisungen finden Sie unter CCE-Integrationsknoten und Node-Autorisierungen. |
| 3 |
Konfigurieren Sie die entsprechenden CCE-Integrationsknoten und den Routing-Flow für das Chat-Asset. Flow-Beispiele finden Sie unter Flow-Konfigurationen. |
| 4 |
Speichern und testen Sie den Flow. |
Zusätzliche Anleitungen zur Konfiguration finden Sie unter Best Practices und Richtlinien und FAQs.
Ausnahmen und Einschränkungen
Beachten Sie die folgenden Ausnahmen und Einschränkungen:
- Bestätigen Sie den Kanal, die Plattform, die Zuweisung und die Routing-Auswahl, bevor Sie das Asset erstellen. Der Kanal kann nach der Erstellung nicht geändert werden, und Plattformänderungen sind durch die Arbeitslast begrenzt.
- Für Webex Contact Center und Webex Contact Center Enterprise kann ein einzelnes Asset Web und Mobile nicht zusammen verwenden. Erstellen Sie separate Ressourcen, wenn beide benötigt werden.
- Web-Push-Benachrichtigungen sind nur verfügbar fürWebex Connect. Safari Web Push, Webex Contact Center Web Push und Webex Contact Center Enterprise Web Push werden nicht unterstützt.
- Die JWT-Autorisierung wird für Web-Assets, die Webex Contact Center oder Webex Contact Center Enterprise zugewiesen sind, nicht unterstützt.
- Führen Sie für Webex Contact Center und Webex Contact Center Enterprise die Konfiguration von Einstiegspunkt, Flow, Widget und Embed-Code im Contact Center-Bereich von Control Hub durch.
- ZumWebex Connect, vervollständigen Sie die Service- und Flow-Konfiguration inWebex Connect.
- Löschen Sie ein Chat-Asset nicht, nachdem es einem Service zugeordnet wurde, ohne zuerst die Downstream-Zuordnung zu entfernen oder zu aktualisieren. Ein gelöschtes Asset kann nicht wiederhergestellt werden und kann dazu führen, dass ein vorhandenes Mapping unbrauchbar wird.
- Bewahren Sie nach der Erstellung die generierte App-ID, den Client-Schlüssel und die SDK-Konfigurationsdateien auf, die zur Initialisierung des entsprechenden SDK erforderlich sind.
