Konfigurácia zdroja Chatu

Prehľad

Pomocou digitálnych kanálov v Control Hub môžete vytvoriť a nakonfigurovať zdroj chatu pre web (živý chat), mobilné telefóny (správy v aplikácii) a upozornenia Push. Nastavenia dostupné pre konfiguráciu závisia od služby vybratej v časti Priradiť k a od toho, či vyberiete možnosť Web, Mobile alebo oboje.

Tento článok popisuje kompletný proces konfigurácie aktív vrátane podporovaných funkcií, odosielania správ, poverení poskytovateľa tlače, autorizácie webového tokenu JSON (JWT), webových kľúčov JSON (JWK), prepravných protokolov, registrácie viacerých používateľov a konfigurácie špecifickej pre služby po vytvorení zdroja.

Podporované možnosti

Tabuľka 1. Podporované možnosti podľa služby
Schopnosť	Webex Connect	Kontaktné centrum Webex	Webex Kontaktné centrum Enterprise
Webový živý chat	Podporované	Podporované	Podporované
Mobilné správy v aplikácii	Podporované	Podporované	Podporované
Web a mobilné zariadenia v jednom aktíve	Podporované	Nie je podporovaný	Nie je podporovaný
Mobilné - Android push notifikácie	Podporované	Podporované	Podporované
Mobilné - iOS push notifikácie	Podporované	Podporované	Podporované
Web Push upozornenia	Podporované (Chrome a Firefox)	Nie je podporovaný	Nie je podporovaný
JWT - Mobilný	Podporované	Podporované a požadované	Podporované a požadované
JWT - Web	Podporované	Nie je podporovaný	Nie je podporovaný
Registrácia viacerých používateľov	Podporované	Podporované	Podporované
Doručená schránka na strane servera	Podporované	Neuplatniteľné	Neuplatniteľné
Dátový tok	Podporované	Neuplatniteľné	Neuplatniteľné

Skôr ako začnete

Prihláste sa do Control Hub ako plný správca alebo správca kontaktného centra, ktorý dokáže spravovať digitálne zdroje.
Uistite sa, že pre organizáciu sú poskytované Webex Connect digitálne služby, Webex Contact Center alebo Contact Center Enterprise. Bez nároku nie sú digitálne aktíva k dispozícii.
Identifikujte vstupný bod a tok kontaktného centra, ktorý bude prijímať nové konverzácie v chate.
Ak nasadenie používa upozornenia na mobilné push, pripravte si poverenia Firebase, Huawei alebo Apple požad ované vybranou platformou.
Ak plánujete použiť autorizáciu JWT, pripravte si verejný JWK používaný na overenie tokenov vydaných vaším dôveryhodným backendom.

Konfigurácia zdroja Chat

Ak chcete nakonfigurovať zdroj Chatu:

1	Prihláste sa do Control Hub.
2	Prejdite do časti Služ by > Digitálne aktíva.
3	Vyberte polož ku Vytvoriť aktív um.
4	V časti Konfigurácia podrobností o prostriedku zadajte nasledujúce hodnoty: Názov (povinné): Zadajte názov majetku. Popis: Zadajte voliteľný popis prípadu použitia. Kanál (povinné): Vyberte položku Chat. Kanál nemôžete zmeniť po vytvorení zdroja. Priradiť k (povinné): VyberteWebex Connect, Webex Contact Center alebo Webex Contact Center Enterprise. Dostupné možnosti závisia od nárokov organizácie.
5	V časti Správy vyberte platformu a nakonfigurujte Live Chat/Správy v aplikácii a všetky požadované upozornenia push. Zobrazené možnosti závisia od vybranej platformy. Nastavenia upozornení pre Android a iOS sú k dispozícii, keď je vybratá možnosť Mobile. Web Push je k dispozícii, keď je pre zdroj priradený vybratá možnosť WebWebex Connect.

Konfigurácia správ

V časti Správy vyberte platformu a nakonfigurujte možnosti odosielania správ pre dané zariadenie.

Konfigurácia správ:

Primárny a sekundárny dopravný protokol sa musia líšiť. Ak SDK nemôže nadviazať spojenie pomocou primárneho protokolu, použije sekundárny protokol ako záložný protokol.

1	Platforma: Pre Webex Connect vyberte položku Web, Mobile alebo oboje. V prípade mobilných zariadení vyberte položku Android, iOS alebo oboje. V prípade Webex Contact Center alebo Webex Contact Center Enterprise vyberte možnosť Web alebo Mobile.
2	Živý chat/Správy v aplikácii: PreWebex Connect, je k dispozícii pre web a mobilné zariadenia. Pre Webex Contact Center alebo Webex Contact Center Enterprise poskytuje Web Live Chat a Mobile poskytuje správy v aplikácii.
3	Primárny transportný protokol: Vyberte položku MQTT alebo Web Socket.
4	Sekundárny transportný protokol: Vyberte protokol, ktorý nie je vybratý ako primárny.

Konfigurácia push upozornení

Povoli ť upozornenia push, keď musí aplikácia prijímať upozornenia prostredníctvom nakonfigurovaného poskytovateľa push. Zobrazené sekcie upozornení závisia od vybranej platformy.

K dispozícii sú nasledujúce možnosti poskytovateľa push:

Android: Firebase Cloud Messaging (FCM), Huawei alebo oboje. Vzťahuje Webex Connect sa na Webex Contact Center a Webex Contact Center Enterprise.
iOS: FCM, služba Apple Push Notification Service (APNS) alebo autentifikácia založená na tokenoch pre APNS. Vzťahuje Webex Connect sa na Webex Contact Center a Webex Contact Center Enterprise.
Web: Firebase Cloud Messaging. Vzťahuje sa Webex Connect iba na.

Vyberte platformu a nakonfigurujte príslušného poskytovateľa v príslušnej téme.

Získajte účet služby Firebase Service JSON

Webex používa súbor JSON účtu služby Firebase na overenie požiadaviek servera pre služby Firebase Cloud Messaging. Použite projekt Firebase priradený k vašej aplikácii.

Ak chcete získať a nahrať účet služby Firebase Service JSON:

Zabezpečenie: Konto služby Firebase JSON obsahuje citlivé poverenia. Uložte ho bezpečne a nahrajte iba súbor pre zamýšľaný projekt Firebase.

Pokyny na konfiguráciu služby Firebase Cloud Messaging nájdete v téme Odoslanie správy pomocou rozhrania FCM HTTP v1 API.

1	Otvorte konzolu Firebase a vyberte projekt Firebase používaný vašou aplikáciou.
2	Otvorte polož ku Nastavenia projektu > Servisné úč ty.
3	Vyberte položku Generovať nový súkrom ný kľúč a potvrďte stiahnutie.
4	Stiahnutý súbor JSON uložte bezpečne. Súbor obsahuje poverenia súkromného kľúča.
5	V Control Hub nahrajte súbor JSON v aplikácii Upload Firebase Service Account JSON pre príslušnú konfiguráciu upozornení pre Android, iOS alebo Web notifikácie.

Nakonfigurujte upozornenia push systému Android

Sekcia upozornení pre Android sa zobrazí, keď sú vybraté Mobilné, Android a Povoliť upozornenia push. Vyberte aspoň jedného poskytovateľa; Firebase a Huawei je možné nakon figurovať jednotlivo alebo spoločne. Táto konfigurácia je k dispozícii pre zdro Webex Connect je Webex Contact Center a Webex Contact Center Enterprise Mobile.

Dokumentácia poskytovateľa: Huawei - Nastavenie a testovanie súpravy Push Kit

1	Vyberte položky Mobile, Android a Povoliť upozornenia push. Zobrazí sa časť upozor není pre Android.
2	Vyberte Firebase Cloud Messaging a nahrajte požadovaný súbor JSON účtu Firebase Service Account z projektu Firebase.
3	Ak aplikácia podporuje zariadenia, ktoré používajú mobilné služby Huawei, vyberte položku Huawei a zadajte ID v aplik ácii a Tajomstvo v aplikácii AppGallery Connect. Výnimka Huawei: Konfiguráciu Huawei je možné preskočiť, ak aplikácia ne podporuje zariadenia bez služieb Google Play. Aktuálne Webex Connect vedenie podporuje EMUI 10.x a novšie.

Nakonfigurujte upozornenia push systému iOS

Sekcia upozornení pre iOS sa zobrazí, keď sú vybraté Mobilné, iOS a Povoliť upozornenia push. Vyberte jedného poskytovateľa push. Táto konfigurácia je k dispozícii pre zdro Webex Connect je Webex Contact Center a Webex Contact Center Enterprise Mobile.

Pokyny na konfiguráciu APN založené na certifikátoch nájdete v téme Vytvorenie pripojenia založeného na certifikátoch k APN.

Pokyny na konfiguráciu APN založené na tokenoch nájdete v téme Vytvorenie pripojenia založen ého na token och k APN.

1	Vyberte položky Mobile, iOS a Povoliť upozornenia push. Zobrazí sa časť upozornení pre iOS.
2	Vyberte jedného poskytovateľa push.
3	V prípade služby Firebase Cloud Messaging nahrajte súbor JSON účtu Firebase Service Account stiahnutý z projektu Firebase.
4	V prípade služby Apple Push Notification Service (APNS) zadajte heslo certifikátu, vyberte položku Sandbox alebo Production, nahrajte certifikát APNS, zadajte názov a overte konfiguráciu. Podporovaný je iba formát certifikátu.p12.
5	Pre autentifikáciu APNS založenú na tokenoch zadajte ID kľúča, ID tímu a ID balíka alebo balíka aplikácie, vyberte položku Sandbox alebo Production a nahrajte súbor súkromného kľúča APNS. Výber brány: Použite Sandbox pre vývojovú aplikáciu a Production pre aplikáciu pripravenú na výrobu. Uložte súkromný kľúč APNS bezpečne; Apple umožňuje načí tanie stiahnutého súboru kľúčov.p8 iba raz.
6	Vymeňte certifikát poskytovateľa Apple pred jeho platnosťou, aby ste predišli prerušeniu dodávky push.

Konfigurácia upozornení Web Push

Web Push upozornenia sú k dispozícii iba pre zdroje prirad Webex Connect ené k vybratému webu. Chrome a Firefox sú podporované. Safari Web Push nie je momentálne podporovaný.

Web Push upozornenia nie sú podporované pre zdroje priradené k Webex Contact Center alebo Webex Contact Center Enterprise.

Ak chcete nakonfigurovať upozornenia Web Push:

1	Skontrolujte, či je daný prípravok prirad Webex Connect ený a že je vybratý web.
2	Použite prehliadač Chrome alebo Firefox na prístup na webovú stránku a prijímanie upozornení Web Push.
3	URL webovej stránky (povinné): Zadajte adresu URL webovej stránky, ktorá bude dostávať upozornenia Web Push.
4	Ikona upozornenia (povinné): Zadajte cestu k ikone upozornenia. Ikona musí byť 80 x 80 pixelov.
5	Nakonfigurujte Firebase Cloud Messaging (FCM) pre svoju webovú aplikáciu podľa dokumentácie Fire base.
6	Firebase Service Account JSON (povinné): Nahrajte súbor JSON účtu služby Firebase obsahujúci súkromný kľúč potrebný na použitie rozhrania API Firebase Cloud Messaging HTTP v1.

Konfigurácia autorizácie webového tokenu JSON

Autorizácia JWT vyžaduje, aby bola komunikácia SDK autorizovaná pomocou platného webového tokenu JSON. Pre nové aktíva je typ šifrovania asymetrický.

Podpora JWT je nasledovná:

Webex Connect: Podporované pre mobilné a webové zariadenia v rovnakom zdroji.
Webex Contact Center a Webex Contact Center Enterprise - Web: Nie je podporované.
Webex Contact Center a Webex Contact Center Enterprise - Mobile: Podporované a potrebné pre konfiguráciu mobilných aktív.

Nakonfigurujte nasledujúce nastavenia:

Typ šifrovania: Asymetrický pre nové aktíva.
Vypršanie platnosti tokenu (povinné): Zadajte, ako dlho zostáva JWT platná, kým sa vyžaduje nový token identity používateľa. Platný rozsah: 5-360 minút. Predvolené: 60 minút.
JSON Web Keys (povinné): Nahrajte verejný JWK používaný na overenie tokenov. Môžete pridať druhý kľúč na otáčanie. Maximálne: dva kľúče.

Pridajte a pripravte verejný webový kľúč JSON tak, ako je popísané v základných témach.

Pripravte verejný JWK

Nahraný súbor musí obsahovať verejný overovací kľúč RSA. Webex overuje nasledujúce vlastnosti JWK.

Vlastnosti JWK sú definované v RFC 7517, časť 4. Vlastnosti špecifické pre algoritmus sú definované v R FC 7518.

Tabuľka 2. Verejné nehnuteľnosti JWK
Názov nehnuteľnosti	Popis
alg	Identifikuje kryptografický algoritmus použitý s kľúčom. Požadovaná hodnota je RS256, ktorá špecifikuje RSASSA-PKCS1- pomocou SHA-256. v1_5
e	Exponent pre verejný kľúč RSA, reprezentovaný ako hodnota kódovaná Base64URLUint.
key_ops	Určuje operáciu, pre ktorú je kľúč určený. Podporovaná hodnota je overiť, čo znamená, že kľúč sa používa na overenie digitálnych podpisov. Pozri RFC 7517, oddiel 4.3.
kty	Identifikuje rodinu kryptografických algoritmov použitých s kľúčom. Hodnota musí byť RSA. Pozri RFC 7517, oddiel 4.1.
n	Modul pre verejný kľúč RSA, reprezentovaný ako hodnota kódovaná Base64URLUint.
použiť	Určuje zamýšľané použitie verejného kľúča. Hodnota musí byť sig, čo znamená, že kľúč je určený na overenie podpisu. Pozri RFC 7517, časť 4.2.
dieťa	Identifikuje kľúč a používa sa na zhodu konkrétneho kľúča, napríklad pri otáčaní kľúča. Pozri RFC 7517, oddiel 4.5.

Nahrajte iba verejný overovací kľúč. Udržujte zodpovedajúci súkromný podpisovací kľúč v dôveryhodnom systéme, ktorý vydáva JWT.

Pridanie webového kľúča JSON

Ak chcete pridať verejný webový kľúč JSON:

1	Vyberte polož ku Pridať kľúč.
2	Zadajte názov webového kľúča JSON.
3	Zadajte vydavateľa webového kľúča JSON. Táto hodnota sa musí zhodovať s emitentom, ktorý používa dôveryhodný backend pri generovaní JWT.
4	Nahrajte verejný súbor JWK.
5	Vyberte polož ku Uložiť.

Konfigurácia registrácií viacerých používateľov

Povoli ť registráciu viacerých používateľov na rovnakom zariadení, ak sa na tom istom fyzickom zariadení môže zaregistrovať viacerí používatelia.

Push upozornenia sa doručujú aktívnym aj neaktívnym registrovaným používateľom.
Živý chat alebo správy v aplikácii sa doručujú aktuálne aktívnemu používateľovi. Správy pre neaktívnych používateľov sú umiestnené v rade, kým sa používateľ znova nestane aktívnym.

Nakonfigurujte ďalšie nastavenia Webex Connect

Nasledujúce rozšírené nastavenia sa vzťahujú iba na zdro Webex Connect je a nevzťahujú sa na zdroje Webex Contact Center alebo Webex Contact Center Enterprise.

Jedno zariadenie na používateľa: Obmedzuje používateľa na jedno registrované zariadenie. Registrácia na novom zariadení zastaví doručovanie push do staršieho zariadenia.
Doručená pošta na strane servera: Ukladá kópiu údajov doručenej pošty na strane servera na neskoršie vyhľadanie.
Dátový tok: odosiela príslušné údaje o udalostiach do vybranej Webex Connect integrácie pre správy odosielané prostredníctvom rozhrania Správy API.

Uložiť na vytvorenie majetku

Po nakonfigurovaní príslušných správ, autorizácie JWT, registrácie viacerých používateľov a Webex Connect nastavení uložte konfiguráciu a vytvorte nástroj Chat.

Ak chcete vytvoriť aktív um, vyberte položku Uložiť.

Počkajte na potvrdenie, že aktívum bolo úspešne vytvorené.

Kompletná integrácia služieb

Po vytvorení zdroja Chat dokončite integráciu služby vybratej v časti Priradiť k. Postupujte podľa príslušného postupu pre Webex Connect Webex Contact Center alebo Webex Contact Center Enterprise.

Kompletná integrácia Webex Connect

V prípade priradeného majet Webex Connect ku dokončite mapovanie služby a konfiguráciu toku vWebex Connect. Autorizácia uzla sa nevyžaduje.

Na zachytenie prichádzajúcich udalostí a spúšťanie toku môžete použiť štartovací uzol, vlastnú udalosť alebo vlastný webhook. Ďalšie informácie nájdete v téme Š tartovací uzol, V lastná udal osť a V lastný webhook.

1	Prihláste sa doWebex Connect.
2	Dokončite príslušné mapovanie služieb a konfiguráciu toku pre nástroj Chat.
3	Zaznamenajte vygenerované ID aplikácie a klientsky kľúč.
4	Stiahnite si konfiguračný súbor SDK pre každú vybranú platformu.

Kompletná integrácia Webex Contact Center

V prípade zdroja priradeného do Webex Contact Center zmapojte ho na vstupný bod kontaktného centra a potom dokončite autorizáciu uzla Webex Contact Center.

Aktíva je možné zmapovať iba na jeden vstupný bod. Pred zverejnením zákazníckej skúsenosti dokončite mapovanie vstupného bodu a toku.

1	Otvorte konfigur áciu kontaktného centra v Control Hub.
2	Vytvorte alebo otvorte vstupný bod, ktorý prijíma konverzácie v chate.
3	V časti Mapovanie toku vyberte nástroj Chat a požadovaný tok vstupu zákazníka.
4	Uložte vstupný bod a overte mapovanie aktív a toku.
5	Dokončite autorizáciu uzla Webex Contact Center v. Webex Connect Pokyny nájdete v téme Integrácia úloh Webex CC a autorizácie uzlov.
6	Pri nasadení na webe nakonfigurujte miniaplikáciu Live Chat a získajte kód vloženého webu do Control Hub.

Kompletná integrácia Webex Contact Center Enterprise

V prípade zdroja priradeného spoločnosti Webex Contact Center Enterprise dokončite autorizáciu uzla CCE Webex Connect pred konfiguráciou toku smerovania.

1	Prihláste sa doWebex Connect.
2	Dokončite autorizáciu uzla CCE. Pokyny nájdete v téme Integračné uzly a autorizácie uzlov CCE.
3	Nakonfigurujte príslušné integračné uzly CCE a tok smerovania pre nástroj Chat. Príklady toku nájdete v téme Konfigurácie toku.
4	Uložte a otestujte prietok.

Ďalšie pokyny pre konfiguráciu nájdete v téme Osv edčené postupy a pokyny a často kladené otázky.

Výnimky a obmedzenia

Majte na pamäti nasledujúce výnimky a obmedzenia:

Pred vytvorením zdroja potvrďte výber kanála, platformy, priradenia a smerovania. Kanál sa po vytvorení nedá zmeniť a zmeny platformy sú obmedzené pracovným zaťažením.
V prípade Webex Contact Center a Webex Contact Center Enterprise nemôže jedno zariadenie používať web a mobilné zariadenia spoločne. Vytvorte samostatné aktíva, ak sú potrebné obe.
Web Push upozornenia sú k dispozícii iba preWebex Connect. Safari Web Push, Webex Contact Center Web Push a Webex Contact Center Enterprise Web Push nie sú podporované.
Autorizácia JWT nie je podporovaná pre webové zdroje priradené k Webex Contact Center alebo Webex Contact Center Enterprise.
V prípade Webex Contact Center a Webex Contact Center Enterprise vykonajte konfiguráciu vstupného bodu, toku, miniaplikácie a vloženého kódu v časti Contact Center v Control Hub.
Dokon Webex Connect čite konfiguráciu servisu a toku vWebex Connect.
Neodstraňujte zdroj chatu po jeho mapovaní do služby bez toho, aby ste najskôr odstránili alebo aktualizovali následné mapovanie. Odstránené zložky nie je možné obnoviť a existujúce mapovanie môže zanechať nepoužiteľné.
Po vytvorení si ponechajte vygenerované konfiguračné súbory App ID, Client Key a SDK potrebné na inicializáciu príslušnej SDK.

Cisco AI Assistant

Ďakujeme za vašu spätnú väzbu.