- Domov
- /
- Článok
Webex Contact Center pre salesforce Service Cloud Voice integruje Cisco robustné CCaaS (Contact Center as a Service) s CRM Salesforce, čo umožňuje podnikom spravovať viackanálové interakcie so zákazníkmi (hlasové, digitálne) v rámci rozhrania Salesforce pomocou Webex AI pre virtuálnych agentov, prepis a inteligentné smerovanie, transformujúc agentov na super-agentov s jednotnými údajmi pre lepšie skúsenosti zákazníkov.
Prehľad
Webex Contact Center pre službu Salesforce Cloud Voice
Webex Contact Center pre Service Cloud Voice je out-of-the-box integračné riešenie, ktoré prináša silu Webex Contact Center do konzoly Salesforce Service Cloud Voice Omni-channel agent.
Pred pokračovaním v inštalácii si pozrite nasledujúcu časť:
Získať informácie o predpokladoch a obmedzeniach služby Salesforce Cloud Voice a uistiť sa, že vaša organizácia Salesforce je pripravená povoliť a nainštalovať balík Webex Contact Center for Service Cloud Voice .
Predpoklady a obmedzenia
Predpoklady (podtéma)
Používateľské rozhrania: Service Cloud Voice je k dispozícii iba v Salesforce Lightning Experience.
Service Cloud Voice je k dispozícii v týchto vydaniach.
- Podnik
- Neobmedzené
- Vývojára
Licencie
-
Zákazníci si musia zakúpiť novú doplnkovú licenciu A-SF-VOICE na prihláseného agenta okrem licencií Flex 3 Standard alebo Premium pre Webex Contact Center. Ďalšie informácie nájdete v príručke objednávania Flex 3.
- Salesforce Voice pre partnerskú telefóniu
Pred TURN na hlas musíte nastaviť nevyhnutné služby vo vašej organizácii.
- Prejsť na Informácie o spoločnosti > Licencia
- Vyhľadajte používateľa služby Service Cloud Voice (telefónia od partnera).
Všetky vydania pre vývojárov sa teraz dodávajú s 5 licenciami pre partnerskú telefóniu, ktoré sú k dispozícii na testovanie.
- Vyhľadajte používateľa služby Service Cloud Voice (telefónia od partnera).
- Prípadne to môžete overiť tak, že prejdete na Salesforce Setup a vyhľadáte "voice" na ľavom bočnom paneli.
- Ak sa zobrazí text "Partnerské telefónne kontaktné centrá", máte licenciu SCV.
- Ak možnosť "Kontaktné centrá pre partnerov telefónie" nie je viditeľná, potom "Povoliť službu Service Cloud Voice" podľa nižšie uvedených krokov.
- Prejdite na Salesforce Setup a vyhľadajte a vyberte "Nastavenie telefónie partnera" a prepnite tlačidlo na "Povoliť Service Cloud Voice".
- Povoľte Omni-Channel, aby vaši agenti mohli uskutočňovať a prijímať hovory.
- Prejdite na Salesforce Setup a vyhľadajte a vyberte "Nastavenie telefónie partnera" a prepnite tlačidlo na "Povoliť Service Cloud Voice".
Povoliť viackanálový kanál
Ak je Omni-Channel už vo vašej organizácii povolený, tento krok preskočte.
- V časti Nastavenie zadajte do poľa Rýchle vyhľadávanie výraz Omnikanálové nastavenia a potom vyberte položku Nastavenia viacerých kanálov.


- Vyberte položku Povoliť viackanálový kanál.
- Kliknite na položku Uložiť.
Obmedzenia
- Hlas je k dispozícii iba v aplikácii Lightning.
- Hlas je podporovaný v službách Service Cloud a Sales Cloud ako doplnková licencia.
- Hlas nie je podporovaný v Salesforce Mobile ani v iPade Safari.
- Hlas je podporovaný iba vo webových prehliadačoch Google Chrome, Microsoft Edge (Chromium) a Mozilla Firefox. Súbory cookie musia byť povolené, aby umožňovali jediné prihlásenie (SSO).
- Štandardná navigácia nie je podporovaná.
- Telefonovanie je vysoko regulované, preto sa poraďte so svojím zástupcom Salesforce o dostupnosti hlasových služieb vo vašom regióne.
Pozrite si časť Hlasové limity a obmedzenia služby Cloud a Príručku inštalácie a konfigurácie.
Požiadavky
Kódy nečinnosti
Nájdite nečinné kódy
| 1 |
Prihláste sa do portálu správy. |
| 2 |
Prejdite na kódy Contact Center > DESKTOP EXPERIENCE >Tille/Wrap-up Codes. |
| 3 |
Uistite sa, že sú zobrazené Nečinné kódy, inak kliknite na rozbaľovacie tlačidlo filtra a vyberte možnosť Nečinný kód v hornej časti stránky. |
| 4 |
Kliknutím na kód nečinnosti otvoríte zobrazenie podrobností. Tam nájdete Idle Code ID.
ID je možné skopírovať a potom použiť na konfiguráciu mapovania stavu prítomnosti. Jeden z identifikátorov musí byť použitý ako predvolený dôvod Cisco Not Ready. |
INTEGROVAŤ
Inštalácia
Pred pokračovaním v inštalácii si prečítajte časť Predpoklady a obmedzenia , kde nájdete informácie o predpokladoch a obmedzeniach služby Salesforce Service Cloud.
Inštalácia a konfigurácia Webex Contact Center pre službu Service Cloud Voice
Po získaní licencie Service Cloud Voice for Partner Telephony 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
|
| 2 |
Povoliť TURN na hlasové hovory s partnerskou telefóniou. V ponuke Nastavenia sa zobrazí stránka Kontaktné centrá pre telefóniu partnerov .
Ak plánujete nasadiť balík v testovacom prostredí (sandbox) služby Salesforce, nahraďte |
Nainštalujte balík
Inštalácia balíka:
| 1 |
Otvorte poskytnutý odkaz balíka na spustenie inštalácie. |
| 2 |
Prihláste sa do organizácie Salesforce, kde má byť balík nainštalovaný. |
| 3 |
V sprievodcovi inštaláciou vyberte možnosť zabezpečenia"Inštalovať len pre správcov"(1) a kliknite na tlačidlo Inštalovať (2). Určite, ktorí používatelia získajú určité povolenia pre objekty a komponenty, ktoré sa dodávajú s balíkom Webex Contact Center for Service Cloud Voice. Okrem toho im udeľte tieto povolenia; Sady povolení, ktoré sa dodávajú s balíkom Webex Contact Center for Service Cloud Voice, pomáhajú tomuto procesu. Sprievodca inštaláciou balíka – zobrazí sa uvítacia obrazovka: |
| 4 |
Udeľte nasledujúce sady povolení aspoň jednému používateľovi, aby ste mohli vytvoriť Centrum kontaktov:
|
| 5 |
Kliknite na položku Nastavenie | Používatelia | Používatelia. |
| 6 |
Vyhľadajte a vyberte používateľa. |
| 7 |
Posuňte zobrazenie nadol na sekciu Priradenia nastavené povoleniami. |
| 8 |
Kliknite na Upraviť priradenia |
| 9 |
Pre správcov kontaktného centra: Priraďte množinu povolení správcu kontaktného centra (telefónia partnera).
|
| 10 |
Pre agentov kontaktného centra: priraďte sadu povolení agenta kontaktného centra (telefónia partnera) a sadu povolení agenta Webex Contact Center SCV.
Neodporúča sa vybrať možnosť Inštalovať pre všetkých používateľov , pretože táto možnosť udeľuje všetky povolenia (čítanie, vytváranie, úpravu a odstraňovanie) na súčasti a objekty balíka každému používateľovi, ktorý používa vlastný používateľský profil. |
| 11 |
Priraďte používateľom balíkovú licenciu na prácu s pripojeniami pre službu Service Cloud Voice.
|
| 12 |
Prípadne môžete kliknúť na Nastavenie | Používatelia | Používatelia.. |
| 13 |
Vyhľadajte a vyberte používateľa. |
| 14 |
Posuňte sa nadol na položku Spravované balíky. |
| 15 |
Kliknite na Priradiť licencie. |
| 16 |
Zo zoznamu vyberte Webex Contact Center pre balík Service Cloud Voice . |
| 17 |
Kliknite na tlačidlo Pridať. |
| 18 |
Vytvorte stavy prítomnosti, aby ste definovali, ktoré servisné kanály budú priradené k rôznym stavom. Agenti sa môžu prihlásiť do Omni-Channel s rôznymi stavmi 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 výraz
|
| 20 |
Kliknite na položku Nové. Vytvorte aspoň jeden stav pre "Online" a jeden pre "Zaneprázdnený".
|
Priraďte stavy prítomnosti agentom
| 1 |
V časti Nastavenie zadajte do poľa Rýchle vyhľadávanie výraz Sady povolení a potom vyberte položku Sady povolení. |
| 2 |
Kliknutím otvorte Množinu povolení pre telefóniu od partnera. |
| 3 |
Kliknite na položku Prístup k stavom prítomnosti služby. |
| 4 |
Kliknite na položku Upraviť. |
| 5 |
V zozname Prítomnosť dostupnej služby vyberte predtým vytvorené stavy prítomnosti a kliknutím na tlačidlo Pridať ich priraďte k množine povolení. Agenti, ktorí sú priradení k tejto sade povolení, sa môžu prihlásiť do Omni-Channel s ktorýmkoľvek stavom prítomnosti, ktorý majú k dispozícii. |
| 6 |
Kliknite na položku Uložiť. |
| 7 |
Kliknite na položku Spravovať priradenia na tej istej stránke. Potom kliknite na Pridať priradenie v pravom hornom rohu, vyberte požadovaného používateľa, kliknite na tlačidlo Ďalej, vyberte možnosť vypršania platnosti pre priradených používateľov (voliteľné) a potom kliknite na Priradiť . Služba Service Cloud Voice používa na prácu so záznamom hlasového hovoru externú doménu. Nasledujúce adresy URL musia byť pridané do "Nastavenia vzdialeného webu" v inštalácii ( kliknutím sem otvoríte oficiálnu dokumentáciu):
Príklad: Ako nájsť adresu URL inštancie. |
| 8 |
Po prihlásení sa pozrite na adresu URL v paneli s adresou prehliadača. Adresa URL inštancie je časť pred ".my.salesforce.com" alebo ".salesforce.com" alebo ." lightning.force.com". Ak je vaša webová adresa napríklad https://orgfarm-54a38e30ad-dev-ed.develop.my.salesforce-setup.com/, potom je adresa URL vašej inštancie "orgfarm-54a38e30ad-dev-ed.develop". Príklad: URL adresa organizácie pôvodu: https://cisco.lightning.force.com Príklad: webové adresy, ktoré chcete pridať:
|
| 9 |
Omnikanálová pomôcka je požadovaná v aplikácii Lightning Service Console, aby agent mohol používať službu Service Cloud Voice.
Oficiálnu referenciu od Salesforce nájdete kliknutím na tlačidlo Let's Do This (Urobme to), ktoré otvorí stránku Konfigurácia prostredia agenta pre službu Cloud Voice with Partner Telephony na portáli pomoci Salesforce ( priamy odkaz). |
| 10 |
V časti Nastavenie zadajte do poľa Rýchle vyhľadávanie výraz Nastavenie telefónie partnera a potom vyberte položku Nastavenie telefónie partnera. |
| 11 |
Posuňte zobrazenie nadol na časť 5 Ďalšie nastavenia hlasu. |
| 12 |
Ak chcete povoliť ochranu clickjack pre stránky Visualforce s vypnutými hlavičkami pri práci s mikrofónom v aplikácii Lightning, musíte okrem adresy URL inštancie Salesforce pridať domény, z ktorých sa načítava softvérový telefón a vlastné panely s nástrojmi, ako dôveryhodné domény. Tieto nastavenia a zoznam dôveryhodných domén nájdete v časti Nastavenie | Bezpečnosť | Nastavenia relácie. Ak chcete získať správnu doménu Visualforce, prejdite na položku Nastavenie | Vlastný kód | Visualforce Pages 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 adresu URL zobrazenú v paneli s adresou URL prehliadača a pridajte ju do zoznamu Zoznam dôveryhodných domén pre vnorené rámce , pričom vyberte položku Visualforce Pages ako typ IFrame. Príklad: MyDomainName.lightning.force.com
Ak vo svojej organizácii nemáte nasadenú funkciu My Domain, váš formát adresy URL je iný. Ak máte nasadenú osobnú doménu a rozšírené domény nie sú vo vašej organizácii povolené, váš formát adresy URL je iný. Ak rozšírené domény nie sú povolené, nastavenie Stabilizovať adresy URL v aplikáciách Visualforce, Experience Builder, Site.com studio a obsahových súboroch Moja doména ovplyvňuje aj tento formát. Podrobnosti nájdete v téme Formáty adries URL mojej domény v Pomocníkovi služby Salesforce. Nastavenia ochrany Clickjack a dôveryhodných domén pre Lightning Experience
|
| 13 |
Na zobrazenie ovládacích prvkov nahrávania počas hovorov potrebujú 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 množinu polí a hodnôt, ktoré sa používajú na definovanie kontaktného centra v Salesforce pre konkrétny CTI systém. Salesforce používa definičné súbory kontaktného centra na podporu integrácie s viacerými dodávateľmi systému CTI.
Importovanie centra kontaktov
| 1 |
V časti Nastavenie zadajte do poľa Rýchle vyhľadávanie výraz Kontaktné centrá pre telefóniu partnerov a potom vyberte položku Kontaktné centrá pre telefóniu partnerov . Zobrazí sa zoznam existujúcich (ak existujú) kontaktných centier.
|
| 2 |
Kliknite na položku Vytvoriť centrum kontaktov na pravej strane stránky. |
| 3 |
Vyberte Webex Contact Center ako poskytovateľa telefónnych služieb. Potom kliknite na tlačidlo Ďalej.
Otvorí sa prehliadač súborov.
|
| 4 |
Vyberte súbor.XML |
| 5 |
Kliknite na položku Otvoriť. Súbor sa importuje.
|
| 6 |
Skontrolujte, či sa vaše kontaktné centrum zobrazuje v zobrazení zoznamu Kontaktné centrá.
|
Konfigurácia centra kontaktov
| 1 |
V časti Nastavenie zadajte do poľa Rýchle vyhľadávanie výraz Kontaktné centrá pre telefóniu partnerov a potom vyberte položku Kontaktné centrá pre telefóniu partnerov . | ||||||||||||||||||||||||||||||
| 2 |
Kliknite na predtým importované centrum kontaktov. | ||||||||||||||||||||||||||||||
| 3 |
Kliknite na položku Upraviť.
| ||||||||||||||||||||||||||||||
| 4 |
V dolnej časti stránky Kontaktné centrum kliknite na tlačidlo Pridať v časti Používatelia kontaktného centra. | ||||||||||||||||||||||||||||||
| 5 |
Kliknite na tlačidlo + vedľa používateľov, ktorí majú prístup k otvorenému Centru kontaktov. V tomto zozname sa zobrazia iba používatelia, ktorí majú |
Prispôsobiť
Externá klientska aplikácia pre integráciu Webex Contact Center
Konfigurácia externej klientskej aplikácie pre Webex Contact Center Salesforce Connector
Ak chcete službu Service Cloud Voice využívať v plnom rozsahu, tok hovorov v kontaktnom centre je možné prispôsobiť tak, aby vytvoril záznam hlasového hovoru a spustil viackanálový tok Salesforce, keď je hovor na IVR.
Vytvoriť certifikát
Uistite sa, že ste už vytvorili digitálny certifikát v súlade s politikou zabezpečenia vašej organizácie.
Ak chcete vygenerovať digitálny certifikát, pozrite si dokumentáciu Salesforce na # https://developer.salesforce.com/docs/atlas.en-us.voice_pt_developer_guide.meta/voice_pt_developer_guide/voice_pt_generate_certificate.htm.
Príklad
openSSSL genrsa -des3 -passout pass:<password> -out server.pass.key 2048 openSSL RSA -passin pass:<password> -in server.pass.key -out server.key rm server.pass.key openssl req -new -key server.key -out server.CSR Názov krajiny (2-písmenový kód) [AU]:CH Názov štátu alebo provincie (celý názov) [Some-State]: Názov lokality (napr. mesto) []: Názov organizácie (napr. Spoločnosť) [Internet Widgits Pty Ltd]: Názov organizačnej jednotky (napr. sekcia) []: Bežný názov (napr. server FQDN alebo VAŠE meno) []: E-mailová adresa []: my-api-user@my-example-org.com Zadajte nasledujúce atribúty "extra", ktoré sa majú odoslať spolu so žiadosťou o certifikát Heslo výzvy []:<password> Voliteľný názov spoločnosti []: openssl x509 -req -sha256 -days 365 -in server.CSR -signkey server.key -out server.crt
server.crt = > Certifikát pre aplikáciu externého klienta Salesforce
server.key => Súkromný kľúč pre konektor Salesforce v Webex Control Hub
Sada povolení pre používateľa integrácie SCV
Nasledujúca sada povolení udeľuje prístup k triedam Apex, ktoré používa Connects for SCV na integráciu s postupmi IVR kontaktného centra a Webex Contact Center pre Salesforce pre SCV.
Nasleduje príklad konfigurácie a popisuje minimálne požadované povolenia pre fungovanie integrácie Contact Center / IVR.
- V časti Nastavenie prejdite na položku Používatelia | Sady povolení.
- Kliknite na tlačidlo Nový .
- Zadajte štítok, napríklad: IVR Prístup k triedam SCV Apex
- API Meno sa automaticky vyplní
- licencie: Žiadne
- Kliknite na tlačidlo Uložiť .
- Otvorí sa nová sada povolení.
- Prejdite na položku Apex Class Access.
- Kliknite na tlačidlo Upraviť a pridajte nasledujúce triedy Apex:
- cisco_wxcc_scv. Smerovanie služieb
- Prejdite na položku Systémové povolenia.
- Kliknite na tlačidlo Upraviť a povoľte nasledujúce povolenia:
- Služby Apex REST
- API Povolené
Minimálny prístup - profil API iba integrácií
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 toku IVR.
Nasleduje príklad konfigurácie a popisuje minimálne požadované povolenia pre fungovanie integrácie Contact Center / IVR.
Toto je klon z profilu Minimálny prístup - API iba integrácie.
- V časti Nastavenie prejdite na položku Používatelia | Profily.
- V zozname Profily vyhľadajte položku Minimálny prístup profilu - integrácie API Only.
- Kliknutím na názov profilu otvorte profil Minimálny prístup – API Iba integrácie .
- V profile Minimálny prístup – API iba integrácie 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 sú vo vašom profile Minimálny prístup – API Iba integrácie odstránené všetky povolenia zo samotného profilu.
- Prejdite na položku Systémové povolenia.
- Uistite sa, že sú povolené nasledujúce povolenia:
- API Povolené
- API Jediný používateľ
Používateľ integrácie SCV
Nasleduje príklad konfigurácie a popisuje minimálne požadované povolenia pre fungovanie integrácie Contact Center / IVR. Pre používateľa integrácie SCV nie je potrebná žiadna licencia Salesforce Service Cloud Voice alebo Webex Contact Center pre licenciu Salesforce for SCV.
- V časti Nastavenie prejdite na položku Používatelia | Používateľov.
- Kliknite na tlačidlo Nový používateľ .
- Zadajte meno, priezvisko a všetky ostatné povinné polia.
- Používateľská licencia: Salesforce integrácia
- Profil: vyberte profil vytvorený v predchádzajúcom kroku ("Integračný profil SCV", klon profilu Minimum Access - API Only Integrations)
- Kliknite na tlačidlo Uložiť .
- Otvorte nový záznam používateľa.
- Priraďte predtým vytvorenú sadu povolení ("IVR Prístup k triedam SCV Apex").
- Priraďte množinu povolení na integráciu Salesforce API.
Vytvorte aplikáciu externého klienta Salesforce
Vytvorenie novej externej klientskej aplikácie
Existujú dve možnosti prepojenia údajov Salesforce s aplikáciami tretích strán. Pripojené aplikácie aj externé klientske aplikácie sú rámce na integráciu údajov. Externé klientske aplikácie sú ďalšou generáciou pripojených aplikácií.
Konfigurácia aplikácie externého klienta Salesforce, ktorú používa Cisco Webex Contact Center:
- V časti Nastavenie prejdite na položku Aplikácie | Externé klientske aplikácie | Správca aplikácií pre externých klientov.
- Kliknite na položku Nová externá klientska aplikácia.
- Externá klientska aplikácia – základné informácie
- Názov aplikácie externého klienta: WxCC - SCV
- API Názov: WxCC_SCV
- Kontaktný e-mail: < svoj e-mailový >
- Distribučný stav: vyberte možnosť Local (Miestny)

Aplikácia externého klienta —API (Povoliť nastavenia OAuth)
- Vybrať: Povoliť OAuth
- Nastavenia aplikácie
- URL adresa spätného volania: http://localhost:1717/OauthRedirect ako vzorová URL adresa spätného volania
- Rozsahy OAuth
- Vyberte rozsahy OAuth:
- Správa údajov používateľov prostredníctvom rozhraní API (API)
- Požiadavky môžete kedykoľvek vykonať (refresh_token, offline_access)

Povolenie toku
- Vybrať: Povoliť JWT Bearer Flow
- Kliknite na Nahrať súbory a nahrajte
súbor server.crt, ktorý obsahuje váš digitálny certifikát.

Zabezpečenie
Zrušte začiarknutie políčka Vyžadovať tajný kľúč pre tok webového servera voľba.

- Kliknite na tlačidlo Vytvoriť .
- Zmeňte na Tab Politiky a potom kliknite na tlačidlo Upraviť .
- Politiky – politiky OAuth
- Pravidlá doplnkov
- Oprávnení používatelia: vyberte položku Používatelia schválení správcom sú predbežne autorizovaní
- Potvrďte zmenu
- Autorizácia aplikácie
- Politika tokenov obnovenia: vyberte možnosť Token obnovenia s okamžitou platnosťou
- IP Relaxácia: vyberte možnosť Vynútiť obmedzenia IP

- Pravidlá doplnkov
- Pravidlá – pravidlá aplikácií
- Počiatočná stránka – žiadna
- Vyberte sady povolení — Priraďte sadu povolení vytvorenú predtým ("IVR Prístup k triedam SCV Apex")

- Kliknite na položku Uložiť.
- Zmeňte nastavenia na Tab.
-
V časti OAuth Nastavenia, kliknite na tlačidlo Spotrebiteľský kľúč a tajný kľúč; počkajte na e-mail a overte svoju totožnosť. Nový prehliadač Tab otvára obrazovku s podrobnosťami o spotrebiteľovi.

- Kliknite na položku Kopírovať a uložte spotrebiteľský kľúč. Spotrebiteľský kľúč sa neskôr použije na vytvorenie konektora Salesforce v ovládacom centre Webex Contact Center.

-
Webex Contact Center Konfigurácia a skript na vytvorenie záznamov hlasových hovorov
Ak chcete získať plnú hodnotu služby Salesforce Service Cloud Voice, tok hovorov v Webex Contact Center musí byť upravený tak, aby sa vytvoril záznam hlasového hovoru v službe Service Cloud Voice hneď po prijatí hovoru do kontaktného centra.
Voliteľný Omni-Flow môže byť spustený pre rozhodnutia o smerovaní a automatizáciu v Salesforce.
Podrobnosti o použitých rozhraniach API nájdete v téme Service Cloud Voice API Wrapper.
Predpoklady
Ak chcete používať Service Cloud Voice API Wrapper, musí byť nakonfigurovaná aplikácia externého klienta Salesforce pre integráciu IVR.
Nakonfigurujte konektor Salesforce v Webex Control Hub
Nastavte konektory integrácie Salesforce pre Webex Contact Center, ako je popísané v článku na # https://help.webex.com/en-us/article/7fuy63/SetUp-Integration-Connectors-for-Webex-Contact-Center#id_133211.
| 1 |
Prihláste sa do svojej zákazníckej organizácie na # https://admin.webex.com a prejdite do časti 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É: ZACHOVAJTE BEZPEČNOSŤ PRAVIDELNÝM STRIEDANÍM TAJOMSTIEV Uistite sa, že pravidelne striedate svoj súkromný kľúč a certifikát, aby boli vaše integrácie v bezpečí. Aktualizujte súkromný kľúč v konektore kontaktného centra v Webex Hub a certifikát v externej klientskej aplikácii v Salesforce. Tip na riešenie problémov Po kliknutí na tlačidlo Hotovo a spojnici sa konektor neuloží:
|
Webex Contact Center Hlavný tok
| Premenná prietoku | Popis |
|---|---|
| Premenná toku pre záznam hlasového hovoru ID | Jedinečný ID na identifikáciu hovoru. Vyžaduje sa na vytvorenie záznamu hlasového hovoru. Formát: wxcc_<Interakcia ID> Príklad: wxcc_fc4ec7d8-4c91-49aa-b764-081fbba344a8
|
| Lokálna premenná pre začiatok hovoru Čas |
Používa sa na vytvorenie záznamu hlasového hovoru a pri aktualizácii hlasového hovoru.
|
| Lokálna premenná pre názov frontu/ID |
Vrátené funkciou Execute Omni Flow , ktorása používa na smerovanie hovorov. Táto premenná sa vyžaduje iba pri použití Execute Omni Flow
|
| Lokálna premenná pre názov agenta/ID |
Vrátené funkciou Execute Omni Flow , ktorása používa na smerovanie hovorov. Táto premenná sa vyžaduje iba pri použití Execute Omni Flow
|
Prehľad hlavného toku

- Generovať kľúč hovoru dodávateľa
- Nastavenie času začatia hovoru
- Požiadavka HTTP: Vytvoriť záznam hlasového hovoru
- Vyhodnoťte odpoveď HTTP pre vytvorenie záznamu hlasového hovoru
- Spracovanie chýb pri vytváraní záznamu hlasového hovoru
- Požiadavka HTTP: Vykonajte Omni Flow
- Vyhodnoťte odpoveď HTTP pre vykonanie omni toku
- Spracovanie chýb pre Execute Omni Flow
- Pokračujte v smerovaní hovoru
| Tok | Popis |
|---|---|
| Generovať kľúč hovoru dodávateľa |
Každý hovor spracovaný v službe Service Cloud Voice vytvorí záznam hlasového hovoru v službe Salesforce a vyžaduje jedinečný ID s názvom Kľúč hovoru dodávateľa. V prípade záznamov hlasových hovorov vytvorených v 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í byť v súlade s nasledujúcimi pravidlami:
|
| Nastavenie času začatia hovoru |
UTC časová pečiatka č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 zavesí pred presmerovaním k agentovi.
|
| Požiadavka HTTP: Vytvoriť záznam hlasového hovoru |
Tento krok sa vyžaduje pri každom hovore. Po vytvorení záznamu hlasového hovoru musí byť záznam hlasového hovoru ID odovzdaný 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 požiadavky HTTP |
|
Požiadavka HTTP: Vytvoriť záznam hlasového hovoru
Tento krok sa vyžaduje pri každom hovore. Po vytvorení záznamu hlasového hovoru musí byť záznam hlasového hovoru ID odovzdaný 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 požiadavky HTTP
- Štítok aktivity: CreateVoiceCall
- Použiť overený koncový bod: Povolené
- Konektor: Salesforce Connector vytvorený v predchádzajúcom kroku
- Cesta požiadavky:
/services/apexrest/cisco_wxcc_scv/voice/v1/createVoiceCall - Metóda: POST
- Typ obsahu požiadavky: Application/JSON
Orgán žiadosti
Pri vytváraní záznamu hlasového hovoru môžete aktualizovať aj vlastné polia v zázname hlasového hovoru údajmi o hovore. Nižšie sú uvedené dva príklady tela žiadosti, 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": "<Contact Center API name>", "certDevName": "<názov vývojára certu>", "vendorCallKey": "{{SCV_VendorCallKey}}", "to": "{{NewPhoneContact.DNIS}}", "from": "{{NewPhoneContact.ANI}}", "initiationMethod": "Inbound", "startTime": "{{SCV_CallStartTime}}", "účastníci": [ { "participantKey": "{{NewPhoneContact.ANI}}", "type": "END_USER" } ] }
Príklad aktualizácie vlastných polí v zázname hlasového hovoru:
{ "callCenterDevName": "<Contact Center API name>", "certDevName": "<názov vývojára certu>", "vendorCallKey": "{{SCV_VendorCallKey}}", "to": "{{NewPhoneContact.DNIS}}", "from": "{{NewPhoneContact.ANI}}", "initiationMethod": "Inbound", "startTime": "{{SCV_CallStartTime}}", "účastníci": [ { "participantKey": "{{NewPhoneContact.ANI}}", "type": "END_USER" } ], "callAttributes": "{\"custfield1__c\": \"<value1>\",\"custfield2__c\": \"<value2>\",\" custfield3__c\": \"<hodnota3>\"}" }
Parametre
| Názov nehnuteľnosti | Hodnota |
|---|---|
| callCenterDevName | Meno vývojára centra kontaktov |
| certDevName | API Názov certifikátu (podľa konfigurácie v Kontaktnom centre) |
| vendorCallKey | Jedinečný hovor ID: {{SCV_VendorCallKey}}
|
| do | CalledNumber/DNIS: {{NewPhoneContact.DNIS}}
|
| z | CallingNumber/ANI: {{NewPhoneContact.ANI}}
|
| Počiatočný čas | časová pečiatka UTC{{SCV_CallStartTime}} (nastaví sa hneď po prijatí hovoru v skripte) |
| Atribúty hovoru |
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_VoiceCallRecordId
- Výraz cesty:
$.data.voiceCallId
Záznam hlasového hovoru ID, ktorý sa má odovzdať agentovi.
Vyhodnoťte odpoveď HTTP pre vytvorenie záznamu hlasového hovoru
Skontrolujte stav HTTP požiadavky Vytvoriť hlasový hovor http:
- Štítok: statusCodeCreateVoiceCall
- Premenná: CreateVoiceCall.httpStatusCode
Ak je kód stavu == 200 => úspešný inak => požiadavka zlyhala, spracovanie chýb
Spracovanie chýb pri vytváraní záznamu hlasového hovoru
Iba pre demo / ladenie prehrajte správu v závislosti od stavového kódu http.
Ak bolo vytvorenie hlasového hovoru úspešné, pokračujte Vykonať súhrnný postup. V opačnom prípade pokračujte v smerovaní hovoru.
Požiadavka HTTP: Vykonanie Omni Flow (voliteľný krok)
Funkciu Execute Omni-Flow použite, ak chcete:
- Spúšťať automatizované úlohy, napríklad vyhľadávať alebo vytvárať záznamy, a prepájať záznamy so záznamom hlasového hovoru
- Vyhľadávanie záznamov a vytváranie funkcie Screen-Pop
- Synchronizovať fronty Salesforce a Cisco
- Rozhodnutie o smerovaní môže vykonať služba Service Cloud Voice
Táto požiadavka vždy vráti "frontu" alebo "agenta" na miesto, kam musí byť hovor smerovaný.
Po vykonaní tejto požiadavky sa uistite, že ste odoslali funkciu Jasné smerovanie, ak volajúci zavesí skôr, ako ho prijme agent. Pozrite si časť Webex Contact Center Tok udalostí.
Nastavenia požiadavky HTTP
- Označenie aktivity: ExecuteOmniFlow
- Použiť overený koncový bod: Povolené
- Konektor: Salesforce Connector vytvorený v predchádzajúcom kroku
- Cesta požiadavky:
/services/apexrest/cisco_wxcc_scv/voice/v1/executeOmniFlow - Metóda: POST
- Typ obsahu požiadavky: Application/JSON
Orgán žiadosti
Okrem povinných polí môžete do Omni-Flow odovzdať ďalšie údaje ako vstupné premenné. Nižšie sú uvedené dva príklady tela žiadosti. Prvý bez dodatočných parametrov prietoku, iba povinné polia, druhý s dvoma vstupnými premennými.
Príklad s parametrami Omni-Flow:
{ "callCenterDevName": "<Contact Center API name>", "certDevName": "<cert dev name>", "voiceCallId": "{{SCV_VoiceCallRecordId}}", "dialedNumber": "{{NewPhoneContact.DNIS}}", "flowDevName": "<flow API name>", "failbackQueue": "<záložný názov frontu>" }
Príklad aktualizácie vlastných polí v zázname hlasového hovoru:
{ "callCenterDevName": "<Contact Center API name>", "certDevName": "<názov vývojára certu>", "voiceCallId": "{{SCV_VoiceCallRecordId}}", "dialedNumber": "{{NewPhoneContact.DNIS}}", "flowDevName": "<flow API name>", "failbackQueue": "<záložný názov frontu>", "flowInputParameters": { "param1": "value1", "param2": "value2" } } }
Parametre
| Názov nehnuteľnosti | Hodnota |
|---|---|
| callCenterDevName | Meno vývojára centra kontaktov |
| certDevName | API Názov certifikátu (podľa konfigurácie v Centre kontaktov) |
| voiceCallId | ID záznamu hlasového hovoru vytvoreného v predchádzajúcom kroku: {{SCV_VoiceCallRecordId}}
|
| Vytočené číslo | CalledNumber/DNIS: {{NewPhoneContact.DNIS}}
|
| flowDevName | Názov vývojára Omni-Flow na vykonanie |
| Záložný front: | Front ID alebo Front API názov záložného frontu Salesforce |
| flowInputParameters |
Ďalšie vstupy pre omnikanálový tok (pár kľúč-hodnota). Príklad:
|
Nastavenia analýzy
Front
- Typ obsahu: JSON
- Výstupná premenná: SCV_OmniFlowQueue
- Výraz cesty:
$.data.queue
"Front" vrátený z Execute Omni-Flow môže byť použitý na smerovanie.
Agent- Typ obsahu: JSON
- Výstupná premenná: SCV_OmniFlowAgent
- Výraz cesty:
$.data.agent
"Agent" vrátený z Execute Omni-Flow, môže byť použitý na smerovanie.
Vyhodnoťte odpoveď HTTP pre vykonanie omni toku
Skontrolujte stav HTTP požiadavky http Execute Omni Flow:
- Štítok: statusCodeExecuteOmniFlow
- Premenná: ExecuteOmniFlow.httpStatusCode
Ak bol kód stavu == 200 => úspešný inak => požiadavka zlyhala, spracovanie chyby.
Spracovanie chýb pre Execute Omni Flow
Iba pre demo / ladenie prehrajte správu v závislosti od stavového kódu http.
Ak bolo vykonanie Omni Flow úspešné, premenné SCV_OmniFlowQueue a SCV_OmniFlowAgent nie sú nastavené. Rozhodnutie o smerovaní v toku hovorov.
Pokračujte v smerovaní hovoru
Pokračujte v toku hovorov, smerujte hovor k agentovi. Voliteľné, použite SCV_OmniFlowQueue a SCV_OmniFlowAgent na výber frontu a agenta.
Webex Contact Center Tok udalostí
Ak volajúci zavesí hovor skôr, ako ho prijme agent, musíme aktualizovať službu Service Cloud Voice a ukončiť hovor.
- Ak bola použitá možnosť Spustiť omni-flow, odošlite vymazanie smerovania na odstránenie čakajúceho smerovania služby (PSR)
- Odoslať aktualizáciu hlasového hovoru, ak chcete aktualizovať čas začiatku a konca záznamu hlasového hovoru a zmeniť stav z Nový na Dokončený

- PhoneContactEnded - Táto udalosť sa spustí, keď sa odpojí živý hovor a všetci účastníci sa odstránia.
- Požiadavka HTTP: Vymazať smerovanie
- Požiadavka HTTP: Aktualizácia hlasového hovoru
Požiadavka HTTP: Vymazať smerovanie
- Štítok: ClearRouting
- Použiť overený koncový bod: Povolené
- Konektor: Salesforce Connector vytvorený v predchádzajúcom kroku
- Cesta požiadavky:
/services/apexrest/cisco_wxcc_scv/voice/v1/clearRouting - Metóda: POST
Typ obsahu požiadavky: Application/JSON
Orgán žiadosti
{ "callCenterDevName": "<Contact Center API name>", "certDevName": "<názov vývojára certu>", "voiceCallId": "{{SCV_VoiceCallRecordId}}" }
Parametre
| Názov nehnuteľnosti | Hodnota |
|---|---|
| callCenterDevName | Meno vývojára centra kontaktov |
| certDevName | API Názov certifikátu (podľa konfigurácie v Centre kontaktov) |
| voiceCallId | ID záznamu hlasového hovoru vytvoreného v predchádzajúcom kroku: SCV_VoiceCallRecordId |
Nastavenia analýzy
Žiadny.
Požiadavka HTTP: Aktualizácia hlasového hovoru
- Štítok: UpdateVoiceCall
- Použiť overený koncový bod: Povolené
- Konektor: Salesforce Connector vytvorený v predchádzajúcom kroku
- Cesta požiadavky:
/services/apexrest/cisco_wxcc_scv/voice/v1/updateVoiceCall - Metóda: POST
- Typ obsahu požiadavky: Application/JSON
Orgán žiadosti
{ "callCenterDevName": "<Contact Center API name>", "certDevName": "<názov vývojára certu>", "voiceCallId": "{{SCV_VoiceCallRecordId}}", "startTime": "{{SCV_CallStartTime}}", "endTime": "{{now() | replace({'[UTC]': ''})}}", "disconnectReason": { "value": "Opustené vo fronte", "isError": true } }
Parametre
| Názov nehnuteľnosti | Hodnota |
|---|---|
| callCenterDevName | Meno vývojára centra kontaktov |
| certDevName | API Názov certifikátu (podľa konfigurácie v Kontaktnom centre) |
| voiceCallId | ID záznamu hlasového hovoru vytvoreného v predchádzajúcom kroku: SCV_VoiceCallRecordId |
| Počiatočný čas | UTC časová pečiatka začiatku hovoru{{SCV_CallStartTime}} (používa sa na vytvorenie záznamu hlasového hovoru) |
| Koncový čas | Aktuálna časová pečiatka UTC '{{now() |
| odpojiťDôvod | Dôvod odpojenia hovoru. Vlastnosť isError musí byť nastavená na hodnotu true , aby sa zobrazila správne. |
Nastavenia analýzy
Žiadny.
Referencie
- Vytvorenie súkromného kľúča a digitálneho certifikátu s vlastným podpisom
- Konfigurácia pripojenej aplikácie pre Webex Contact Center Salesforce Connector
- Nastavenie integračných konektorov pre Webex Contact Center - Salesforce
- Cisco Webex Contact Center Sprievodca nastavením a správou > návrhárovi postupov
- Integrácia telefónie REST API
Preklad jazykov
(Voliteľné) Povoliť prekladateľský pracovný stôl
Toto nastavenie je použiteľné len v prípade, že používate nastavenia jazyka prekladu.
| 1 |
Prejdite na položku Nastavenie → Prekladateľský pracovný stôl → Nastavenia jazyka prekladu. |
| 2 |
Kliknite na Povoliť a vyberte jazyk prekladu.
|
(Voliteľné) Povoliť jazyky iba pre platformu
Toto nastavenie platí len pre iné jazyky ako SK.
| 1 |
Prejdite na Nastavenie → Nastavenia spoločnosti → Nastavenia jazyka. |
| 2 |
Vyberte požadované jazyky. |
| 3 |
Zaškrtnite nasledujúce políčka:
|
| 4 |
Uložte zmeny.
|
Aktivujte jazyk a vyberte používateľa (úlohu)
| 1 |
Prejdite na položku Nastavenie → Prekladateľský pracovný stôl → Nastavenia jazyka prekladu. |
| 2 |
Vyberte jazyk a vyberte používateľa, ktorý ho preloží. |
| 3 |
Uložte zmeny.
|
Viacjazyčné nastavenia
Preklad vlastných štítkov
| 1 |
Prejdite na Nastavenie → vlastných štítkov. |
| 2 |
Vyberte názov vlastného označenia, ktoré chcete otvoriť.
|
| 3 |
V súvisiacom zozname Preklady kliknite na položku Nový |
| 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 označenia, ak je predvoleným jazykom používateľa jazyk prekladu. |
| 6 |
Uložte zmeny. |
Povolenia Salesforce vyžadované funkciou používateľa
Sada povolení Webex Contact Center SCV Agent obsahuje všetky povolenia potrebné na prácu s miniaplikáciou Webex Contact Center a integráciami vyvinutými pre agentov.
Prístup do triedy Apex (sekcia)
- cisco_wxcc_scv. CiscoScvWxcc
- cisco_wxcc_scv. Obsluha odpovedí na služby
- cisco_wxcc_scv. Smerovanie služieb
- cisco_wxcc_scv. Obsluha integrácie telefónie
Vlastný typ metaúdajov Prístupy (sekcia)
- cisco_wxcc_scv. Pripojenie WxCC
Visualforce Page Access (sekcia)
- cisco_wxcc_scv. CiscoScvLoginWxCC
- cisco_wxcc_scv. CiscoScvMainWxCC
- cisco_wxcc_scv. CiscoScvOAuthRedirect
- cisco_wxcc_scv. CiscoScvSwLoader
Service Cloud Voice API Wrapper
Predpoklady
Ak chcete používať Service Cloud Voice API Wrapper, musí byť nakonfigurovaná aplikácia externého klienta Salesforce pre integráciu IVR.
Používanie Service Cloud Voice API Wrapper
Service Cloud Voice (SCV) pre Salesforce používa Telephony Integration REST API na vytváranie a aktualizáciu hlasových hovorov, spúšťanie viackanálových tokov a odstraňovanie záznamov PendingServiceRouting priradených k hlasovému hovoru. Táto služba vyžaduje autorizáciu JWT a použitie metódy PATCH HTTP, ktorú v súčasnosti Cisco IP Interactive Voice Response (IVR nepodporuje).
S cieľom zjednodušiť používanie telefónnej integrácie REST API pre SCV (nielen) v systéme IVR bola sprístupnená nová sada rozhraní API, ktoré obaľujú existujúci 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 autentifikácie tokenu JWT, implementuje ďalšie kontroly údajov požadovaných Salesforce API a zlepšuje objekty odpovede.
Načítanie Access_Token
Spustiť požiadavku # POST na https://<your-domain-name>.my.salesforce.com/services/oauth2/token
Odoslanie nasledujúcich parametrov do tela:
{ "grant_type": "client_credentials", "client_id": "<spotrebiteľský kľúč pripojenej aplikácie>", "client_secret": "<Tajomstvo spotrebiteľa pripojenej aplikácie>" } Ak je požiadavka úspešná, vráti sa nasledujúca odpoveď JSON: { "access_token": "<your-access-token>", "instance_url": "<your-org-base-url>", "ID": "https://login.salesforce.com/id/<id>/<id>", "token_type": "Bearer", "issued_at": "<timestamp>", "signature": "<unique-signature-code>" }
Realizujte požiadavky
Adresa URL 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 adresy URL inštancie (t. j. https://abc-123.lightning.force.com ) má za následok stav 401 Neoprávnené s vráteným chybovým kódom INVALID_SESSION_ID.
Vytvoriť hlasový hovor (časť)
Vytvorí záznam hlasového hovoru obsahujúci účastníkov (t. j. volajúceho a príjemcu) pre záznam hlasového hovoru. Keď vytvoríte záznam hlasového hovoru, konverzácia sa vytvorí v službe Salesforce. Túto API používajte iba v reálnom čase, čo znamená, že túto API by ste mali vyvolať iba pri iniciovaní hovoru. Tento API možno použiť aj na vytvorenie záznamov hlasových hovorov pre prepojenie a konferenčné hovory zahrnutím parametra parentVoiceCallId do objemu dát požiadavky.
Koncový bod URI
<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/createVoiceCall
Metóda HTTP
POST
Hlavičky
Autorizácia: Doručiteľ <access_token>
Content-Type: application/json
Parametre
{ "callCenterDevName": "contactCenterDevName123", "certDevName": "certDevName123", "vendorCallKey": "5324881f-1e84-4367-8930-f69a74b30ca6", "to": "8002345678", "od": "4081456688", "initiationMethod": "Prichádzajúce", "startTime": "2019-07-02T17:32:28Z", "účastníci": [ { "participantKey": "4081456688", "type": "END_USER" } ], "callAttributes": "{\"devscv24__AAA_Test__c\":\"hodnota poľa\",\"Other_Field__c\":\"iná hodnota\"}", "parentVoiceCallId": "fsdfzuhsdfsa-43556fgef3-56g44gv4ew", "callOrigin": "Ukážka", "front": "queue123" }
Odpoveď (úspešná)
{ "data": { "voiceCallId": "00X000012345abc" }, "errors": null, "success": true }
Odpoveď (s chybami)
{ "data": null, "errors": ["Chybové hlásenie 1", "Chybové hlásenie 2"], "úspech": false }
Aktualizácia hlasového hovoru
Aktualizuje hlasový hovor po ukončení hovoru. Tento 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 hovoru. Aktualizovať hlasový hovor API je asynchrónna operácia. Nemôžete dotazovať stav hovoru API.
Tento koncový bod je možné použiť aj na vytvorenie hlasového hovoru aj po ukončení hovoru. Toto správanie je užitočné v scenároch, v ktorých chcete zaznamenať záznam v službe Salesforce pre nedokončené alebo zmeškané hovory, alebo v akomkoľvek inom scenári, v ktorom hlasový hovor ešte nebol vytvorený.
Koncový bod URI
<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/updateVoiceCall
Metóda HTTP
POST
Hlavičky
Autorizácia: Doručiteľ <access_token>
Content-Type: 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 } }
Podrobný popis parametrov akceptovaných touto žiadosťou nájdete v oficiálnej dokumentácii Salesforce v časti "Parametre".
Odpoveď (úspešná)
{ "data": { "status": "čakajúce" }, "errors": null, "success": true }
Aktualizovať hlasový hovor API je asynchrónna operácia. Nemôžete dotazovať stav hovoru API.
Odpoveď (s chybami)
{ "data": null, "errors": ["Chybové hlásenie 1", "Chybové hlásenie 2"], "úspech": false }
Spustiť omni-flow
Vykonáva omnikanálový tok na smerovanie hovorov. Odovzdá hovor ID (Salesforce VoiceCallId alebo ID dodávateľa telefónnych služieb ContactId) ako parametre postupu a vráti pokyny na smerovanie agenta alebo frontu do toku kontaktov. Služba Service Cloud Voice predvolene používa viackanálový tok (alebo záložný front) určený pre telefónny kanál, ktorý sa zhoduje s vytočeným číslom. Ak sa vytočené číslo nezhoduje s existujúcim telefónnym kanálom, môžete voliteľne nastaviť nové vytočené číslo, viackanálový tok a záložný front ako vstupné parametre pre tento hovor API.
Služba Service Cloud Voice používa toto poradie priorít pri smerovaní hovorov:
- Používa nastavenia viackanálového toku a záložného frontu pre telefónny kanál, ktorý sa zhoduje s vytočeným číslom. Postup má prednosť. Ak postup zlyhá, použije sa záložný front.
- Používa parametre flowDevName a failbackQueue zadané v hovore Execute Omniflow API.
Koncový bod URI
<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/executeOmniFlow
Metóda HTTP
POST
Hlavičky
Autorizácia: Doručiteľ <access_token>
Content-Type: application/json
Parametre
{ "callCenterDevName": "contactCenterDevName123", "certDevName": "certDevName123", "voiceCallId": "00X000012345abc", "dialedNumber": "+18445791189", "flowDevName": "Route_VoiceCall", "fallbackQueue": "00G111222333444", "flowInputParameters": { "Input1": "jeden", "Input2": "dva" } }
- Parameter voiceCallId je Salesforce voiceCallId alebo kontakt predajcu telefónnych služieb ID.
- Podrobný popis parametrov akceptovaných touto žiadosťou nájdete v oficiálnej dokumentácii Salesforce v časti "Parametre".
Odpoveď (úspešná)
{ "data": { "queue": "queue info", "agent": "agent info" }, "errors": null, "success": true }
AGENT_INFO a QUEUE_INFO zodpovedajú poľu ExternalId na mape smerovania centra hovorov
Odpoveď (s chybami)
{ "data": null, "errors": ["Chybové hlásenie 1", "Chybové hlásenie 2"], "úspech": false }
Jasné smerovanie
Odstráni záznam PSR (PendingServiceRouting) hlasového hovoru. Toto API nie je potrebné volať pre väčšinu scenárov; záznam PSR sa automaticky odstráni, keď hovor prestane byť smerovaný. Existujú však niektoré scenáre, napríklad pri zmeškaných alebo opustených hovoroch pri používaní partnerských telefónnych systémov, kde musíte explicitne zavolať na toto číslo API, aby ste vymazali záznam PSR.
Koncový bod URI
<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/clearRouting
Metóda HTTP
POST
Hlavičky
Autorizácia: Doručiteľ <access_token>
Content-Type: application/json
Parametre
{ "callCenterDevName": "contactCenterDevName123", "certDevName": "certDevName123", "voiceCallId": "00X000012345abc" }
- Parametrom voiceCallId je Salesforce voiceCallId alebo kontakt ID dodávateľa telefónnych služieb.
- Podrobný popis parametrov akceptovaných touto žiadosťou nájdete v oficiálnej dokumentácii Salesforce v časti "Parametre".
Odpoveď (úspešná)
{ "data": { "status": "Success" }, "errors": null, "success": true }
Odpoveď (s chybami)
{ "data": null, "errors": ["Chybové hlásenie 1", "Chybové hlásenie 2"], "úspech": 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 aplikácie špecifické pre zákazníka je potrebný prispôsobiteľný nástroj na prenos telefónnych čísel z formátu A do formátu B.
Riešenie Webex Contact Center for Service Cloud Voice automaticky odstráni všetky znaky okrem čísel, hashtagov (#), hviezdičiek (*), čiarok (,) a úvodných znamienok plus (+). Odstráni sa aj prvý výskyt (0). Toto sa vykoná PRED použitím prekladov 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 Meno-hodnota. To vám umožní nakonfigurovať neobmedzené množstvo pravidiel pre každú funkciu.
Konfigurácia je uložená ako reťazec JSON.
Všimnite si, že spätným lomkám je potrebné uniknúť, napr. \d+ sa zmení na \\d+.
{"Odstrániť všetky znaky okrem číslic":"[1,17]->[^\\d]+","Na interné číslo":"[7,17]->(\\d{7})(\\d{4})->$2"}
Pole Názov sa technicky nepoužíva. Je tu na pridanie reťazca čitateľného človekom, aby sa rýchlo identifikoval účel tohto pravidla. Dobré mená sú napríklad: Odstráňte všetky úvodné nuly, Pridajte úvodné plus atď.
Vytváranie pravidiel prekladu
Pravidlá sa poskytujú ako regulárne výrazy. Presnejšie: Implementácia regulárnych výrazov v jazyku JavaScript.
Dobrým spôsobom, ako začať, je prečítať si dokument RegExp z webových dokumentov 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 od 7 do 11 znakov (vrátane okrajov + medzier) sa zhodujú.
Predikáty sa vždy zhodujú s pôvodnou dĺžkou čísla. To pomáha zjednodušiť konfiguráciu znížením rizika kolíznych 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 vyberá ich.
Volič
Selektory definujú konečný formát čísla. Ak je potrebné pridať znaky / číslice, ktoré pôvodne neboli prítomné, toto je miesto, kde to môžete urobiť.
Volič je posledným krokom pri vytváraní čísla. Na základe výstupu vzoru volič vytvorí 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.
V tomto príklade sa používajú 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. 0319175200 sa zhoduje, a preto sa použije pravidlo. Vzor určuje, že číslo musí začínať skupinou jednej číslice (\d{1}), za ktorou nasleduje skupina dvoch číslic (\d{2}), za ktorou nasleduje skupina troch číslic (\d{3}) atď.
Selektor potom pristupuje k skupinám vzorov a definuje nový číselný reťazec. To znamená, že $2 odkazuje na prvý (\d{2}), a preto obsahuje 31.
Príklad 2
Nasledujúci príklad ukazuje, ako prepojiť číslo prijaté z kontaktného centra vo formáte +14693150217 do amerického formátu E164 +1 469 315 0217.
V tomto príklade sa používajú dve pravidlá prekladu (1. a 2.)
- Toto číslo má presne 12 znakov, preto sa použije pravidlo "Pridať medzery do amerických čísel".
- (\+1) hovorí, že číslo musí začínať +1. Ak má číslo 12 znakov, ale nezačína +1, pravidlo sa zruší a nič sa nezmení.
- (\d{3}) hovorí, že za +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í na "$1 $2 $3 $4":
- $1 odkazuje na skupinu (\+1), číslo, ktoré sa má odoslať do služby Service Cloud Voice, vyzerá ako +1.
- $2 odkazuje na prvý z nich (\d{3}), číslo, ktoré sa má odoslať službe Service Cloud Voice, vyzerá ako +1 469.
- $3 odkazuje na druhý z dvoch (\d{3}), číslo, ktoré sa má odoslať do služby Service Cloud Voice, vyzerá ako +1 469 315.
- $4 odkazuje na poslednú skupinu (\d{4}), číslo, ktoré sa má odoslať do služby Service Cloud Voice, vyzerá ako +1 469 315 0217.
Medzery v náhradnej časti pravidla "$1 $2 $3 $4" sa používajú priamo. Ak teda použijete "$1-$2-$3-$4", číslo bude preložené ako: +1-469-315-0217
Môžete tiež 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 sa prichádzajúce číslo "+14693150217" preloží na: (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.
V tomto príklade sa používajú dve pravidlá prekladu (1. a 2.)
- Toto číslo má presne 13 znakov, preto sa použije pravidlo "Pridať medzery k nemeckým číslam".
- (\+49) hovorí, že číslo musí začínať +49. Ak má číslo 13 znakov, ale nezačína +49, pravidlo sa zruší a nič sa nezmení.
- (\d{3}) hovorí, že za +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á ako +49.
- $2 odkazuje na prvý z nich (\d{3}), číslo, ktoré sa má odoslať do služby Service Cloud Voice, vyzerá ako +49 151.
- $3 odkazuje na druhý z dvoch (\d{4}), číslo, ktoré sa má odoslať do služby Service Cloud Voice, vyzerá ako +49 151 5555.
- $4 odkazuje na poslednú skupinu (\d{3}), číslo, ktoré sa má odoslať do služby Service Cloud Voice, vyzerá ako +49 151 5555 531.
To isté platí pre pravidlo jedna. Náhradný diel $1 $2 $3 $4 môžete použiť na výber toho, čo chcete použiť z čísla.
Ďalšie príklady prekladu Regex
| Popis | Preklad Regex |
|---|---|
| Odstránenie všetkých znakov okrem číslic | [1,17]->[^\d]+ |
| Odstránenie všetkých znakov okrem číslic & + | [1,17]->[^+\d]+ |
| Popis | Preklad Regex |
|---|---|
| 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 |
| Popis | Preklad Regex |
|---|---|
| Odstráňte + a nahraďte ho nulami US E164 | [10,12]->(.{ 1})(\d{1})(\d{10})-> 001 $3 |
| Odstráňte +1 a nahraďte ho nulami US E164 | [10,12]->(^\+1+)(\d+)-> 001$2 |
| Odstráňte + a nahraďte ho nulami DE E164 | [12,15]->(.{ 1})(\d{2})(\d{10})-> 0049 $3 |
| Odstráňte +49 a nahraďte ho nulami DE E164 | [10,12]->(^\+49+)(\d+)-> 0049$2 |
| Odstráňte + a nahraďte ho nulami CH E164 | [10,13]->(.{ 1})(\d{2})(\d{9})-> 0041 $3 |
| Odstráňte +41 a nahraďte ho nulami CH E164 | [10,12]->(^\+41+)(\d+)-> 0041$2 |
| Popis | Preklad Regex |
|---|---|
| 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 hlasového hovoru
Konfigurácia stránky záznamu hlasového hovoru
Stránka záznamu hlasového hovoru je predvolene predkonfigurovaná, s rozložením 3 stĺpcov a nasledujúcimi súčasťami:
- Opatrenia a odporúčania
- Poznámky k hovorom
- Podrobnosti o hovore
- Nahrávky
Komponenty je možné voľne odstrániť alebo pridať na stránku v závislosti od obchodných potrieb. Je možné použiť aj rôzne rozloženia strán, 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.
Zobrazenie komponentu Dôvod zabalenia
Komponent Dôvod ukončenia musí byť zobrazený počas hovoru a počas zalomenia.
Pridajte komponent Cisco Dôvod ukončenia na stránku záznamu hlasového hovoru:
- Presuňte webový komponent Cisco Wrap-Up Reason Lightning z oblasti Vlastné komponenty s konektorom Lightning na stránku záznamu hlasového hovoru.
- Kliknite na položku Uložiť.
- Kliknite na položku Aktivovať.
- Kliknite na položku Priradiť ako predvolenú organizáciu.
- Kliknite na položku Uložiť.
- Znova kliknite na Uložiť a potom sa kliknutím na šípku späť vráťte na stránku.
Komponent Cisco Dôvod zabalenia sa počas hovoru a zabalenia zobrazí automaticky:
Po pridaní na stránku sa komponent Cisco Dôvod zabalenia zobrazí pre každý hovor, a to aj v prípade, že v Cisco Contact Center nie je nakonfigurovaná žiadna funkcia Zabaliť.
Zobrazenie prehrávača nahrávania hovorov
Prehrávač nahrávania hovorov sa zobrazí, ak bol uložený odkaz na nahrávanie príslušného hlasového hovoru.
Ak chcete pridať komponent Prehrávač nahrávania hovorov na stránku záznamu hlasového hovoru, postupujte nasledovne:
- Presuňte webovú súčasť Prehrávač nahrávania hovorov Lightning na stránku záznamu hlasového hovoru
- Kliknite na tlačidlo Uložiť .
- Kliknite na položku Aktivovať.
- Kliknite na položku Priradiť ako predvolenú organizáciu.
- Kliknite na tlačidlo Uložiť .
- Znova kliknite na Uložiť a potom sa kliknutím na šípku späť vráťte na stránku.
Webex Správcovia
Konfigurácia toku
Vyskakovacie okno
Uzol "Screen Pop" je k dispozícii v postupe Webex Contact Center. Môže sa použiť na spustenie vyskakovacieho okna obrazovky v službe Service Cloud Voice alebo v samostatnom okne.
Ďalšie informácie o tejto funkcii nájdete v dokumentácii Flow Designer.
Funkcia Screen Pop v samostatnom okne
Ak chcete otvoriť kontextové okno obrazovky v samostatnom okne, v uzle "Screen Pop" musí byť uvedená absolútna adresa URL. Parameter queryParameters sa pripojí k webovej adrese ako parametre vyhľadávania.
Podporované sú nasledujúce režimy:
- Nový prehliadač Tab - Vždy otvorí nový prehliadač Tab.
- Existujúci prehliadač Tab - Na prvej obrazovke Existujúci prehliadač Tab sa otvorí nový prehliadač Tab. Tento Tab bude vyhradený Tab pre nasledujúce vyskakovacie okná obrazovky Existujúci prehliadač Tab a adresa URL sa obnoví v rámci tohto konkrétneho prehliadača Tab.
- Inside Desktop - Zaobchádza sa s ním rovnakým spôsobom ako s novým prehliadačom Tab.
Aktuálne otvorená stránka môže zabrániť presmerovaniu. V takom prípade sa v novom prehliadači Tab otvorí kontextové okno obrazovky existujúceho prehliadača Tab.





