Konfigurere et chataktiv

Oversigt

Brug digitale kanaler i Control Hub til at oprette og konfigurere et chataktiv til web (live chat), mobil (beskeder i appen) og push-meddelelser. De indstillinger, der er tilgængelige for konfiguration, afhænger af den tjeneste, der er valgt i Tildel til, og om du vælger Web, Mobil eller begge dele.

Denne artikel beskriver den komplette aktivkonfigurationsproces, herunder understøttede funktioner, meddelelser, push-udbyderlegitimationsoplysninger, JWT-godkendelse (JSON Web Token), JSON Web Keys (JWK), transportprotokoller, registrering af flere brugere og servicespecifik konfiguration, efter at aktivet er oprettet.

Understøttede funktioner

Tabel 1. Understøttede funktioner efter service
Kapacitet	Webex Connect	Webex kontaktcenter	Webex Contact Center Enterprise
Live chat på nettet	Understøttet	Understøttet	Understøttet
Mobilbeskeder i appen	Understøttet	Understøttet	Understøttet
Web og mobil i et enkelt aktiv	Understøttet	Ikke understøttet	Ikke understøttet
Mobil - Android push-meddelelser	Understøttet	Understøttet	Understøttet
Mobil - iOS push-meddelelser	Understøttet	Understøttet	Understøttet
Web Push-underretninger	Understøttet (Chrome og Firefox)	Ikke understøttet	Ikke understøttet
JWT - Mobil	Understøttet	Understøttet og påkrævet	Understøttet og påkrævet
JWT - Web	Understøttet	Ikke understøttet	Ikke understøttet
Flerbrugerregistreringer	Understøttet	Understøttet	Understøttet
Indbakke på serversiden	Understøttet	Ikke relevant	Ikke relevant
Datastrøm	Understøttet	Ikke relevant	Ikke relevant

Før du begynder

Log på Control Hub som fuld administrator eller Contact Center-administrator, der kan administrere digitale aktiver.
Sørg for, at Webex Connect digitale tjenester, Webex Contact Center eller Contact Center Enterprise er klargjort til organisationen. Uden retten er digitale aktiver ikke tilgængelige.
Identificer kontaktcenterindgangspunktet og flowet, der vil modtage nye chat samtaler.
Hvis implementeringen bruger mobile push-meddelelser, skal du forberede de Firebase-, Huawei- eller Apple- legitimationsoplysninger, der kræves af den valgte platform.
Hvis du planlægger at bruge JWT-godkendelse, skal du forberede den offentlige JWK, der bruges til at bekræfte de tokens, der er udstedt af din betroede backend.

Konfigurer chataktivet

Sådan konfigureres et chataktiv:

1	Log ind på Control Hub.
2	Gå til Services > Digitale aktiver.
3	Vælg Opret aktiv.
4	Angiv følgende værdier i Konfigurer aktivoplysninger: Navn (påkrævet): Angiv et aktivnavn. Beskrivelse: Angiv en valgfri beskrivelse af brugssagen. Kanal (påkrævet): Vælg Chat. Du kan ikke ændre kanalen, når aktivet er oprettet. Tildel til (påkrævet): VælgWebex Connect, Webex Contact Center eller Webex Contact Center Enterprise. De tilgængelige indstillinger afhænger af organisationens rettigheder.
5	I Beskeder skal du vælge platformen og konfigurere Live Chat/In-App Messaging og eventuelle nødvendige push-meddelelser. De viste indstillinger afhænger af den valgte platform. Android- og iOS-underretningsindstillinger er tilgængelige, når Mobil er valgt. Web Push er tilgængelig, når Web er valgt for et aktiv, der er tildeltWebex Connect.

Konfigurer beskeder

I Beskeder skal du vælge platformen og konfigurere meddelelsesfunktionerne for aktivet.

Sådan konfigurerer du beskeder:

De primære og sekundære transportprotokoller skal være forskellige. Hvis SDK'en ikke kan oprette en forbindelse ved hjælp af den primære protokol, bruger den den sekundære protokol som en nødløsning.

1	Platform: Vælg Web, Mobil eller begge dele. Webex Connect For mobil skal du vælge Android, iOS eller begge dele. For Webex Contact Center eller Webex Contact Center Enterprise skal du vælge enten Web eller Mobil.
2	Live Chat/Beskeder i appen: TilWebex Connect, den er tilgængelig til web og mobil. For Webex Contact Center eller Webex Contact Center Enterprise leverer Web Live Chat og Mobile leverer meddelelser i appen.
3	Primær transportprotokol: Vælg MQTT eller Web Socket.
4	Sekundær transportprotokol: Vælg den protokol, der ikke er valgt som primær.

Konfigurer push-meddelelser

Aktiv ér Tillad push-meddelelser, når applikationen skal modtage underretninger via en konfigureret push-udbyder. De viste meddelelsessektioner afhænger af den valgte platform.

Følgende push-udbyderindstillinger er tilgængelige:

Android: Firebase Cloud Messaging (FCM), Huawei eller begge dele. Gælder forWebex Connect, Webex Contact Center og Webex Contact Center Enterprise.
iOS: FCM, Apple Push Notification Service (APNS) eller tokenbaseret godkendelse til APNS. Gælder forWebex Connect, Webex Contact Center og Webex Contact Center Enterprise.
Web: Firebase Cloud Messaging. Gælder Webex Connect kun for.

Vælg platformen og konfigurer den relevante udbyder i det tilsvarende emne.

Hent Firebase-servicekontoen JSON

Webex bruger en JSON-fil til Firebase-tjenestekonto til at godkende serveranmodninger til Firebase Cloud Messaging. Brug det Firebase-projekt, der er knyttet til din applikation.

Sådan hentes og uploades Firebase-servicekontoens JSON:

Sikkerhed: Firebase-tjenestekontoen JSON indeholder følsomme legitimationsoplysninger. Gem det sikkert, og upload kun filen til det tilsigtede Firebase-projekt.

Du kan finde konfigurationsinstruktioner for Firebase Cloud Messaging under Send en meddelelse ved hjælp af FCM HTTP v1 API.

1	Åbn Firebase-konsollen, og vælg det Firebase-projekt, der bruges af dit program.
2	Åbn Projektindstillinger > Servicekonti.
3	Vælg Generer ny privat nø gle, og bekræft overførslen.
4	Gem den downloadede JSON-fil sikkert. Filen indeholder legitimationsoplysninger til private nøgler.
5	I Control Hub skal du uploade JSON-filen i Upload Firebase Service-konto JSON til den relevante Android-, iOS- eller webmeddelelseskonfiguration.

Konfigurer Android push-meddelelser

Android-meddelelsessektionen vises, når Mobile, Android og Tillad push- meddelelser er valgt. Vælg mindst én udbyder; Firebase og Huawei kan konfigureres individuelt eller sammen. Denne konfiguration er tilgængelig for Webex Connect Webex Contact Center og Webex Contact Center Enterprise Mobile-aktiver.

Udbyderdokumentation: Huawei - Opsætning og test af Push Kit

1	Vælg Mobil, Android og Tillad push-meddelelser. Android-meddelelsessektionen vises.
2	Vælg Firebase Cloud Messaging, og upload den krævede JSON -fil til Firebase Service Account fra Firebase-projektet.
3	Hvis appen understøtter enheder, der bruger Huawei Mobile Services, skal du vælge Huawei og indtaste ID- et i appen og hemmeligheden i appen fra AppGallery Connect. Huawei-undtagelse: Huawei-konfiguration kan springes over, når appen ikke understøtter enheder uden Google Play Services. Nuværende Webex Connect vejledning understøtter EMUI 10.x og nyere.

Konfigurer iOS-push-meddelelser

iOS-meddelelsessektionen vises, når Mobil-, iOS- og Tillad push-meddelelser er valgt. Vælg en push-udbyder. Denne konfiguration er tilgængelig for Webex Connect Webex Contact Center og Webex Contact Center Enterprise Mobile-aktiver.

Du kan finde instruktioner til konfiguration af certifikatbaserede APN'er under Oprettelse af en certifikat baseret forbindelse til APN'er.

For tokenbaserede APN'er konfigurationsinstruktioner, se Oprettelse af en tokenbaseret forbindelse til APN'er.

1	Vælg Mobil, iOS og Tillad push-meddelelser. iOS-meddelelsessektionen vises.
2	Vælg en push-udbyder.
3	For Firebase Cloud Messaging skal du uploade JSON-filen til Firebase Service Account, der er downloadet fra Firebase-projektet.
4	For Apple Push Notification Service (APNS) skal du indtaste certifikatadgangskoden, vælge Sandkasse eller Produktion, uploade APNS-certifikatet, angive et navn og validere konfigurationen . Kun certifikatformatet .p12 understøttes.
5	For tokenbaseret APNS-godkendelse skal du indtaste nøgle-id'et, team-id'et og apppakken eller bundt-id'et, vælge Sandkasse eller Produktion og uploade APNS-filen med privat nøgle. Valg af gateway: Brug Sandbox til en udviklingsapp og Produktion til en produktionsklar app. Gem den private APNS-nøgle sikkert; Apple tillader kun, at den downloadede .p8-nøglefil hentes én gang.
6	Udskift Apple-udbydercertifikatet, før det udløber, for at undgå afbrydelse af push-levering.

Konfigurer Web Push-underretninger

Web Push-meddelelser er kun tilgængelige for aktiver, der er tildelt Webex Connect med Web valgt. Chrome og Firefox understøttes. Safari Web Push understøttes ikke i øjeblikket.

Web Push-meddelelser understøttes ikke for aktiver, der er tildelt Webex Contact Center eller Webex Contact Center Enterprise.

Sådan konfigureres Web Push-underretninger:

1	Bekræft, at aktivet er tildelt, Webex Connect og at Web er valgt.
2	Brug Chrome eller Firefox til at få adgang til webstedet og modtage Web Push-underretninger.
3	Websteds-URL (påkrævet): Indtast webadressen på det websted, der vil modtage Web Push-underretninger.
4	Meddelelsesikon (påkrævet): Indtast stien til meddelelsesikonet. Ikonet skal være 80 x 80 pixels.
5	Konfigurer Firebase Cloud Messaging (FCM) til din webapplikation ved at følge Fire base-dokumentationen.
6	Firebase Service-konto JSON (påkrævet): Upload JSON-filen til Firebase-servicekontoen, der indeholder den private nøgle, der kræves for at bruge Firebase Cloud Messaging HTTP v1 API.

Konfigurer JSON Web Token-godkendelse

JWT-godkendelse kræver, at SDK-kommunikation godkendes ved hjælp af et gyldigt JSON Web Token. For nye aktiver er krypteringstypen asymmetrisk.

JWT support er som følger:

Webex Connect: Understøttet til mobil og web i det samme aktiv.
Webex Contact Center og Webex Contact Center Enterprise - Web: Understøttes ikke.
Webex Contact Center og Webex Contact Center Enterprise - Mobile: Understøttes og kræves til konfigurationen af mobilaktivet.

Konfigurer følgende indstillinger:

Krypteringstype: Asymmetrisk for nye aktiver.
Token udløb (påkrævet): Angiv, hvor længe JWT forbliver gyldig, før der kræves et nyt brugeridentitetstoken. Gyldigt interval: 5-360 minutter. Standard: 60 minutter.
JSON Web Keys (påkrævet): Upload den offentlige JWK, der bruges til at bekræfte tokens. Du kan tilføje en anden nøgle til rotation. Maksimum: to nøgler.

Tilføj og klargør den offentlige JSON-webnøgle som beskrevet i de underordnede emner.

Forbered den offentlige JWK

Den uploadede fil skal indeholde den offentlige RSA-bekræftelsesnøgle. Webex validerer følgende JWK-egenskaber.

JWK-egenskaber er defineret i RFC 7517, afsnit 4. Algoritme-specifikke egenskaber er defineret i RFC 7518.

Tabel 2. Offentlige JWK ejendomme
Ejendomsnavn	Beskrivelse
alg	Identificerer den kryptografiske algoritme, der bruges sammen med nøglen. Den krævede værdi er RS256, som specificerer RSASSA-PKCS1- ved hjælp af SHA-256. v1_5
e	Eksponenten for den offentlige RSA-nø gle, repræsenteret som en Base64URLuint-kodet værdi.
key_ops	Angiver den handling, som nøglen er beregnet til. Den understøttede værdi bekræftes, hvilket angiver, at nøglen bruges til at verificere digitale signaturer. Se RFC 7517, afsnit 4.3.
kty	Identificerer den kryptografiske algoritmefamilie, der bruges sammen med nøglen. Værdien skal være RSA. Se RFC 7517, afsnit 4.1.
n	Modulet for den offentlige RSA-nø gle, repræsenteret som en Base64URLuint-kodet værdi.
anvendelse	Angiver den tilsigtede anvendelse af den offentlige nøgle. Værdien skal være sig, hvilket angiver, at nøglen er beregnet til signaturverifikation. Se RFC 7517, afsnit 4.2.
barn	Identificerer nøglen og bruges til at matche en bestemt nøgle, f.eks. under nøglerotation. Se RFC 7517, afsnit 4.5.

Upload kun den offentlige bekræftelsesnøgle. Gem den tilsvarende private signeringsnøgle i det betroede system, der udsteder JWT'er.

Tilføj en JSON-webnøgle

Sådan tilføjer du en offentlig JSON-webnøgle:

1	Vælg Tilføj nøgle.
2	Indtast et JSON-webnøglenavn.
3	Indtast JSON-webnøgleudstederen. Denne værdi skal matche den udsteder, der bruges af den betroede backend, når den genererer JWT.
4	Upload den offentlige JWK-fil.
5	Vælg Gem.

Konfigurer flerbrugerregistreringer

Aktiv ér Tillad flere brugerregistreringer på samme enhed, når flere brugere kan registrere sig på den samme fysiske enhed.

Push-underretninger leveres til både aktive og inaktive registrerede brugere.
Live Chat eller In-App Messaging leveres til den aktuelt aktive bruger. Meddelelser til inaktive brugere står i kø, indtil brugeren bliver aktiv igen.

Konfigurer yderligere Webex Connect -indstillinger

Følgende avancerede indstillinger gælder kun for Webex Connect aktiver og gælder ikke for Webex Contact Center eller Webex Contact Center Enterprise-aktiver.

Enkelt enhed pr. bruger: Begrænser en bruger til én registreret enhed. Registrering på en ny enhed stopper push-levering til den ældre enhed.
Indbakke på serversiden: Gemmer en kopi af indbakkedata på serversiden til senere hentning.
Datastrøm: Sender relevante hændelsesdata til den valgte Webex Connect integration for meddelelser sendt via Messaging API.

Gem for at oprette aktivet

Når du har konfigureret den relevante Messaging, JWT-godkendelse, flerbrugerregistrering og Webex Connect indstillinger, skal du gemme konfigurationen for at oprette chataktivet.

Vælg Gem for at oprette aktivet.

Vent på bekræftelse af, at aktivet blev oprettet med succes.

Komplet serviceintegration

Når du har oprettet chataktivet, skal du fuldføre integrationen for den tjeneste, der er valgt i Tildel til. Følg den gældende procedure forWebex Connect, Webex Contact Center eller Webex Contact Center Enterprise.

Komplet Webex Connect integration

For et aktiv, der er tildelt tilWebex Connect, skal du fuldføre tjenestekortlægningen og flowkonfigurationen iWebex Connect. Nodegodkendelse er ikke påkrævet.

Du kan bruge en startnode, brugerdefineret begivenhed eller brugerdefineret webhook til at fange indgående begivenheder og udløse et flow. Du kan finde flere oplysninger under Startnode, Bruger defineret begivenhed og Bruger defineret webhook.

1	Log ind påWebex Connect.
2	Fuldfør den relevante tjenestekortlægning og flowkonfiguration for chataktivet.
3	Optag det genererede app-id og klientnøgle.
4	Download SDK-konfigurationsfilen for hver valgt platform.

Komplet Webex Contact Center-integration

For et aktiv, der er tildelt Webex Contact Center, skal du knytte aktivet til et kontaktcenterindgangspunkt og derefter fuldføre Webex Contact Center-nodegodkendelse.

Et aktiv kan kun knyttes til ét indgangspunkt. Gennemfør indgangspunktet og flowkortlægningen, før du offentliggør kundeoplevelsen.

1	Åbn Contact Center- konfigurationen i Control Hub.
2	Opret eller åbn det indgangspunkt, der modtager chatsamtaler.
3	Vælg chataktivet og det ønskede kundeindtastnings flow i Flowkortlægning.
4	Gem indgangspunktet, og kontroller aktiv- og flowkortlægningen.
5	Fuldfør Webex Contact Center-nodegodkendelse iWebex Connect. Du kan finde instruktioner i Webex CC-noder til opgaveintegration og nodegodkendelser.
6	For en webudvikling skal du konfigurere widgeten Live Chat og hente webstedets integreringskode i Control Hub.

Komplet Webex Contact Center Enterprise-integration

For et aktiv, der er tildelt Webex Contact Center Enterprise, skal du fuldføre CCE-nodegodkendelse, Webex Connect før du konfigurerer routingsflowet.

1	Log ind påWebex Connect.
2	Fuldfør CCE-nodegodkendelse. Du kan finde instruktioner i CCE-integrationsnoder og nodegodkendelser.
3	Konfigurer de relevante CCE-integrationsnoder og routingflow for chataktivet. For floweksempler, se F lowkonfigurationer.
4	Gem og test flowet.

For yderligere konfigurationsvejledning, se Bedste fremgangsmåder og retningslinjer og ofte stillede spørgsmål.

Undtagelser og begrænsninger

Husk følgende undtagelser og begrænsninger:

Bekræft valg af kanal, platform, tildeling og routing, før du opretter aktivet. Kanalen kan ikke ændres efter oprettelse, og platformændringer er begrænset af arbejdsbyrden.
For Webex Contact Center og Webex Contact Center Enterprise kan et enkelt aktiv ikke bruge Web og Mobile sammen. Opret separate aktiver, når begge er påkrævet.
Web Push-underretninger er kun tilgængelige forWebex Connect. Safari Web Push, Webex Contact Center Web Push og Webex Contact Center Enterprise Web Push understøttes ikke.
JWT-godkendelse understøttes ikke for webaktiver, der er tildelt Webex Contact Center eller Webex Contact Center Enterprise.
For Webex Contact Center og Webex Contact Center Enterprise skal du udføre konfiguration af indgangspunkt, flow, widget og indlejringskode i afsnittet Contact Center i Control Hub.
TilWebex Connect, fuldfør service- og flowkonfigurationen iWebex Connect.
Du må ikke slette et chataktiv, når det er knyttet til en tjeneste, uden først at fjerne eller opdatere downstream-tilknytningen. Et slettet aktiv kan ikke gendannes og kan efterlade en eksisterende tilknytning ubrugelig.
Efter oprettelsen skal du bevare det genererede app-id, klientnøgle og SDK-konfigurationsfiler, der kræves for at initialisere den relevante SDK.

Cisco AI Assistant

Tak for din feedback.