Konfigurere en chat-ressurs

Oversikt

Bruk digitale kanaler i Control Hub til å opprette og konfigurere en chat-ressurs for Internett (Live Chat), Mobil (Meldinger i appen) og Push-varsler. Hvilke innstillinger som er tilgjengelige for konfigurasjon, avhenger av tjenesten som er valgt i Tilordne til, og om du velger Web, Mobil eller begge deler.

Denne artikkelen beskriver den komplette konfigurasjonsprosessen for eiendeler, inkludert støttede funksjoner, meldinger, push-leverandørlegitimasjon, JSON Web Token (JWT) -autorisasjon, JSON Web Keys (JWK), transportprotokoller, flerbrukerregistrering og tjenestespesifikk konfigurasjon etter at eiendelen er opprettet.

Støttede funksjoner

Tabell 1. Støttede funksjoner etter tjeneste
Evne	Webex Connect	Webex kontaktsenter	Webex Contact Center Enterprise
Live Chat på nettet	Støttet	Støttet	Støttet
Mobil Meldinger i appen	Støttet	Støttet	Støttet
Nett og mobil i én ressurs	Støttet	Støttes ikke	Støttes ikke
Mobil - Android push-varsler	Støttet	Støttet	Støttet
Mobil - iOS push-varsler	Støttet	Støttet	Støttet
Web Push-varsler	Støttet (Chrome og Firefox)	Støttes ikke	Støttes ikke
JWT - Mobil	Støttet	Støttet og påkrevd	Støttet og påkrevd
JWT - Internett	Støttet	Støttes ikke	Støttes ikke
Flerbrukerregistreringer	Støttet	Støttet	Støttet
Innboks på serversiden	Støttet	Ikke aktuelt	Ikke aktuelt
Datastrøm	Støttet	Ikke aktuelt	Ikke aktuelt

Før du begynner

Logg på Control Hub som fullverdig administrator eller Contact Center-administrator som kan administrere digitale ressurser.
Kontroller at Webex Connect digitale tjenester, Webex Contact Center eller Contact Center Enterprise er klargjort for organisasjonen. Uten rettigheten er digitale eiendeler ikke tilgjengelige.
Identifiser kontaktsenterets inngangspunkt og flyt som vil motta nye chat- samtaler.
Hvis distribusjonen bruker mobile push-varsler, klargjør du Firebase-, Huawei- eller Apple- legitimasjonen som kreves av den valgte plattformen.
Hvis du planlegger å bruke JWT-autorisasjon, må du forberede den offentlige JWK som brukes til å bekrefte tokens utstedt av din pålitelige backend.

Konfigurere Chat-ressursen

Slik konfigurerer du en chat-ressurs:

1	Logg på Control Hub.
2	Gå til T jenester > Digitale eiendeler.
3	Velg Opprett ressurs.
4	I Konfigurer ressursdetaljer angir du følgende verdier: Navn (påkrevd): Angi et ressursnavn. Beskrivelse: Angi en valgfri beskrivelse av brukstilfelle. Kanal (påkrevd): Velg Chat. Du kan ikke endre kanalen etter at ressursen er opprettet. Tilordne til (påkrevd): VelgWebex Connect, Webex Contact Center eller Webex Contact Center Enterprise. De tilgjengelige alternativene avhenger av organisasjonens rettigheter.
5	I Meldinger velger du plattformen og konfigurerer Live Chat/Meldinger i appen og eventuelle nødvendige push-varsler. Alternativene som vises, avhenger av den valgte plattformen. Varslingsinnstillinger for Android og iOS er tilgjengelige når Mobil er valgt. Web Push er tilgjengelig når Web er valgt for en ressurs som er tilordnet tilWebex Connect.

Konfigurer meldinger

I Meldinger velger du plattformen og konfigurerer meldingsfunksjonene for eiendelen.

Slik konfigurerer du meldinger:

De primære og sekundære transportprotokollene må være forskjellige. Hvis SDK-en ikke kan opprette en tilkobling ved hjelp av primærprotokollen, bruker den den sekundære protokollen som en tilbakestilling.

1	Plattform: ForWebex Connect, velg Web, Mobil eller begge deler. For mobil velger du Android, iOS eller begge deler. For Webex Contact Center eller Webex Contact Center Enterprise velger du enten Web eller Mobil.
2	Live Chat/Meldinger i appen: ForWebex Connect, den er tilgjengelig for nett og mobil. For Webex Contact Center eller Webex Contact Center Enterprise tilbyr Web Live Chat og Mobile gir meldinger i appen.
3	Primær transportprotokoll: Velg MQTT eller Web Socket.
4	Sekundær transportprotokoll: Velg protokollen som ikke er valgt som primær.

Konfigurer push-varsler

Akti ver Tillat push-varsler når applikasjonen må motta varsler gjennom en konfigurert push-leverandør. Varslingsdelene som vises, avhenger av den valgte plattformen.

Følgende push-leverandøralternativer er tilgjengelige:

Android: Firebase Cloud Messaging (FCM), Huawei eller begge deler. Gjelder forWebex Connect, Webex Contact Center og Webex Contact Center Enterprise.
iOS: FCM, Apple Push Notification Service (APNS) eller tokenbasert godkjenning for APNS. Gjelder forWebex Connect, Webex Contact Center og Webex Contact Center Enterprise.
Nett: Firebase Cloud Messaging. Gjelder Webex Connect bare.

Velg plattformen og konfigurer gjeldende leverandør i det tilsvarende emnet.

Skaff deg Firebase-tjenestekontoen JSON

Webex bruker en JSON-fil for Firebase-tjenestekonto for å godkjenne serverforespørsler til Firebase Cloud Messaging. Bruk Firebase-prosjektet som er knyttet til applikasjonen din.

Slik henter du og laster opp Firebase Service Account JSON:

Sikkerhet: Firebase-tjenestekontoen JSON inneholder sensitiv legitimasjon. Lagre den sikkert og last opp bare filen for det tiltenkte Firebase-prosjektet.

Hvis du vil ha konfigurasjonsinstruksjoner for Firebase Cloud Messaging, kan du se Sende en melding ved hjelp av FCM HTTP v1 API.

1	Åpne Firebase-konsollen og velg Firebase-prosjektet som brukes av applikasjonen din.
2	Åpne Prosjektinnstillinger > Tjenestekontoer.
3	Velg Generer ny privat nøkkel, og bekreft nedlastingen.
4	Lagre den nedlastede JSON-filen sikkert. Filen inneholder legitimasjon for private nøkler.
5	Last opp JSON-filen i Last opp Firebase-tjenestekonto JSON i Control Hub for gjeldende Android-, iOS- eller nettvarslingskonfigurasjon.

Konfigurer Android-push-varsler

Android-varslingsdelen vises når Mobil, Android og Tillat push- varsler er valgt. Velg minst én leverandør; Firebase og Huawei kan konfigureres individuelt eller sammen. Denne konfigurasjonen er tilgjengelig for Webex Connect Webex Contact Center og Webex Contact Center Enterprise Mobile-ressurser.

Leverandørdokumentasjon: Huawei - Push Kit oppsett og testing

1	Velg Mobil, Android og Tillat push-varsler. Android-varslingsdelen vises.
2	Velg Firebase Cloud Messaging og last opp den nødvendige JSON -filen for Firebase Service Account fra Firebase-prosjektet.
3	Hvis appen støtter enheter som bruker Huawei Mobile Services, velger du Huawei og skriver inn ID-en i appen og hemmeligheten i appen fra AppGallery Connect. Huawei-unntak: Huawei-konfigurasjonen kan hoppes over når appen ikke støtter enheter uten Google Play Services. Gjel Webex Connect dende veiledning støtter EMUI 10.x og nyere.

Konfigurer iOS-push-varsler

iOS-varslingsdelen vises når Mobil-, iOS- og Tillat push-varsler er valgt. Velg en push-leverandør. Denne konfigurasjonen er tilgjengelig for Webex Connect Webex Contact Center og Webex Contact Center Enterprise Mobile-ressurser.

Hvis du vil ha instruksjoner for konfigurasjon av sertifikatbaserte APN-er, kan du se Etablere en sertifikat basert tilkobling til APN-er.

Hvis du vil ha konfigurasjonsinstruksjoner for tokenbaserte APN-er, kan du se Etab lere en tokenbasert tilkobling til APN-er.

1	Velg Mobil, iOS og Tillat push-varsler. iOS-varslingsdelen vises.
2	Velg en push-leverandør.
3	For Firebase Cloud Messaging, last opp JSON-filen for Firebase Service Account som er lastet ned fra Firebase-prosjektet.
4	For Apple Push Notification Service (APNS) angir du sertifikatpassordet, velger Sandkasse eller Produksjon, laster opp APNS-sertifikatet, skriver inn et navn og validerer konfigurasjonen . Bare sertifikatformatet .p12 støttes.
5	For tokenbasert APNS-godkjenning angir du nøkkel-ID, team-ID og apppakke- eller pakke- ID, velger Sandkasse eller Produksjon og laster opp APNS-filen med privat nøkkel. Gateway-valg: Bruk Sandbox for en utviklingsapp og Produksjon for en produksjonsklar app. Lagre den private APNS-nøkkelen på en sikker måte. Apple tillater at den nedlastede .p8-nøkkelfilen bare hentes én gang.
6	Bytt ut Apple-leverandørsertifikatet før det utløper for å unngå avbrudd i push-leveransen.

Konfigurer Web Push-varsler

Web Push-varsler er bare tilgjengelige for ressurser som er til Webex Connect ordnet med Web valgt. Chrome og Firefox støttes. Safari Web Push støttes ikke for øyeblikket.

Web Push-varsler støttes ikke for ressurser som er tilordnet Webex Contact Center eller Webex Contact Center Enterprise.

Slik konfigurerer du Web Push-varsler:

1	Bekreft at ressursen er tilordnet Webex Connect og at Web er valgt.
2	Bruk Chrome eller Firefox for å få tilgang til nettstedet og motta Web Push-varsler.
3	Nettstedsnettadresse (påkrevd): Skriv inn nettadressen til nettstedet som vil motta Web Push-varsler.
4	Varslingsikon (påkrevd): Skriv inn banen til varslingsikonet. Ikonet må være 80 x 80 piksler.
5	Konfigurer Firebase Cloud Messaging (FCM) for webapplikasjonen din ved å følge Fire base-dokumentasjonen.
6	Firebase-tjenestekonto JSON (påkrevd): Last opp JSON-filen for Firebase-tjenestekontoen som inneholder den private nøkkelen som kreves for å bruke Firebase Cloud Messaging HTTP v1 API.

Konfigurer JSON Web Token-autorisasjon

JWT-autorisasjon krever at SDK-kommunikasjon skal autoriseres ved hjelp av en gyldig JSON Web Token. For nye eiendeler er krypteringstypen asymmetrisk.

JWT-støtte er som følger:

Webex Connect: Støttes for mobil og nett i samme ressurs.
Webex Contact Center og Webex Contact Center Enterprise - Web: Støttes ikke.
Webex Contact Center og Webex Contact Center Enterprise - Mobile: Støttes og kreves for konfigurasjonen av mobilressursen.

Konfigurer følgende innstillinger:

Krypteringstype: Asymmetrisk for nye eiendeler.
Token Utløp (påkrevd): Angi hvor lenge JWT forblir gyldig før et nytt brukeridentitetstoken kreves. Gyldig rekkevidde: 5-360 minutter. Standard: 60 minutter.
JSON Web Keys (påkrevd): Last opp den offentlige JWK som brukes til å bekrefte tokens. Du kan legge til en ny nøkkel for rotering. Maksimum: to nøkler.

Legg til og klargjør den offentlige JSON-nettnøkkelen som beskrevet i underordnede emner.

Forbered den offentlige JWK

Den opplastede filen må inneholde den offentlige RSA-verifiseringsnøkkelen. Webex validerer følgende JWK-egenskaper.

JWK-egenskaper er definert i RFC 7517, avsnitt 4. Algoritme-spesifikke egenskaper er definert i RFC 7518.

Tabell 2. Offentlige JWK-eiendommer
Eiendomsnavn	Beskrivelse
alg	Identifiserer den kryptografiske algoritmen som brukes med nøkkelen. Den nødvendige verdien er RS256, som spesifiserer RSASSA-PKCS1- ved hjelp av SHA-256. v1_5
e	Eksponenten for den offentlige RSA-nøkkel en, representert som en Base64URLuint-kodet verdi.
key_ops	Angir operasjonen som nøkkelen er beregnet på. Den støttede verdien er verifisert, noe som indikerer at nøkkelen brukes til å verifisere digitale signaturer. Se RFC 7517, avsnitt 4.3.
kty	Identifiserer kryptografiske algoritmefamilien som brukes sammen med nøkkelen. Verdien må være RSA. Se RFC 7517, avsnitt 4.1.
n	Modulen for den offentlige RSA-nøkkel en, representert som en Base64URLuint-kodet verdi.
bruk	Angir den tiltenkte bruken av den offentlige nøkkelen. Verdien må være sig, noe som indikerer at nøkkelen er beregnet for signaturverifisering. Se RFC 7517, avsnitt 4.2.
kid	Identifiserer nøkkelen og brukes til å matche en bestemt nøkkel, for eksempel under nøkkelrotasjon. Se RFC 7517, avsnitt 4.5.

Last opp bare den offentlige verifiseringsnøkkelen. Behold den tilsvarende private signeringsnøkkelen i det klarerte systemet som utsteder JWT-er.

Legg til en JSON-webnøkkel

Slik legger du til en offentlig JSON-nettnøkkel:

1	Velg Legg til nøkkel.
2	Skriv inn et JSON-webnøkkelnavn.
3	Skriv inn JSON-nettnøkkelutstederen. Denne verdien må samsvare med utstederen som brukes av den klarerte backend når den genererer JWT.
4	Last opp den offentlige JWK-filen.
5	Velg Lagre.

Konfigurer flerbrukerregistreringer

Akti ver Tillat flerbrukerregistreringer på samme enhet når flere brukere kan registrere seg på samme fysiske enhet.

Push-varsler leveres for både aktive og inaktive registrerte brukere.
Live Chat eller Meldinger i appen leveres til den aktive brukeren. Meldinger for inaktive brukere står i kø til brukeren blir aktiv igjen.

Konfigurer tilleggsinn Webex Connect stillinger

Følgende avanserte innstillinger gjelder bare for Webex Connect ressurser og gjelder ikke Webex Contact Center eller Webex Contact Center Enterprise-ressurser.

Enkel enhet per bruker: Begrenser en bruker til én registrert enhet. Registrering på en ny enhet stopper push-levering til den eldre enheten.
Innboks på serversiden: Lagrer en kopi av innboksdata på serversiden for senere henting.
Datastrøm: Sender gjeldende hendelsesdata til den valgte Webex Connect integrasjonen for meldinger sendt via Messaging API.

Lagre for å opprette ressursen

Når du har konfigurert gjeldende Meldinger, JWT-autorisasjon, flerbrukerregistrering og Webex Connect innstillinger, lagrer du konfigurasjonen for å opprette Chat-ressursen.

Velg Lagre for å opprette ressursen.

Vent på bekreftelse på at eiendelen ble opprettet vellykket.

Komplett tjenesteintegrasjon

Etter at du har opprettet Chat-ressursen, fullfører du integreringen for tjenesten som er valgt i Tilordne til. Følg gjeldende prosedyre forWebex Connect, Webex Contact Center eller Webex Contact Center Enterprise.

Fullstendig Webex Connect integrasjon

For en ressurs som er tilordnet tilWebex Connect, fullfør tjenestekartlegging og flytkonfigurasjon iWebex Connect. Node autorisasjon er ikke nødvendig.

Du kan bruke en startnode, egendefinert hendelse eller tilpasset webhook for å fange innkommende hendelser og utløse en flyt. Hvis du vil ha mer informasjon, kan du se Start node, Custom Event og Custom Webhook.

1	Logg påWebex Connect.
2	Fullfør gjeldende tjenestekartlegging og flytkonfigurasjon for Chat-ressursen.
3	Registrer den genererte app-ID-en og klientnøkkelen.
4	Last ned SDK-konfigurasjonsfilen for hver valgt plattform.

Komplett Webex Contact Center-integrasjon

For en ressurs som er tilordnet Webex Contact Center, tilordner du ressursen til et kontaktsenterinngangspunkt og fullfører deretter Webex Contact Center-nodegodkjenning.

En ressurs kan tilordnes til bare ett inngangspunkt. Fullfør inngangspunktet og flytkartleggingen før du publiserer kundeopplevelsen.

1	Åpne Contact Center- konfigurasjonen i Control Hub.
2	Opprett eller åpne inngangspunktet som mottar Chat-samtaler.
3	I Fly ttilordning velger du Chat-ressursen og ønsket kundeoppføringsfly t.
4	Lagre inngangspunktet og bekreft ressurs- og flyttilordningen.
5	Fullfør Webex Contact Center-nodeautorisasjon iWebex Connect. Hvis du vil ha instruksjoner, kan du se Webex CC-oppgaveintegreringsnoder og nodeautorisasjoner.
6	For en webdistribusjon konfigurerer du Live Chat-widgeten og henter nettstedets innebyggingskode i Control Hub.

Komplett Webex Contact Center Enterprise-integrasjon

For en ressurs som er tilordnet Webex Contact Center Enterprise, fullfør CCE-nodeautorisasjon Webex Connect før du konfigurerer rutingsflyten.

1	Logg påWebex Connect.
2	Fullfør CCE-nodeautorisasjon. Hvis du vil ha instruksjoner, kan du se CCE-integreringsnoder og nodeautorisasjoner.
3	Konfigurer gjeldende CCE-integreringsnoder og rutingsflyt for Chat-ressursen. For flyteksempler, se Fly tkonfigurasjoner.
4	Lagre og test flyten.

For ytterligere konfigurasjonsveiledning, se Beste fremgangsmåter og retningslinjer og vanlige spørsmål.

Unntak og begrensninger

Husk følgende unntak og begrensninger:

Bekreft valg av kanal, plattform, tildeling og ruting før du oppretter ressursen. Kanalen kan ikke endres etter opprettelsen, og plattformendringer er begrenset av arbeidsmengde.
For Webex Contact Center og Webex Contact Center Enterprise kan ikke en enkelt ressurs bruke Internett og mobil sammen. Opprett separate eiendeler når begge er påkrevd.
Web Push-varsler er bare tilgjengelige forWebex Connect. Safari Web Push, Webex Contact Center Web Push og Webex Contact Center Enterprise Web Push støttes ikke.
JWT-autorisasjon støttes ikke for webressurser som er tilordnet Webex Contact Center eller Webex Contact Center Enterprise.
For Webex Contact Center og Webex Contact Center Enterprise, utfør konfigurasjon av inngangspunkt, flyt, widget og innebygde koder i Kontaktsenter-delen av Control Hub.
ForWebex Connect, fullfør service- og flytkonfigurasjonen iWebex Connect.
Ikke slett en Chat-ressurs etter at den er tilordnet til en tjeneste uten først å fjerne eller oppdatere nedstrøms kartlegging. En slettet ressurs kan ikke gjenopprettes, og en eksisterende tilordning kan være ubrukelig.
Etter opprettelsen beholder du de genererte App-ID-, klientnøkkel- og SDK-konfigurasjonsfilene som kreves for å initialisere riktig SDK.

Cisco AI Assistant

Takk for tilbakemeldingen.