Chat eszköz konfigurálása

Áttekintés

A Vezérlőközpontban található digitális csatornák segítségével létrehozhat és konfigurálhat csevegési eszközt webes (élő csevegés), mobil (alkalmazáson belüli üzenetküldés) és Push értesítésekhez. A konfiguráláshoz rendelkezésre álló beállítások attól függenek, hogy melyik szolgáltatást választja ki a Hozzá rendelés men üpontban, és hogy a Web, a Mobil vagy mindkettő lehetőséget választották-e.

Ez a cikk leírja a teljes eszközkonfigurációs folyamatot, beleértve a támogatott képességeket, az üzenetküldést, a push-provider hitelesítő adatait, a JSON Web Token (JWT) engedélyezését, a JSON webkulcsokat (JWK), a szállítási protokollokat, a többfelhasználós regisztrációt és a szolgáltatásspecifikus konfigurációt az eszköz létrehozása után.

Támogatott képességek

Táblázat 1. Szolgáltatás által támogatott képességek
Képesség	Webex Connect	Webex Kapcsolattartó Központ	Webex Kapcsolattartó Központ Enterprise
Webes élő csevegés	Támogatott	Támogatott	Támogatott
Mobil alkalmazáson belüli üzenetküldés	Támogatott	Támogatott	Támogatott
Web és mobil egyetlen eszközben	Támogatott	Nem támogatott	Nem támogatott
Mobil - Android push értesítések	Támogatott	Támogatott	Támogatott
Mobil - iOS push értesítések	Támogatott	Támogatott	Támogatott
Web Push értesítések	Támogatott (Chrome és Firefox)	Nem támogatott	Nem támogatott
JWT - Mobil	Támogatott	Támogatott és szükséges	Támogatott és szükséges
JWT - Web	Támogatott	Nem támogatott	Nem támogatott
Többfelhasználós regisztrációk	Támogatott	Támogatott	Támogatott
Szerver oldali beérkező levelek	Támogatott	Nem alkalmazható	Nem alkalmazható
Adatfolyam	Támogatott	Nem alkalmazható	Nem alkalmazható

Mielőtt elkezdené

Jelentkezzen be a Control Hub ba teljes rendszergazdaként vagy Contact Center rendszergazdaként, aki képes kezelni a digitális eszközöket.
Győződ Webex Connect jön meg arról, hogy a szervezet számára biztosított legyen a digitális szolgáltatások, a Webex Contact Center vagy a Contact Center Enterprise. A jogosultság nélkül a digitális eszközök nem állnak rendelkezésre.
Határozza meg a kapcsolattartó központ belépési pontját és folyamatát, amely új csevegési beszélgetéseket fog fogadni.
Ha a telepítés mobil push értesítéseket használ, készítse elő a kiválasztott platformhoz szükséges Firebase, Huawei vagy Apple hitelesítő adatokat.
Ha a JWT engedélyezést tervezi használni, készítse elő a megbízható háttér által kiadott tokenek ellenőrzésére használt nyilvános JWK-t.

A csevegőeszköz konfigurálása

Csevegőeszköz konfigurálása:

1	Jelentkezzen be a Control Hub alkalmazás ba.
2	Lépjen a Sz olgáltatások > Digitális eszközök menüpon tra.
3	Válassza az E szköz létrehozása lehetőséget.
4	Az Eszközök adatainak konfigurálása mezőben adja meg a következő értékeket: Név (kötelező): Adjon meg egy eszköz nevét. Leírás: Adjon meg egy opcionális használati esetleírást. Csatorna (kötelező): Válassza a Chat lehetőséget. Az eszköz létrehozása után nem módosíthatja a csatornát. Hozzárendelés (kötelező): Válassza ki Webex Connect a Webex Contact Center vagy a Webex Contact Center Enterprise lehetőséget. A rendelkezésre álló lehetőségek a szervezet jogosultságaitól függenek.
5	Az Üzenetküldésben válassza ki a platformot, és konfigurálja az Élő csevegés/alkalmazáson belüli üzenetküldést és a szükséges push értesítéseket. A megjelenített beállítások a kiválasztott platformtól függenek. Az Android és iOS értesítési beállítások akkor érhetők el, ha a Mobil lehetőséget választja. A Web Push akkor érhető el, ha a Web be van jelölve egy hozzárendelt eszközhözWebex Connect.

Üzenetküldés konfigurálása

Az Üzenetküldés mezőben válassza ki a platformot, és konfigurálja az eszköz üzenetküldési képességeit.

Az üzenetküldés konfigurálása:

Az elsődleges és a másodlagos szállítási protokolloknak eltérőnek kell lenniük. Ha az SDK nem tud kapcsolatot létesíteni az elsődleges protokoll használatával, a másodlagos protokollt használja biztonsági mentésként.

1	Platform: Válassza ki a Webex Connect Web, a Mobil vagy mindkettő lehetőséget. Mobil esetén válassza az Android, az iOS vagy mindkettő lehetőséget. A Webex Contact Center vagy a Webex Contact Center Enterprise esetén válassza a Web vagy a Mobile lehetőséget.
2	Élő csevegés/Alkalmazáson belüli üzen Webex Connect etküldés: Mert elérhető weben és mobilon. A Webex Contact Center vagy a Webex Contact Center Enterprise esetében a Web élő csevegést biztosít, a Mobile pedig alkalmazáson belüli üzenetküldést biztosít.
3	Elsődleges szállítási protokoll: Válassza az MQTT vagy a Web Socket lehetőséget.
4	Másodlagos szállítási protokoll: Válassza ki a nem elsődlegként kiválasztott protokollt.

A push értesítések konfigurálása

Engedél yezze a push értesítések engedélyezését, ha az alkalmazásnak értesítéseket kell kapnia egy konfigurált push szolgáltatón keresztül. A megjelenített értesítési szakaszok a kiválasztott platformtól függenek.

A következő push szolgáltatói lehetőségek állnak rendelkezésre:

Android: Firebase Cloud Messaging (FCM), Huawei vagy mindkettő. A Webex Con Webex Connect tact Center és a Webex Contact Center Enterprise szolgáltatásokra vonatkozik.
iOS: FCM, Apple Push Notification Service (APNS) vagy tokenalapú hitelesítés APNS számára. A Webex Con Webex Connect tact Center és a Webex Contact Center Enterprise szolgáltatásokra vonatkozik.
Web: Firebase Cloud Messaging. Webex ConnectCsak a következőkre vonatkozik.

Válassza ki a platformot, és konfigurálja az alkalmazandó szolgáltatót a megfelelő témában.

Szerezze be a Firebase szolgáltatási fiókot JSON

A Webex egy Firebase szolgáltatási fiók JSON-fájlt használ a Firebase Cloud Messaging kiszolgálói kérelmek hitelesítésére. Használja az alkalmazáshoz társított Firebase projektet.

A Firebase Service Account JSON letöltéséhez és feltöltéséhez:

Biztonság: A Firebase szolgáltatási fiók JSON érzékeny hitelesítő adatokat tartalmaz. Tárolja biztonságosan, és csak a tervezett Firebase projekt fájlját töltse fel.

A Firebase Cloud Messaging konfigurációs utasításait az Üzenet küldése az FCM HTTP v1 API használatával című témakörben talál.

1	Nyissa meg a Firebase konzolt, és válassza ki az alkalmazás által használt Firebase projektet.
2	Nyissa meg a Projekt beállítások > Sz olgáltatási fiókok lehetőséget.
3	Válassza az Új privát kulcs létreho zása lehetőséget, és erősítse meg a letöltést.
4	Tárolja biztonságosan a letöltött JSON fájlt. A fájl privát kulcsú hitelesítő adatokat tartalmaz.
5	Töltse fel a JSON-fájlt a Vezérlőközpontban a Firebase Service Account JSON feltöl tése menüpontban a megfelelő Android, iOS vagy webes értesítési konfigurációhoz.

Konfigurálja az Android push értesítéseket

Az Android értesítési szakasz akkor jelenik meg, amikor a Mobil, az Android és a push értesítések engedélyezése lehetőséget választja ki. Válasszon legalább egy szolgáltatót; A Firebase és a Huawei külön-külön vagy együtt konfigurálható. Ez a konfiguráció a Webex Con Webex Connect tact Center és a Webex Contact Center Enterprise Mobile eszközökhöz érhető el.

Szolgáltatói dokumentáció: Huawei - Push Kit beállítása és tesztelése

1	Válassza a Mobil, Android és A push értesítések engedélyezése lehetőséget. Megjelenik az Android értes ítési szakasz.
2	Válassza a Firebase Cloud Messaging lehetőséget, és töltse fel a szükséges Firebase Service Account JSON fájlt a Firebase projektből.
3	Ha az alkalmazás támogatja a Huawei mobilszolgáltatásokat használó eszközöket, válassza a Huawei lehetőséget, és írja be az AppGallery Connect alkalmazáson belüli azonosítót és az Alkalmazáson belüli titkot. Huawei kivétel: A Huawei konfigurációja kihagyható, ha az alkalmazás nem támogatja a Google Play szolgáltatások nélküli eszközöket. A jelenlegi Webex Connect útmutató támogatja az EMUI 10.x és újabb verzióját.

Konfigurálja az iOS push értesítéseket

Az iOS értesítési szakasz akkor jelenik meg, amikor a Mobil, iOS és A push értesítések engedélyezése jelölőnégy zetet választja ki. Válasszon ki egy push szolgáltatót. Ez a konfiguráció a Webex Con Webex Connect tact Center és a Webex Contact Center Enterprise Mobile eszközökhöz érhető el.

A tanúsítványalapú APN-ek konfigurálási utasításait a Tanúsítványalapú kapcsol at létrehozása APN-ekkel című témakörben talál.

A tokenalapú APN-ek konfigurálási utasításait a Token-alapú kapcsolat létrehozása APN-ekkel című témakörben talál.

1	Válassza a Mobil, iOS lehetőséget és Push értesítések engedélyezése lehetőséget. Meg jelenik az iOS értesítési szakasz.
2	Válasszon ki egy push szolgáltatót.
3	A Firebase Cloud Messaging alkalmazáshoz töltse fel a Firebase Service Account JSON fájlt, amelyet letöltöttek a Firebase projektből.
4	Az Apple Push Notification Service (APNS) esetén adja meg a tanúsítvány jelszavát, válassza a Sandbox vagy a Production lehetőséget, töltse fel az APNS-tanúsítványt, adja meg a nevet, és ellenőrizze a konfigurációt. Csak a.p12 tanúsítvány formátum támogatott.
5	A tokenalapú APNS-hitelesítéshez adja meg a Kulcsazonosítót, a Csapatazonosítót és az alkalmazáscsomag- vagy csomagazonosítót, válassza a Sandbox vagy a Production lehetőséget, és töltse fel az APNS privát kulcsfájlt. Átjáró kiválasztása: Használja a Sandbox alkalmazást fejlesztő alkalmazáshoz, a Production pedig egy gyártásra kész alkalmazáshoz. Az APNS privát kulcsot biztonságosan tárolja; az Apple csak egyszer engedél yezi a letöltött.p8 kulcsfájl letöltését.
6	Cserélje ki az Apple szolgáltatói tanúsítványát annak lejárta előtt, hogy elkerülje a kézbesítés megszakítását.

Web Push értesítések konfigurálása

A Web Push értesítések csak a Web kiválasztáshoz rendelt eszközök Webex Connect esetében érhetők el. A Chrome és a Firefox támogatott. A Safari Web Push jelenleg nem támogatott.

A Web Push értesítések nem támogatottak a Webex Contact Center vagy a Webex Contact Center Enterprise-hoz rendelt eszközök esetében.

A Web Push értesítések konfigurálása:

1	Ellenőrizze, hogy az eszköz hozzá van-e rendelve, Webex Connect és hogy a Web be van-e jelölve.
2	Használja a Chrome-ot vagy a Firefoxot a webhely eléréséhez és a Web Push értesítések fogadásához.
3	Webhely URL-címe (kötelező): Adja meg annak a webhelynek az URL-jét, amely Web Push értesítéseket kap.
4	Értesítési ikon (kötelező): Adja meg az értesítési ikon elérési útját. Az ikonnak 80 x 80 pixelnek kell lennie.
5	A Firebase Cloud Messaging (FCM) konfigurálása webes alkalmazásához a Fire base dokumentációjának követésével.
6	Firebase Service Account JSON (kötelező): Töltse fel a Firebase szolgáltatás-fiók JSON fájlt, amely tartalmazza a Firebase Cloud Messaging HTTP v1 API használatához szükséges privát kulcsot.

A JSON Web Token engedélyezésének konfigurálása

A JWT engedélyezése megköveteli, hogy az SDK kommunikációt érvényes JSON Web Token használatával engedélyezni kell. Új eszközök esetében a titkosítási típus aszimmetrikus.

A JWT támogatás a következő:

Webex Connect: Támogatott mobil és web számára ugyanabban az eszközben.
Webex Contact Center és Webex Contact Center Enterprise - Web: Nem támogatott.
Webex Contact Center és Webex Contact Center Enterprise - Mobile: Támogatott és szükséges a mobil eszközök konfigurálásához.

Konfigurálja a következő beállításokat:

Titkosítási típus: Aszimmetrikus új eszközökhöz.
Token lejárata (kötelező): Adja meg, mennyi ideig marad érvényes a JWT, mielőtt új felhasználói azonosító token szükséges. Érvényes tartomány: 5-360 perc. Alapértelmezett: 60 perc.
JSON webkulcsok (kötelező): Töltse fel a tokenek ellenőrzésére használt nyilvános JWK-t. Hozzáadhat egy második kulcsot a forgatáshoz. Maximum: két kulcs.

Adja hozzá és készítse elő a nyilvános JSON webkulcsot a gyermektémákban leírtak szerint.

Készítse elő a nyilvános JWK-t

A feltöltött fájlnak tartalmaznia kell a nyilvános RSA ellenőrző kulcsot. A Webex érvényesíti a következő JWK tulajdonságokat.

A JWK tulajdonságait az RFC 7517 4. szakasz határozza meg. Az algoritmusspecifikus tulajdonságokat az R FC 7518 határozza meg.

Táblázat 2. Nyilvános JWK ingatlanok
Ingatlan neve	Leírás
alg	Azonosítja a kulccsal használt kriptográfiai algoritmust. A szükséges érték az RS256, amely az RSASSA-PKCS1- t adja meg az SHA-256 használatával. v1_5
e	Az RSA nyilvános kulcs exponense, Base64URLUint kódol t értékként ábrázolva.
key_ops	Meghatározza azt a műveletet, amelyre a kulcsot szánják. A támogatott érték az ellenőrzés, jelezve, hogy a kulcsot a digitális aláírások ellenőrzésére használják. Lásd az RFC 7517 4.3 szakaszát.
kty	Azonosítja a kulccsal használt kriptográfiai algoritmuscsaládot. Az értéknek RSA-nak kell lennie. Lásd az RFC 7517 4.1. szakaszát.
n	Az RSA nyilvános kulcs modulusa, Base64URLUint kódol t értékként ábrázolva.
használ	Megadja a nyilvános kulcs rendeltetésszerű használatát. Az értéknek sig-nek kell lennie, jelezve, hogy a kulcs aláírás-ellenőrzésre szolgál. Lás d az RFC 7517 4.2 pontját.
kölyök	Azonosítja a kulcsot, és egy adott kulcs illesztésére szolgál, például a billentyűforgatás során. Lásd az RFC 7517 4.5 szakaszát.

Csak a nyilvános ellenőrző kulcsot töltse fel. Tartsa meg a megfelelő privát aláírási kulcsot a JWT-ket kibocsátó megbízható rendszerben.

JSON webkulcs hozzáadása

Nyilvános JSON webkulcs hozzáadása:

1	Válassza a gomb hozzáadása lehetőséget.
2	Adjon meg egy JSON webkulcs nevét.
3	Adja meg a JSON webkulcs kibocsátóját. Ennek az értéknek meg kell egyeznie azzal a kibocsátóval, amelyet a megbízható háttérrendszer használ a JWT létrehozásakor.
4	Töltse fel a nyilvános JWK fájlt.
5	Válassza a Mentés lehetőséget.

Többfelhasználós regisztrációk konfigurálása

Enged élyezze a több felhasználó regisztrációjának engedélyezését ugyan azon az eszközön, ha több felhasználó regisztrálhat ugyanazon a fizikai eszközön.

A push értesítések mind az aktív, mind az inaktív regisztrált felhasználók számára érhetők el.
Az élő csevegés vagy az alkalmazáson belüli üzenetküldés a jelenleg aktív felhasználónak érkezik. Az inaktív felhasználók üzeneteit addig sorba helyezik, amíg a felhasználó újra aktívvá nem válik.

További Webex Connect beállítások konfigurálása

A következő speciális beállítások csak az eszközökre vonatko Webex Connect znak, és nem alkalmazhatók a Webex Contact Center vagy a Webex Contact Center Enterprise eszközökre.

Egyetlen eszköz felhasználónként: A felhasználót egy regisztrált eszközre korlátozza. Az új eszközön történő regisztráció leállítja a push szállítást a régebbi eszközre.
Kiszolgálóoldali beérkező levelek: A beérkező levelek adatainak kiszolgálóoldali másolatát tárolja későbbi visszakeresés céljából.
Adatfolyam: Az Üzenetküldő API-n keresztül küldött üzenetek esetén alkalmazandó eseményadatokat küld a kiválasztott Webex Connect integrációhoz.

Mentés az eszköz létrehozásához

Miután konfigurálta az alkalmazandó Üzenetküldést, a JWT-engedélyezést, a többfelhasználós regisztrációt és a Webex Connect beállításokat, mentse el a konfigurációt a Chat eszköz létrehozásához.

Az eszköz létrehozá sához válassza a Mentés lehetőséget.

Várja meg a megerősítést, hogy az eszköz sikeresen jött létre.

Teljes körű szolgáltatás-integráció

Miután létrehozta a csevegőeszközt, fejezze be a Hozzá rendelés menüpontban kiválasztott szolgáltatás integrálását. Kövesse a Webex Cont Webex Connect act Center vagy a Webex Contact Center Enterprise vonatkozó eljárást.

Teljes Webex Connect integráció

Egy hozzárendelt eszköz esetében végezze Webex Connect el a szolgáltatásleképezést és a folyamatkonfigurációtWebex Connect. A csomópont engedélyezése nem szükséges.

Kezdő csomópontot, egyéni eseményt vagy egyéni webhookot használhat a bejövő események rögzítésére és folyamatok indítására. További információt a Csomópont indítása, az Egyéni esemény és az Egyéni webhook című témak örben talál.

1	Jelentkezzen beWebex Connect.
2	Töltse ki a Chat eszközhöz alkalmazandó szolgáltatás-leképezést és áramlás-konfigurációt.
3	Jegyezze fel a generált alkalmazás-azonosítót és az ügyfélkulcsot.
4	Töltse le az SDK konfigurációs fájlt minden kiválasztott platformhoz.

Teljes Webex Contact Center integráció

A Webex Contact Centerhez rendelt eszköz esetén vegye fel az eszközt egy Kapcsolatközpont belépési pontjára, majd töltse ki a Webex Contact Center csomópont engedélyezését.

Egy eszköz csak egy belépési pontra leképezhető. Az ügyfélélmény közzététele előtt fejezze be a belépési pont- és folyamatleképezést.

1	Nyissa meg a Contact Center konfigurációt a Control Hub alkalmazásban.
2	Hozza létre vagy nyissa meg a csevegési beszélgetéseket fogadó belépési pontot.
3	A Folyamatleképez ésben válassza ki a Chat eszközt és a szükséges ügyfélbeviteli folyamatot.
4	Mentse el a belépési pontot, és ellenőrizze az eszköz- és áramlásterképezést.
5	Töltse ki a Webex Contact Center csomópont engedélyezését. Webex Connect Az utasításokat a Webex CC feladatintegrációs csomópontok és cs omópontok engedélyezése című témakörben talál.
6	Webes telepítéshez konfigurálja az Élő csevegés widgetet, és szerezze be a webhely beágyazási kódját a Vezérlőközpontban.

Teljes Webex Contact Center vállalati integráció

A Webex Contact Center Enterprise-hoz rendelt eszköz esetében töltse ki a CCE csomópont engedélyezését az útválasztási Webex Connect folyamat konfigurálása előtt.

1	Jelentkezzen beWebex Connect.
2	Teljes CCE csomópont engedélyezése. Az utasításokat a CCE integrációs csomópontok és csomópontok engedélyezései című cikkben talál
3	Konfigurálja az alkalmazandó CCE-integrációs csomópontokat és útválasztási folyamatot a Chat eszközhöz. Áramlási példákat lásd: Á ramláskonfigur ációk.
4	Mentse el és tesztelje az áramlást.

További konfigurációs útmutatót a Bevált gyakorlatok és irányelvek és GYIK című té makör ben talál.

Kivételek és korlátozások

Tartsa szem előtt a következő kivételeket és korlátozásokat:

Az eszköz létrehozása előtt erősítse meg a csatorna-, platform-, hozzárendelés- és útválasztást. A csatorna létrehozása után nem változtatható meg, a platformmódosításokat pedig a munkaterhelés korlátozza.
A Webex Contact Center és a Webex Contact Center Enterprise esetében egyetlen eszköz nem tudja együtt használni a Web és a Mobile alkalmazást. Hozzon létre külön eszközöket, ha mindkettő szükséges.
A Web Push értesítések csak a következőhöz érhetők Webex Connect el. A Safari Web Push, a Webex Contact Center Web Push és a Webex Contact Center Enterprise Web Push nem támogatott.
A JWT-engedélyezés nem támogatott a Webex Contact Center vagy a Webex Contact Center Enterprise-hoz rendelt webes eszközök esetében.
A Webex Contact Center és a Webex Contact Center Enterprise esetében végezze el a belépési pont, az áramlás, a widget és a beágyazott kód konfigurálását a Vezérlőközpont kapcsolattartó központ szakaszában.
Ehhez fejez Webex Connect ze be a szerviz- és áramlási konfigurációtWebex Connect.
Ne törölje a csevegési eszközt, miután azt egy szolgáltatásra leképezték, anélkül, hogy előzetesen eltávolítaná vagy frissítené a későbbi leképezést. A törölt eszköz nem állítható vissza, és a meglévő leképezést használhatatlanná teheti.
Létrehozás után őrizze meg a létrehozott alkalmazásazonosítót, ügyfélkulcsot és SDK konfigurációs fájlokat, amelyek szükségesek a megfelelő SDK inicializálásához.

Cisco AI Assistant

Köszönjük visszajelzését.