Configurarea unui element de chat

Prezentare generală

Utilizați canalele digitale în Control Hub pentru a crea și configura un element de chat pentru Web (Chat live), mobil (mesagerie în aplicație) și notificări push. Setările disponibile pentru configurare depind de serviciul selectat în Atribuire către și dacă selectați Web, Mobil sau ambele.

Acest articol descrie procesul complet de configurare a activelor, inclusiv capabilități acceptate, mesagerie, acreditări furnizor push, autorizare JSON Web Token (JWT), chei web JSON (JWK), protocoale de transport, înregistrare multi-utilizator și configurație specifică serviciului după crearea activului.

Capacități acceptate

Tabelul 1. Capacități acceptate în funcție de serviciu
Capacitate	Webex Connect	Centrul de contact Webex	Centrul de contact Webex Enterprise
Chat Live Web	Sprijinit	Sprijinit	Sprijinit
Mesagerie mobilă în aplicație	Sprijinit	Sprijinit	Sprijinit
Web și mobil într-un singur activ	Sprijinit	Nu este acceptat	Nu este acceptat
Mobil - notificări push Android	Sprijinit	Sprijinit	Sprijinit
Mobil - notificări push iOS	Sprijinit	Sprijinit	Sprijinit
Notificări Web Push	Acceptate (Chrome și Firefox)	Nu este acceptat	Nu este acceptat
JWT - Mobil	Sprijinit	Sprijinit și necesar	Sprijinit și necesar
JWT - site-uri web	Sprijinit	Nu este acceptat	Nu este acceptat
Înregistrări multi-utilizator	Sprijinit	Sprijinit	Sprijinit
Inbox pe partea serverului	Sprijinit	Nu se aplică	Nu se aplică
Fluxul de date	Sprijinit	Nu se aplică	Nu se aplică

Înainte de a începe

Conectați-vă la Control Hub ca administrator complet sau administrator al Centrului de contact care poate gestiona activele digitale.
Asigurați-vă că serviciile Webex Connect digitale, Centrul de contact Webex sau Contact Center Enterprise sunt furnizate pentru organizație. Fără dreptul, activele digitale nu sunt disponibile.
Identificați punctul de intrare și fluxul de contact Center care vor primi noi conversații de chat.
Dacă implementarea utilizează notificări push mobile, pregătește acreditările Firebase, Huawei sau Apple solicitate de platforma selectată.
Dacă intenționați să utilizați autorizația JWT, pregătiți JWK-ul public utilizat pentru a verifica jetoanele emise de backend-ul dvs. de încredere.

Configurarea activului de chat

Pentru a configura un element de chat:

1	Conectați-vă la Control Hub.
2	Accesați Servicii > Active digitale.
3	Selectați Creare material.
4	În Configurare detalii despre material, introduceți următoarele valori: Nume (obligatoriu): Introduceți un nume de activ. Descriere: Introduceți o descriere opțională a cazului de utilizare. Canal (obligatoriu): Selectați Chat. Nu puteți schimba canalul după crearea materialului. Atribuiți la (obligatoriu): Selec Webex Connect tați, Centrul de contact Webex sau Webex Contact Center Enterprise. Opțiunile disponibile depind de drepturile organizației.
5	În Mesagerie, selectați platforma și configurați Live Chat /In-App Messaging și orice notificări push necesare. Opțiunile afișate depind de platforma selectată. Setările de notificare Android și iOS sunt disponibile atunci când este selectat Mobil. Web Push este disponibil atunci când Web este selectat pentru un element atribuitWebex Connect.

Configurați mesageria

În Mesagerie, selectați platforma și configurați capacitățile de mesagerie pentru activ.

Pentru a configura mesageria:

Protocoalele de transport primar și secundar trebuie să fie diferite. Dacă SDK-ul nu poate stabili o conexiune utilizând protocolul primar, acesta utilizează protocolul secundar ca rezervă.

1	Platformă: PentruWebex Connect, selectați Web, Mobil sau ambele. Pentru mobil, selectați Android, iOS sau ambele. Pentru Centrul de contact Webex sau Webex Contact Center Enterprise, selectați Web sau Mobile.
2	Chat live/mesagerie în aplicație: PentruWebex Connect, este disponibil pentru web și mobil. Pentru Centrul de contact Webex sau Webex Contact Center Enterprise, Web oferă Live Chat, iar Mobile oferă mesagerie în aplicație.
3	Protocol principal de transport: Selectați MQTT sau Web Socket.
4	Protocol de transport secundar: Selectați protocolul care nu este selectat ca primar.

Configurați notificările push

Activați Permiteți notificările push atunci când aplicația trebuie să primească notificări printr-un furnizor push configurat. Secțiunile de notificare afișate depind de platforma selectată.

Sunt disponibile următoarele opțiuni de furnizor push:

Android: Firebase Cloud Messaging (FCM), Huawei sau ambele. Se aplică laWebex Connect, Centrul de contact Webex și Centrul de contact Webex Enterprise.
iOS: FCM, Apple Push Notification Service (APNS) sau autentificare bazată pe token pentru APNS. Se aplică laWebex Connect, Centrul de contact Webex și Centrul de contact Webex Enterprise.
Web: Mesagerie Firebase Cloud. Se aplică Webex Connect numai.

Selectați platforma și configurați furnizorul aplicabil în subiectul corespunzător.

Obțineți contul de serviciu Firebase JSON

Webex utilizează un fișier JSON al contului de serviciu Firebase pentru autentificarea solicitărilor de server către Firebase Cloud Messaging. Utilizați proiectul Firebase asociat aplicației dvs.

Pentru a obține și încărca JSON pentru contul de serviciu Firebase:

Securitate: contul de serviciu Firebase JSON conține acreditări sensibile. Stocați-l în siguranță și încărcați numai fișierul pentru proiectul Firebase dorit.

Pentru instrucțiunile de configurare Firebase Cloud Messaging, consultați Trimiterea unui mesaj utilizând API-ul FCM HTTP v1.

1	Deschideți consola Firebase și selectați proiectul Firebase utilizat de aplicația dvs.
2	Deschideți Setări proiect > Con turi de servicii.
3	Selec tați Generați o nouă cheie privată și confirmați descărcarea.
4	Stocați fișierul JSON descărcat în siguranță. Fișierul conține acreditări cu cheie privată.
5	În Control Hub, încărcați fișierul JSON în Încăr cați contul de serviciu Firebase JSON pentru configurația aplicabilă de notificare Android, iOS sau Web.

Configurați notificările push Android

Secțiunea de notificare Android este afișată atunci când sunt selectate Mobile, Android și Per mite notificări push. Selectați cel puțin un furnizor; Firebase și Huawei pot fi configurate individual sau împreună. Această configurație este disponibilă pentru Webex Connect acti vele Webex Contact Center și Webex Contact Center Enterprise Mobile.

Documentația furnizorului: Huawei - Configurarea și testarea kitului Push

1	Selectați Mobil, Android și Permiteți notificările push. Este afișată secțiunea de notificare Android.
2	Selectați Firebase Cloud Messaging și încărcați fișierul JSON necesar Firebase Service Account din proiectul Firebase.
3	Dacă aplicația acceptă dispozitive care utilizează Huawei Mobile Services, selectați Huawei și introduceți ID- ul în aplicație și Secretul în aplicație din AppGallery Connect. Excepție Huawei: configurația Huawei poate fi omisă atunci când aplicația nu acceptă dispozitive fără Servicii Google Play. Ghi Webex Connect dul curent acceptă EMUI 10.x și versiuni ulterioare.

Configurați notificările push iOS

Secțiunea de notificare iOS este afișată atunci când sunt selectate Mobile, iOS și Permite notificări push. Selectați un furnizor push. Această configurație este disponibilă pentru Webex Connect acti vele Webex Contact Center și Webex Contact Center Enterprise Mobile.

Pentru instrucțiuni de configurare APN-uri bazate pe certificate, consultați Stabilirea unei conexiuni bazate pe certificate la APN-uri.

Pentru instrucțiuni de configurare APN-uri bazate pe token, consultați Stabilirea unei conexiuni bazate pe token la APN-uri.

1	Selectați Mobil, iOS și Permiteți notificările push. Este afișată secțiunea de notificare iOS.
2	Selectați un furnizor push.
3	Pentru Firebase Cloud Messaging, încărcați fișierul JSON al contului de serviciu Firebase descărcat din proiectul Firebase.
4	Pentru Serviciul de notificare push Apple (APNS), introduceți parola certificatului, selectați Sandbox sau Producție, încărcați certificatul APNS, introduceți un nume și validați configurația . Numai formatul certificatului.p12 este acceptat.
5	Pentru autentificarea APNS bazată pe token, introduceți ID-ul cheii, ID-ul echipei și ID-ul pachetului de aplicație sau pachet, selectați Sandbox sau Production și încărcați fișierul cheie privată APNS. Selectarea gateway-ului: Utilizați Sandbox pentru o aplicație de dezvoltare și Production pentru o aplicație pregătită pentru producție. Stocați cheia privată APNS în siguranță; Apple permite ca fișierul cheie descărcat .p8 să fie recuperat o singură dată.
6	Înlocuiți certificatul furnizorului Apple înainte de expirarea acestuia pentru a evita întreruperea livrării push.

Configurați notificările Web Push

Notificările Web Push sunt disponibile numai pentru activele atribuite Webex Connect cu Web selectat. Chrome și Firefox sunt acceptate. Safari Web Push nu este acceptat momentan.

Notificările Web Push nu sunt acceptate pentru activele atribuite Centrului de contact Webex sau Webex Contact Center Enterprise.

Pentru a configura notificările Web Push:

1	Confirmați că activul este atribuit Webex Connect și că Web este selectat.
2	Utilizați Chrome sau Firefox pentru a accesa site-ul web și a primi notificări Web Push.
3	Adresa URL a site-ului web (obligatoriu): Introduceți adresa URL a site-ului web care va primi notificări Web Push.
4	Pictograma de notificare (obligatoriu): Introduceți calea către pictograma de notificare. Pictograma trebuie să fie de 80 x 80 pixeli.
5	Configurați Firebase Cloud Messaging (FCM) pentru aplicația dvs. web urmând documentația Fire base.
6	Cont de serviciu Firebase JSON (obligatoriu): Încărcați fișierul JSON al contului de serviciu Firebase care conține cheia privată necesară pentru a utiliza API-ul Firebase Cloud Messaging HTTP v1.

Configurați autorizarea JSON Web Token

Autorizarea JWT necesită ca comunicarea SDK să fie autorizată utilizând un token web JSON valid. Pentru activele noi, tipul de criptare este asimetric.

Suportul JWT este după cum urmează:

Webex Connect: Suportat pentru mobil și web în același material.
Centrul de contact Webex și Centrul de contact Webex Enterprise - Web: Nu este acceptat.
Centrul de contact Webex și Webex Contact Center Enterprise - Mobile: acceptate și necesare pentru configurația activelor mobile.

Configurați următoarele setări:

Tip de criptare: Asimetric pentru active noi.
Expirarea jetonului (obligatoriu): Introduceți cât timp rămâne valabil JWT înainte ca un nou token de identitate de utilizator să fie necesar. Interval valabil: 5-360 minute. Implicit: 60 minute.
Chei Web JSON (obligatoriu): Încărcați JWK-ul public utilizat pentru verificarea jetoanelor. Puteți adăuga o a doua cheie pentru rotație. Maxim: două chei.

Adăugați și pregătiți cheia web JSON publică așa cum este descris în subiectele copil.

Pregătiți JWK public

Fișierul încărcat trebuie să conțină cheia publică de verificare RSA. Webex validează următoarele proprietăți JWK.

Proprietățile JWK sunt definite în RFC 7517, secțiunea 4. Proprietățile specifice algoritmului sunt definite în RFC 7518.

Tabelul 2. Proprietăți publice JWK
Denumirea proprietății	Descriere
alg	Identifică algoritmul criptografic utilizat cu cheia. Valoarea necesară este RS256, care specifică RSASSA-PKCS1- folosind SHA-256. v1_5
e	Exponentul pentru cheia publică RSA, reprezentat ca o valoare codificată Base64URLuint.
key_ops	Specifică operația pentru care este destinată cheia. Valoarea acceptată este verificată, indicând faptul că cheia este utilizată pentru verificarea semnăturilor digitale. A se vedea RFC 7517, secțiunea 4.3.
kty	Identifică familia de algoritmi criptografice utilizate împreună cu cheia. Valoarea trebuie să fie RSA. A se vedea RFC 7517, secțiunea 4.1.
n	Modulul pentru cheia publică RSA, reprezentat ca o valoare codificată Base64URLuint.
folosire	Specifică utilizarea intenționată a cheii publice. Valoarea trebuie să fie sig, indicând faptul că cheia este destinată verificării semnăturii. A se vedea RFC 7517, punctul 4.2.
puști	Identifică cheia și este utilizată pentru a se potrivi cu o cheie specifică, cum ar fi în timpul rotației cheii. A se vedea RFC 7517, secțiunea 4.5.

Încărcați numai cheia de verificare publică. Păstrați cheia de semnare privată corespunzătoare în sistemul de încredere care emite JWT-uri.

Adăugarea unei chei web JSON

Pentru a adăuga o cheie web JSON publică:

1	Selectați Adăugare cheie.
2	Introduceți un nume de cheie web JSON.
3	Introduceți emitentul cheii web JSON. Această valoare trebuie să corespundă emitentului utilizat de backend-ul de încredere atunci când generează JWT.
4	Încărcați fișierul public JWK.
5	Selectați Salvare.

Configurați înregistrările multi-utilizator

Activați Permiteți înregistrările mai multor utilizatori pe același dispozitiv atunci când mai mulți utilizatori se pot înregistra pe același dispozitiv fizic.

Notificările push sunt livrate atât pentru utilizatorii înregistrați activi, cât și pentru cei inactivi.
Chatul live sau mesageria în aplicație este livrată utilizatorului activ în prezent. Mesajele pentru utilizatorii inactivi sunt plasate în coadă până când utilizatorul devine din nou activ.

Configurați Webex Connect setări suplimentare

Următoarele setări avansate se aplică numai Webex Connect activelor și nu sunt aplicabile activelor Webex Contact Center sau Webex Contact Center Enterprise.

Un singur dispozitiv per utilizator: Restricționează un utilizator la un dispozitiv înregistrat. Înregistrarea pe un dispozitiv nou oprește livrarea prin împingere către dispozitivul mai vechi.
Inbox pe partea serverului: Stochează o copie de pe partea serverului a datelor din căsuța de e-mail pentru recuperarea ulterioară.
Flux de date: Trimite datele evenimentului aplicabile către Webex Connect integrarea selectată pentru mesajele trimise prin API-ul de mesagerie.

Salvați pentru a crea materialul

După ce configurați mesageria aplicabilă, autorizarea JWT, înregistrarea multi-utilizator și Webex Connect setările, salvați configurația pentru a crea elementul Chat.

Selectați Sal vare pentru a crea elementul.

Așteptați confirmarea faptului că activul a fost creat cu succes.

Integrare completă a serviciilor

După ce creați elementul de chat, finalizați integrarea pentru serviciul selectat în Atri buire la. Urmați procedura aplicabilă pentruWebex Connect, Webex Contact Center sau Webex Contact Center Enterprise.

Webex ConnectIntegrare completă

Pentru un activ atribuitWebex Connect, finalizați maparea serviciului și configurația fluxului înWebex Connect. Autorizarea nodului nu este necesară.

Puteți utiliza un nod de pornire, un eveniment personalizat sau un Webhook personalizat pentru a capta evenimentele primite și a declanșa un flux. Pentru mai multe informații, consultați Nodul de pornire, Eveniment personalizat și Webhook personalizat.

1	Conectați-vă laWebex Connect.
2	Finalizați maparea serviciului aplicabil și configurația fluxului pentru elementul Chat.
3	Înregistrați ID-ul aplicației generate și cheia clientului.
4	Descărcați fișierul de configurare SDK pentru fiecare platformă selectată.

Integrare completă Webex Contact Center

Pentru un material atribuit Centrului de contact Webex, mapați materialul la un punct de intrare al Centrului de contact, apoi finalizați autorizarea nodului Webex Contact Center.

Un activ poate fi mapat la un singur punct de intrare. Finalizați maparea punctului de intrare și a fluxului înainte de a publica experiența clientului.

1	Deschideți configurația Contact Center în Control Hub.
2	Creați sau deschideți punctul de intrare care primește conversațiile de chat.
3	În Maparea flux ului, selectați elementul de chat și fluxul de intrare pentru client necesar.
4	Salvați punctul de intrare și verificați maparea activelor și a fluxului.
5	Completați autorizarea nodului Webex Contact Center înWebex Connect. Pentru instrucțiuni, consultați Nodurile de integrare a sarcinilor Webex CC și autorizațiile nodurilor.
6	Pentru o implementare Web, configurați widgetul Live Chat și obțineți codul de încorporare a site-ului web în Control Hub.

Integrare completă Webex Contact Center Enterprise

Pentru un activ atribuit Webex Contact Center Enterprise, finalizați autorizarea nodului CCE Webex Connect înainte de a configura fluxul de rutare.

1	Conectați-vă laWebex Connect.
2	Autorizarea completă a nodului CCE. Pentru instrucțiuni, consultați Nodurile de integrare CCE și autorizațiile nodurilor.
3	Configurați nodurile de integrare CCE aplicabile și fluxul de rutare pentru elementul Chat. Pentru exemple de flux, consultați Configurațiile fluxului.
4	Salvați și testați fluxul.

Pentru îndrumări suplimentare de configurare, consultați Cele mai bune practici și orient ări și întrebări frecvente.

Excepții și limitări

Țineți cont de următoarele excepții și limitări:

Confirmați alegerea canalului, platformei, atribuirii și rutării înainte de a crea activul. Canalul nu poate fi schimbat după creare, iar modificările platformei sunt restricționate de volumul de muncă.
Pentru Webex Contact Center și Webex Contact Center Enterprise, un singur activ nu poate utiliza Web și Mobile împreună. Creați active separate atunci când ambele sunt necesare.
Notificările Web Push sunt disponibile numai pentruWebex Connect. Safari Web Push, Webex Contact Center Web Push și Webex Contact Center Enterprise Web Push nu sunt acceptate.
Autorizarea JWT nu este acceptată pentru activele Web atribuite Centrului de contact Webex sau Webex Contact Center Enterprise.
Pentru Centrul de contact Webex și Webex Contact Center Enterprise, efectuați configurarea punctului de intrare, flux, widget și cod încorporat în secțiunea Contact Center din Control Hub.
PentruWebex Connect, finalizați configurația serviciului și a fluxului înWebex Connect.
Nu ștergeți un element de chat după ce acesta este mapat la un serviciu fără a elimina sau actualiza mai întâi maparea din aval. Un material șters nu poate fi restaurat și poate lăsa o mapare existentă inutilizabilă.
După creare, păstrați ID-ul aplicației generate, cheia clientului și fișierele de configurare SDK necesare pentru inițializarea SDK-ului corespunzător.

Cisco AI Assistant

Mulțumim pentru feedback.