- Start
- /
- Artikel
Hartelijk dank voor uw feedback
In dit artikel
Feedback?Creëer en configureer een digitaal chatelement in Control Hub voor Webex Connect, Webex Contact Center of Webex Contact Center Enterprise.
Overzicht
Gebruik digitale kanalen in Control Hub om een chatitem te maken en te configureren voor webberichten (livechat), mobiele apparaten (in-app-berichten) en pushmeldingen. De instellingen die beschikbaar zijn voor de configuratie zijn afhankelijk van de service die is geselecteerd in Toewijzen aan en of u Web, Mobiel of beide selecteert.
Dit artikel beschrijft het volledige proces voor de configuratie van activa, inclusief ondersteunde mogelijkheden, berichten, inloggegevens voor push-providers, JSON Web Token (JWT) -autorisatie, JSON Web Keys (JWK's), transportprotocollen, registratie voor meerdere gebruikers en servicespecifieke configuratie nadat het item is aangemaakt.
Ondersteunde mogelijkheden
| Bekwaamheid | Webex Connect | Webex-contactcentrum | Webex Contact Center Enterprise |
|---|---|---|---|
| Live chat op het web | Ondersteund | Ondersteund | Ondersteund |
| Mobiel berichtenverkeer in de app | Ondersteund | Ondersteund | Ondersteund |
| Web en mobiel in één apparaat | Ondersteund | Niet ondersteund | Niet ondersteund |
| Mobiel - Push-meldingen voor Android | Ondersteund | Ondersteund | Ondersteund |
| Mobiel - Push-meldingen voor iOS | Ondersteund | Ondersteund | Ondersteund |
| Push-meldingen op het web | Ondersteund (Chrome en Firefox) | Niet ondersteund | Niet ondersteund |
| JWT - Mobiel | Ondersteund | Ondersteund en vereist | Ondersteund en vereist |
| JWT - Internet | Ondersteund | Niet ondersteund | Niet ondersteund |
| Registraties voor meerdere gebruikers | Ondersteund | Ondersteund | Ondersteund |
| Inbox aan de serverzijde | Ondersteund | Niet van toepassing | Niet van toepassing |
| Datastream | Ondersteund | Niet van toepassing | Niet van toepassing |
Voordat u begint
- Meld u aan bij Control Hub als volledige beheerder of als beheerder van een contactcenter die digitale activa kan beheren.
- Zorg ervoor dat Webex Connect digitale services, Webex Contact Center of Contact Center Enterprise beschikbaar zijn voor de organisatie. Zonder het recht zijn digitale activa niet beschikbaar.
- Identificeer het contactcentrum en de flow die nieuwe chatgesprekken zullen ontvangen.
- Als de implementatie gebruikmaakt van mobiele pushmeldingen, bereid dan de Firebase-, Huawei- of Apple-inloggegevens voor die vereist zijn voor het geselecteerde platform.
- Als u van plan bent om JWT-autorisatie te gebruiken, bereid dan de openbare JWK voor die wordt gebruikt om de tokens te verifiëren die zijn uitgegeven door uw vertrouwde backend.
Configureer het Chat-item
Om een Chat-item te configureren:
| 1 |
Meld u aan bij Control Hub. |
| 2 |
Ga naar Services > Digital Assets. |
| 3 |
Selecteer Create asset. |
| 4 |
Voer in Assetgegevens configureren de volgende waarden in:
|
| 5 |
Selecteer in Messaging het platform en configureer Live Chat/In-App Messaging en eventuele vereiste pushmeldingen. De weergegeven opties zijn afhankelijk van het geselecteerde platform. De meldingsinstellingen voor Android en iOS zijn beschikbaar wanneer Mobiel is geselecteerd. Web Push is beschikbaar wanneer Web is geselecteerd voor een item dat is toegewezen aanWebex Connect. |
Berichten configureren
Selecteer in Messaging het platform en configureer de berichtenmogelijkheden voor het bedrijfsmiddel.
Om de berichtgeving te configureren:
De primaire en secundaire transportprotocollen moeten verschillend zijn. Als de SDK geen verbinding kan maken met behulp van het primaire protocol, wordt het secundaire protocol gebruikt als noodoplossing.
| 1 |
Platform: VoorWebex Connect, selecteer Web, Mobiel of beide. Voor mobiele apparaten selecteert u Android, iOS of beide. Voor Webex Contact Center of Webex Contact Center Enterprise selecteert u Web of Mobile. |
| 2 |
Livechat/berichten in de app: VoorWebex Connect, het is beschikbaar voor het web en mobiel. Voor Webex Contact Center of Webex Contact Center Enterprise biedt Web livechat en Mobile biedt in-app-berichten. |
| 3 |
Primair transportprotocol: Selecteer MQTT of Web Socket. |
| 4 |
Secundair transportprotocol: Selecteer het protocol dat niet als primair is geselecteerd. |
Pushmeldingen configureren
Schakel Pushmeldingen toestaan in wanneer de toepassing meldingen moet ontvangen via een geconfigureerde pushprovider. De weergegeven meldingsgedeelten zijn afhankelijk van het geselecteerde platform.
De volgende opties voor pushproviders zijn beschikbaar:
- Android: Firebase Cloud Messaging (FCM), Huawei of beide. Van toepassing Webex Connect op Webex Contact Center en Webex Contact Center Enterprise.
- iOS: FCM, Apple Push Notification Service (APNS) of authenticatie op basis van tokens voor APNS. Van toepassing Webex Connect op Webex Contact Center en Webex Contact Center Enterprise.
- Internet: Firebase Cloud Messaging. Webex ConnectAlleen van toepassing op.
Selecteer het platform en configureer de toepasselijke provider in het betreffende onderwerp.
Verkrijg het Firebase Service Account (JSON)
Webex gebruikt een JSON-bestand voor een Firebase-serviceaccount om serveraanvragen voor Firebase Cloud Messaging te verifiëren. Gebruik het Firebase-project dat aan uw toepassing is gekoppeld.
Om het Firebase Service Account (JSON) op te halen en te uploaden:
Beveiliging: De JSON-serviceaccount van Firebase bevat gevoelige inloggegevens. Sla het veilig op en upload alleen het bestand voor het beoogde Firebase-project.
Zie Een bericht verzenden via de FCM HTTP v1 API voor de configuratie-instructies van Firebase Cloud Messaging.
| 1 |
Open de Firebase-console en selecteer het Firebase-project dat door uw toepassing wordt gebruikt. |
| 2 |
Open Projectinstellingen > Serviceaccounts. |
| 3 |
Selecteer Nieuwe privésleutel genereren en bevestig de download. |
| 4 |
Sla het gedownloade JSON-bestand veilig op. Het bestand bevat inloggegevens met een persoonlijke sleutel. |
| 5 |
Upload in Control Hub het JSON-bestand in Upload Firebase Service Account (JSON) voor de toepasselijke configuratie voor Android-, iOS- of webmeldingen. |
Pushmeldingen voor Android configureren
De sectie Android-meldingen wordt weergegeven wanneer Mobiel, Android en Pushmeldingen toestaan zijn geselecteerd. Selecteer minstens één provider; Firebase en Huawei kunnen afzonderlijk of samen worden geconfigureerd. Deze configuratie is beschikbaar voor Webex Connect Webex Contact Center en Webex Contact Center Enterprise Mobile assets.
Documentatie van de provider: Huawei - Push Kit installeren en testen
| 1 |
Selecteer Mobiel, Android en Pushmeldingen toestaan. Het gedeelte met Android-meldingen wordt weergegeven. |
| 2 |
Selecteer Firebase Cloud Messaging en upload het vereiste JSON-bestand voor de Firebase Service Account van het Firebase-project. |
| 3 |
Als de app apparaten ondersteunt die gebruikmaken van Huawei Mobile Services, selecteer dan Huawei en voer de in-app-ID en het In-app Secret in via AppGallery Connect. Huawei-uitzondering: de Huawei-configuratie kan worden overgeslagen als de app geen ondersteuning biedt voor apparaten zonder Google Play-services. De huidige Webex Connect richtlijnen ondersteunen EMUI 10.x en hoger. |
Pushmeldingen voor iOS configureren
De sectie iOS-meldingen wordt weergegeven wanneer Mobiel, iOS en Pushmeldingen toestaan zijn geselecteerd. Selecteer één pushprovider. Deze configuratie is beschikbaar voor Webex Connect Webex Contact Center en Webex Contact Center Enterprise Mobile assets.
Voor instructies voor de configuratie van APN's op basis van certificaten, zie Een op certificaten gebaseerde verbinding met APN's tot stand brengen.
Voor instructies voor het configureren van APN's op basis van tokens, zie Een op tokens gebaseerde verbinding met APN's tot stand brengen.
| 1 |
Selecteer Mobiel, iOS en Pushmeldingen toestaan. Het gedeelte met iOS-meldingen wordt weergegeven. |
| 2 |
Selecteer één pushprovider. |
| 3 |
Upload voor Firebase Cloud Messaging het JSON-bestand van de Firebase Service Account dat u van het Firebase-project hebt gedownload. |
| 4 |
Voer voor Apple Push Notification Service (APNS) het certificaatwachtwoord in, selecteer Sandbox of Production, upload het APNS-certificaat, voer een naam in en valideer de configuratie. Alleen het .p12-certificaatformaat wordt ondersteund. |
| 5 |
Voor APNS-verificatie op basis van tokens voert u de sleutel-ID, de team-ID en het pakket- of bundel-ID van de app in, selecteert u Sandbox of Production en uploadt u het APNS-bestand met de privésleutel. Gateway-selectie: gebruik Sandbox voor een ontwikkelingsapp en Productie voor een app die klaar is voor productie . Sla de persoonlijke APNS-sleutel veilig op; Apple staat toe dat het gedownloade .p8-sleutelbestand slechts één keer wordt opgehaald. |
| 6 |
Vervang het Apple providercertificaat voordat het verloopt om te voorkomen dat de levering wordt onderbroken. |
Push-meldingen op het web configureren
Push-meldingen op het web zijn alleen beschikbaar voor items die zijn toegewezen Webex Connect aan wie Web is geselecteerd. Chrome en Firefox worden ondersteund. Safari Web Push wordt momenteel niet ondersteund.
Push-meldingen op het web worden niet ondersteund voor middelen die zijn toegewezen aan Webex Contact Center of Webex Contact Center Enterprise.
Om pushmeldingen via het web te configureren:
| 1 |
Bevestig dat het item is toegewezen aan Webex Connect en dat Web is geselecteerd. |
| 2 |
Gebruik Chrome of Firefox om toegang te krijgen tot de website en om webpushmeldingen te ontvangen. |
| 3 |
Website-URL (vereist): Voer de URL in van de website die webpushmeldingen zal ontvangen. |
| 4 |
Meldingspictogram (vereist): Voer het pad naar het meldingspictogram in. Het pictogram moet 80 x 80 pixels zijn. |
| 5 |
Configureer Firebase Cloud Messaging (FCM) voor uw webtoepassing door de Firebase-documentatie te volgen. |
| 6 |
Firebase Service Account JSON (vereist): Upload het JSON-bestand voor de Firebase-serviceaccount dat de privésleutel bevat die vereist is voor het gebruik van de Firebase Cloud Messaging HTTP v1 API. |
Autorisatie voor JSON-webtokens configureren
Voor JWT-autorisatie moet SDK-communicatie worden geautoriseerd met een geldig JSON-webtoken. Voor nieuwe middelen is het coderingstype asymmetrisch.
De ondersteuning van JWT is als volgt:
- Webex Connect: Ondersteund voor mobiel en internet in hetzelfde apparaat.
- Webex Contact Center en Webex Contact Center Enterprise - Web: niet ondersteund.
- Webex Contact Center en Webex Contact Center Enterprise - Mobile: ondersteund en vereist voor de configuratie van mobiele bedrijfsmiddelen.
Configureer de volgende instellingen:
- Coderingstype: Asymmetrisch voor nieuwe middelen.
- Vervaldatum van het token (vereist): Voer in hoe lang de JWT geldig blijft voordat een nieuw gebruikersidentiteitstoken vereist is. Geldig bereik: 5-360 minuten. Standaard: 60 minuten.
- JSON-websleutels (vereist): Upload de openbare JWK die wordt gebruikt om tokens te verifiëren. U kunt een tweede sleutel toevoegen om te roteren. Maximaal: twee sleutels.
Voeg de openbare JSON-websleutel toe en bereid deze voor, zoals beschreven in de onderliggende onderwerpen.
Bereid het publiek voor, JWK
Het geüploade bestand moet de openbare RSA-verificatiesleutel bevatten. Webex valideert de volgende JWK-eigenschappen.
De eigenschappen van JWK zijn gedefinieerd in RFC 7517, sectie 4. Algoritme-specifieke eigenschappen zijn gedefinieerd in RFC 7518.
| Naam van de accommodatie | Beschrijving |
|---|---|
| alg | Identificeert het cryptografische algoritme dat met de sleutel wordt gebruikt. De vereiste waarde is RS256, wat RSASSA-PKCS1- specificeert met behulp van SHA-256. v1_5 |
| e | De exponent voor de openbare RSA-sleutel, weergegeven als een waarde die is gecodeerd met Base64URLuint. |
| key_ops | Specificeert de bewerking waarvoor de sleutel bedoeld is. De ondersteunde waarde is verify, wat aangeeft dat de sleutel wordt gebruikt om digitale handtekeningen te verifiëren. Zie RFC 7517, paragraaf 4.3. |
| sleutel | Identificeert de familie van cryptografische algoritmen die met de sleutel wordt gebruikt. De waarde moet RSA zijn. Zie RFC 7517, paragraaf 4.1. |
| n | De modulus voor de openbare RSA-sleutel, weergegeven als een waarde die is gecodeerd met Base64URLuint. |
| gebruik | Specificeert het beoogde gebruik van de openbare sleutel. De waarde moet sig zijn, wat aangeeft dat de sleutel bedoeld is voor de verificatie van de handtekening. Zie RFC 7517, paragraaf 4.2. |
| kind | Identificeert de sleutel en wordt gebruikt om een specifieke sleutel te matchen, bijvoorbeeld tijdens het draaien van de toets. Zie RFC 7517, paragraaf 4.5. |
Een JSON-websleutel toevoegen
Om een openbare JSON-websleutel toe te voegen:
| 1 |
Selecteer Sleutel toevoegen. |
| 2 |
Voer de naam van een JSON-websleutel in. |
| 3 |
Voer de JSON Web Key Issuer in. Deze waarde moet overeenkomen met de uitgever die door de vertrouwde backend werd gebruikt bij het genereren van de JWT. |
| 4 |
Upload het openbare JWK-bestand. |
| 5 |
Selecteer Opslaan. |
Registraties voor meerdere gebruikers configureren
Schakel registraties van meerdere gebruikers op hetzelfde apparaat toestaan wanneer meerdere gebruikers zich op hetzelfde fysieke apparaat kunnen registreren.
- Pushmeldingen worden verzonden voor zowel actieve als inactieve geregistreerde gebruikers.
- Livechat of berichten in de app worden verzonden naar de gebruiker die momenteel actief is. Berichten voor inactieve gebruikers worden in de wachtrij geplaatst totdat de gebruiker weer actief wordt.
Aanvullende Webex Connect instellingen configureren
- Eén apparaat per gebruiker: beperkt een gebruiker tot één geregistreerd apparaat. Als u zich registreert op een nieuw apparaat, wordt de verzending naar het oudere apparaat stopgezet.
- Inbox aan de serverzijde: slaat een kopie van de gegevens in de inbox op die u later kunt ophalen.
- Datastream: Stuurt toepasselijke gegevens van gebeurtenissen naar de geselecteerde Webex Connect integratie voor berichten die via de Messaging API worden verzonden.
Opslaan om de asset te creëren
Nadat u de toepasselijke Messaging-, JWT-autorisatie, registratie voor meerdere gebruikers en Webex Connect instellingen hebt geconfigureerd, slaat u de configuratie op om het Chat-item te maken.
|
Selecteer Opslaan om het item aan te maken. Wacht op de bevestiging dat het item met succes is aangemaakt.
|
Volledige service-integratie
Nadat u het chatelement hebt gemaakt, voltooit u de integratie voor de service die is geselecteerd in Assign to. Volg de toepasselijke procedure voor Webex Connect Webex Contact Center of Webex Contact Center Enterprise.
Volledige Webex Connect integratie
Voor een item dat is toegewezen aanWebex Connect, vult u de service mapping en de stroomconfiguratie inWebex Connect. Autorisatie van knooppunten is niet vereist.
U kunt een startknooppunt, aangepaste gebeurtenis of aangepaste webhook gebruiken om binnenkomende gebeurtenissen vast te leggen en een flow te activeren. Zie Start Node, Custom Event en Custom Webhook voor meer informatie.
| 1 |
Meld u aan bijWebex Connect. |
| 2 |
Voltooi de toepasselijke service mapping en flowconfiguratie voor het Chat-item. |
| 3 |
Noteer de gegenereerde app-ID en clientsleutel. |
| 4 |
Download het SDK-configuratiebestand voor elk geselecteerd platform. |
Volledige integratie met Webex Contact Center
Voor een item dat is toegewezen aan Webex Contact Center, moet u het bedrijfsmiddel toewijzen aan een contactcentrumtoegangspunt en vervolgens de autorisatie van het Webex Contact Center-knooppunt voltooien.
| 1 |
Open de configuratie van het contactcentrum in Control Hub. |
| 2 |
Creëer of open het startpunt dat chatgesprekken ontvangt. |
| 3 |
Selecteer in Flow Mapping het chatitem en de vereiste stroom voor het invoeren van klanten. |
| 4 |
Sla het toegangspunt op en controleer de toewijzing van bedrijfsmiddelen en stromen. |
| 5 |
Voltooi de autorisatie van het Webex Contact Center-knooppunt inWebex Connect. Zie Webex CC Task Integration Nodes and Node Authorizations voor instructies. |
| 6 |
Configureer voor een webimplementatie de Live Chat-widget en verkrijg de invoegcode van de website in Control Hub. |
Volledige integratie met Webex Contact Center Enterprise
Voor een item dat is toegewezen aan Webex Contact Center Enterprise, moet u de autorisatie van het CCE-knooppunt voltooien Webex Connect voordat u de routeringsstroom configureert.
| 1 |
Meld u aan bijWebex Connect. |
| 2 |
Volledige autorisatie van het CCE-knooppunt. Voor instructies, zie CCE Integration Nodes and Node Authorizations. |
| 3 |
Configureer de toepasselijke CCE-integratieknooppunten en de routeringsstroom voor het Chat-item. |
| 4 |
Sla de flow op en test deze. |
Zie Beste praktijken en richtlijnen en veelgestelde vragen voor meer informatie over de configuratie.
Uitzonderingen en beperkingen
Houd rekening met de volgende uitzonderingen en beperkingen:
- Bevestig de keuze voor het kanaal, het platform, de toewijzing en de routering voordat u het item aanmaakt. Het kanaal kan niet worden gewijzigd nadat het is gemaakt, en wijzigingen in het platform worden beperkt door de werkbelasting.
- Voor Webex Contact Center en Webex Contact Center Enterprise kan niet één asset web en mobiel tegelijk gebruiken. Creëer afzonderlijke activa wanneer beide nodig zijn.
- Push-meldingen op het web zijn alleen beschikbaar voorWebex Connect. Safari Web Push, Webex Contact Center Web Push en Webex Contact Center Enterprise Web Push worden niet ondersteund.
- JWT-autorisatie wordt niet ondersteund voor webassets die zijn toegewezen aan Webex Contact Center of Webex Contact Center Enterprise.
- Voer voor Webex Contact Center en Webex Contact Center Enterprise de configuratie van het toegangspunt, de flow, de widget en de embedcode uit in het Contact Center-gedeelte van Control Hub.
- VoorWebex Connect, voltooi de service- en stroomconfiguratie inWebex Connect.
- Verwijder een chatitem niet nadat het is toegewezen aan een service zonder eerst de downstream-toewijzing te verwijderen of bij te werken. Een verwijderd item kan niet worden hersteld en kan een bestaande kaart onbruikbaar maken.
- Bewaar na het aanmaken de gegenereerde app-ID, clientsleutel en SDK-configuratiebestanden die nodig zijn om de juiste SDK te initialiseren.
