- Domov
- /
- Članek
Kontaktni center Webex za Salesforce Service Cloud Voice integrira Ciscovo robustno CCaaS (kontaktni center kot storitev) s Salesforceovim CRM-jem, kar podjetjem omogoča upravljanje večkanalnih interakcij s strankami (glasovne, digitalne) znotraj vmesnika Salesforce z uporabo umetne inteligence Webex za virtualne agente, prepisovanje in inteligentno usmerjanje, s čimer agente spremeni v "super-agente" z enotnimi podatki za boljšo uporabniško izkušnjo.
Pregled
Kontaktni center Webex za Salesforce Service Cloud Voice
Webex Contact Center za Service Cloud Voice je vnaprej pripravljena rešitev za integracijo, ki prinaša moč Webex Contact Center v konzolo agentov Salesforce Service Cloud Voice Omni-channel.
Preden nadaljujete z namestitvijo, si oglejte naslednji razdelek:
če želite izvedeti več o predpogojih in omejitvah storitve Salesforce Service Cloud Voice in zagotoviti, da je vaša organizacija Salesforce pripravljena na omogočanje in namestitev paketa Webex Contact Center for Service Cloud Voice.
Predpogoji in omejitve
Predpogoji (podtema)
Uporabniški vmesniki: Storitev Cloud Voice je na voljo samo v storitvi Salesforce Lightning Experience.
Storitev Cloud Voice je na voljo v teh izdajah.
- Podjetje
- Neomejeno
- Razvijalec
Licence
-
Stranke morajo poleg standardnih ali premium licenc Flex 3 za Webex Contact Center kupiti tudi novo dodatno licenco A-SF-VOICE za vsakega prijavljenega agenta. Za več informacij glejte navodila za naročanje Flex 3.
- Salesforce Voice za partnersko telefonijo
Preden vklopite Voice, morate v svoji organizaciji nastaviti predpogojne storitve.
- Pomaknite se do Podatki o podjetju > Licenca za nabor dovoljenj
- Preveri Uporabnik storitve Cloud Voice (partnerska telefonija).
Vse razvijalske izdaje so zdaj opremljene s 5 partnerskimi licencami za telefonijo, ki so na voljo za testiranje.
- Preveri Uporabnik storitve Cloud Voice (partnerska telefonija).
- Lahko pa to preverite tudi tako, da odprete nastavitev Salesforce in v levi stranski vrstici poiščete "glas".
- Če se prikaže »Partnerski telefonski kontaktni centri«, imate licenco SCV.
- Če možnost »Kontaktni centri za telefonijo partnerjev« ni vidna, potem »Omogoči storitev Cloud Voice« tako, da sledite spodnjim korakom.
- Pojdite v nastavitev Salesforce in poiščite ter izberite »Nastavitev partnerske telefonije« in preklopite gumb na »Omogoči storitev Cloud Voice«.
- Omogočite Omni-Channel, da bodo vaši agenti lahko klicali in sprejemali klice.
- Pojdite v nastavitev Salesforce in poiščite ter izberite »Nastavitev partnerske telefonije« in preklopite gumb na »Omogoči storitev Cloud Voice«.
Omni-kanal
Če je v vaši organizaciji že omogočena možnost Omni-Channel, ta korak preskočite.
- V nastavitvah v polje Hitro iskanje vnesite Nastavitve večkanalnega načina in nato izberite Nastavitve večkanalnega načina.


- Izberite Omni-Channel.
- Kliknite Shrani.
Omejitve
- Glas je na voljo samo v programu Lightning Experience.
- Glas je podprt v storitvah Service Cloud in Sales Cloud kot dodatna licenca.
- Glas ni podprt v aplikaciji Salesforce Mobile ali v brskalniku Safari na iPadu.
- Glas je podprt samo v spletnih brskalnikih Google Chrome, Microsoft Edge (Chromium) in Mozilla Firefox. Za omogočanje enotne prijave (SSO) morajo biti omogočeni piškotki.
- Standardna navigacija ni podprta.
- Telefonija je strogo regulirana, zato se o razpoložljivosti storitve Voice v vaši regiji posvetujte s svojim predstavnikom Salesforce.
Zahteve
Kode mirovanja
Poiščite kode mirovanja
| 1 |
Prijavite se v upravljalni portal. |
| 2 |
Pomaknite se do Kontaktnega centra > IZKUŠNJA NAMIZJA > Idle/Wrap-up Kode. |
| 3 |
Prepričajte se, da so prikazane kode mirovanja, sicer kliknite spustni gumb filtra in na vrhu strani izberite Koda mirovanja. |
| 4 |
Kliknite na kodo mirovanja, da odprete podroben pogled. Tam lahko najdete ID kode mirovanja.
ID-je je mogoče kopirati in nato uporabiti za konfiguracijo preslikave stanja prisotnosti. Eden od ID-jev mora biti uporabljen kot privzeti razlog za nepripravljenost Cisco. |
Integriraj
Namestitev
Preden nadaljujete z namestitvijo, si oglejte razdelek Predpogoji in omejitve, kjer so navedene predpogoji in omejitve storitve Salesforce Service Cloud.
Namestitev in konfiguracija kontaktnega centra Webex za storitev Cloud Voice
Ko pridobite licenco Service Cloud Voice za partnersko telefonijo, se v meniju Nastavitve prikaže stran Nastavitev partnerske telefonije.
Več informacij najdete v uradni referenci Salesforce ( neposredna povezava).
| 1 |
V nastavitvah v polje |
| 2 |
Omogoči Vklopi glas s partnersko telefonijo. Stran Kontaktni centri za partnersko telefonijo se prikaže v meniju Nastavitev. Če nameravate paket namestiti v peskovniku Salesforce, zamenjajte del |
Namestite paket
Za namestitev paketa:
| 1 |
Za začetek namestitve odprite priloženo povezavo paketa. |
| 2 |
Prijavite se v organizacijo Salesforce, kjer želite namestiti paket. |
| 3 |
V čarovniku za namestitev izberite varnostno možnost »Namesti samo za skrbnike« (1) in kliknite Namesti (2). Določite, kateri uporabniki dobijo določena dovoljenja za objekte in komponente, ki so vključene v paket Webex Contact Center for Service Cloud Voice. Poleg tega jim podelite ta dovoljenja; pri tem postopku pomagajo nabori dovoljenj, ki so priloženi paketu Webex Contact Center for Service Cloud Voice. Čarovnik za namestitev paketa – prikaže se pozdravni zaslon: Namestitveni paket ni neposredno dostopen prek Salesforce AppExchange. Stranke morajo uporabiti gumb »Prenesi zdaj« na seznamu AppExchange, ki odpre kontaktni obrazec za zahtevo povezave za namestitev in aktivacije Cisco. |
| 4 |
Dodelite naslednje nabore dovoljenj vsaj enemu uporabniku, da lahko ustvarite kontaktni center: |
| 5 |
Kliknite Nastavi | Uporabniki | Uporabniki. |
| 6 |
Iskanje in izbira uporabnika. |
| 7 |
Pomaknite se navzdol do razdelka »Dodelitve nabora dovoljenj«. |
| 8 |
Kliknite na Uredi naloge |
| 9 |
Za skrbnike kontaktnega centra: dodelite nabor dovoljenj skrbnika kontaktnega centra (partnerska telefonija).
|
| 10 |
Za agente kontaktnega centra: dodelite nabor dovoljenj za agenta kontaktnega centra (partnerska telefonija) in nabor dovoljenj agenta kontaktnega centra Webex SCV.
Izbira možnosti Namesti za vse uporabnike ni priporočljiva, saj s tem podelite vsa dovoljenja (branje, ustvarjanje, urejanje in brisanje) za komponente in objekte paketa vsem uporabnikom, ki uporabljajo uporabniški profil po meri. |
| 11 |
Dodelite licenco za paket uporabnikom za delo s storitvijo Connects for Service Cloud Voice.
|
| 12 |
Lahko pa kliknete Nastavi | Uporabniki | Uporabniki.. |
| 13 |
Poiščite in izberite uporabnika. |
| 14 |
Pomaknite se navzdol do Upravljani paketi. |
| 15 |
Kliknite Dodeli licence. |
| 16 |
Na seznamu izberite paket Webex Contact Center za storitev Cloud Voice. |
| 17 |
Kliknite Dodaj. |
| 18 |
Ustvarite Stanja prisotnosti, da določite, katerim servisnim kanalom so dodeljeni različni statusi. Agenti se lahko prijavijo v Omni-Channel z različnimi statusi, odvisno od vrste dela, do katerega so upravičeni. |
| 19 |
V nastavitvah v polje Hitro iskanje vnesite |
| 20 |
Kliknite Novo. Ustvarite vsaj en status za »Na spletu« in enega za »Zaseden«.
|
Dodelite stanje(-a) prisotnosti agentom
| 1 |
V nastavitvah v polje Hitro iskanje vnesite Nabori dovoljenj in nato izberite Nabori dovoljenj. |
| 2 |
Kliknite, da odprete Nabor dovoljenj za partnersko telefonijo. |
| 3 |
Kliknite Dostop do statusov prisotnosti storitev. |
| 4 |
Kliknite Uredi. |
| 5 |
Na seznamu Razpoložljive prisotnosti storitev izberite predhodno ustvarjena stanja prisotnosti in kliknite Dodaj, da jih povežete z naborom dovoljenj. Agenti, ki so dodeljeni temu naboru dovoljenj, se lahko prijavijo v Omni-Channel s katerim koli od stanj prisotnosti, ki so jim na voljo. |
| 6 |
Kliknite Shrani. |
| 7 |
Na isti strani kliknite Upravljanje nalog. Nato v zgornjem desnem kotu kliknite Dodaj dodelitev, izberite želenega uporabnika, kliknite Naprej, izberite Možnost poteka veljavnosti za dodeljene uporabnike (neobvezno) in nato kliknite Dodeli. Storitev Cloud Voice za delovanje z zapisom VoiceCall uporablja zunanjo domeno. Naslednje URL-je je treba dodati v »Nastavitve oddaljenega spletnega mesta« v nastavitvah ( kliknite tukaj, da odprete uradno dokumentacijo):
Primer: Kako najti URL primerka. |
| 8 |
Po prijavi si oglejte URL v naslovni vrstici brskalnika. URL primerka je del pred ".my.salesforce.com" ali ".salesforce.com" ali ".lightning.force.com". Na primer, če je vaš URL https://orgfarm-54a38e30ad-dev-ed.develop.my.salesforce-setup.com/,, potem je "orgfarm-54a38e30ad-dev-ed.develop" URL vašega primerka. Primer: URL izvorne organizacije: https://cisco.lightning.force.com Primer: URL za dodajanje:
|
| 9 |
Da lahko agent uporablja Service Cloud Voice, je v aplikaciji Lightning Service Console potreben pripomoček Omni-Channel.
Uradno referenco Salesforce najdete s klikom na gumb Naredimo to, ki odpre stran Konfiguriraj izkušnjo agenta za Service Cloud Voice s partnersko telefonijo na portalu za pomoč Salesforce ( neposredna povezava). |
| 10 |
V razdelku Nastavitev v polje Hitro iskanje vnesite Nastavitev partnerske telefonije in nato izberite Nastavitev partnerske telefonije. |
| 11 |
Pomaknite se navzdol do razdelka 5 Več glasovnih nastavitev. |
| 12 |
Če želite omogočiti zaščito pred ClickJackom za strani Visualforce z onemogočenimi glavami med delom s programsko opremo v programu Lightning Experience, morate poleg URL-ja primerka Salesforce dodati domene, iz katerih se nalaga programska oprema in orodne vrstice po meri, kot zaupanja vredne domene. Te nastavitve in seznam zaupanja vrednih domen najdete v razdelku Nastavitve | Varnost | Nastavitve seje Če želite pridobiti pravilno domeno Visualforce, se pomaknite na Nastavitve | Koda po meri | Strani Visualforce in kliknite gumb Predogled za Primer: MyDomainName--cisco_wxcc_scv.vf.force.com Če želite pridobiti domeno primerka Salesforce, kopirajte URL, prikazan v naslovni vrstici brskalnika, in ga dodajte na seznam Seznam zaupanja vrednih domen za vdelane okvirje, pri čemer kot vrsto IFrame izberite Strani Visualforce. Primer: MyDomainName.lightning.force.com Če v svoji organizaciji nimate nameščene Moje domene, je oblika URL-ja drugačna. Če imate uvedeno možnost »Moja domena« in v vaši organizaciji niso omogočene izboljšane domene, je oblika URL-ja drugačna. Če izboljšane domene niso omogočene, na to obliko vpliva tudi nastavitev Stabiliziraj URL-je v programih Visualforce, Experience Builder, Site.com studio in datotekah z vsebino Moja domena. Za podrobnosti glejte Oblike URL-jev moje domene v pomoči za Salesforce. Nastavitve zaščite Clickjack in zaupanja vrednih domen za Lightning Experience |
| 13 |
Za prikaz kontrolnikov snemanja med klici potrebujejo agenti dovoljenje aplikacije Če ga želite dodeliti, ga dodajte naboru dovoljenj, ustvarjenemu v koraku Stanja prisotnosti.
|
Konfiguracija
Kontaktni center
Datoteka z definicijo kontaktnega centra določa niz polj in vrednosti, ki se uporabljajo za definiranje kontaktnega centra v Salesforceu za določen sistem CTI. Salesforce uporablja definicijske datoteke kontaktnega centra za podporo integracije z več ponudniki sistemov CTI.
Več informacij najdete v uradni dokumentaciji Salesforce ( neposredna povezava).
Uvoz kontaktnega centra
Prenesite najnovejšo različico kontaktnega centra tukaj.
Nadgradnja z beta različice: Ta priročnik opisuje čisto namestitev različice General Availability (GA) integracije Webex Contact Center za Salesforce Service Cloud Voice.
Če nadgrajujete z beta različice integracije, ne uporabljajte ponovno obstoječega zapisa kontaktnega centra partnerjev. Namesto tega:
- Uvozite datoteko XML kontaktnega centra za partnerje, ki je vključena v izdajo GA.
- Ustvarite nov zapis v centru za stik s partnerji z uporabo uvoženega XML-ja.
- Posodobite svojo konfiguracijo, da boste lahko uporabljali novo ustvarjeni center za stike s partnerji.
XML kontaktnega centra partnerjev GA vsebuje posodobljene konfiguracijske vrednosti, vključno s pravilnim URL-jem povezovalnika in drugimi metapodatki. Ponovna uporaba zapisa v centru za stike s partnerji, ustvarjenega iz beta XML, lahko ohrani zastarele konfiguracijske vrednosti in prepreči pravilno delovanje integracije.
| 1 |
V nastavitvah v polje Hitro iskanje [] vnesite ] Kontaktni centri partnerske telefonije in nato izberite Kontaktni centri partnerske telefonije. Prikaže se seznam obstoječih (če obstajajo) kontaktnih centrov.
|
| 2 |
Na desni strani kliknite Ustvari kontaktni center. |
| 3 |
Kot ponudnika telefonije izberite Webex Contact Center. Nato kliknite Naprej. Odpre se brskalnik datotek.
|
| 4 |
Izberite datoteko |
| 5 |
Kliknite Odpri. Datoteka je uvožena.
|
| 6 |
Preverite, ali je vaš kontaktni center prikazan na seznamu kontaktnih centrov. |
Konfigurirajte kontaktni center
| 1 |
V nastavitvah v polje Hitro iskanje [] vnesite ] Kontaktni centri partnerske telefonije in nato izberite Kontaktni centri partnerske telefonije. | ||||||||||||||||||||||||||||||
| 2 |
Kliknite prej uvoženi kontaktni center. | ||||||||||||||||||||||||||||||
| 3 |
Kliknite Uredi.
| ||||||||||||||||||||||||||||||
| 4 |
Na dnu strani Kontaktni center kliknite gumb Dodaj v razdelku Uporabniki kontaktnega centra. | ||||||||||||||||||||||||||||||
| 5 |
Kliknite + poleg uporabnikov, ki imajo dostop do odprtega kontaktnega centra. Na tem seznamu so prikazani samo uporabniki, ki imajo nastavljeno dovoljenje |
Prilagodi
Aplikacija za zunanje odjemalce za integracijo kontaktnega centra Webex
Konfigurirajte aplikacijo zunanjega odjemalca za Webex Contact Center Salesforce Connector
Za polno uporabo storitve Service Cloud Voice je mogoče prilagoditi tok klica v kontaktnem centru tako, da ustvari zapis glasovnega klica in izvede tok Salesforce Omni-Channel, medtem ko je klic na IVR-ju.
Ustvari potrdilo
Prepričajte se, da ste že ustvarili digitalno potrdilo v skladu z varnostno politiko vaše organizacije.
Za ustvarjanje digitalnega potrdila glejte dokumentacijo Salesforce na https://developer.salesforce.com/docs/atlas.en-us.voice_pt_developer_guide.meta/voice_pt_developer_guide/voice_pt_generate_certificate.htm.
Primer
openssl genrsa -des3 -passout pass: -out server.pass.key 2048
openssl rsa -passin pass: -in server.pass.key -out server.key
rm server.pass.key
openssl req -new -key server.key -out server.csr
Country Name (2 letter code) [AU]:CH
State or Province Name (full name) [Some-State]:
Locality Name (eg, city) []:
Organization Name (eg, company) [Internet Widgits Pty Ltd]:
Organizational Unit Name (eg, section) []:
Common Name (e.g. server FQDN or YOUR name) []:
Email Address []: my-api-user@my-example-org.com
Please enter the following 'extra' attributes
to be sent with your certificate request
A challenge password []:
An optional company name []:
openssl x509 -req -sha256 -days 365 -in server.csr -signkey server.key -out server.crt
strežnik.crt => Potrdilo za aplikacijo Salesforce External Client
strežnik.key => Zasebni ključ za Salesforce Connector v Webex Control Hub
Nastavitev dovoljenj za uporabnika integracije SCV
Naslednji nabor dovoljenj omogoča dostop do razredov Apex, ki jih uporablja Connects for SCV za integracijo s poteki IVR za kontaktni center in Webex Contact Center for Salesforce za SCV.
Sledi primer konfiguracije in opisuje minimalna potrebna dovoljenja za kontaktni center. / Integracija IVR za delovanje.
- V nastavitvah pojdite na Uporabniki | Nabori dovoljenj
- Kliknite gumb Novo.
- Vnesite oznako, na primer: Dostop do tečajev SCV Apex prek IVR
- Ime API-ja se samodejno izpolni
- Licenca: Brez
- Kliknite gumb Shrani.
- Odpre se nov nabor dovoljenj.
- Pomaknite se na Dostop do razreda Apex.
- Kliknite gumb Uredi in dodajte naslednje razrede Apex:
- cisco_wxcc_scv.ServiceRouting
- Pomaknite se do Sistemska dovoljenja.
- Kliknite gumb Uredi in omogočite naslednja dovoljenja:
- Storitve Apex REST
- API omogočen
Minimalni dostop – profil za integracije samo z API-jem
Ta profil se uporablja za integracijo s programom Webex Contact Center for Salesforce for SCV za ustvarjanje zapisov glasovnih klicev in izvajanje funkcije Omni-Flow iz poteka IVR.
Sledi primer konfiguracije in opisuje minimalna potrebna dovoljenja za kontaktni center. / Integracija IVR za delovanje.
To je klon profila Minimalni dostop - integracije samo z API-jem.
- V nastavitvah pojdite na Uporabniki | Profili.
- Na seznamu profilov poiščite profil Minimalni dostop – integracije samo z API-jem.
- Kliknite ime profila, da odprete profil Minimalni dostop – integracije samo z API-jem.
- V profilu Minimalni dostop – integracije samo z API-jem kliknite gumb Kloniraj.
- Vnesite novo ime profila, na primer: Integracija SCV.
- Kliknite gumb Shrani.
- Odpre se nov profil.
- Preverite, ali so v vašem profilu Minimalni dostop – integracije samo z API-jem odstranjena vsa dovoljenja.
- Pomaknite se do Sistemska dovoljenja.
- Prepričajte se, da so omogočena naslednja dovoljenja:
- API omogočen
- Uporabnik samo API-ja
Uporabnik integracije SCV
Sledi primer konfiguracije in opisuje minimalna potrebna dovoljenja za kontaktni center. / Integracija IVR za delovanje. Za uporabnika za integracijo SCV ni potrebna licenca Salesforce Service Cloud Voice ali licenca Webex Contact Center for Salesforce for SCV.
- V nastavitvah pojdite na Uporabniki | Uporabniki.
- Kliknite gumb Nov uporabnik.
- Vnesite ime, priimek in vsa ostala obvezna polja.
- Uporabniška licenca: Integracija Salesforcea
- Profil: izberite profil, ustvarjen v prejšnjem koraku ("profil integracije SCV", klon profila Minimalni dostop - integracije samo API)
- Kliknite gumb Shrani.
- Odprite nov zapis uporabnika.
- Dodelite nabor dovoljenj, ki ste ga ustvarili prej ("Dostop IVR do razredov SCV Apex").
- Dodeli licenco za nabor dovoljenj Integracija Salesforce API.
Ustvarite aplikacijo za zunanje odjemalce Salesforce
Ustvarjanje nove aplikacije za zunanje odjemalce
Obstajata dve možnosti za povezavo podatkov Salesforce z aplikacijami tretjih oseb. TakoPovezane aplikacijekotAplikacije zunanjih odjemalcevso ogrodja za integracijo podatkov. Aplikacije zunanjih odjemalcev so naslednja generacija povezanih aplikacij.
Če želite konfigurirati aplikacijo Salesforce External Client, ki jo uporablja kontaktni center Cisco Webex:
- V Nastavitvese pomaknite doAplikacije | Aplikacije zunanjega odjemalca | Upravitelj aplikacij zunanjega odjemalca.
- Kliknite naNova zunanja odjemalska aplikacija.
- Aplikacija za zunanje odjemalce – osnovne informacije
- Ime zunanje odjemalske aplikacije: WxCC - SCV
- Ime API-ja: ŠxCC_SCV
- E-poštni naslov za stik < your email >
- Država distribucije: izberite Lokalno

Zunanja odjemalska aplikacija – API (omogoči nastavitve OAuth)
- Izberite: Omogoči OAuth
- Nastavitve aplikacije
- Povratni klic URL: http://localhost:1717/OauthRedirect as vzorčni URL za povratni klic
- Obsegi OAuth
- Izberite obsege OAuth:
- Upravljanje uporabniških podatkov prek API-jev (api)
- Izvajanje zahtev kadar koli (refresh_token, offline_access)

Omogočanje pretoka
- Izberite: Omogoči tok nosilca JWT
- Kliknite Naloži datoteke in naložite datoteko
server.crt, ki vsebuje vaše digitalno potrdilo.

Varnost
Počistite možnost Zahtevaj skrivnost za potek spletnega strežnika.

- Kliknite gumbUstvari.
- Spremenite na zavihek Pravilniki in nato kliknite gumbUredi.
- Pravilniki – Pravilniki OAuth
- Pravilniki o vtičnikih
- Dovoljeni uporabniki: Izberite uporabnike, ki jih je odobril skrbnik, in so predhodno pooblaščeni
- Potrdite spremembo
- Avtorizacija aplikacije
- Pravilnik o osvežitvi žetonov: izberite Takojšnji potek osvežilnega žetona
- Sprostitev IP-ja: izberite Uveljavi omejitve IP-ja

- Pravilniki o vtičnikih
- Pravilniki – Pravilniki aplikacij
- Začetna stran – brez
- Izberite nabore dovoljenj – dodelite prej ustvarjen nabor dovoljenj (»Dostop IVR do razredov SCV Apex«).

- Kliknite Shrani.
- Spremeni v Nastavitve zavihkov.
-
V razdelku Nastavitve OAuth kliknite gumbKljuč potrošnika in Skrivnost; počakajte na e-pošto in potrdite svojo identiteto. V novem zavihku brskalnika se odpre zaslon s podatki o potrošniku.

- Kliknite Kopiraj in shraniteključ potrošnika. Ključ potrošnika se kasneje uporabi za ustvarjanje priključka Salesforce v nadzornem središču Webex Contact Center.

-
Konfiguracija kontaktnega centra Webex in skript za ustvarjanje zapisov glasovnih klicev
Da bi v celoti izkoristili Salesforce Service Cloud Voice, je treba spremeniti potek klicev v centru Webex Contact Center tako, da se zapis glasovnega klica v storitvi Service Cloud Voice ustvari takoj, ko klic prispe v center za stike.
Za odločitve o usmerjanju in avtomatizacijo v Salesforceu je mogoče izvesti izbirni Omni-Flow.
Za podrobnosti o uporabljenih API-jih glejte Ovoj API-ja storitve Cloud Voice.
Predpogoji
Za uporabo ovojnice API-ja Service Cloud Voice je treba konfigurirati aplikacijo Salesforce External Client za integracijo IVR.
Konfigurirajte Salesforce Connector v Webex Control Hub
Nastavite priključke za integracijo Salesforce za kontaktni center Webex, kot je opisano v članku na https://help.webex.com/en-us/article/7fuy63/Set-Up-Integration-Connectors-for-Webex-Contact-Center#id_133211.
| 1 |
Prijavite se v svojo organizacijo strank na https://admin.webex.com in pojdite na Storitve > Kontaktni center > Nastavitve najemnika > Integrations>Connectors. |
| 2 |
Na kartici Salesforce kliknite Nastavi ali dodaj povezovalnik.
POMEMBNO: VARNOST ZAGOTAVLJAJTE Z OBČASNIM MENJAVANJEM SKRIVNOSTI Za varnost integracij redno menjajte zasebni ključ in potrdilo. Posodobite zasebni ključ v priključku za kontaktni center v Webex Hubin potrdilo v aplikaciji za zunanje odjemalce v Salesforce. Nasvet za odpravljanje težav Ko kliknete Končano in se povezovalnik ne shrani:
|
Glavni tok kontaktnega centra Webex
| Spremenljivka pretoka | Opis |
|---|---|
| Spremenljivka pretoka za ID zapisa glasovnega klica | Enolična identifikacijska številka za identifikacijo klica. Potrebno za ustvarjanje zapisa glasovnega klica. Oblika: wxcc_<Interaction Id> Primer: wxcc_fc4ec7d8-4c91-49aa-b764-081fbba344a8
|
| Lokalna spremenljivka za čas začetka klica |
Uporablja se za ustvarjanje zapisa glasovnega klica in pri posodabljanju glasovnega klica.
|
| Lokalna spremenljivka za čakalno vrsto name/id |
Vrne Izvedi Omni Flow, ki se uporablja za usmerjanje klicev. Ta spremenljivka je potrebna samo pri uporabi ukaza Execute Omni Flow.
|
| Lokalna spremenljivka za agenta name/id |
Vrne Izvedi Omni Flow, ki se uporablja za usmerjanje klicev. Ta spremenljivka je potrebna samo pri uporabi ukaza Execute Omni Flow.
|
Pregled glavnega toka

- Ustvari ključ za klic dobavitelja
- Nastavi čas začetka klica
- Zahteva HTTP: Ustvari zapis glasovnega klica
- Ocena odgovora HTTP za ustvarjanje zapisa glasovnega klica
- Obravnava napak pri ustvarjanju zapisa glasovnega klica
- Zahteva HTTP: Izvedi Omni Flow
- Oceni odgovor HTTP za izvedbo Omni Flow
- Obravnavanje napak pri izvajanju Omni Flow
- Nadaljujte z usmerjanjem klicev
| Tok | Opis |
|---|---|
| Ustvari ključ za klic dobavitelja |
Vsak klic, obdelan v storitvi Service Cloud Voice, ustvari zapis glasovnega klica v storitvi Salesforce in zahteva edinstven ID, imenovan ključ klica dobavitelja. Za zapise glasovnih klicev, ustvarjene v centru Webex Contact Center, mora biti ključ za klic dobavitelja definiran v toku WxCC in nato posredovan skupaj s klicem agentu z uporabo spremenljivke toka. Vrednost vendorCallKey mora biti v skladu z naslednjimi pravili:
|
| Nastavi čas začetka klica |
Časovni žig UTC začetnega časa klica. Ta časovni žig se uporablja za ustvarjanje zapisa glasovnega klica in za posodobitev zapisa glasovnega klica, če klicatelj prekine klic, preden je preusmerjen k agentu.
|
| Zahteva HTTP: Ustvari zapis glasovnega klica |
Ta korak je potreben za vsak klic. Ko je zapis glasovnega klica ustvarjen, je treba ID zapisa glasovnega klica posredovati skupaj s klicem agentu v spremenljivki, skupaj s ključem za klic prodajalca. Konfigurirajte uporabljeno spremenljivko v konfiguraciji kontaktnega centra v storitvi Service Cloud Voice. |
| Nastavitve zahtev HTTP |
|
Zahteva HTTP: Ustvari zapis glasovnega klica
Ta korak je potreben za vsak klic. Ko je zapis glasovnega klica ustvarjen, je treba ID zapisa glasovnega klica posredovati skupaj s klicem agentu v spremenljivki, skupaj s ključem za klic prodajalca. Konfigurirajte uporabljeno spremenljivko v konfiguraciji kontaktnega centra v storitvi Service Cloud Voice.
Nastavitve zahtev HTTP
- Oznaka dejavnosti: UstvariGlasovniKlic
- Uporabi overjeno končno točko: Omogočeno
- Priključek: Salesforce Connector, ustvarjen v prejšnjem koraku
- Pot zahteve:
/services/apexrest/cisco_wxcc_scv/voice/v1/createVoiceCall - Metoda: OBJAVI
- Vrsta vsebine zahteve: Application/JSON
Telo zahteve
Pri ustvarjanju zapisa glasovnega klica lahko posodobite tudi polja po meri v zapisu glasovnega klica s podatki o klicu. Spodaj sta dva primera telesa zahteve, eden z vsemi obveznimi polji, vendar brez posodobitve polj po meri, in eden s polji po meri.
Brez posodabljanja polj po meri v zapisu glasovnega klica:
{
"callCenterDevName": "",
"certDevName": "",
"vendorCallKey": "{{SCV_VendorCallKey}}",
"to": "{{NewPhoneContact.DNIS}}",
"from": "{{NewPhoneContact.ANI}}",
"initiationMethod": "Inbound",
"startTime": "{{SCV_CallStartTime}}",
"participants": [
{
"participantKey": "{{NewPhoneContact.ANI}}",
"type" : "END_USER"
}
]
}
Primer posodabljanja polj po meri v zapisu glasovnega klica:
{
"callCenterDevName": "",
"certDevName": "",
"vendorCallKey": "{{SCV_VendorCallKey}}",
"to": "{{NewPhoneContact.DNIS}}",
"from": "{{NewPhoneContact.ANI}}",
"initiationMethod": "Inbound",
"startTime": "{{SCV_CallStartTime}}",
"participants": [
{
"participantKey": "{{NewPhoneContact.ANI}}",
"type" : "END_USER"
}
],
"callAttributes": "{\"custfield1__c\": \"\",\"custfield2__c\": \"\",\"custfield3__c\": \"\"}"
}
Parametri
| Ime nepremičnine | Vrednost |
|---|---|
| ImeRazvijalca klicnegaCentra | Ime razvijalca kontaktnega centra |
| ImeRazvijalcaCert | Ime API-ja potrdila (kot je konfigurirano v kontaktnem centru) |
| prodajalcaCallKey | Enolična identifikacijska številka klica: {{SCV_VendorCallKey}} |
| za | CalledNumber/DNIS: {{NewPhoneContact.DNIS}} |
| od | CallingNumber/ANI: {{NewPhoneContact.ANI}} |
| začetni čas | Časovni žig UTC {{SCV_CallStartTime}} (nastavi se takoj po tem, ko je klic sprejet v skripti) |
| Atributi klica |
Predstavlja dodatna standardna in prilagojena polja v zapisu glasovnega klica, kjer vsak par ključ-vrednost ustreza standardnemu ali prilagojenemu polju in njegovim vrednostim. Primer: |
Nastavitve razčlenjevanja
- Vrsta vsebine: JSON
- Izhodna spremenljivka: SCV_IDZapisaVoiceCall
- Izraz poti:
$.data.voiceCallId
ID zapisa glasovnega klica, ki se posreduje agentu.
Ocena odgovora HTTP za ustvarjanje zapisa glasovnega klica
Preverite stanje HTTP zahteve za ustvarjanje glasovnega klica:
- Oznaka: koda stanjaUstvariGlasovni klic
- Spremenljivka: CreateVoiceCall.httpStatusCode
Če koda stanja == 200 => sicer uspešno => zahteva ni uspela, obravnavanje napak
Obravnava napak pri ustvarjanju zapisa glasovnega klica
Za predstavitev / samo odpravljanje napak, predvajanje sporočila odvisno od kode stanja http.
Če je bilo ustvarjanje glasovnega klica uspešno, nadaljujte z izvedbo ukaza Omni Flow. V nasprotnem primeru nadaljujte z usmerjanjem klicev.
Zahteva HTTP: Izvedite Omni Flow (neobvezen korak)
Uporabite Execute Omni-Flow, kadar želite:
- izvajajte avtomatizirana opravila, na primer iščite ali ustvarjajte zapise, in jih povežite z zapisom glasovnega klica
- iskanje zapisov in prikazovanje zaslona
- sinhronizirajte čakalne vrste Salesforce in Cisco
- Naj Service Cloud Voice sprejme odločitev o usmerjanju
Ta zahteva vedno vrne »čakalno vrsto« ali »agenta«, kamor je treba klic usmeriti.
Po izvedbi te zahteve poskrbite, da pošljete sporočilo »Clear Routing«, če klicatelj prekine klic, preden se mu oglasi agent. Glejte Potek dogodkov kontaktnega centra Webex.
Nastavitve zahtev HTTP
- Oznaka dejavnosti: Izvedi OmniFlow
- Uporabi overjeno končno točko: Omogočeno
- Priključek: Salesforce Connector, ustvarjen v prejšnjem koraku
- Pot zahteve:
/services/apexrest/cisco_wxcc_scv/voice/v1/executeOmniFlow - Metoda: OBJAVI
- Vrsta vsebine zahteve: Application/JSON
Telo zahteve
Poleg obveznih polj lahko v Omni-Flow posredujete tudi dodatne podatke kot vhodne spremenljivke. Spodaj sta dva primera telesa zahteve. Prvi brez dodatnih parametrov pretoka, samo z obveznimi polji, drugi z dvema vhodnima spremenljivkama.
Primer s parametri Omni-Flow:
{
"callCenterDevName": "",
"certDevName": "",
"voiceCallId": "{{SCV_VoiceCallRecordId}}",
"dialedNumber": "{{NewPhoneContact.DNIS}}",
"flowDevName": "",
"fallbackQueue": ""
}
Primer posodabljanja polj po meri v zapisu glasovnega klica:
{
"callCenterDevName": "",
"certDevName": "",
"voiceCallId": "{{SCV_VoiceCallRecordId}}",
"dialedNumber": "{{NewPhoneContact.DNIS}}",
"flowDevName": "",
"fallbackQueue": "",
"flowInputParameters":
{
"param1": "value1",
"param2": "value2"
}
}
Parametri
| Ime nepremičnine | Vrednost |
|---|---|
| ImeRazvijalca klicnegaCentra | Ime razvijalca kontaktnega centra |
| ImeRazvijalcaCert | Ime API-ja potrdila (kot je konfigurirano v kontaktnem centru) |
| ID glasovnega klica | ID zapisa glasovnega klica, ustvarjenega v prejšnjem koraku: {{SCV_VoiceCallRecordId}} |
| klicana številka | CalledNumber/DNIS: {{NewPhoneContact.DNIS}} |
| flowDeveloperName | Ime razvijalca Omni-Flow, ki ga je treba izvesti |
| rezervna čakalna vrsta | ID čakalne vrste ali ime API-ja čakalne vrste za rezervno čakalno vrsto Salesforce |
| Parametri vhodnih parametrov pretoka |
Dodatni vhodni podatki za tok Omni-Channel (par ključ-vrednost). Primer: |
Nastavitve razčlenjevanja
Čakalna vrsta
- Vrsta vsebine: JSON
- Izhodna spremenljivka: SCV_OmniFlowQueue
- Izraz poti:
$.data.queue
»Čakalna vrsta«, ki jo vrne Execute Omni-Flow, se lahko uporabi za usmerjanje.
Posrednik- Vrsta vsebine: JSON
- Izhodna spremenljivka: SCV_OmniFlowAgent
- Izraz poti:
$.data.agent
"Agent", vrnjen iz programa Execute Omni-Flow, se lahko uporabi za usmerjanje.
Oceni odgovor HTTP za izvedbo Omni Flow
Preverite stanje HTTP zahteve Execute Omni Flow http:
- Oznaka: statusCodeExecuteOmniFlow
- Spremenljivka: IzvediOmniFlow.httpStatusCode
Če koda stanja == 200 => sicer uspešno => Zahteva ni uspela, obravnavanje napake.
Obravnavanje napak pri izvajanju Omni Flow
Za predstavitev / samo odpravljanje napak, predvajanje sporočila odvisno od kode stanja http.
Če je bila izvedba ukaza Omni Flow uspešna, spremenljivki SCV_OmniFlowQueue in SCV_OmniFlowAgent nista nastavljeni. Odločitev o usmerjanju v toku klicev.
Nadaljujte z usmerjanjem klicev
Nadaljujte s potekom klica, preusmerite klic k agentu. Neobvezno, za izbiro čakalne vrste in agenta uporabite SCV_OmniFlowQueue in SCV_OmniFlowAgent.
Potek dogodkov kontaktnega centra Webex
Če klicatelj prekine klic, preden se nanj oglasi agent, moramo posodobiti Service Cloud Voice in prekiniti klic.
- Če je bil uporabljen ukaz »Izvedi Omni-Flow«, pošljite ukaz »Počisti usmerjanje«, da izbrišete čakajoče usmerjanje storitev (PSR).
- Pošljite posodobitev glasovnega klica, da posodobite začetni in končni čas v zapisu glasovnega klica ter spremenite stanje iz Novo v Zaključeno

- PhoneContactEnded – Ta dogodek se sproži, ko se aktivni klic prekine in so vsi udeleženci odstranjeni.
- Zahteva HTTP: Počisti usmerjanje
- Zahteva HTTP: Posodobi glasovni klic
Zahteva HTTP: Počisti usmerjanje
- Oznaka: Počisti usmerjanje
- Uporabi overjeno končno točko: Omogočeno
- Priključek: Salesforce Connector, ustvarjen v prejšnjem koraku
- Pot zahteve:
/services/apexrest/cisco_wxcc_scv/voice/v1/clearRouting - Metoda: OBJAVI
Vrsta vsebine zahteve: Application/JSON
Telo zahteve
{
"callCenterDevName": "",
"certDevName": "",
"voiceCallId": "{{SCV_VoiceCallRecordId}}"
}
Parametri
| Ime nepremičnine | Vrednost |
|---|---|
| ImeRazvijalca klicnegaCentra | Ime razvijalca kontaktnega centra |
| ImeRazvijalcaCert | Ime API-ja potrdila (kot je konfigurirano v kontaktnem centru) |
| ID glasovnega klica | ID zapisa glasovnega klica, ustvarjenega v prejšnjem koraku: SCV_IDZapisaVoiceCall |
Nastavitve razčlenjevanja
Nobenega.
Zahteva HTTP: Posodobi glasovni klic
- Oznaka: Posodobi glasovni klic
- Uporabi overjeno končno točko: Omogočeno
- Priključek: Salesforce Connector, ustvarjen v prejšnjem koraku
- Pot zahteve:
/services/apexrest/cisco_wxcc_scv/voice/v1/updateVoiceCall - Metoda: OBJAVI
- Vrsta vsebine zahteve: Application/JSON
Telo zahteve
{
"callCenterDevName": "",
"certDevName": "",
"voiceCallId": "{{SCV_VoiceCallRecordId}}",
"startTime": "{{SCV_CallStartTime}}",
"endTime": "{{now() | replace({'[UTC]': ''})}}",
"disconnectReason": { "value": "Abandoned in queue", "isError": true }
}
Parametri
| Ime nepremičnine | Vrednost |
|---|---|
| ImeRazvijalca klicnegaCentra | Ime razvijalca kontaktnega centra |
| ImeRazvijalcaCert | Ime API-ja potrdila (kot je konfigurirano v kontaktnem centru) |
| ID glasovnega klica | ID zapisa glasovnega klica, ustvarjenega v prejšnjem koraku: SCV_IDZapisaVoiceCall |
| začetni čas | Časovni žig UTC začetka klica {{SCV_CallStartTime}} (kot se uporablja za ustvarjanje zapisa glasovnega klica) |
| končni čas | Trenutni časovni žig UTC `{{now() |
| Razlog za prekinitev povezave | Razlog za prekinitev klica. Lastnost isError mora biti nastavljena na true, da se pravilno prikaže. |
Nastavitve razčlenjevanja
Nobenega.
Reference
- Ustvarite zasebni ključ in samopodpisano digitalno potrdilo
- Konfigurirajte povezano aplikacijo za Webex Contact Center Salesforce Connector
- Nastavitev integracijskih konektorjev za kontaktni center Webex – Salesforce
- Vodnik za nastavitev in skrbništvo kontaktnega centra Cisco Webex > Oblikovalec pretoka
- REST API za integracijo telefonije
Prevajanje jezikov
(Neobvezno) Omogoči delovno mesto za prevajanje
Ta nastavitev velja le, če uporabljate nastavitve jezika prevajanja.
| 1 |
Pojdite v Nastavitve → Prevajalsko delovno okolje → Nastavitve jezika prevajanja. |
| 2 |
Kliknite Omogoči, da izberete jezik prevajanja. |
(Izbirno) Omogoči jezike samo za platformo
Ta nastavitev velja samo za jezike, ki niso EN-US.
| 1 |
Pojdite v Nastavitve → Nastavitve podjetja → Jezikovne nastavitve. |
| 2 |
Izberite zahtevane jezike. |
| 3 |
Izberite naslednja potrditvena polja:
|
| 4 |
Shranite spremembe. |
Aktivirajte jezik in izberite uporabnika (nalogo)
| 1 |
Pojdite v Nastavitve → Prevajalsko delovno okolje → Nastavitve jezika prevajanja. |
| 2 |
Izberite jezik in izberite uporabnika, ki ga bo prevajal. |
| 3 |
Shranite spremembe. |
Večjezične nastavitve
Prevedi oznake po meri
| 1 |
Pojdite v Nastavitve → Oznake po meri. |
| 2 |
Izberite ime nalepke po meri, ki jo želite odpreti.
|
| 3 |
Na seznamu povezanih prevodov kliknite |
| 4 |
Izberite jezik, v katerega prevajate. |
| 5 |
V polje Besedilo prevoda vnesite prevedeno vrednost. To besedilo prepiše vrednost, navedeno v polju Vrednost oznake, ko je privzeti jezik uporabnika jezik prevajanja. |
| 6 |
Shranite spremembe. |
Dovoljenja Salesforce, ki jih zahteva uporabniška funkcija
Komplet dovoljenj agenta Webex Contact Center SCV vsebuje vsa dovoljenja, potrebna za delo s pripomočkom Webex Contact Center in integracijami, razvitimi za agente.
Dostop do razreda Apex (oddelek)
- cisco_wxcc_scv.CiscoScvWxcc
- cisco_wxcc_scv.ServiceResponseHandler
- cisco_wxcc_scv.ServiceRouting
- cisco_wxcc_scv.TelephonyIntegrationHandler
Dostopi do vrst metapodatkov po meri (razdelek)
- cisco_wxcc_scvPovezava .WxCC
Dostop do strani Visualforce (razdelek)
- cisco_wxcc_scv.CiscoScvLoginWxCC
- cisco_wxcc_scv.CiscoScvMainWxCC
- cisco_wxcc_scv.CiscoScvOAuthPreusmeritev
- cisco_wxcc_scv.CiscoScvSwLoader
Ovoj API-ja storitve Cloud Voice
Predpogoji
Za uporabo ovojnice API-ja Service Cloud Voice je treba konfigurirati aplikacijo Salesforce External Client za integracijo IVR.
Uporabite ovojnico API-ja Service Cloud Voice
Service Cloud Voice (SCV) za Salesforce uporablja REST API za integracijo telefonije za ustvarjanje in posodabljanje glasovnih klicev, izvajanje večkanalnih tokov in brisanje zapisov PendingServiceRouting, povezanih z glasovnim klicem. Ta storitev zahteva avtorizacijo JWT in uporabo metode PATCH HTTP, ki je Cisco IP Interactive Voice Response (IVR) trenutno ne podpira.
Za poenostavitev uporabe REST API-ja za integracijo telefonije za SCV v (ne le) sistemu IVR je na voljo nov nabor API-jev, ki dopolnjujejo obstoječi API Salesforce in so dostopni neposredno iz organizacije Salesforce, kjer je nameščen paket Webex Contact Center for Service Cloud Voice.
Ovoj API-ja Service Cloud Voice odpravlja potrebo po preverjanju pristnosti žetona JWT, izvaja dodatna preverjanja podatkov, ki jih zahteva Salesforce API, in izboljšuje objekte odziva.
Pridobi žeton Access_
Izvedi zahtevo POST za https://<your-domain-name>.my.salesforce.com/services/oauth2/token
Pošiljanje naslednjih parametrov v telesu:
{
"grant_type": "client_credentials",
"client_id": "",
"client_secret": ""
}
If the request is successful, the following JSON response will be returned:
{
"access_token": "",
"instance_url": "",
"id": "https://login.salesforce.com/id//",
"token_type": "Bearer",
"issued_at": "",
"signature": ""
}
Izvedite zahteve
URL primerka mora vsebovati my.salesforce.com.
Primer pravilnega URL-ja primerka: https://abc-123.my.salesforce.com
Uporaba katere koli druge domene kot URL-ja primerka (npr. https://abc-123.lightning.force.com ) povzroči stanje 401 Nepooblaščeno z vrnjeno kodo napake INVALID_SESSION_.
Ustvari glasovni klic (razdelek)
Ustvari zapis VoiceCall, ki vsebuje udeležence (torej klicatelja in prejemnika) za zapis VoiceCall. Ko ustvarite zapis VoiceCall, se v Salesforceu ustvari pogovor. Ta API uporabljajte samo v realnem času, kar pomeni, da ga morate poklicati le, ko se sproži klic. Ta API se lahko uporabi tudi za ustvarjanje zapisov VoiceCall za preusmeritve in konferenčne klice z vključitvijo parametra parentVoiceCallId v koristno vsebino zahteve.
URI končne točke
<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/createVoiceCall
Metoda HTTP
OBJAVI
Naslovnice
Avtorizacija: Nosilec <access_token>
Vrsta vsebine: application/json
Parametri
{
"callCenterDevName": "contactCenterDevName123",
"certDevName": "certDevName123",
"vendorCallKey": "5324881f-1e84-4367-8930-f69a74b30ca6",
"to": "8002345678",
"from": "4081456688",
"initiationMethod": "Inbound",
"startTime": "2019-07-02T17:32:28Z",
"participants": [
{
"participantKey": "4081456688",
"type" : "END_USER"
}
],
"callAttributes": "{\"devscv24__AAA_Test__c\":\"field value\",\"Other_Field__c\":\"other value\"}",
"parentVoiceCallId": "fsdfzuhsdfsa-43556fgef3-56g44gv4ew",
"callOrigin": "Preview",
"queue": "queue123"
}
Odgovor (uspešen)
{
"data": {
"voiceCallId": "00X000012345abc"
},
"errors": null,
"success": true
}
Odgovor (z napakami)
{
"data": null,
"errors": ["Error message 1", "Error message 2"],
"success": false
} Posodobi glasovni klic
Posodobi glasovni klic po koncu klica. S tem API-jem lahko posodobite parametre, povezane s klici, ki niso na voljo med fazo ustvarjanja VoiceCall. API za posodobitev glasovnega klica je asinhrona operacija. Stanja klica API-ja ni mogoče preveriti.
To končno točko je mogoče uporabiti tudi za ustvarjanje glasovnega klica tudi po koncu klica. To vedenje je uporabno v primerih, ko želite v Salesforceu zabeležiti zapis za zapuščene ali zgrešene klice ali v katerem koli drugem primeru, ko glasovni klic še ni bil ustvarjen.
URI končne točke
<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/updateVoiceCall
Metoda HTTP
OBJAVI
Naslovnice
Avtorizacija: Nosilec <access_token>
Vrsta vsebine: application/json
Parametri
{
"callCenterDevName": "contactCenterDevName123",
"certDevName": "certDevName123",
"voiceCallId": "00X000012345abc",
"startTime": "2020-08-26T21:21:14Z",
"endTime": "2019-08-26T21:21:34Z",
"isActiveCall": true,
"fromNumber": "1234",
"callOrigin": "Preview",
"enqueueTime": "2019-08-26T21:21:34Z",
"acceptTime": "2019-08-26T21:21:24Z",
"numberOfHolds": 20,
"queue": "queue123",
"agent": "agent123",
"agentInteractionDuration": 12,
"longestHoldDuration": 10,
"totalHoldDuration": 21,
"recordingLocation": "Bern",
"totalRecordingDuration": 55,
"callAttributes": "{\"devscv24__AAA_Test__c\":\"field value\",\"Other_Field__c\":\"other value\"}",
"disconnectReason": {
"value": "TELECOM_PROBLEM",
"isError": true
}
} Odgovor (uspešen)
{
"data": {
"status": "pending"
},
"errors": null,
"success": true
} API za posodobitev glasovnega klica je asinhrona operacija. Stanja klica API-ja ni mogoče preveriti.
Odgovor (z napakami)
{
"data": null,
"errors": ["Error message 1", "Error message 2"],
"success": false
} Izvedi Omni-flow
Izvede večkanalni tok za usmerjanje klicev. Posreduje ID klica (Salesforce VoiceCallId ali ContactId ponudnika telefonije) kot parameter toku in vrne navodila za usmerjanje agenta ali čakalne vrste toku stika. Service Cloud Voice privzeto uporablja tok Omni-Channel (ali rezervno čakalno vrsto), določen za telefonski kanal, ki se ujema s klicano številko. Če klicana številka ne ustreza obstoječemu telefonskemu kanalu, lahko po želji nastavite novo klicano številko, tok Omni-Channel in rezervno čakalno vrsto kot vhodne parametre za ta klic API-ja.
Storitev Cloud Voice uporablja ta vrstni red prednosti za usmerjanje klicev:
- Uporablja nastavitve večkanalnega toka in rezervne čakalne vrste za telefonski kanal, ki se ujema s klicano številko. Tok ima prednost. Če tok ne uspe, se uporabi rezervna čakalna vrsta.
- Uporablja parametra flowDevName in fallbackQueue, določena v klicu API-ja Execute Omniflow.
URI končne točke
<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/executeOmniFlow
Metoda HTTP
OBJAVI
Naslovnice
Avtorizacija: Nosilec <access_token>
Vrsta vsebine: application/json
Parametri
{
"callCenterDevName": "contactCenterDevName123",
"certDevName": "certDevName123",
"voiceCallId": "00X000012345abc",
"dialedNumber": "+18445791189",
"flowDevName": "Route_VoiceCall",
"fallbackQueue": "00G111222333444",
"flowInputParameters":
{
"Input1": "one",
"Input2": "two"
}
} Odgovor (uspešen)
{
"data": {
"queue": "queue info",
"agent": "agent info"
},
"errors": null,
"success": true
} AGENT_INFO in QUEUE_INFO ustrezata polju ExternalId v CallCenterRoutingMap
Odgovor (z napakami)
{
"data": null,
"errors": ["Error message 1", "Error message 2"],
"success": false
} Jasna pot
Izbriše zapis PendingServiceRouting (PSR) za glasovni klic. Tega API-ja v večini scenarijev ni treba klicati; zapis PSR se samodejno izbriše, ko klic ni več usmerjen. Vendar pa obstajajo nekateri scenariji, na primer pri zgrešenih ali prekinjenih klicih pri uporabi partnerskih telefonskih sistemov, kjer morate ta API izrecno poklicati, da počistite zapis PSR.
URI končne točke
<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/clearRouting
Metoda HTTP
OBJAVI
Naslovnice
Avtorizacija: Nosilec <access_token>
Vrsta vsebine: application/json
Parametri
{
"callCenterDevName": "contactCenterDevName123",
"certDevName": "certDevName123",
"voiceCallId": "00X000012345abc"
} Odgovor (uspešen)
{
"data": {
"status": "Success"
},
"errors": null,
"success": true
} Odgovor (z napakami)
{
"data": null,
"errors": ["Error message 1", "Error message 2"],
"success": false
} Prevodi telefonskih številk
Različne interakcije med Service Cloud Voice in Webex Contact Center so odvisne od prevodov telefonskih številk. Zaradi mednarodnih razlik in specifičnih aplikacij za stranke je potrebno prilagodljivo orodje za prenos telefonskih številk iz formata A v format B.
Rešitev Webex Contact Center for Service Cloud Voice samodejno odstrani vse znake razen številk in hashtagov (#), zvezdice (*), vejice (,) in vodilni znaki plus (+). Prav tako odstrani prvo pojavitev (0). To bo storjeno PREDEN bodo uporabljeni prevodi vaših telefonskih številk.
Ta priročnik opisuje, kako konfigurirati prevode telefonskih številk.
Polja
Prevodi telefonskih številk so shranjeni v poljih Ime-Vrednost. To vam omogoča, da konfigurirate neomejeno število pravil za vsako funkcijo.
Konfiguracija je shranjena kot niz JSON.
Upoštevajte, da je treba poševne črte ubežati, npr. \d+ postane \\d+.
{"Remove all characters but digits":"[1,17]->[^\\d]+","To internal number":"[7,17]->(\\d{7})(\\d{4})->$2"}
Polje Ime se tehnično ne uporablja. Namenjen je dodajanju človeku berljivega niza, da se hitro prepozna namen tega pravila. Dobra imena so na primer: Odstrani vse vodilne ničle, Dodaj vodilni plus itd.
Ustvarjanje pravil prevajanja
Pravila so podana kot regularni izrazi. Da bom natančnejši: Implementacija regularnih izrazov v JavaScriptu.
Dober način za začetek je branje dokumenta RegExp iz spletne dokumentacije MDN.
Kljub temu je ustvarjanje kompleksnih regularnih izrazov pogosto okorno. Zato smo dodali dodatno sintakso, da bi bila konfiguracija čim bolj enostavna.
Spodnja slika prikazuje splošno sintakso pravila za prevajanje telefonske številke:
Predikat
Predikat se uporablja za določitev intervala, ki določa dolžino števila, ki se ujema.
Zgornji predikat določa, da so vsa števila z dolžino med 7 in 11 znaki (vključno z robovi + presledki) se ujemajo.
Predikati se vedno ujemajo z originalno dolžino števila. To pomaga poenostaviti konfiguracijo z zmanjšanjem tveganja za trčenje pravil za interne / zunanje številke.
Vzorec
Vzorec določa obliko zapisa števila, ki se mora ujemati.
Zgornji vzorec določa, da mora število vsebovati samo števke, in jih izbere.
Izbirnik
Izbirniki določajo končno obliko števila. Če znaki / Treba je dodati številke, ki prvotno niso bile prisotne, tukaj je pravo mesto za to.
Selektor je zadnji korak pri sestavljanju števila. Na podlagi izhodnega vzorca selektor sestavi novo število.
Primer 1
Naslednji primer prikazuje, kako prenesti številko, prejeto iz kontaktnega centra v formatu 0319175200, v švicarski format E164. +41 31 917 52 00.
Ta primer uporablja dve pravili prevajanja (1. in 2.)
Prvo pravilo v tem primeru dejansko ne spremeni števila. Pri številkah, dolgih od 1 do 17 znakov, bi bilo odstranjeno vse razen številk. Ker ni prisotnega neštevilčnega števila, se nič ne spremeni.
Drugo pravilo velja za številke, ki so (prvotno) dolge natanko 10 znakov. 0319175200 se ujema in zato se pravilo uporabi. Vzorec določa, da se mora številka začeti s skupino ene števke (\d{1}), ki mu sledi skupina dveh števk (\d{2}), ki mu sledi skupina treh števk (\d{3}) in tako naprej.
Selektor nato dostopa do skupin vzorcev, da definira nov številski niz. To pomeni $2 sklicuje se na prvo (\d{2}) in zato vsebuje 31.
Primer 2
Naslednji primer prikazuje, kako prenesti številko, prejeto iz kontaktnega centra, v formatu +14693150217 v ameriški format E164 +1 469 315 0217.
Ta primer uporablja dve pravili prevajanja (1. in 2.)
- Ta številka je dolga natanko 12 znakov, zato velja pravilo »Dodaj presledke ameriškim številkam«.
- (\+1) pravi, da se mora številka začeti z +1. Če je številka dolga 12 znakov, vendar se ne začne z +1, Pravilo je preklicano in nič se ne spremeni.
- (\d{3}) pravi, da +1 morajo slediti 3 števke.
- (\d{3}) pravi, da morajo zadnjim 3 števkam slediti še 3 števke.
- (\d{4}) pravi, da morajo zadnjim 3 števkam slediti 4 števke.
Če se karkoli od tega ne ujema, se številka ne bo spremenila.
Torej, vsa pravila veljajo za “+14693150217”. Zato se število spremeni za “$1 $2 $3 $4”:
- $1 se nanaša na skupino (\+1), številka, ki jo je treba poslati storitvi Service Cloud Voice, je videti takole +1.
- $2 nanaša se na prvega od obeh (\d{3}), številka, ki jo je treba poslati storitvi Service Cloud Voice, izgleda takole +1 469.
- $3 nanaša se na drugega od obeh (\d{3}), številka, ki jo je treba poslati storitvi Service Cloud Voice, izgleda takole +1 469 315.
- $4 se nanaša na zadnjo skupino (\d{4}), številka, ki jo je treba poslati storitvi Service Cloud Voice, izgleda takole +1 469 315 0217.
Presledki v nadomestnem delu pravila “$1 $2 $3 $4” se uporabljajo neposredno. Torej, če uporabljate “$1-$2-$3-$4” število bi se prevedlo v: +1-469-315-0217
Skupine lahko tudi odstranite: [12, 12]->(\+1)(\d{3})(\d{3})(\d{4})->$2 $3 $4 bo prevedeno v: 469 315 0217. [12, 12]->(\+1)(\d{3})(\d{3})(\d{4})-> $3 $4 bo prevedeno v: 315 0217.
Možno je tudi pretvoriti mednarodno ameriško številko v lokalno, na primer: [12, 12]->(\+1)(\d{3})(\d{3})(\d{4})->($2) $3-$4.
Nato dohodna številka “+14693150217” bo prevedeno v: (469) 315-0217.
Primer 3
Naslednji primer prikazuje, kako prenesti številko, prejeto iz kontaktnega centra, v obliki +491515555531 v nemškem formatu E164 +49 151 5555 531.
Ta primer uporablja dve pravili prevajanja (1. in 2.)
- Ta številka je dolga natanko 13 znakov, zato velja pravilo »Dodaj presledke nemškim številkam«.
- (\+49) pravi, da se mora številka začeti z +49. Če je številka dolga 13 znakov, vendar se ne začne z +49, Pravilo je preklicano in nič se ne spremeni.
- (\d{3}) pravi, da +49 morajo slediti 3 števke.
- (\d{4}) pravi, da morajo zadnjim 3 števkam slediti 4 števke.
- (\d{3}) pravi, da morajo zadnjim 4 števkam slediti 3 števke.
Če se karkoli od tega ne ujema, se številka ne bo spremenila.
Torej veljajo vsa pravila “+491515555531”. Zato se število spremeni za “$1 $2 $3 $4”:
- $1 se nanaša na skupino (\+49), številka, ki jo je treba poslati storitvi Service Cloud Voice, je videti takole +49.
- $2 nanaša se na prvega od obeh (\d{3}), številka, ki jo je treba poslati storitvi Service Cloud Voice, izgleda takole +49 151.
- $3 nanaša se na drugega od obeh (\d{4}), številka, ki jo je treba poslati storitvi Service Cloud Voice, izgleda takole +49 151 5555.
- $4 se nanaša na zadnjo skupino (\d{3}), številka, ki jo je treba poslati storitvi Service Cloud Voice, izgleda takole +49 151 5555 531.
Enako velja za pravilo ena. Nadomestni del lahko uporabite $1 $2 $3 $4 izbrati, kaj želite uporabiti iz številke.
Več primerov regularnih izrazov za prevajanje
| Opis | Prevodni regularni izraz |
|---|---|
| Odstranite vse znake razen številk | [1,17]->[^\d]+ |
| Odstranite vse znake razen številk & + | [1,17]->[^+\d]+ |
| Opis | Prevodni regularni izraz |
|---|---|
| Odstrani +1 | [12,12]->(.{1})(\d{1})(\d{10})->$3 |
| Odstrani +1 | [10,12]->(^\+1+)(\d+)->$2 |
| Odstrani +49 | [10,15]->(^\+49+)(\d+)->$2 |
| Odstrani +49 | [10,15]->(.{1})(\d{2})(\d{9})->$3 |
| Odstrani +41 | [10,13]->(^\+41+)(\d+)->$2 |
| Odstrani +41 | [10,13]->(.{1})(\d{2})(\d{9})->$3 |
| Odstrani +XX | [10,14]->(^\++)(\d{2})(\d+)->$3 |
| Opis | Prevodni regularni izraz |
|---|---|
| Odstrani + in ga nadomestite z ničlami US E164 | [10,12]->(.{1})(\d{1})(\d{10})-> 001 $3 |
| Odstrani +1 in ga nadomestite z ničlami US E164 | [10,12]->(^\+1+)(\d+)-> 001$2 |
| Odstrani + in ga nadomestite z ničlami DE E164 | [12,15]->(.{1})(\d{2})(\d{10})-> 0049 $3 |
| Odstrani +49 in ga nadomestite z ničlami DE E164 | [10,12]->(^\+49+)(\d+)-> 0049$2 |
| Odstrani + in ga nadomestite z ničlami CH E164 | [10,13]->(.{1})(\d{2})(\d{9})-> 0041 $3 |
| Odstrani +41 in ga nadomestite z ničlami CH E164 | [10,12]->(^\+41+)(\d+)-> 0041$2 |
| Opis | Prevodni regularni izraz |
|---|---|
| Ameriška številka s presledkom | [12,17]->(\d{1})(\d{3})(\d{3})(\d{4})->+1 $2 $3 $4 |
| Ameriška številka s presledkom | [12,17]->(\+1)(\d{3})(\d{3})(\d{4})->$1 $2 $3 $4 |
| DE številka s presledkom | [12,17]->(\d{2})(\d{3})(\d{4})(\d{3})->+49 $2 $3 $4 |
| DE številka s presledkom | [12,17]->(\+49)(\d{3})(\d{4})(\d{3})->$1 $2 $3 $4 |
| Številka CH s presledkom | [12,17]->(\d{2})(\d{2})(\d{3})(\d{2})(\d{2})->+41 $2 $3 $4 |
| Številka CH s presledkom | [12,17]->(\+41)(\d{2})(\d{3})(\d{2})(\d{2})->$1 $2 $3 $4 |
Konfiguracija strani VoiceCall
Konfiguracija strani za snemanje glasovnih klicev
Stran z zapisom VoiceCall je privzeto vnaprej konfigurirana s 3-stolpčno postavitvijo in naslednjimi komponentami:
- Dejanja & priporočila
- Opombe o klicu
- Podrobnosti klica
- Posnetki
Komponente je mogoče prosto odstraniti ali dodati na stran, odvisno od poslovnih potreb. Uporabiti je mogoče tudi različne postavitve strani, vendar se nekatere komponente, kot sta predvajalnik snemanja klicev in telo pogovora, prilegajo le na srednje velika in velika območja predloge.
Prikaz komponente Razlog za zaključek
Komponenta Razlog za zaključek mora biti prikazana med klicem in med zaključkom.
Na stran z zapisom VoiceCall dodajte komponento Cisco Wrap-Up Reason:
- Povlecite spletno komponento Lightning ] Razlog za zaključek Cisco iz območja po meri na seznamu komponent Lightning na stran za snemanje glasovnih klicev.
- Kliknite Shrani.
- Kliknite Aktiviraj.
- Kliknite Določi kot privzeto organizacijo.
- Kliknite Shrani.
- Ponovno kliknite Shrani in nato kliknite Puščica nazaj, da se vrnete na stran.
Komponenta Razlog za zaključek Cisco se bo samodejno prikazala med klicem in med zaključkom:
Če je dodana na stran, se komponenta Cisco Wrap-Up Reason prikaže za vsak klic, tudi če v Cisco Contact Center ni konfigurirana nobena možnost Wrap-Up.
Prikaz predvajalnika za snemanje klicev
Predvajalnik posnetkov klicev se bo prikazal, če je bila za ustrezni glasovni klic shranjena povezava za posnetek.
Če želite na stran za snemanje glasovnih klicev dodati komponento Predvajalnik za snemanje klicev, sledite tem korakom:
- Povlecite spletno komponento Lightning predvajalnika za snemanje klicev na stran za snemanje glasovnih klicev
- KlikniteShrani.
- KlikniteAktiviraj.
- KlikniteDoloči kot privzeto organizacijo.
- KlikniteShrani.
- Ponovno klikniteShraniin nato kliknite puščico Nazaj, da se vrnete na stran.
Skrbniki Webexa
Konfiguracija pretoka
Pojavno okno na zaslonu
V Webex Contact Center Flow je na voljo vozlišče »Pojavno okno«. Uporablja se lahko za sprožitev pojavnega okna znotraj storitve Service Cloud Voice ali v ločenem oknu.
Več informacij o tej funkciji najdete v dokumentaciji za Flow Designer .
Pojavno okno v ločenem oknu
Če želite odpreti pojavno okno v ločenem oknu, morate v vozlišču »Pojavno okno« navesti absolutni URL. Parametri poizvedbe bodo dodani URL-ju kot parametri iskanja.
Podprti so naslednji načini:
- Nov zavihek brskalnika - Vedno odpre nov zavihek brskalnika.
- Obstoječi zavihek brskalnika – Na prvem pojavnem zaslonu Obstoječi zavihek brskalnika se odpre nov zavihek brskalnika. Ta zavihek bo namenski zavihek za poznejša pojavna okna z obstoječimi zavihki brskalnika, URL pa se bo osvežil znotraj tega določenega zavihka brskalnika.
- Znotraj namizja - Obravnava se enako kot Nov zavihek brskalnika.
Trenutno odprta stran lahko prepreči preusmeritev. V tem primeru se v novem zavihku brskalnika odpre pojavno okno Obstoječi zavihek brskalnika.





