Konfiguriranje resursa za chat

Pregled

Upotrijebite digitalne kanale u Control Hubu za izradu i konfiguriranje resursa za chat za Web (Live Chat), Mobile (Razmjena poruka u aplikaciji) i Push obavijesti. Postavke dostupne za konfiguraciju ovise o usluzi odabranoj u odjelj ku Dodjeljivanje i odaberete li Web, Mobile ili oboje.

Ovaj članak opisuje cjelovit postupak konfiguracije imovine, uključujući podržane mogućnosti, razmjenu poruka, vjerodajnice pružatelja usluga, autorizaciju JSON web tokena (JWT), JSON web ključeve (JWK), transportne protokole, registraciju više korisnika i konfiguraciju specifičnu za uslugu nakon kreiranja sredstva.

Podržane mogućnosti

Tablica 1. Podržane mogućnosti servisa
Sposobnost	Webex Connect	Webex kontakt centar	Webex kontakt centar Enterprise
Web chat uživo	Podržano	Podržano	Podržano
Mobilna razmjena poruka u aplikaciji	Podržano	Podržano	Podržano
Web i mobilni uređaji u jednoj imovini	Podržano	Nije podržano	Nije podržano
Mobilni - Android push obavijesti	Podržano	Podržano	Podržano
Mobilni - iOS push obavijesti	Podržano	Podržano	Podržano
Web Push obavijesti	Podržano (Chrome i Firefox)	Nije podržano	Nije podržano
JWT - Mobitel	Podržano	Podržano i potrebno	Podržano i potrebno
JWT - Web	Podržano	Nije podržano	Nije podržano
Višekorisničke registracije	Podržano	Podržano	Podržano
Pristiglu poštu na strani poslužitelja	Podržano	Nije primjenjivo	Nije primjenjivo
Podatkovni tok	Podržano	Nije primjenjivo	Nije primjenjivo

Prije nego što počnete

Prijavite se u Control Hub kao potpuni administrator ili administrator kontaktnog centra koji može upravljati digitalnim sredstvima.
Osigurajte da su za organizaciju predviđene Webex Connect digitalne usluge, Webex kontakt centar ili Contact Center Enterprise. Bez prava digitalna sredstva nisu dostupna.
Identificirajte ulaznu točku i tok kontaktnog centra koji će primati nove razgovore za chat.
Ako implementacija koristi mobilne push obavijesti, pripremite vjerodajnice Firebase, Huawei ili Apple koje zahtijeva odabrana platforma.
Ako planirate koristiti JWT autorizaciju, pripremite javni JWK koji se koristi za provjeru tokena koje je izdao vaš pouzdani backend.

Konfigurirajte imovinu Chat

Da biste konfigurirali sredstvo za chat:

1	Prijavite se u Control Hub.
2	Idite na U slu ge > Digitalna sredstva.
3	Odaberite Stvori imovinu.
4	U odjeljku Konfiguriranje detalja imovine unesite sljedeće vrijednosti: Naziv (obavezno): Unesite naziv sredstva. Opis: Unesite opcijski opis slučaja upotrebe. Kanal (obavezno): Odaberite Chat. Kanal ne možete promijeniti nakon stvaranja sredstva. Dodijelite (obavezno): OdaberiteWebex Connect, Webex kontakt centar ili Webex Contact Center Enterprise. Dostupne opcije ovise o pravima organizacije.
5	U Razmjeni poruka odaberite platformu i konfigurirajte Live Chat/Razmjenu poruka unutar aplikacije i sve potrebne push obavijesti. Prikazane opcije ovise o odabranoj platformi. Postavke obavijesti za Android i iOS dostupne su kada je odabran Mobile. Web Push dostupan je kada je odabran Web za dodijeljeno sredstvoWebex Connect.

Konfigurirajte poruke

U Razmjeni poruka odaberite platformu i konfigurirajte mogućnosti razmjene poruka za sredstvo.

Da biste konfigurirali razmjenu poruka:

Primarni i sekundarni transportni protokoli moraju biti različiti. Ako SDK ne može uspostaviti vezu pomoću primarnog protokola, koristi sekundarni protokol kao rezervnu kopiju.

1	Platforma: Za Webex Connect odaberite Web, Mobile ili oboje. Za mobilne uređaje odaberite Android, iOS ili oboje. Za Webex Contact Center ili Webex Contact Center Enterprise odaberite Web ili Mobile.
2	Live Chat/Razmjena poruka u aplikaciji: ZaWebex Connect, dostupan je za web i mobilne uređaje. Za Webex kontakt centar ili Webex Contact Center Enterprise, Web pruža Live Chat, a Mobile pruža razmjenu poruka unutar aplikacije.
3	Primarni transportni protokol: Odaberite MQTT ili Web Socket.
4	Sekundarni transportni protokol: Odaberite protokol koji nije odabran kao primarni.

Konfigurirajte push obavijesti

Omoguć ite Dopusti push obavijesti kada aplikacija mora primati obavijesti putem konfiguriranog pružatelja usluga push. Prikazani odjeljci obavijesti ovise o odabranoj platformi.

Dostupne su sljedeće opcije pružatelja usluga push:

Android: Firebase Cloud Messaging (FCM), Huawei ili oboje. Odnosi se na Webex Connect Webex kontakt centar i Webex Contact Center Enterprise.
iOS: FCM, Apple Push Notification Service (APNS) ili autentifikacija temeljena na tokenima za APNS. Odnosi se na Webex Connect Webex kontakt centar i Webex Contact Center Enterprise.
Web: Firebase Cloud Messaging. Primjenjuje se Webex Connect samo na.

Odaberite platformu i konfigurirajte primjenjivog pružatelja usluga u odgovarajućoj temi.

Nabavite račun usluge Firebase JSON

Webex koristi JSON datoteku računa usluge Firebase za provjeru autentičnosti zahtjeva poslužitelja na Firebase Cloud Messaging. Koristite projekt Firebase povezan s vašom aplikacijom.

Da biste dobili i prenijeli JSON račun usluge Firebase:

Sigurnost: JSON račun usluge Firebase sadrži osjetljive vjerodajnice. Čuvajte ga sigurno i prenesite samo datoteku za predviđeni Firebase projekt.

Upute za konfiguraciju Firebase Cloud Messaging potražite u odjelj ku Slanje poruke pomoću FCM HTTP v1 API-ja.

1	Otvorite Firebase konzolu i odaberite Firebase projekt koji koristi vaša aplikacija.
2	Otvorite Postavke projekta > Servisni računi.
3	Odaberite Generiraj novi privatni ključ i potvrdite preuzimanje.
4	Sigurno pohranite preuzetu JSON datoteku. Datoteka sadrži vjerodajnice privatnog ključa.
5	U Control Hub prenesite JSON datoteku u Upload Firebase Service Account JSON za primjenjivu konfiguraciju obavijesti za Android, iOS ili Web obavijesti.

Konfigurirajte Android push obavijesti

Odjeljak Android obavijesti prikazuje se kada su odabrani Mobile, Android i Dop usti push obavijesti. Odaberite barem jednog davatelja usluga; Firebase i Huawei mogu se konfigurirati pojedinačno ili zajedno. Ova konfiguracija dostupna je za Webex Connect Webex Contact Center i Webex Contact Center Enterprise Mobile sredstva.

Dokumentacija davatelja usluga: Huawei - Postavljanje i testiranje Push Kit

1	Odaberite Mobile, Android i Dopusti push obavijesti. Prikazuje se odjeljak Android obavijesti.
2	Odaberite Firebase Cloud Messaging i prenesite potrebnu datoteku Firebase Service Account JSON iz projekta Firebase.
3	Ako aplikacija podržava uređaje koji koriste Huawei Mobile Services, odaberite Huawei i unesite ID unutar aplikacije i Tajnu u aplikaciji iz AppGallery Connect. Huawei iznimka: Huaweijeva konfiguracija može se preskočiti kada aplikacija ne po država uređaje bez Google Play usluga. Trenutne Webex Connect smjernice podrž avaju EMUI 10.x i novije verzije.

Konfigurirajte iOS push obavijesti

Odjeljak iOS obavijesti prikazuje se kada su odabrani Mobile, iOS i Dopusti push obavijesti. Odaberite jednog pružatelja usluga pritiska. Ova konfiguracija dostupna je za Webex Connect Webex Contact Center i Webex Contact Center Enterprise Mobile sredstva.

Upute za konfiguraciju APN-ova temeljene na certifikatima potražite u odjeljku Us postavljanje veze na temelju certifikata s APN-ovima.

Upute za konfiguraciju APN-ova temeljene na tokenima potražite u odjeljku Us postavljanje veze temeljene na žetonima s APN-ovima.

1	Odaberite Mobile, iOS i Dopusti push obavijesti. Prikazuje se odjeljak obavijesti o i OS-u.
2	Odaberite jednog pružatelja usluga pritiska.
3	Za Firebase Cloud Messaging prenesite JSON datoteku Firebase Service Account preuzetu iz projekta Firebase.
4	Za Apple Push Notification Service (APNS) unesite lozinku certifikata, odaberite Sandbox ili Production, prenesite APNS certifikat, unesite ime i potvrdite konfiguraciju. Podržan je jedino format certifikata .p12.
5	Za provjeru autentičnosti APNS-a temeljenu na tokenima unesite ID ključa, ID tima i ID paketa aplikacije ili paketa, odaberite Sandbox ili Production i prenesite datoteku privatnog ključa APNS-a. Odabir pristupnika: Koristite Sandbox za razvojnu aplikaciju i Produkciju za aplikaciju spremnu za proizvodnju. Sigurno pohranite privatni ključ APNS-a; Apple dopušta da se preuzeta datoteka ključa.p8 preuzme samo jednom.
6	Zamijenite Appleov certifikat davatelja usluga prije isteka kako biste izbjegli prekid isporuke.

Konfiguriranje web Push obavijesti

Web Push obavijesti dostupne su samo za sredstva dodijeljena odab Webex Connect ranom webu. Chrome i Firefox su podržani. Safari Web Push trenutno nije podržan.

Web Push obavijesti nisu podržane za sredstva dodijeljena Webex Contact Centru ili Webex Contact Center Enterprise.

Da biste konfigurirali Web Push obavijesti:

1	Potvrdite je li sredstvo dodijeljeno Webex Connect i da je odabran Web.
2	Koristite Chrome ili Firefox za pristup web mjestu i primanje Web Push obavijesti.
3	URL web stranice (obavezno): Unesite URL web stranice koja će primati Web Push obavijesti.
4	Ikona obavijesti (obavezno): Unesite put do ikone obavijesti. Ikona mora biti 80 x 80 piksela.
5	Konfigurirajte Firebase Cloud Messaging (FCM) za svoju web aplikaciju slijedeći Fire base dokumentaciju.
6	Firebase Service Account JSON (obavezno): Prenesite JSON datoteku Firebase service-account koja sadrži privatni ključ potreban za korištenje Firebase Cloud Messaging HTTP v1 API-ja.

Konfigurirajte autorizaciju JSON Web Tokena

Autorizacija JWT-a zahtijeva odobravanje SDK komunikacije pomoću važećeg JSON web tokena. Za nova sredstva vrsta šifriranja je Asimetrična.

JWT podrška je sljedeća:

Webex Connect: Podržano za mobilne uređaje i web u istoj imovini.
Webex kontakt centar i Webex Contact Center Enterprise - Web: Nije podržano.
Webex Contact Center i Webex Contact Center Enterprise - Mobile: Podržani i potrebni za konfiguraciju mobilnih sredstava.

Konfigurirajte sljedeće postavke:

Vrsta šifriranja: Asimetrična za nove imovine.
Istek tokena (obavezno): Unesite koliko dugo JWT ostaje važeći prije nego što je potreban novi token identiteta korisnika. Važeći raspon: 5-360 minuta. Zadano: 60 minuta.
JSON web ključevi (obavezno): Prenesite javni JWK koji se koristi za provjeru tokena. Možete dodati drugi ključ za rotaciju. Maksimalno: dvije tipke.

Dodajte i pripremite javni JSON web ključ kako je opisano u temama djece.

Pripremite javni JWK

Prenesena datoteka mora sadržavati javni ključ za provjeru RSA. Webex potvrđuje sljedeća svojstva JWK.

Svojstva JWK definirana su u RFC 7517, odjeljak 4. Svojstva specifična za algoritam definirana su u RFC 7518.

Tablica 2. Javne nekretnine JWK
Naziv nekretnine	Opis
alg	Identificira kriptografski algoritam koji se koristi s ključem. Potrebna vrijednost je RS256, koja određuje RSASSA-PKCS1- koristeći SHA-256. v1_5
e	Eksponent za RSA javni ključ, predstavljen kao vrijednost kodirana Base64URLUint.
key_ops	Određuje operaciju za koju je ključ namijenjen. Podržana vrijednost je potvrda, što ukazuje da se ključ koristi za provjeru digitalnih potpisa. Vidjeti RFC 7517, odjeljak 4.3.
kty	Identificira obitelj kriptografskih algoritama koja se koristi s ključem. Vrijednost mora biti RSA. Vidjeti RFC 7517, odjeljak 4.1.
n	Modul za RSA javni ključ, predstavljen kao vrijednost kodirana Base64URLUint.
upotrijebiti	Određuje namjeravanu uporabu javnog ključa. Vrijednost mora biti sig, što znači da je ključ namijenjen za provjeru potpisa. Vidjeti RFC 7517, odjeljak 4.2.
dijete	Identificira ključ i koristi se za usklađivanje određenog ključa, primjerice tijekom rotacije tipke. Vidjeti RFC 7517, odjeljak 4.5.

Prenesite samo javni ključ za provjeru. Zadržite odgovarajući privatni ključ za potpisivanje u pouzdanom sustavu koji izdaje JWT-ove.

Dodajte JSON web ključ

Da biste dodali javni JSON web ključ:

1	Odaberite Dodaj ključ.
2	Unesite naziv web ključa JSON.
3	Unesite izdavatelja web ključa JSON. Ova vrijednost mora odgovarati izdavatelju koji koristi pouzdani backend kada generira JWT.
4	Prenesite javnu datoteku JWK.
5	Odaberite Spremi.

Konfigurirajte registracije više korisnika

Omogu ći Dopusti registracije više korisnika na istom uređ aju kada se više korisnika može registrirati na istom fizičkom uređaju.

Push obavijesti isporučuju se i aktivnim i neaktivnim registriranim korisnicima.
Chat uživo ili razmjena poruka unutar aplikacije isporučuju se trenutačno aktivnom korisniku. Poruke za neaktivne korisnike čekaju se dok korisnik ponovno ne postane aktivan.

Konfigurirajte dodatne postavke Webex Connect

Sljedeće napredne postavke odnose se samo na Webex Connect sredstva i nisu primjenjive na Webex Contact Center ili Webex Contact Center Enterprise sredstva.

Jedan uređaj po korisniku: Ograničava korisnika na jedan registrirani uređaj. Registracija na novom uređaju zaustavlja isporuku push na stariji uređaj.
Pristiglu poštu na strani poslužitelja: pohranjuje kopiju podataka pristiglih poštanskih sandučića na strani poslužitelja za kasnije preuzimanje.
Podatkovni tok: šalje primjenjive podatke o događaju odabranoj Webex Connect integraciji za poruke poslane putem API-ja za razmjenu poruka.

Spremite da biste stvorili imovinu

Nakon što konfigurirate primjenjivu poruku poruka, JWT autorizaciju, registraciju više korisnika i Webex Connect postavke, spremite konfiguraciju da biste stvorili sredstvo Chat.

Odaberite S premi da biste stvorili sredstvo.

Pričekajte potvrdu da je sredstvo uspješno stvoreno.

Kompletna integracija usluge

Nakon što stvorite sredstvo za chat, dovršite integraciju usluge odabrane u odjeljku Dod jeljivanje. Slijedite primjenjivi postupak za Webex Connect Webex kontakt centar ili Webex Contact Center Enterprise.

Kompletna Webex Connect integracija

Za dodijeljeno sredstvo do Webex Connect vršite mapiranje usluge i konfiguraciju protoka uWebex Connect. Autorizacija čvora nije potrebna.

Možete koristiti Početni čvor, Prilagođeni događaj ili Prilagođeni Webhook za snimanje dolaznih događaja i pokretanje protoka. Dodatne informacije potražite u odjeljku Početni čvor, Prilagođeni događaj i Prilagođeni webhook.

1	Prijavite se naWebex Connect.
2	Dovršite primjenjivu konfiguraciju mapiranja usluga i protoka za sredstvo Chat.
3	Snimite generirani ID aplikacije i ključ klijenta.
4	Preuzmite SDK konfiguracijsku datoteku za svaku odabranu platformu.

Kompletna integracija Webex kontakt centra

Za sredstvo dodijeljeno Webex kontaktnom centru, preslikajte ga na ulaznu točku kontaktnog centra, a zatim dovršite autorizaciju čvora Webex kontaktnog centra.

Imovina se može preslikati samo na jednu ulaznu točku. Dovršite mapiranje ulazne točke i toka prije objavljivanja korisničkog iskustva.

1	Otvorite konfiguraciju Contact Center u upravljačkom čvorištu.
2	Stvorite ili otvorite ulaznu točku koja prima razgovore za chat.
3	U mapiranju proto ka odaberite sredstvo Chat i potreban tijek unosa korisnika.
4	Spremite ulaznu točku i provjerite mapiranje imovine i protoka.
5	Dovršite autorizaciju čvora Webex Contact Center u. Webex Connect Upute potražite u odjeljku Webex CC integracijski čvorovi zadataka i ovlaštenja čvorova.
6	Za web implementaciju konfigurirajte widget Live Chat i nabavite kôd za ugradnju web-mjesta u Control Hub.

Kompletna integracija Webex Contact Center Enterprise

Za sredstvo dodijeljeno Webex Contact Center Enterprise dovršite autorizaciju CCE čvora Webex Connect prije konfiguriranja toka usmjeravanja.

1	Prijavite se naWebex Connect.
2	Kompletna autorizacija CCE čvora. Upute potražite u odjeljku CCE integracijski čvorovi i ovlaštenja čvorova.
3	Konfigurirajte primjenjive CCE integracijske čvorove i tok usmjeravanja za sredstvo Chat. Primjere protoka potražite u odjeljku Konfiguracije proto ka.
4	Spremite i testirajte protok.

Dodatne smjernice za konfiguraciju potražite u odjel jku Najbolje prakse i smjernice te č esta pitanja.

Iznimke i ograničenja

Imajte na umu sljedeće iznimke i ograničenja:

Potvrdite izbor kanala, platforme, dodjele i usmjeravanja prije stvaranja sredstva. Kanal se ne može mijenjati nakon stvaranja, a promjene platforme ograničene su radnim opterećenjem.
Za Webex Contact Center i Webex Contact Center Enterprise, jedno sredstvo ne može koristiti Web i Mobile zajedno. Stvorite zasebna sredstva kada su oba potrebna.
Web Push obavijesti dostupne su samo zaWebex Connect. Safari Web Push, Webex Contact Center Web Push i Webex Contact Center Enterprise Web Push nisu podržani.
JWT autorizacija nije podržana za web-sredstva dodijeljena Webex Contact Centru ili Webex Contact Center Enterprise.
Za Webex Contact Center i Webex Contact Center Enterprise izvršite konfiguraciju ulazne točke, protoka, widgeta i ugrađenog koda u odjeljku Contact Center u upravljačkom čvorištu.
ZaWebex Connect, dovršite konfiguraciju usluge i protoka uWebex Connect.
Ne brišite imovinu Chat nakon što je preslikana na uslugu bez prethodnog uklanjanja ili ažuriranja nizvodnog mapiranja. Izbrisano sredstvo ne može se vratiti i postojeće mapiranje može ostaviti neupotrebljivim.
Nakon kreiranja zadržite generirani ID aplikacije, klijentski ključ i SDK konfiguracijske datoteke potrebne za inicijalizaciju odgovarajućeg SDK-a.

Cisco AI Assistant

Hvala na povratnim informacijama.