- Domov
- /
- Článok
Webex Contact Center pre Salesforce Service Cloud Voice integruje robustné riešenie Cisco CCaaS (Contact Center as a Service) s CRM od Salesforce, čo umožňuje firmám spravovať viackanálové interakcie so zákazníkmi (hlasové, digitálne) v rámci rozhrania Salesforce pomocou umelej inteligencie Webex pre virtuálnych agentov, prepis a inteligentné smerovanie, čím transformuje agentov na „superagentov“ s jednotnými údajmi pre lepšie zákaznícke skúsenosti.
Prehľad
Kontaktné centrum Webex pre Salesforce Service Cloud Voice
Webex Contact Center pre Service Cloud Voice je integračné riešenie pripravené na použitie, ktoré prináša výkon Webex Contact Center do konzoly agentov omnikanálovej služby Salesforce Service Cloud Voice.
Pred pokračovaním v inštalácii si prečítajte nasledujúcu časť:
a dozviete sa o predpokladoch a obmedzeniach služby Salesforce Service Cloud Voice a uistite sa, že vaša organizácia Salesforce je pripravená na povolenie a inštaláciu balíka Webex Contact Center pre Service Cloud Voice.
Predpoklady a obmedzenia
Predpoklady (podtéma)
Používateľské rozhrania: Služba Cloud Voice je k dispozícii iba v Salesforce Lightning Experience.
Služba Cloud Voice je k dispozícii v týchto vydaniach.
- Podnik
- Neobmedzené
- Vývojár
Licencie
-
Zákazníci si musia zakúpiť novú doplnkovú licenciu A-SF-VOICE pre každého prihláseného agenta okrem štandardných alebo prémiových licencií Flex 3 pre Webex Contact Center. Viac informácií nájdete v objednávacej príručke Flex 3.
- Salesforce Voice pre partnerskú telefoniu
Pred zapnutím služby Voice musíte vo svojej organizácii nastaviť potrebné služby.
- Prejsť na Informácie o spoločnosti > Licencia na sadu povolení
- Skontrolujte používateľa služby Cloud Voice (partnerská telefonia).
Všetky edície pre vývojárov teraz obsahujú 5 licencií pre partnerské telefónie, ktoré sú k dispozícii na testovanie.
- Skontrolujte používateľa služby Cloud Voice (partnerská telefonia).
- Prípadne si to môžete overiť v časti Nastavenie Salesforce a vyhľadaním výrazu „hlas“ v ľavom bočnom paneli.
- Ak sa zobrazí „Partnerské telefonické kontaktné centrá“, máte licenciu SCV.
- Ak možnosť „Kontaktné centrá partnerskej telefonie“ nie je viditeľná, potom „Povoliť službu Cloud Voice“ podľa krokov uvedených nižšie.
- Prejdite do časti Nastavenie Salesforce, vyhľadajte a vyberte možnosť „Nastavenie partnerskej telefonie“ a prepnite tlačidlo na „Povoliť službu Cloud Voice“.
- Povoľte Omni-Channel, aby vaši agenti mohli uskutočňovať a prijímať hovory.
- Prejdite do časti Nastavenie Salesforce, vyhľadajte a vyberte možnosť „Nastavenie partnerskej telefonie“ a prepnite tlačidlo na „Povoliť službu Cloud Voice“.
Povoliť omnikanál
Ak je vo vašej organizácii už povolená funkcia Omni-Channel, tento krok preskočte.
- V časti Nastavenie zadajte do poľa Rýchle vyhľadávanie Nastavenia omni-kanála a potom vyberte Nastavenia omni-kanála.


- Vyberte Povoliť všekanálový režim.
- Kliknite na tlačidlo Uložiť.
Obmedzenia
- Hlas je k dispozícii iba v režime Lightning Experience.
- Hlas je podporovaný v službách Service Cloud a Sales Cloud ako doplnková licencia.
- Hlas nie je podporovaný v aplikácii Salesforce Mobile ani v prehliadači Safari na iPade.
- Hlas je podporovaný iba vo webových prehliadačoch Google Chrome, Microsoft Edge (Chromium) a Mozilla Firefox. Pre umožnenie jednotného prihlásenia (SSO) musia byť povolené súbory cookie.
- Štandardná navigácia nie je podporovaná.
- Telefonovanie je prísne regulované, preto sa informujte u svojho zástupcu spoločnosti Salesforce o dostupnosti služby Voice vo vašom regióne.
Požiadavky
Kódy nečinnosti
Nájdite kódy nečinnosti
| 1 |
Prihláste sa do správcovského portálu. |
| 2 |
Prejdite na Kontaktné centrum > POČÍTAČOVÉ ZÁŽITKY > Idle/Wrap-up Kódy. |
| 3 |
Uistite sa, že sú zobrazené kódy nečinnosti, v opačnom prípade kliknite na rozbaľovacie tlačidlo filtra a v hornej časti stránky vyberte možnosť Kód nečinnosti. |
| 4 |
Kliknutím na kód nečinnosti otvoríte podrobný náhľad. Tam nájdete ID kódu nečinnosti.
ID je možné skopírovať a potom použiť na konfiguráciu mapovania stavu prítomnosti. Jedno z ID sa musí použiť ako predvolený dôvod „Cisco nie je pripravený“ . |
Integrovať
Inštalácia
Pred pokračovaním v inštalácii si pozrite časť Predpoklady a obmedzenia, kde sa dozviete viac o predpokladoch a obmedzeniach služby Salesforce Service Cloud.
Inštalácia a konfigurácia kontaktného centra Webex pre službu Cloud Voice
Po získaní licencie Service Cloud Voice pre partnerskú telefóniu sa v ponuke Nastavenie zobrazí stránka Nastavenie partnerskej telefónie.
Ďalšie informácie nájdete v oficiálnej referencii Salesforce ( priamy odkaz).
| 1 |
V časti Nastavenie zadajte do poľa |
| 2 |
Povoliť Zapnúť hlasovú komunikáciu s partnerskou telefóniou. Stránka Kontaktné centrá partnerskej telefonie sa zobrazí v ponuke Nastavenie. Ak plánujete nasadiť balík v sandboxe Salesforce, nahraďte časť |
Nainštalujte balík
Inštalácia balíka:
| 1 |
Otvorte poskytnutý odkaz v balíku a spustite inštaláciu. |
| 2 |
Prihláste sa do organizácie Salesforce, kde sa má balík nainštalovať. |
| 3 |
V sprievodcovi inštaláciou vyberte možnosť zabezpečenia „Inštalovať iba pre správcov“ (1) a kliknite na Inštalovať (2). Určte, ktorí používatelia získajú určité povolenia k objektom a komponentom, ktoré sú súčasťou balíka Webex Contact Center for Service Cloud Voice. Okrem toho im udeľte tieto povolenia; sady povolení, ktoré sú súčasťou balíka Webex Contact Center for Service Cloud Voice, pomáhajú v tomto procese. Sprievodca inštaláciou balíkov – zobrazí sa uvítacia obrazovka: Inštalačný balík nie je priamo prístupný cez Salesforce AppExchange. Zákazníci musia použiť tlačidlo „Získať teraz“ v zozname AppExchange, ktoré otvorí kontaktný formulár na vyžiadanie odkazu na inštaláciu a aktivácie Cisco. |
| 4 |
Udeľte nasledujúce sady povolení aspoň jednému používateľovi, aby ste mohli vytvoriť kontaktné centrum: |
| 5 |
Kliknite na Nastaviť | Používatelia | Používatelia. |
| 6 |
Vyhľadajte a vyberte používateľa. |
| 7 |
Posuňte sa nadol na časť „Priradenia súborov povolení“. |
| 8 |
Kliknite na Upraviť priradenia |
| 9 |
Pre správcov kontaktného centra: priradiť sadu povolení Správca kontaktného centra (telefónne spojenie s partnermi).
|
| 10 |
Pre agentov kontaktného centra: priraďte sadu povolení pre agenta kontaktného centra (partnerská telefonia) a sadu povolení agenta SCV pre kontaktné centrum Webex.
Neodporúča sa vybrať možnosť Inštalovať pre všetkých používateľov, pretože to udeľuje všetky povolenia (čítanie, vytváranie, úpravu a mazanie) pre komponenty a objekty balíka každému používateľovi, ktorý používa vlastný používateľský profil. |
| 11 |
Priraďte používateľom licenciu balíka na prácu s aplikáciou Connects for Service Cloud Voice.
|
| 12 |
Prípadne môžete kliknúť na Nastaviť | Používatelia | Používatelia.. |
| 13 |
Vyhľadajte a vyberte používateľa. |
| 14 |
Prejdite nadol na Spravované balíky. |
| 15 |
Kliknite na Priradiť licencie. |
| 16 |
V zozname vyberte balíček Webex Contact Center pre Service Cloud Voice. |
| 17 |
Kliknite na Pridať. |
| 18 |
Vytvorte Stavy prítomnosti na definovanie, ktoré servisné kanály sú priradené k rôznym stavom. Agenti sa môžu prihlásiť do Omni-Channel s rôznymi statusmi v závislosti od druhu práce, na ktorú majú nárok. |
| 19 |
V časti Nastavenie zadajte do poľa Rýchle vyhľadávanie |
| 20 |
Kliknite na Nový. Vytvorte aspoň jeden stav „Online“ a jeden „Zaneprázdnený“.
|
Priradiť stav(y) prítomnosti agentom
| 1 |
V časti Nastavenie zadajte do poľa Rýchle vyhľadávanie položku Sady povolení a potom vyberte položku Sady povolení. |
| 2 |
Kliknite pre otvorenie Sada povolení pre partnerskú telefonickú komunikáciu. |
| 3 |
Kliknite na Stavy prítomnosti služieb Prístup. |
| 4 |
Kliknite na Upraviť. |
| 5 |
V zozname Dostupné prítomnosti služieb vyberte predtým vytvorený(é) stav(y) prítomnosti a kliknite na tlačidlo Pridať, čím ich priradíte k sade povolení. Agenti, ktorí sú priradení k tejto sade povolení, sa môžu prihlásiť do Omni-Channel s ľubovoľným zo stavov prítomnosti, ktoré majú k dispozícii. |
| 6 |
Kliknite na tlačidlo Uložiť. |
| 7 |
Na tej istej stránke kliknite na Spravovať priradenia. Potom kliknite na Pridať priradenie v pravom hornom rohu, vyberte požadovaného používateľa, kliknite na Ďalej, vyberte Možnosť expirácie pre priradených používateľov (voliteľné) a potom kliknite na Priradiť. Služba Cloud Voice používa na prácu so záznamom VoiceCall externú doménu. Nasledujúce adresy URL je potrebné pridať do sekcie „Nastavenia vzdialeného servera“ v nastavení ( kliknite sem pre otvorenie oficiálnej dokumentácie):
Príklad: Ako nájsť URL adresu inštancie. |
| 8 |
Po prihlásení si pozrite URL adresu v adresnom riadku prehliadača. URL adresa inštancie je časť pred „.my.salesforce.com“ alebo „.salesforce.com“ alebo „.lightning.force.com“. Napríklad, ak je vaša URL adresa https://orgfarm-54a38e30ad-dev-ed.develop.my.salesforce-setup.com/,, potom je URL adresa vašej inštancie „orgfarm-54a38e30ad-dev-ed.develop“. Príklad: URL adresa pôvodnej organizácie: https://cisco.lightning.force.com Príklad: URL adresa, ktorú chcete pridať:
|
| 9 |
Aby agent mohol používať službu Service Cloud Voice, v aplikácii Lightning Service Console je vyžadovaná položka Omni-Channel Utility.
Oficiálnu referenciu od spoločnosti Salesforce nájdete kliknutím na tlačidlo Urobme to, ktoré otvorí stránku Konfigurácia skúseností agentov pre službu Service Cloud Voice s partnerskou telefóniou na portáli pomoci Salesforce ( priamy odkaz). |
| 10 |
V časti Nastavenie zadajte do poľa Rýchle vyhľadávanie Nastavenie partnerskej telefonie a potom vyberte Nastavenie partnerskej telefonie. |
| 11 |
Prejdite nadol do sekcie 5 Ďalšie nastavenia hlasu. |
| 12 |
Ak chcete povoliť ochranu ClickJack pre stránky Visualforce so zakázanými hlavičkami počas práce so softvérovým telefónom v Lightning Experience, musíte okrem URL adresy inštancie Salesforce pridať domény, z ktorých sa softvérový telefón a vlastné panely s nástrojmi načítavajú, ako dôveryhodné domény. Tieto nastavenia a zoznam dôveryhodných domén nájdete v časti Nastavenie | Zabezpečenie | Nastavenia relácie Ak chcete získať správnu doménu Visualforce, prejdite na Nastavenie | Vlastný kód | Stránky Visualforce a kliknite na tlačidlo Náhľad pre Príklad: MyDomainName--cisco_wxcc_scv.vf.force.com Ak chcete získať doménu inštancie Salesforce, skopírujte URL adresu zobrazenú v paneli s adresou URL prehliadača a pridajte ju do zoznamu Zoznam dôveryhodných domén pre vložené rámce, pričom ako typ IFrame vyberte Stránky Visualforce. Príklad: MyDomainName.lightning.force.com Ak vo svojej organizácii nemáte nasadenú funkciu Moja doména, formát URL adresy bude iný. Ak máte nasadenú službu Moja doména a vo vašej organizácii nie sú povolené rozšírené domény, formát URL adresy bude odlišný. Ak nie sú povolené rozšírené domény, nastavenie Stabilizovať adresy URL v aplikáciách Visualforce, Experience Builder, Site.com studio a súboroch obsahu Moja doména tiež ovplyvní tento formát. Podrobnosti nájdete v časti Formáty URL adresy mojej domény v Pomocníkovi Salesforce. Nastavenia ochrany Clickjack a dôveryhodných domén pre Lightning Experience |
| 13 |
Aby sa počas hovorov zobrazili ovládacie prvky nahrávania, agenti potrebujú povolenie aplikácie Ak ho chcete priradiť, pridajte ho do sady povolení vytvorenej v kroku Stavy prítomnosti.
|
Konfigurácia
Kontaktné centrum
Definičný súbor kontaktného centra určuje sadu polí a hodnôt, ktoré sa používajú na definovanie kontaktného centra v Salesforce pre konkrétny systém CTI. Salesforce používa definičné súbory kontaktného centra na podporu integrácie s viacerými dodávateľmi systémov CTI.
Ďalšie informácie nájdete v oficiálnej dokumentácii spoločnosti Salesforce ( priamy odkaz).
Importovať kontaktné centrum
Stiahnite si najnovšiu verziu Kontaktného centra tu.
Aktualizácia z beta verzie: Táto príručka popisuje čistú inštaláciu verzie General Availability (GA) integrácie Webex Contact Center pre Salesforce Service Cloud Voice.
Ak vykonávate aktualizáciu z beta verzie integrácie, nepoužívajte opätovne existujúci záznam z centra kontaktov partnerov. Namiesto toho:
- Importujte súbor XML kontaktného centra partnerov, ktorý je súčasťou vydania GA.
- Vytvorte nový záznam kontaktného centra partnerov pomocou importovaného súboru XML.
- Aktualizujte svoju konfiguráciu, aby ste mohli používať novovytvorené kontaktné centrum pre partnerov.
Súbor XML kontaktného centra partnerov služby GA obsahuje aktualizované konfiguračné hodnoty vrátane správnej adresy URL konektora a ďalších metadát. Opätovné použitie záznamu kontaktného centra partnerov vytvoreného z beta verzie XML môže zachovať zastarané konfiguračné hodnoty a zabrániť správnemu fungovaniu integrácie.
| 1 |
V časti Nastavenie zadajte do poľa Rýchle vyhľadávanie [ text – Kontaktné centrá partnerskej telefonie a potom vyberte možnosť Kontaktné centrá partnerskej telefonie. Zobrazí sa zoznam existujúcich (ak nejaké existujú) kontaktných centier.
|
| 2 |
Kliknite na Vytvoriť kontaktné centrum na pravej strane stránky. |
| 3 |
Ako poskytovateľa telefónnych služieb vyberte Webex Contact Center. Potom kliknite na Ďalej. Otvorí sa prehliadač súborov.
|
| 4 |
Vyberte súbor |
| 5 |
Kliknite na Otvoriť. Súbor sa importuje.
|
| 6 |
Skontrolujte, či sa vaše kontaktné centrum zobrazuje v zozname kontaktných centier. |
Konfigurácia kontaktného centra
| 1 |
V časti Nastavenie zadajte do poľa Rýchle vyhľadávanie [ text – Kontaktné centrá partnerskej telefonie a potom vyberte možnosť Kontaktné centrá partnerskej telefonie. | ||||||||||||||||||||||||||||||
| 2 |
Kliknite na predtým importované kontaktné centrum. | ||||||||||||||||||||||||||||||
| 3 |
Kliknite na Upraviť.
| ||||||||||||||||||||||||||||||
| 4 |
V dolnej časti stránky Kontaktné centrum kliknite na tlačidlo Pridať v časti Používatelia kontaktného centra. | ||||||||||||||||||||||||||||||
| 5 |
Kliknite + vedľa používateľov, ktorí majú prístup k otvorenému kontaktnému centru. V tomto zozname sa zobrazujú iba používatelia s nastaveným oprávnením |
Prispôsobenie
Externá klientska aplikácia pre integráciu kontaktného centra Webex
Konfigurácia aplikácie externého klienta pre Webex Contact Center Salesforce Connector
Pre plné využitie služby Service Cloud Voice je možné prispôsobiť tok hovorov v kontaktnom centre tak, aby sa vytvoril záznam hlasového hovoru a aby sa počas hovoru na IVR spustil tok Salesforce Omni-Channel.
Vytvoriť certifikát
Uistite sa, že ste si už vytvorili digitálny certifikát v súlade s bezpečnostnými zásadami vašej organizácie.
Ak chcete vygenerovať digitálny certifikát, pozrite si dokumentáciu Salesforce na adrese https://developer.salesforce.com/docs/atlas.en-us.voice_pt_developer_guide.meta/voice_pt_developer_guide/voice_pt_generate_certificate.htm.
Príklad
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
server.crt => Certifikát pre aplikáciu Salesforce External Client
server.key => Súkromný kľúč pre Salesforce Connector v Webex Control Hub
Sada povolení pre používateľa integrácie SCV
Nasledujúca sada povolení udeľuje prístup k triedam Apex používaným aplikáciou Connects for SCV na integráciu s postupmi IVR v aplikácii Contact Center a aplikáciou Webex Contact Center for Salesforce for SCV.
Nasleduje príklad konfigurácie a popisuje minimálne požadované oprávnenia pre kontaktné centrum. / Integrácia IVR bude fungovať.
- V časti Nastavenie prejdite na Používatelia | Sady povolení.
- Kliknite na tlačidlo Nové.
- Zadajte napríklad štítok: Prístup IVR k kurzom SCV Apex
- Názov API sa vyplní automaticky
- Licencia: Žiadne
- Kliknite na tlačidlo Uložiť.
- Otvorí sa nová sada povolení.
- Prejdite na Prístup k triede Apex.
- Kliknite na tlačidlo Upraviť a pridajte nasledujúce triedy Apex:
- cisco_wxcc_scv.ServiceRouting
- Prejdite na Systémové povolenia.
- Kliknite na tlačidlo Upraviť a povoľte nasledujúce povolenia:
- Služby Apex REST
- Rozhranie API povolené
Minimálny prístup – profil integrácií iba s rozhraním API
Tento profil sa používa na integráciu s Webex Contact Center for Salesforce for SCV na vytváranie záznamov hlasových hovorov a vykonávanie Omni-Flow z IVR toku.
Nasleduje príklad konfigurácie a popisuje minimálne požadované oprávnenia pre kontaktné centrum. / Integrácia IVR bude fungovať.
Toto je klon profilu Minimálny prístup – Integrácie iba s rozhraním API.
- V časti Nastavenie prejdite na Používatelia | Profily.
- V zozname profilov vyhľadajte profil Minimálny prístup – integrácie iba s rozhraním API.
- Kliknite na názov profilu a otvorte profil Minimálny prístup – integrácie iba s rozhraním API.
- V profile Minimálny prístup – Integrácie iba s rozhraním API kliknite na tlačidlo Klonovať.
- Zadajte nový názov profilu, napríklad: Integrácia SCV.
- Kliknite na tlačidlo Uložiť.
- Otvorí sa nový profil.
- Overte, či váš profil Minimálny prístup – Integrácie iba s rozhraním API má odstránené všetky povolenia.
- Prejdite na Systémové povolenia.
- Uistite sa, že sú povolené nasledujúce povolenia:
- Rozhranie API povolené
- Používateľ iba s rozhraním API
Používateľ integrácie SCV
Nasleduje príklad konfigurácie a popisuje minimálne požadované oprávnenia pre kontaktné centrum. / Integrácia IVR bude fungovať. Pre používateľa integrácie SCV nie je potrebná licencia Salesforce Service Cloud Voice ani licencia Webex Contact Center for Salesforce for SCV.
- V časti Nastavenie prejdite na Používatelia | Používatelia.
- Kliknite na tlačidlo Nový používateľ.
- Zadajte krstné meno, priezvisko a všetky ostatné povinné polia.
- Používateľská licencia: Integrácia Salesforce
- Profil: vyberte profil vytvorený v predchádzajúcom kroku („profil integrácie SCV“, klon profilu Minimálny prístup – integrácie iba s rozhraním API)
- Kliknite na tlačidlo Uložiť.
- Otvorte nový záznam používateľa.
- Priraďte predtým vytvorenú sadu oprávnení( „Prístup IVR k triedam SCV Apex“).
- Priradenie licencie pre sadu povolení Integrácia rozhrania Salesforce API.
Vytvorenie aplikácie pre externého klienta Salesforce
Vytvorenie novej aplikácie pre externého klienta
Existujú dve možnosti prepojenia vašich údajov zo služby Salesforce s aplikáciami tretích strán. Pripojené aplikácieajAplikácie externých klientovsú rámce na integráciu údajov. Aplikácie externých klientov predstavujú ďalšiu generáciu pripojených aplikácií.
Ak chcete nakonfigurovať aplikáciu Salesforce External Client App, ktorú používa kontaktné centrum Cisco Webex:
- Z ponuky Nastavenieprejdite naAplikácie | Externé klientske aplikácie | Správca aplikácií externých klientov.
- Kliknite naNová externá klientska aplikácia.
- Externá klientska aplikácia – základné informácie
- Názov aplikácie externého klienta: WxCC - SCV
- Názov API: WxCC_SCV
- Kontaktný e-mail: < your email >
- Štát distribúcie: vyberte Miestne

Externá klientska aplikácia – API (povoliť nastavenia OAuth)
- Vyberte: Povoliť OAuth
- Nastavenia aplikácie
- Spätné volanie URL: http://localhost:1717/OauthRedirect as vzorová adresa URL spätného volania
- Rozsahy OAuth
- Vyberte rozsahy OAuth:
- Správa používateľských údajov prostredníctvom rozhraní API (API)
- Vykonávať požiadavky kedykoľvek (refresh_token, offline_access)

Povolenie toku
- Vyberte: Povoliť tok nosičov JWT
- Kliknite na Nahrať súbory a nahrajte súbor
server.crt, ktorý obsahuje váš digitálny certifikát.

Zabezpečenie
Zrušte začiarknutie možnosti Vyžadovať tajný kód pre tok webového servera.

- Kliknite na tlačidloVytvoriť.
- Zmeňte na Záložka Pravidlá a potom kliknite na tlačidloUpraviť.
- Zásady – Zásady OAuth
- Pravidlá pre pluginy
- Povolení používatelia: Vyberte používateľov schválených správcom, ktorí sú predautorizovaní
- Potvrdiť zmenu
- Autorizácia aplikácie
- Pravidlá obnovenia tokenov: vyberte možnosť Okamžite vypršať platnosť obnovovacieho tokenu
- Uvoľnenie IP: vyberte Vynútiť obmedzenia IP adries

- Pravidlá pre pluginy
- Zásady – Zásady aplikácií
- Úvodná stránka – žiadna
- Vybrať sady povolení – Priraďte predtým vytvorenú sadu povolení („Prístup IVR k triedam SCV Apex“)

- Kliknite na tlačidlo Uložiť.
- Zmeňte na Nastavenia karty.
-
V časti Nastavenia OAuth kliknite na tlačidloKľúč spotrebiteľa a potom na tlačidlo Tajomstvo; počkajte na e-mail a overte svoju totožnosť. Na novej karte prehliadača sa otvorí obrazovka s údajmi o spotrebiteľovi.

- Kliknite na Kopírovať a uložtekľúč spotrebiteľa. Kľúč spotrebiteľa sa neskôr použije na vytvorenie konektora Salesforce v rozhraní Webex Contact Center Control Hub.

-
Konfigurácia a skript kontaktného centra Webex na vytváranie záznamov hlasových hovorov
Ak chcete naplno využiť hodnotu služby Salesforce Service Cloud Voice, je potrebné upraviť tok hovorov v aplikácii Webex Contact Center tak, aby sa záznam hlasového hovoru v aplikácii Service Cloud Voice vytvoril hneď po prijatí hovoru do kontaktného centra.
Pre rozhodovanie o smerovaní a automatizáciu v Salesforce je možné spustiť voliteľný Omni-Flow.
Podrobnosti o použitých rozhraniach API nájdete v časti Service Cloud Voice API Wrapper.
Predpoklady
Ak chcete používať Service Cloud Voice API Wrapper, musí byť nakonfigurovaná externá klientska aplikácia Salesforce pre integráciu IVR.
Konfigurácia konektora Salesforce v aplikácii Webex Control Hub
Nastavte konektory Salesforce Integration Connectors pre Webex Contact Center podľa popisu v článku na adrese https://help.webex.com/en-us/article/7fuy63/Set-Up-Integration-Connectors-for-Webex-Contact-Center#id_133211.
| 1 |
Prihláste sa do svojej zákazníckej organizácie na adrese https://admin.webex.com a prejdite do sekcie Služby > Kontaktné centrum > Nastavenia nájomníka > Integrations>Connectors. |
| 2 |
Na karte Salesforce kliknite na položku Nastaviť alebo pridať konektor.
DÔLEŽITÉ: UDRŽIAVAJTE BEZPEČNOSŤ PRAVIDELNOU OBMEDZOU TAJOMSTIEV Pre zaistenie bezpečnosti integrácií pravidelne rotujte svoj súkromný kľúč a certifikát. Aktualizujte súkromný kľúč v konektore kontaktného centra v aplikácii Webex Huba certifikát v aplikácii externého klienta v aplikácii Salesforce. Tip na riešenie problémov Po kliknutí na tlačidlo Hotovo a neuložení konektora:
|
Hlavný tok kontaktného centra Webex
| Premenná prietoku | Opis |
|---|---|
| Premenná toku pre ID záznamu hlasového hovoru | Jedinečné ID na identifikáciu hovoru. Vyžaduje sa na vytvorenie záznamu hlasového hovoru. Formát: wxcc_<Interaction Id> Príklad: wxcc_fc4ec7d8-4c91-49aa-b764-081fbba344a8
|
| Lokálna premenná pre čas začiatku hovoru |
Používa sa na vytvorenie záznamu hlasového hovoru a pri aktualizácii hlasového hovoru.
|
| Lokálna premenná pre front name/id |
Vrátené funkciou Vykonajte Omni Flow, používa sa na smerovanie hovorov. Táto premenná je potrebná iba pri použití príkazu Execute Omni Flow.
|
| Lokálna premenná pre agenta name/id |
Vrátené funkciou Vykonajte Omni Flow, používa sa na smerovanie hovorov. Táto premenná je potrebná iba pri použití príkazu Execute Omni Flow.
|
Prehľad hlavného toku

- Generovať kľúč volania dodávateľa
- Nastaviť čas začiatku hovoru
- HTTP požiadavka: Vytvoriť záznam hlasového hovoru
- Vyhodnotenie HTTP odpovede pre vytvorenie záznamu hlasového hovoru
- Spracovanie chyby pri vytváraní záznamu hlasového hovoru
- HTTP požiadavka: Spustite Omni Flow
- Vyhodnotenie HTTP odpovede pre spustenie Omni Flow
- Ošetrenie chýb pri spustení Omni Flow
- Pokračovať v smerovaní hovorov
| Prietok | Opis |
|---|---|
| Generovať kľúč volania dodávateľa |
Každý hovor spracovaný v službe Service Cloud Voice vytvorí záznam hlasového hovoru v Salesforce a vyžaduje si jedinečné ID s názvom Kľúč volania dodávateľa. Pre záznamy hlasových hovorov vytvorené v aplikácii Webex Contact Center musí byť kľúč volania dodávateľa definovaný v toku WxCC a potom odovzdaný spolu s hovorom agentovi pomocou premennej toku. Hodnota vendorCallKey musí spĺňať nasledujúce pravidlá:
|
| Nastaviť čas začiatku hovoru |
Časová pečiatka UTC času začiatku hovoru. Táto časová pečiatka sa používa na vytvorenie záznamu hlasového hovoru a na aktualizáciu záznamu hlasového hovoru, ak volajúci zloží pred presmerovaním k agentovi.
|
| HTTP požiadavka: Vytvoriť záznam hlasového hovoru |
Tento krok je povinný pre každý hovor. Po vytvorení záznamu hlasového hovoru musí byť ID záznamu hlasového hovoru odovzdané spolu s hovorom agentovi v premennej spolu s kľúčom volania dodávateľa. Nakonfigurujte použitú premennú v konfigurácii kontaktného centra v službe Service Cloud Voice. |
| Nastavenia HTTP požiadaviek |
|
HTTP požiadavka: Vytvoriť záznam hlasového hovoru
Tento krok je povinný pre každý hovor. Po vytvorení záznamu hlasového hovoru musí byť ID záznamu hlasového hovoru odovzdané spolu s hovorom agentovi v premennej spolu s kľúčom volania dodávateľa. Nakonfigurujte použitú premennú v konfigurácii kontaktného centra v službe Service Cloud Voice.
Nastavenia HTTP požiadaviek
- Označenie aktivity: Vytvoriť hlasový hovor
- Použiť overený koncový bod: Povolené
- Konektor: Konektor Salesforce vytvorený v predchádzajúcom kroku
- Cesta požiadavky:
/services/apexrest/cisco_wxcc_scv/voice/v1/createVoiceCall - Metóda: POŠTA
- Typ obsahu požiadavky: Application/JSON
Telo žiadosti
Pri vytváraní záznamu hlasového hovoru môžete tiež aktualizovať vlastné polia v zázname hlasového hovoru údajmi o hovore. Nižšie sú uvedené dva príklady tela požiadavky, jeden so všetkými povinnými poľami, ale bez aktualizácie vlastných polí, a jeden s vlastnými poľami.
Bez aktualizácie vlastných polí v zázname hlasového hovoru:
{
"callCenterDevName": "",
"certDevName": "",
"vendorCallKey": "{{SCV_VendorCallKey}}",
"to": "{{NewPhoneContact.DNIS}}",
"from": "{{NewPhoneContact.ANI}}",
"initiationMethod": "Inbound",
"startTime": "{{SCV_CallStartTime}}",
"participants": [
{
"participantKey": "{{NewPhoneContact.ANI}}",
"type" : "END_USER"
}
]
}
Príklad s aktualizáciou vlastných polí v zázname hlasového hovoru:
{
"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\": \"\"}"
}
Parametre
| Názov nehnuteľnosti | Hodnota |
|---|---|
| NázovVývojáraCallCentrum | Meno vývojára kontaktného centra |
| NázovVývojáraCert | Názov API certifikátu (ako je nakonfigurované v kontaktnom centre) |
| dodávateľCallKey | Jedinečné ID hovoru: {{SCV_VendorCallKey}} |
| k | CalledNumber/DNIS: {{NewPhoneContact.DNIS}} |
| z | CallingNumber/ANI: {{NewPhoneContact.ANI}} |
| Čas začiatku | Časová pečiatka UTC {{SCV_CallStartTime}} (nastavuje sa hneď po prijatí hovoru v skripte) |
| Atribúty volania |
Predstavuje ďalšie štandardné a vlastné polia v zázname hlasového hovoru, kde každý pár kľúč-hodnota zodpovedá štandardnému alebo vlastnému poľu a jeho hodnotám. Príklad: |
Nastavenia analýzy
- Typ obsahu: JSON
- Výstupná premenná: SCV_ID záznamu hlasového hovoru
- Výraz cesty:
$.data.voiceCallId
ID záznamu hlasového hovoru, ktoré sa má odovzdať agentovi.
Vyhodnotenie HTTP odpovede pre vytvorenie záznamu hlasového hovoru
Skontrolujte stav HTTP požiadavky na vytvorenie hlasového hovoru:
- Štítok: stavový kódVytvoriťHlasový hovor
- Premenná: CreateVoiceCall.httpStatusCode
Ak stavový kód == 200 => úspešný inak => požiadavka zlyhala, spracovanie chyby
Spracovanie chyby pri vytváraní záznamu hlasového hovoru
Pre ukážku / iba ladenie, prehrávanie správy v závislosti od stavového kódu http.
Ak bolo vytvorenie hlasového hovoru úspešné, pokračujte s príkazom Spustite Omni Flow. V opačnom prípade pokračujte v smerovaní hovorov.
HTTP požiadavka: Spustite Omni Flow (voliteľný krok)
Použite Execute Omni-Flow, keď chcete:
- spúšťať automatizované úlohy, napríklad vyhľadávať alebo vytvárať záznamy, a prepájať tieto záznamy so záznamom hlasového hovoru
- vyhľadávanie záznamov a vyskakovanie obrazovky
- synchronizovať fronty Salesforce a Cisco
- nechať rozhodnutie o smerovaní na Service Cloud Voice
Táto požiadavka vždy vráti „front“ alebo „agenta“, kam musí byť hovor smerovaný.
Po vykonaní tejto požiadavky nezabudnite odoslať príkaz Zrušiť smerovanie, ak volajúci zloží skôr, ako mu agent odpovie. Pozrite si Priebeh udalostí kontaktného centra Webex.
Nastavenia HTTP požiadaviek
- Označenie aktivity: SpustiťOmniFlow
- Použiť overený koncový bod: Povolené
- Konektor: Konektor Salesforce vytvorený v predchádzajúcom kroku
- Cesta požiadavky:
/services/apexrest/cisco_wxcc_scv/voice/v1/executeOmniFlow - Metóda: POŠTA
- Typ obsahu požiadavky: Application/JSON
Telo žiadosti
Okrem povinných polí môžete do Omni-Flow zadať aj ďalšie údaje ako vstupné premenné. Nižšie sú uvedené dva príklady tela žiadosti. Prvý bez dodatočných parametrov toku, iba povinné polia, druhý s dvoma vstupnými premennými.
Príklad s parametrami Omni-Flow:
{
"callCenterDevName": "",
"certDevName": "",
"voiceCallId": "{{SCV_VoiceCallRecordId}}",
"dialedNumber": "{{NewPhoneContact.DNIS}}",
"flowDevName": "",
"fallbackQueue": ""
}
Príklad aktualizácie vlastných polí v zázname hlasového hovoru:
{
"callCenterDevName": "",
"certDevName": "",
"voiceCallId": "{{SCV_VoiceCallRecordId}}",
"dialedNumber": "{{NewPhoneContact.DNIS}}",
"flowDevName": "",
"fallbackQueue": "",
"flowInputParameters":
{
"param1": "value1",
"param2": "value2"
}
}
Parametre
| Názov nehnuteľnosti | Hodnota |
|---|---|
| NázovVývojáraCallCentrum | Meno vývojára kontaktného centra |
| NázovVývojáraCert | Názov API certifikátu (ako je nakonfigurované v kontaktnom centre) |
| ID hlasového hovoru | ID záznamu hlasového hovoru vytvoreného v predchádzajúcom kroku: {{SCV_VoiceCallRecordId}} |
| vytočenéČíslo | CalledNumber/DNIS: {{NewPhoneContact.DNIS}} |
| NázovVývojáraFlow | Meno vývojára Omni-Flow, ktorý sa má spustiť |
| záložný front | ID frontu alebo názov API frontu pre záložný front Salesforce |
| Parametre vstupu toku |
Ďalšie vstupy do omnikanálového toku (pár kľúč-hodnota). Príklad: |
Nastavenia analýzy
Rad
- Typ obsahu: JSON
- Výstupná premenná: SCV_OmniFlowQueue
- Výraz cesty:
$.data.queue
„Front“ vrátený z funkcie Execute Omni-Flow možno použiť na smerovanie.
Agent- Typ obsahu: JSON
- Výstupná premenná: SCV_OmniFlowAgent
- Výraz cesty:
$.data.agent
„Agent“ vrátený z Execute Omni-Flow sa môže použiť na smerovanie.
Vyhodnotenie HTTP odpovede pre spustenie Omni Flow
Skontrolujte stav HTTP požiadavky Execute Omni Flow:
- Štítok: statusCodeExecuteOmniFlow
- Premenná: SpustiťOmniFlow.httpStatusCode
Ak stavový kód == 200 => úspešný inak => požiadavka zlyhala, spracovanie chyby.
Ošetrenie chýb pri spustení Omni Flow
Pre ukážku / iba ladenie, prehrávanie správy v závislosti od stavového kódu http.
Ak bolo spustenie príkazu Omni Flow úspešné, premenné SCV_OmniFlowQueue a SCV_OmniFlowAgent nie sú nastavené. Rozhodnutie o smerovaní v toku hovorov.
Pokračovať v smerovaní hovorov
Pokračovať v priebehu hovoru, presmerovať hovor k agentovi. Voliteľné, na výber frontu a agenta použite SCV_OmniFlowQueue a SCV_OmniFlowAgent.
Priebeh udalostí kontaktného centra Webex
Ak volajúci zloží hovor skôr, ako ho prijme agent, musíme aktualizovať službu Service Cloud Voice a hovor ukončiť.
- Ak sa použil príkaz Execute Omni-Flow, odošlite príkaz Clear Routing na odstránenie čakajúceho smerovania služieb (PSR).
- Odoslať Aktualizovať hlasový hovor, ak chcete aktualizovať čas začiatku a ukončenia záznamu hlasového hovoru a zmeniť stav z Nový na Dokončený

- PhoneContactEnded – Táto udalosť sa spustí, keď sa aktívny hovor ukončí a všetci účastníci sa odstránia.
- HTTP požiadavka: Vymazať smerovanie
- HTTP požiadavka: Aktualizovať hlasový hovor
HTTP požiadavka: Vymazať smerovanie
- Štítok: Vymazať smerovanie
- Použiť overený koncový bod: Povolené
- Konektor: Konektor Salesforce vytvorený v predchádzajúcom kroku
- Cesta požiadavky:
/services/apexrest/cisco_wxcc_scv/voice/v1/clearRouting - Metóda: POŠTA
Typ obsahu požiadavky: Application/JSON
Telo žiadosti
{
"callCenterDevName": "",
"certDevName": "",
"voiceCallId": "{{SCV_VoiceCallRecordId}}"
}
Parametre
| Názov nehnuteľnosti | Hodnota |
|---|---|
| NázovVývojáraCallCentrum | Meno vývojára kontaktného centra |
| NázovVývojáraCert | Názov API certifikátu (ako je nakonfigurované v kontaktnom centre) |
| ID hlasového hovoru | ID záznamu hlasového hovoru vytvoreného v predchádzajúcom kroku: SCV_ID záznamu hlasového hovoru |
Nastavenia analýzy
Žiadne.
HTTP požiadavka: Aktualizovať hlasový hovor
- Štítok: Aktualizovať hlasový hovor
- Použiť overený koncový bod: Povolené
- Konektor: Konektor Salesforce vytvorený v predchádzajúcom kroku
- Cesta požiadavky:
/services/apexrest/cisco_wxcc_scv/voice/v1/updateVoiceCall - Metóda: POŠTA
- Typ obsahu požiadavky: Application/JSON
Telo žiadosti
{
"callCenterDevName": "",
"certDevName": "",
"voiceCallId": "{{SCV_VoiceCallRecordId}}",
"startTime": "{{SCV_CallStartTime}}",
"endTime": "{{now() | replace({'[UTC]': ''})}}",
"disconnectReason": { "value": "Abandoned in queue", "isError": true }
}
Parametre
| Názov nehnuteľnosti | Hodnota |
|---|---|
| NázovVývojáraCallCentrum | Meno vývojára kontaktného centra |
| NázovVývojáraCert | Názov API certifikátu (ako je nakonfigurované v kontaktnom centre) |
| ID hlasového hovoru | ID záznamu hlasového hovoru vytvoreného v predchádzajúcom kroku: SCV_ID záznamu hlasového hovoru |
| Čas začiatku | Časová pečiatka UTC začiatku hovoru {{SCV_CallStartTime}} (použitá na vytvorenie záznamu hlasového hovoru) |
| Čas ukončenia | Aktuálna časová pečiatka UTC `{{now() |
| Dôvod odpojenia | Dôvod ukončenia hovoru. Pre správne zobrazenie je potrebné nastaviť vlastnosť isError na true. |
Nastavenia analýzy
Žiadne.
Referencie
- Vytvorenie súkromného kľúča a samopodpísaného digitálneho certifikátu
- Konfigurácia pripojenej aplikácie pre Webex Contact Center Salesforce Connector
- Nastavenie integračných konektorov pre kontaktné centrum Webex – Salesforce
- Sprievodca nastavením a správou kontaktného centra Cisco Webex > Návrhár toku
- REST API pre integráciu telefónie
Preklad jazyka
(Voliteľné) Povoliť prekladový workshop
Toto nastavenie je použiteľné iba v prípade, že používate nastavenia jazyka prekladu.
| 1 |
Prejdite do časti Nastavenie → Prekladová pracovná plocha → Nastavenia jazyka prekladu. |
| 2 |
Kliknite na Povoliť pre výber jazyka prekladu. |
(Voliteľné) Povoliť jazyky iba pre platformu
Toto nastavenie platí iba pre iné jazyky ako EN-US.
| 1 |
Prejdite do časti Nastavenie → Nastavenia spoločnosti → Nastavenia jazyka. |
| 2 |
Vyberte požadované jazyky. |
| 3 |
Začiarknite nasledujúce políčka:
|
| 4 |
Uložte zmeny. |
Aktivujte jazyk a vyberte používateľa (úlohu)
| 1 |
Prejdite do časti Nastavenie → Prekladová pracovná plocha → Nastavenia jazyka prekladu. |
| 2 |
Vyberte jazyk a vyberte používateľa, ktorý ho bude prekladať. |
| 3 |
Uložte zmeny. |
Viacjazyčné nastavenia
Preložiť vlastné štítky
| 1 |
Prejdite na Nastavenie → Vlastné štítky. |
| 2 |
Vyberte názov vlastného štítku, ktorý chcete otvoriť.
|
| 3 |
V zozname súvisiacich prekladov kliknite na |
| 4 |
Vyberte jazyk, do ktorého prekladáte. |
| 5 |
Zadajte preloženú hodnotu do poľa Text prekladu. Tento text prepíše hodnotu zadanú v poli Hodnota v označení, keď je predvoleným jazykom používateľa jazyk prekladu. |
| 6 |
Uložte zmeny. |
Povolenia Salesforce požadované funkciou používateľa
Sada povolení agenta SCV pre Webex Contact Center obsahuje všetky povolenia potrebné na prácu s miniaplikáciou Webex Contact Center a integráciami vyvinutými pre agentov.
Prístup k Apex Class (sekcia)
- cisco_wxcc_scv.CiscoScvWxcc
- cisco_wxcc_scv.ServiceResponseHandler
- cisco_wxcc_scv.ServiceRouting
- cisco_wxcc_scv.TelephonyIntegrationHandler
Prístupy k vlastným typom metadát (sekcia)
- cisco_wxcc_scvPripojenie .WxCC
Prístup k stránke Visualforce (sekcia)
- cisco_wxcc_scv.CiscoScvLoginWxCC
- cisco_wxcc_scv.CiscoScvMainWxCC
- cisco_wxcc_scv.CiscoScvOAuthRedirect
- cisco_wxcc_scv.CiscoScvSwLoader
Obal API služby Cloud Voice
Predpoklady
Ak chcete používať Service Cloud Voice API Wrapper, musí byť nakonfigurovaná externá klientska aplikácia Salesforce pre integráciu IVR.
Použite obal rozhrania Service Cloud Voice API
Service Cloud Voice (SCV) pre Salesforce používa rozhranie REST API pre integráciu telefónie na vytváranie a aktualizáciu hlasových volaní (VoiceCall), vykonávanie omnikanálových postupov a odstraňovanie záznamov PendingServiceRouting priradených k hlasovému volaniu (VoiceCall). Táto služba vyžaduje autorizáciu JWT a použitie metódy PATCH HTTP, ktorú momentálne nepodporuje systém Cisco IP Interactive Voice Response (IVR).
Aby sa zjednodušilo používanie rozhrania REST API pre integráciu telefónie pre SCV v (nielen) systéme IVR, bola sprístupnená nová sada rozhraní API, ktoré obalujú existujúce rozhranie Salesforce API a sú prístupné priamo z organizácie Salesforce, kde je nainštalovaný balík Webex Contact Center for Service Cloud Voice.
Service Cloud Voice API Wrapper odstraňuje potrebu overovania JWT tokenu, implementuje dodatočné kontroly údajov požadovaných rozhraním Salesforce API a vylepšuje objekty odpovede.
Získajte token Access_
Vykonajte požiadavku POST na https://<your-domain-name>.my.salesforce.com/services/oauth2/token
Odosielanie nasledujúcich parametrov v tele:
{
"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": ""
}
Vykonajte požiadavky
URL adresa inštancie musí obsahovať my.salesforce.com.
Príklad správnej adresy URL inštancie: https://abc-123.my.salesforce.com
Použitie akejkoľvek inej domény ako URL inštancie (napr. https://abc-123.lightning.force.com ) má za následok stav 401 Neautorizované s vráteným chybovým kódom INVALID_SESSION_.
Vytvoriť hlasový hovor (sekcia)
Vytvorí záznam VoiceCall obsahujúci účastníkov (t. j. volajúceho a príjemcu) pre záznam VoiceCall. Keď vytvoríte záznam VoiceCall, v Salesforce sa vytvorí konverzácia. Toto API používajte iba v kontexte reálneho času, čo znamená, že by ste ho mali vyvolať iba vtedy, keď sa iniciuje hovor. Toto API je možné použiť aj na vytváranie záznamov VoiceCall pre presmerovanie a konferenčné hovory zahrnutím parametra parentVoiceCallId do údajovej časti požiadavky.
URI koncového bodu
<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/createVoiceCall
Metóda HTTP
POŠTA
Hlavičky
Autorizácia: Nositeľ <access_token>
Typ obsahu: application/json
Parametre
{
"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"
}
Odpoveď (úspešná)
{
"data": {
"voiceCallId": "00X000012345abc"
},
"errors": null,
"success": true
}
Odpoveď (s chybami)
{
"data": null,
"errors": ["Error message 1", "Error message 2"],
"success": false
} Aktualizovať hlasový hovor
Aktualizuje hlasový hovor po ukončení hovoru. Toto rozhranie API použite na aktualizáciu parametrov súvisiacich s hovorom, ktoré nie sú k dispozícii počas fázy vytvárania hlasového volania. Rozhranie API pre aktualizáciu hlasového volania je asynchrónna operácia. Nemôžete sa dopytovať na stav volania API.
Tento koncový bod je možné použiť aj na vytvorenie hlasového hovoru (VoiceCall) aj po jeho skončení. Toto správanie je užitočné v scenároch, kde chcete v Salesforce zaznamenať záznam o opustených alebo zmeškaných hovoroch, alebo v akomkoľvek inom scenári, kde ešte nebol vytvorený hlasový hovor.
URI koncového bodu
<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/updateVoiceCall
Metóda HTTP
POŠTA
Hlavičky
Autorizácia: Nositeľ <access_token>
Typ obsahu: application/json
Parametre
{
"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
}
} Odpoveď (úspešná)
{
"data": {
"status": "pending"
},
"errors": null,
"success": true
} Rozhranie API pre aktualizáciu hlasového volania je asynchrónna operácia. Nemôžete sa dopytovať na stav volania API.
Odpoveď (s chybami)
{
"data": null,
"errors": ["Error message 1", "Error message 2"],
"success": false
} Vykonajte Omni-flow
Vykonáva omnikanálový tok na smerovanie hovorov. Ako parametre odovzdáva toku ID hovoru (Salesforce VoiceCallId alebo ContactId dodávateľa telefónie) a do toku kontaktov vracia pokyny na smerovanie agenta alebo frontu. Služba Service Cloud Voice štandardne používa omnikanálový tok (alebo záložný front) určený pre telefónny kanál, ktorý zodpovedá volanému číslu. Ak volané číslo nezodpovedá existujúcemu telefónnemu kanálu, môžete voliteľne nastaviť nové volané číslo, omnikanálový tok a záložný front ako vstupné parametre pre toto volanie API.
Služba Cloud Voice používa na smerovanie hovorov toto poradie priority:
- Používa nastavenia Omni-Channel Flow a Fallback Queue pre telefónny kanál, ktorý zodpovedá volanému číslu. Prúd má prednosť. Ak tok zlyhá, použije sa záložný front.
- Používa parametre flowDevName a fallbackQueue zadané vo volaní rozhrania API Execute Omniflow.
URI koncového bodu
<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/executeOmniFlow
Metóda HTTP
POŠTA
Hlavičky
Autorizácia: Nositeľ <access_token>
Typ obsahu: application/json
Parametre
{
"callCenterDevName": "contactCenterDevName123",
"certDevName": "certDevName123",
"voiceCallId": "00X000012345abc",
"dialedNumber": "+18445791189",
"flowDevName": "Route_VoiceCall",
"fallbackQueue": "00G111222333444",
"flowInputParameters":
{
"Input1": "one",
"Input2": "two"
}
} Odpoveď (úspešná)
{
"data": {
"queue": "queue info",
"agent": "agent info"
},
"errors": null,
"success": true
} AGENT_INFO a QUEUE_INFO zodpovedajú poľu ExternalId v mape smerovania CallCenterRoutingMap.
Odpoveď (s chybami)
{
"data": null,
"errors": ["Error message 1", "Error message 2"],
"success": false
} Jasné smerovanie
Odstráni záznam PendingServiceRouting (PSR) pre hlasový hovor. Toto API nie je potrebné volať vo väčšine scenárov; záznam PSR sa automaticky odstráni, keď sa hovor prestane smerovať. Existujú však určité scenáre, napríklad v prípade zmeškaných alebo opustených hovorov pri používaní partnerských telefónnych systémov, kde musíte explicitne zavolať toto rozhranie API na vymazanie záznamu PSR.
URI koncového bodu
<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/clearRouting
Metóda HTTP
POŠTA
Hlavičky
Autorizácia: Nositeľ <access_token>
Typ obsahu: application/json
Parametre
{
"callCenterDevName": "contactCenterDevName123",
"certDevName": "certDevName123",
"voiceCallId": "00X000012345abc"
} Odpoveď (úspešná)
{
"data": {
"status": "Success"
},
"errors": null,
"success": true
} Odpoveď (s chybami)
{
"data": null,
"errors": ["Error message 1", "Error message 2"],
"success": false
} Preklady telefónnych čísel
Rôzne interakcie medzi službami Service Cloud Voice a Webex Contact Center závisia od prekladov telefónnych čísel. Vzhľadom na medzinárodné rozdiely a špecifické aplikácie zákazníka je na prenos telefónnych čísel z formátu A do formátu B potrebný prispôsobiteľný nástroj.
Riešenie Webex Contact Center for Service Cloud Voice automaticky odstraňuje všetky znaky okrem čísel a hashtagov (#), hviezdičky (*), čiarky (,) a úvodné znamienka plus (+). Taktiež odstráni prvý výskyt (0). Toto sa urobí PREDTÝM , ako sa použijú preklady vašich telefónnych čísel.
Táto príručka popisuje, ako nakonfigurovať preklady telefónnych čísel.
Polia
Preklady telefónnych čísel sú uložené v poliach Názov-Hodnota. To vám umožňuje nakonfigurovať neobmedzený počet pravidiel pre každú funkciu.
Konfigurácia je uložená ako reťazec JSON.
Upozorňujeme, že spätné lomky je potrebné uniknúť, napr. \d+ stáva sa \\d+.
{"Remove all characters but digits":"[1,17]->[^\\d]+","To internal number":"[7,17]->(\\d{7})(\\d{4})->$2"}
Pole Názov sa technicky nepoužíva. Slúži na pridanie reťazca čitateľného človekom, aby sa rýchlo identifikoval účel tohto pravidla. Dobré mená sú napríklad: Odstrániť všetky úvodné nuly, Pridať úvodné plus atď.
Vytváranie pravidiel prekladu
Pravidlá sú poskytované ako regulárne výrazy. Presnejšie povedané: Implementácia regulárnych výrazov v jazyku JavaScript.
Dobrým začiatkom je prečítanie dokumentu RegExp z webovej dokumentácie MDN.
Vytváranie zložitých regulárnych výrazov je však často ťažkopádne. Preto sme pridali ďalšiu syntax, aby bola konfigurácia čo najjednoduchšia.
Obrázok nižšie znázorňuje všeobecnú syntax pravidla prekladu telefónneho čísla:
Predikát
Predikát sa používa na určenie intervalu definujúceho dĺžku čísla, ktoré sa má zhodovať.
Vyššie uvedený predikát určuje, že všetky čísla s dĺžkou medzi 7 a 11 znakmi (vrátane hrán + medzery) zhoda.
Predikáty sa vždy zhodujú s pôvodnou dĺžkou čísla. To pomáha zjednodušiť konfiguráciu znížením rizika kolízie pravidiel pre interné / externé čísla.
Vzor
Vzor určuje formát čísla, ktoré sa má zhodovať.
Vyššie uvedený vzor uvádza, že číslo musí pozostávať iba z číslic a tie sa vyberajú.
Selektor
Selektory definujú konečný formát čísla. Ak znaky / je potrebné pridať číslice, ktoré pôvodne neboli prítomné, toto je miesto, kde to urobiť.
Selektor je posledným krokom pri zostavovaní čísla. Na základe výstupu vzoru selektor zostaví nové číslo.
Príklad 1
Nasledujúci príklad ukazuje, ako preniesť číslo prijaté z kontaktného centra vo formáte 0319175200 do švajčiarskeho formátu E164. +41 31 917 52 00.
Tento príklad používa dve pravidlá prekladu (1. a 2.)
Prvé pravidlo v tomto príklade v skutočnosti nemení číslo. Pri číslach s dĺžkou od 1 do 17 znakov by sa odstránilo všetko okrem číslic. Keďže nie je prítomná žiadna nečíslica, nič sa nemení.
Druhé pravidlo platí pre čísla, ktoré majú (pôvodne) presne 10 znakov. Zhoduje sa 0319175200 a preto sa pravidlo uplatňuje. Vzor určuje, že číslo musí začínať skupinou jednej číslice (\d{1}), za ktorým nasleduje skupina dvoch číslic (\d{2}), za ktorým nasleduje skupina troch číslic (\d{3}) a tak ďalej.
Selektor potom pristupuje k skupinám vzorov, aby definoval nový číselný reťazec. To znamená $2 odkazuje na prvý (\d{2}) a preto obsahuje 31.
Príklad 2
Nasledujúci príklad ukazuje, ako preniesť číslo prijaté z kontaktného centra vo formáte +14693150217 do amerického formátu E164 +1 469 315 0217.
Tento príklad používa dve pravidlá prekladu (1. a 2.)
- Toto číslo má presne 12 znakov, takže sa uplatňuje pravidlo „Pridávajte medzery do amerických čísel“.
- (\+1) hovorí, že číslo musí začínať na +1. Ak má číslo 12 znakov, ale nezačína sa znakom +1, pravidlo je zrušené a nič sa nemení.
- (\d{3}) hovorí, že +1 musia nasledovať 3 číslice.
- (\d{3}) hovorí, že za poslednými 3 číslicami musia nasledovať ďalšie 3 číslice.
- (\d{4}) hovorí, že za poslednými 3 číslicami musia nasledovať 4 číslice.
Ak sa niečo z toho nezhoduje, číslo sa nezmení.
Takže všetky pravidlá platia pre “+14693150217”. Preto sa číslo zmení o “$1 $2 $3 $4”:
- $1 odkazuje na skupinu (\+1), Číslo, ktoré sa má odoslať do služby Service Cloud Voice, vyzerá takto +1.
- $2 odkazuje na prvý z dvoch (\d{3}), číslo, ktoré sa má odoslať do služby Service Cloud Voice, vyzerá takto +1 469.
- $3 odkazuje na druhý z dvoch (\d{3}), číslo, ktoré sa má odoslať do služby Service Cloud Voice, vyzerá takto +1 469 315.
- $4 odkazuje na poslednú skupinu (\d{4}), číslo, ktoré sa má odoslať do služby Service Cloud Voice, vyzerá takto +1 469 315 0217.
Medzery v náhradnej časti pravidla “$1 $2 $3 $4” sa používajú priamo. Takže ak používate “$1-$2-$3-$4” číslo by sa preložilo na: +1-469-315-0217
A máte tiež povolené odstrániť skupiny: [12, 12]->(\+1)(\d{3})(\d{3})(\d{4})->$2 $3 $4 bude preložené do: 469 315 0217. [12, 12]->(\+1)(\d{3})(\d{3})(\d{4})-> $3 $4 bude preložené do: 315 0217.
Je tiež možné previesť medzinárodné americké číslo na miestne, napríklad: [12, 12]->(\+1)(\d{3})(\d{3})(\d{4})->($2) $3-$4.
Potom prichádzajúce číslo “+14693150217” bude preložené do: (469) 315-0217.
Príklad 3
Nasledujúci príklad ukazuje, ako preniesť číslo prijaté z kontaktného centra vo formáte +491515555531 do nemeckého formátu E164 +49 151 5555 531.
Tento príklad používa dve pravidlá prekladu (1. a 2.)
- Toto číslo má presne 13 znakov, takže sa uplatňuje pravidlo „Pridávanie medzier do nemeckých čísel“.
- (\+49) hovorí, že číslo musí začínať na +49. Ak má číslo 13 znakov, ale nezačína sa znakom +49, pravidlo je zrušené a nič sa nemení.
- (\d{3}) hovorí, že +49 musia nasledovať 3 číslice.
- (\d{4}) hovorí, že za poslednými 3 číslicami musia nasledovať 4 číslice.
- (\d{3}) hovorí, že za poslednými 4 číslicami musia nasledovať 3 číslice.
Ak sa niečo z toho nezhoduje, číslo sa nezmení.
Takže všetky pravidlá platia pre “+491515555531”. Preto sa číslo zmení o “$1 $2 $3 $4”:
- $1 odkazuje na skupinu (\+49), Číslo, ktoré sa má odoslať do služby Service Cloud Voice, vyzerá takto +49.
- $2 odkazuje na prvý z dvoch (\d{3}), číslo, ktoré sa má odoslať do služby Service Cloud Voice, vyzerá takto +49 151.
- $3 odkazuje na druhý z dvoch (\d{4}), číslo, ktoré sa má odoslať do služby Service Cloud Voice, vyzerá takto +49 151 5555.
- $4 odkazuje na poslednú skupinu (\d{3}), číslo, ktoré sa má odoslať do služby Service Cloud Voice, vyzerá takto +49 151 5555 531.
To isté platí pre pravidlo jedna. Môžete použiť náhradný diel $1 $2 $3 $4 vybrať, čo z čísla použiť.
Ďalšie príklady prekladových regulárnych výrazov
| Opis | Prekladový regulárny výraz |
|---|---|
| Odstráňte všetky znaky okrem číslic | [1,17]->[^\d]+ |
| Odstráňte všetky znaky okrem číslic & + | [1,17]->[^+\d]+ |
| Opis | Prekladový regulárny výraz |
|---|---|
| Odstrániť +1 | [12,12]->(.{1})(\d{1})(\d{10})->$3 |
| Odstrániť +1 | [10,12]->(^\+1+)(\d+)->$2 |
| Odstrániť +49 | [10,15]->(^\+49+)(\d+)->$2 |
| Odstrániť +49 | [10,15]->(.{1})(\d{2})(\d{9})->$3 |
| Odstrániť +41 | [10,13]->(^\+41+)(\d+)->$2 |
| Odstrániť +41 | [10,13]->(.{1})(\d{2})(\d{9})->$3 |
| Odstrániť +XX | [10,14]->(^\++)(\d{2})(\d+)->$3 |
| Opis | Prekladový regulárny výraz |
|---|---|
| Odstrániť + a nahraďte ho nulami US E164 | [10,12]->(.{1})(\d{1})(\d{10})-> 001 $3 |
| Odstrániť +1 a nahraďte ho nulami US E164 | [10,12]->(^\+1+)(\d+)-> 001$2 |
| Odstrániť + a nahraďte ho nulami DE E164 | [12,15]->(.{1})(\d{2})(\d{10})-> 0049 $3 |
| Odstrániť +49 a nahraďte ho nulami DE E164 | [10,12]->(^\+49+)(\d+)-> 0049$2 |
| Odstrániť + a nahraďte ho nulami CH E164 | [10,13]->(.{1})(\d{2})(\d{9})-> 0041 $3 |
| Odstrániť +41 a nahraďte ho nulami CH E164 | [10,12]->(^\+41+)(\d+)-> 0041$2 |
| Opis | Prekladový regulárny výraz |
|---|---|
| Americké číslo s medzerou | [12,17]->(\d{1})(\d{3})(\d{3})(\d{4})->+1 $2 $3 $4 |
| Americké číslo s medzerou | [12,17]->(\+1)(\d{3})(\d{3})(\d{4})->$1 $2 $3 $4 |
| DE číslo s medzerou | [12,17]->(\d{2})(\d{3})(\d{4})(\d{3})->+49 $2 $3 $4 |
| DE číslo s medzerou | [12,17]->(\+49)(\d{3})(\d{4})(\d{3})->$1 $2 $3 $4 |
| Číslo CH s medzerou | [12,17]->(\d{2})(\d{2})(\d{3})(\d{2})(\d{2})->+41 $2 $3 $4 |
| Číslo CH s medzerou | [12,17]->(\+41)(\d{2})(\d{3})(\d{2})(\d{2})->$1 $2 $3 $4 |
Konfigurácia stránky VoiceCall
Konfigurácia stránky so záznamom hlasového hovoru
Stránka so záznamom hlasového hovoru je štandardne predkonfigurovaná s 3-stĺpcovým rozložením a nasledujúcimi komponentmi:
- Akcie & odporúčania
- Poznámky k hovorom
- Podrobnosti o hovore
- Záznamy
Komponenty je možné ľubovoľne odstraňovať alebo pridávať na stránku v závislosti od potrieb podniku. Možno použiť aj rôzne rozloženia stránok, ale niektoré komponenty, ako napríklad Prehrávač nahrávania hovorov a Telo konverzácie, sa zmestia iba na stredné a veľké oblasti šablóny.
Zobraziť komponent Dôvod záveru
Komponent Dôvod ukončenia musí byť zobrazený počas hovoru a počas ukončenia.
Pridajte komponent Cisco Wrap-Up Reason na stránku so záznamom VoiceCall:
- Presuňte webový komponent Lightning Cisco Wrap-Up Reason z oblasti Vlastné v zozname Komponenty Lightning na stránku Záznam hlasového hovoru.
- Kliknite na tlačidlo Uložiť.
- Kliknite na Aktivovať.
- Kliknite na Priradiť ako predvolené nastavenie organizácie.
- Kliknite na tlačidlo Uložiť.
- Znova kliknite na Uložiť a potom kliknite na šípku späť pre návrat na stránku.
Komponent Dôvod ukončenia hovoru Cisco sa automaticky zobrazí počas hovoru a počas ukončenia hovoru:
Ak je komponent Cisco Wrap-Up Reason pridaný na stránku, zobrazí sa pre každý hovor, aj keď v aplikácii Cisco Contact Center nie je nakonfigurovaný žiadny Wrap-Up.
Zobraziť prehrávač nahrávania hovorov
Prehrávač nahrávok hovorov sa zobrazí, ak bol pre príslušný hlasový hovor uložený odkaz na nahrávku.
Ak chcete pridať komponent Prehrávač nahrávania hovorov na stránku Záznam hlasových hovorov, postupujte podľa týchto krokov:
- Presuňte webový komponent Lightning v prehrávači nahrávania hovorov na stránku nahrávania hlasových hovorov
- Kliknite naUložiť.
- Kliknite naAktivovať.
- Kliknite naPriradiť ako predvolené nastavenie organizácie.
- Kliknite naUložiť.
- Znova kliknite naUložiťa potom kliknite na šípku späť, čím sa vrátite na stránku.
Správcovia Webexu
Konfigurácia toku
Vyskakovanie obrazovky
V aplikácii Webex Contact Center Flow je k dispozícii uzol „Vyskakovacie okno“. Môže sa použiť na spustenie kontextového okna v rámci služby Service Cloud Voice alebo v samostatnom okne.
Ďalšie informácie o tejto funkcii nájdete v dokumentácii k Flow Designeru .
Vyskakovacie okno v samostatnom okne
Ak chcete otvoriť kontextové okno v samostatnom okne, musíte v uzle „Pokračovacie okno“ zadať absolútnu URL adresu. Parametre queryParameters budú pridané ako parametre vyhľadávania k URL adrese.
Podporované sú nasledujúce režimy:
- Nová karta prehliadača – Vždy otvorí novú kartu prehliadača.
- Existujúca karta prehliadača – Na prvej obrazovke Existujúca karta prehliadača sa otvorí nová karta prehliadača. Táto karta bude vyhradenou kartou pre nasledujúce kontextové obrazovky s existujúcimi kartami prehliadača a URL adresa sa obnoví v rámci tejto konkrétnej karty prehliadača.
- Vnútri pracovnej plochy – Správa sa rovnako ako Nová karta prehliadača.
Aktuálne otvorená stránka môže zabrániť presmerovaniu. V takom prípade sa na novej karte prehliadača otvorí kontextové okno s existujúcou kartou prehliadača.





