V tomto článku
dropdown icon
Prehľad
    Kontaktné centrum Webex pre službu Salesforce Cloud Voice
    Predpoklady a obmedzenia
    Licencie
    Povoliť Omni-Channel
    Obmedzenia
dropdown icon
Požiadavky
    Salesforce Package 1.2 a novší
    Nečinné kódy
    Limity sadzieb
dropdown icon
Integrovať
    Inštalácia
    Inštalácia a konfigurácia Webex Contact Center for Service Cloud Voice
    Priraďte stav (-ov) prítomnosti agentom
dropdown icon
Konfigurácia
    Vytvorte vlastný záznam metadát o povereniach Webex Contact Center
    Kontaktné centrum
    Import kontaktného centra
    Konfigurácia kontaktného centra
dropdown icon
Prispôsobiť
    Externá klientská aplikácia pre integráciu Webex Contact Center
    Konfigurácia Webex Contact Center a skript na vytváranie záznamov hlasových hovorov
Povolenia Salesforce požadované používateľskou funkciou
dropdown icon
Služba Cloud Voice API Wrapper
    Predpoklady
    Používanie služby Cloud Voice API Wrapper
    Získajte Access_Token
    Vykonajte požiadavky
    Vytvorenie hlasového volania (sekcia)
    Aktualizujte hlasový hovor
    Vykonajte Omni-flow
    Vymazať smerovanie
dropdown icon
Preklady telefónnych čísel
    Vytváranie pravidiel prekladu
dropdown icon
Konfigurácia stránky VoiceCall
    Konfigurácia stránky záznamu VoiceCall
    Zobrazenie zložky Wrap-Up Reason
    Zobrazenie prehrávača nahrávania hovorov
dropdown icon
Správcovia Webex
    Konfigurácia toku
Integrácia kontaktného centra Webex so službou Salesforce Cloud Voice
list-menuV tomto článku
list-menuSpätná väzba?

Webex Contact Center for salesforce Service Cloud Voice integruje robustné CCAA (Contact Center as a Service) spoločnosti Cisco s CRM spoločnosti Salesforce, čo umožňuje podnikom spravovať všakanálové interakcie so zákazníkmi (hlasové, digitálne) v rámci rozhrania Salesforce, pomocou Webex AI pre virtuálnych agentov, transkripcie a inteligentné smerovanie, transformujúc agentov na „superagentov“ s jednotnými údajmi pre lepšiu zákaznícku skúsenosť.

Prehľad

Kontaktné centrum Webex pre službu Salesforce Cloud Voice

Webex Contact Center for Service Cloud Voice je komplexné integračné riešenie, ktoré prináša silu Webex Contact Center do konzoly Salesforce Service Cloud Voice Omni-channel agentov.

Pred pokračovaním v inštalácii si pozrite nasledujúcu časť:

aby ste sa dozvedeli o podmienkach a obmedzeniach služby Salesforce Service Cloud Voice a uistili sa, že váš Salesforce Org je pripravený povoliť a nainštalovať Webex Contact Center for Service Cloud Voice balík.

SCV Voice Connector Release 1 je všeobecne k dispozícii. Táto príručka obsahuje postupy nastavenia, poskytovanie telefonovania pre partnerov a konfiguráciu jediného prihlásenia (SSO).

Predpoklady a obmedzenia

Predpoklady (podtéma)

Používateľské rozhrania: Služba Cloud Voice je k dispozícii iba v službe 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ú licenciu doplnku A-SF-VOICE pre prihláseného agenta okrem štandardných alebo prémiových licencií Flex 3 pre Webex Contact Center. Ďalšie informácie nájdete v príručke objednávania Flex 3.

  • Salesforce Voice pre partnerské telefónie

Predtým, ako zapnete Voice, musíte vo svojej organizácii nastaviť nevyhnutné služby.

  • Prejdite na polož ku Informácie o spoločnosti > Licencia na nastavenie povol ení
    • Skontrolujte službu Service Cloud Voice User (Partner Telephony).

      Všetky vydania pre vývojárov sú teraz dodávané s 5 licenciami pre partnerské telefóny, ktoré sú k dispozícii na testovanie.

  • Prípadne to môžete overiť tak, že prejdete na Salesforce Setup a vyhľadáte „hlas“ na ľavom bočnom paneli.

    • Ak sa zobrazí „Partner Telephony Contact Centers“, máte licenciu SCV.
    • Ak nie je viditeľná možnosť „Kontaktné centrá pre partnerské telefóny“, postupu jte podľa nasledujúcich krokov „Povoliť službu Cloud Voice“.
      • Prejdite na Nastavenie Salesforce a vyhľadajte a vyberte položku „Nastavenie partnerskej telef ónie“ a prepnite tlačidlo na „Povoliť službu Cloud Voice“.

      • Povoľte Omni-Channel a umožnite svojim agentom uskutočňovať a prijímať hovory.

Povoliť Omni-Channel

Ak je Omni-Channel už vo vašej organizácii povolený, preskočte tento krok.

  1. V časti Nastavenie zadajte do poľa Rýchle vyhľadávanie zadajte Nastavenia omni-Channel Settings a potom vyberte položku Nastavenia omni -Channel.

  2. Vyberte možnosť Pov oliť omni-Channel.
  3. Kliknite na polož ku Uložiť.

Obmedzenia

  • Hlas je k dispozícii iba v Lightning Experience.
  • Voice je podporovaný v službe Service Cloud a Sales Cloud ako doplnková licencia.
  • Hlas nie je podporovaný v aplikácii 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 sa umožnilo jednorazové prihlásenie (SSO).
  • Štandardná navigácia nie je podporovaná.
  • Telefonovanie je vysoko regulované, preto sa obráťte na svojho zástupcu Salesforce o dostupnosti Voice vo vašom regióne.
  • Konferencia viacerých strán nie je podporovaná pomocou konektora Salesforce Service Cloud Voice.

Požiadavky

Salesforce Package 1.2 a novší

Pre Salesforce Package 1.2 alebo novší musí nasadenie zohľadňovať digitálnu a hlasovú integráciu a udržiavanie funkcie WebSocket.

Nečinné kódy

Nájdite nečinné kódy

Ak chcete nastaviť nečinné kódy, postupujte podľa týchto krokov:
1

Prihláste sa doManagement Portal.

2

Prejdite na Contact Center > DESKTOP EXPERIENCE > Idle/Wra p-up Codes.

3

Uistite sa, že sú zobrazené nečinné kódy, inak kliknite na rozbaľovacie tlačidlo filtra a vyberte položku Nečinný kód v hornej časti stránky.

4

Kliknutím na nečinný kód otvoríte zobrazenie detailov. Tam nájdete ID nečinného kódu.

Identifikácie je možné skopírovať a potom použiť pre konfiguráciu Mapovanie stavu prítomnosti. Jeden z ID musí byť použitý ako predvolený dôvod Cisco Not Ready.

Limity sadzieb

Táto časť sa vzťahuje iba na balík včasného prístupu v prípade, že sa na balíku včasného prístupu testuje vyšší počet agentov (napr. 0.2). Toto nie je potrebné pre bal ík GA.

Webex Contact Center uplatňuje štandardné limity rýchlosti API na integráciu organizácie Contact Center. Podrobnosti nájdete v časti Limity sadzieb API.

Limit sadzby je potrebné zvýšiť. Na dosiahnutie tohto cieľa:

  • Vytvorte si lístok s podpor ou Webex Contact Center.
  • Zadajte organizáciu Webex Contact Center a požadovaný štandardný limit rýchlosti API pre integráciu (výpočet pozri nižšie).
  • Uveďte, že zvýšenie limitu rýchlosti API je potrebné, pretože používate Webex Contact Center for Service Cloud Voice.

Webex Contact Center for Service Cloud Voice, 15 žiadostí na agenta za minútu na integráciu organizácie Contact Center. Ak chcete vypočítať dobrý východiskový bod pre limit sadzby, môžete použiť nasledujúci vzorec:

Limit rýchlosti za minútu = 15 * maximálny počet agentov pracujúcich paralelne v organizácii Webex Contact Center

Integrovať

Inštalácia

Pred inštaláciou si pozrite časť Predpoklady a obmedzenia, kde nájdete informácie o predbežných podmienkach a obmedzeniach služby Salesforce Service Cloud .

Inštalácia a konfigurácia Webex Contact Center for Service Cloud Voice

Po získaní licencie Service Cloud Voice for Partner Telephony sa v ponuke Nastavenie telefónie pre partnerov zobrazí stránka Nastav enie telefónie pre partnerov.

Ďalšie informácie nájdete v oficiálnej referencii Salesforce (priamy odkaz).

1

V časti Nastavenie zadajte do Partner Telephony Setuppoľa R ýchle vyhľadávanie a potom vyberte položku Nastavenie telefónie pre partnerov.

2

Povoli ť Zapnutie hlasu pomocou partnerskej telefónie.

V ponuke Nastavenia sa zobrazí stránka Kontaktné centrá pre partnerské telef óny.

Ak plánujete nasadiť balík do pieskoviska Salesforce, nahraďte login.salesforce.comčasť inštalačného odkazu za. test.salesforce.com Upozorňujeme, že tento balík sa odstráni z vašej organiz ácie sandboxu vždy, keď vytvoríte novú kópiu v pieskovisku.

Nainštalujte balík

Ak chcete nainštalovať balík:

1

Ak chcete spustiť inštaláciu, otvorte poskytnutý odkaz balíka.

2

Prihláste sa do organizácie Salesforce, kde by mal 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 položku In štalovať (2).

Určte, ktorí používatelia získajú určité povolenia na objekty a komponenty dodávané s balíkom Webex Contact Center for Service Cloud Voice. Okrem toho im udelte tieto povolenia; Súpravy povolení, ktoré sú dodávané 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:

Inštalačný balík nie je priamo prístupný cez Salesforce AppExchange. Zákazníci musia použiť tlačidlo „Získať teraz“ na zozname AppExchange, ktoré otvorí kontaktný formulár na požiadanie o od kaz na inštal áciu a aktiváciu Cisco.

4

Udeľte nasledujúce sady povolení aspoň jednému používateľovi, aby ste mohli vytvoriť kontaktné centrum:

Contact Center Admin (Partner Telephony).
5

Kliknite na položku Nastavenie | Používatelia | Používatelia.

6

Vyhľadávanie a vybraný používateľ.

7

Prejdite nadol na položku „Priradenia súpravy povolení“.

8

Kliknite na Upraviť priradenia

9

Pre správ cov kontaktného centra: pri raďte súpravu povol ení správcu kontaktného centra ( telefonovanie partnerov).

10

Pre agentov kontaktného centra: priraďte súpravu povolení agenta kontaktného centra (partnerské telefónie) a súpravu povolení agentov Webex Contact Center SCV.

Neodporúča sa zvoliť možnosť In štalovať pre všetkých používateľov, pretože to udeľuje všetky povolenia (čítanie, vytváranie, úprava a odstránenie) komponentov a objektov balíka každému používateľovi, ktorý používa vlastný používateľský profil.

11

Priraďte licenciu na balík pre používateľov na prácu s aplikáciou Connects for Service Cloud Voice.

  • Kliknite na polož ku Nastavenie | Aplikácie | Balenie | Nainštalované balíky.
  • Kliknite na položku Spravovať licen cie vedľa nedávno nainštalovaného Webex Contact Center for Service Cloud Voice.
  • Kliknite na polož ku Pridať používateľov.
  • Vyberte používateľov, ktorým bude priradená verzia licencie, a kliknite na položku Pridať.

12

Prípadne môžete kliknúť na polož ku Nastavenie | Používatelia | Používatelia. .

13

Vyhľadajte a vyberte používateľa.

14

Prejdite nadol na položku Spravované balíky.

15

Kliknite na polož ku Priradiť licen cie.

16

Zo zoznamu vyberte Webex Contact Center for Service Cloud Voice bal ík.

17

Kliknite na polož ku Pridať.

18

Vytvorte stavy prítomnosti, aby ste definovali, ktoré kanály služieb sú 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 Presence Statusespoľa Rýchle vyhľadávanie a potom vyberte položku Sta vy prítomnosti.

20

Kliknite na polož ku Nov ý. Vytvorte aspoň jeden stav pre „Online“ a jeden pre „Zaneprázdnený“.

  • Vytvorte špecializovaný stav zaneprázdnenej prítomnosti pre RONA. Konfigurácia prítomnosti môže byť použitá na automatické nastavenie stavu Omni-Channel na určený stav vždy, keď sa objaví RONA na strane CTI alebo v rámci Salesforce.
  • Ak nakonfigurujete stav RONA v rámci konfigurácie prítomnosti, nepoužívajte predvolenú konfiguráciu prítomnosti. V súčasnosti Webex Contact Center for Service Cloud Voice nezískava stav RONA nakonfigurovaný v predvolenej konfigurácii.

Priraďte stav (-ov) prítomnosti agentom

1

V časti Nastavenie zadajte Súpravy povolení do poľa Rýchle vyhľadávanie a potom vyberte položku Sady povol ení.

2

Kliknutím otvoríte súpravu povolení pre telefónie partnerov.

3

Kliknite na polož ku Prístup k stavom prítomnosti služieb.

4

Kliknite na polož ku Upraviť.

5

V zozn ame Dostupné služby vyberte predtým vytvorené stavy prítomnosti a kliknite na položku Pri dať, aby ste ich priradili k množin y povolení. Agenti, ktorí sú priradení do tejto sady povolení, sa môžu prihlásiť do Omni-Channel s ktorýmkoľvek stavom prítomnosti, ktorý im je 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 položku Pridať pri radenie 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 položku Priradiť.

Služba Cloud Voice používa externú doménu na prácu so záznamom VoiceCall. Nas ledujúce adresy URL musia byť pridané do „Nastavenia vzdialenej lokality“ v nastavení (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 vášho prehliadača. URL inštancie je časť pred „.my.salesforce.com“ alebo „.salesforce.com“ alebo. „lightning.force.com“. Ak je napríklad vaša adresa URL https://orgfarm-54a38e30ad-dev-ed.develop.my.salesforce-setup.com/, potom je adresa URL vašej inštancie „orgfarm-54a38e30ad-dev-ed.development“.

Príklad:

URL pôvodu org: https://cisco.lightning.force.com

Príklad: URL, ktorú chcete pridať:

  • https://cisco.my.salesforce-scrt.com

9

Položka nástroja Omni-Channel je potrebná v aplikácii Lightning Service Console, aby agent mohol používať službu Service Cloud Voice.

  • V časti Nastavenie zadajte do poľa Rýchle vyhľadávanie zadajte Aplikácie a potom vyberte položku Správca aplikácií.
  • Kliknite na rozbaľovací zoznam vedľa aplikácie Service Console alebo aplikácie, ktorú chcete použiť, a potom kliknite na položku Upraviť.
  • V časti Nastavenia aplikácie kliknite na položku Obslužné položky (Iba na pracovnej ploche).
  • Kliknite na položku Pridať obslužnú položku.
  • V modálnom okne vyhľadajte Omni-Channel.
  • Kliknite na položku Omni-Channel.
  • Kliknite na položku Uložiť a ukončite aplikáciu Správca aplikácií.

Oficiálny odkaz od spoločnosti Salesforce nájdete kliknutím na tlačidlo Po ďme to urobiť, ktoré otvorí stránku Konfigurácia služby Agent Experience for Service 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 zadajte Nastavenie telef ónie pre partnerov a potom vyberte položku Nastavenie telefónie pre partner ov.

11

Prejdite nadol do časti 5 Ďalšie nastavenia hlas u.

12

Ak chcete po voliť ochranu pred kliknutím na stránky Visualforce s hla vičkami zakázanými počas práce s softfónom v aplikácii Lightning Experience, musíte okrem adresy URL inštancie Salesforce pridať domény, z ktorých sa softphone a vlastné panely s nástrojmi načítajú ako dôveryhodné domény.

Tieto nastavenia a zoznam Dôveryhodné domény nájdete v časti Nastavenie | Zabezpečenie | Nastav enia relácie.

Ak chcete získať správnu doménu Visualforce, prejdite na položku Nastavenie | Vlastný kód | Stránky Visualforce a kliknite na tlačidlo Náhľad. CiscoScvMainWxCC Salesforce môže automaticky presmerovať na inú adresu URL v závislosti od konfigurácie Salesforce ORG. Skopírujte adresu URL a pridajte ju do Trusted Domains for Inline Frameszoznamu a vyberte možnosť „Visualforce Pages“ ako typ iFrame.

Príklad: MyDomainName-- .vf.force.com cisco_wxcc_scv

Ak chcete získať domé nu inš tancie Salesforce, skopírujte adresu URL zobrazenú v paneli URL prehliadača a pridajte ju do zoznamu Dôveryhodné domény pre vstavané rámce a vyberte položku Visualforce Pages ako typ iFrame.

Príklad: MyDomainName.Lightning.Force.com

Ak vo vašej organizácii nemáte nasadenú stránku Moja doména, formát adresy URL je iný. Ak máte nasadenú stránku Moja doména a rozšírené domény nie sú povolené vo vašej organizácii, formát adresy URL je iný. Ak rozšírené domény nie sú povolené, tento formát ovplyvní aj nastavenie Stabilizovať adresy URL v aplikáciách Visualforce, Experience Builder, Site.com studio a obsahové súbory Moja doména. Podrobnosti nájdete v téme Formáty adries URL mojej domény v Pomocníkovi Salesforce.

Nastavenia ochrany Clickjack a dôveryhodných domén pre zážitok z blesku

13

Na zobrazenie ovládacích prvkov nahrávania počas hovorov potrebujú agenti povolenie Control Call Recordingaplikácie.

Ak ju chcete priradiť, pridajte ho do sady povolení vytvorených v kroku Stav prítomnosti.

  • Otvorte súpravu povolení.
  • Kliknite na odkaz Povolenia aplikácie.
  • Kliknite na tlačidlo Upraviť.
  • Pridajte povolenie na nahrávanie hovorov Control Call Center a u ložte ho.

Konfigurácia

Vytvorte vlastný záznam metadát o povereniach Webex Contact Center

Ak sa chcete pripojiť k Webex Contact Center, musíte vytvoriť vlastný záznam typu metadát:
1

V časti Nastavenie zadajte V lastný typ metaúdajov do poľa Rýchle vyhľad ávanie a potom vyberte položku V lastné typy metadát.

2

V zozname nájdite typ vlastných metad át pripojenia WxCC.

3

Kliknite na položku Spravovať záznamy pred pripojením WxCC a potom na položku Nový.

4

Zadajte meno. Príklad: WebExccMetadata

5

Zadajte štandardnú adresu URL autentifikácie WxCC a tajomstvo klienta pre vašu organizáciu. Ak chcete nastaviť telefóniu Salesforce, kliknite na položku Konfigurácia konektora Salesforce v ovládacom centre Webex.

6

Kliknite na polož ku Uložiť.

7

Zapamätajte si názov pripojenia WxCC, ktorý potrebujete v konfigurácii kontaktného centra.

Kontaktné centrum

Súbor definície kontaktného centra určuje množinu polí a hodnôt, ktoré sa používajú na definovanie kontakt ného centra v Salesforce pre konkrétny systém CTI. Salesforce používa súbory definície Contact Center na podporu integrácie s viacerými dodávateľmi systému CTI.

Ďalšie informácie nájdete v oficiálnej dokumentácii Salesforce (priamy odkaz).

Import kontaktného centra

Stiahnite si najnovšiu verziu kontaktného centra tu.

Aktualizácia z Beta: Táto príručka popisuje čistú inštaláciu vydania General Availability (GA) integrácie Webex Contact Center pre Salesforce Service Cloud Voice.

Ak aktualizujete integráciu z verzie beta, nepoužívajte opätovne existujúci záznam kontaktného centra pre partnerov. Namiesto toho:

  1. Importujte súbor XML Partner Contact Center, ktorý je súčasťou vydania GA.
  2. Vytvorte nový záznam kontaktného centra pre partnerov pomocou importovaného XML.
  3. Aktualizujte svoju konfiguráciu tak, aby ste mohli používať novo vytvorené kontaktné centrum pre partnerov.

XML GA Partner Contact Center obsahuje aktualizované konfiguračné hodnoty vrátane správnej adresy URL konektora a ďalších metadát. Opätovné použitie záznamu partnerského kontaktného centra vytvoreného z Beta XML môže zachovať zastarané konfiguračné hodnoty a zabrániť správnemu fungovaniu integrácie.

1

V časti Nastavenie zadajte kontaktné centrá pre partnerské telefóny v poli R ýchle vyhľadávanie a potom vyberte položku Kontaktné centrá pre partnerské telefóny.

Zobrazí sa zoznam existujúcich (ak existujú) kontaktných centier.
2

Kliknite na položku Vytvoriť kontaktné centrum na pravej strane stránky.

3

Ako poskytovateľa telefónnych služieb vyberte Webex Contact Center. Potom kliknite na tlači dlo Ďalej.

Otvorí sa prehliadač súborov.
4

Vyberte .xmlsúbor, ktorý obsahuje definíciu kontaktného centra.

5

Kliknite na polož ku Otvoriť.

Súbor je importovaný.
6

Skontrolujte, či sa vaše kontaktné centrum zobrazuje v zobrazení zoznamu kontaktných centier.

Konfigurácia kontaktného centra

1

V časti Nastavenie zadajte kontaktné centrá pre partnerské telefóny v poli R ýchle vyhľadávanie a potom vyberte položku Kontaktné centrá pre partnerské telefóny.

2

Kliknite na kontaktné centrum predtým importované.

3

Kliknite na polož ku Upraviť.

Tabuľka 1. Podrobnosti kontaktného centra
PolePopis
Zobrazené meno Toto je názov kontaktného centra, ktoré sa zobrazuje v zozname dostupných kontaktných centier. Rovnaký súbor definície kontaktného centra (.xml) je možné importovať viackrát a mať rôzne zobrazené názvy.
Verejný kľúč

Na používanie funkcií hlasu je potrebný certifikát s verejným a súkromným kľúčom. Na získanie súkromného kľúča je možné vy generovať samopodpísaný certifikát, vy generovať certifik át podpísaný Certificate Authority alebo priamo importovať súbory Java keystore (JKS) alebo Bouncy castle fips keystore súbory (BCFKS) pomocou tlačidla Import from keystore.

Po vygenerovaní certifikátu:

  • Kliknite na štítok Certifik át.
  • Kliknite na polož ku Stiahnuť certifikát.
  • Otvorte stiahnutý certifikát pomocou textového editora.
  • Skopírujte jeho obsah do poľa Vere jný kľúč kontaktného centra.

Povinné: Áno

Jedinečný názov certifikátu

Samopodpísan Unique Nameého certifikátu vytvoreného pre verejný kľúč.

Povinné: Áno

Pripravený identifikátor stavu
  • Otvorte stránku Stav prítomnosti v nastavení.
  • Kliknite na stav Online a skopírujte jeho ID Salesforce z panela URL.
  • Vložte ID do tohto poľa.

Povinné: Áno

ID stavu nie je pripravený
  • Otvorte stránku Stav prítomnosti v nastavení.
  • Kliknite na stav zan eprá zdnenosti a skopírujte jeho ID Salesforce z panela URL.
  • Vložte ID do tohto poľa.

Povinné: Áno

Predvolený dôvod Cisco nie je pripravený

ID nečinného kódu Cisco, ktorý sa používa ako predvolený nečinný kód v prípade, že pre určitý stav prítomnosti nie je poskytnuté žiadne mapovanie.

Povinné: Áno

Ak chcete skontrolovať nakonfigurované ID kódov nečinnosti, pozrite si časť Kódy ne činnosti.

Mapovanie stavu prítomnosti

Používa sa na mapovanie stavov Salesforce Omni Presence do stavu Cisco Ready a príčinových kódov Not Ready.

Musia sa pridať stavy nečinného kó du:

  • Otvorte stránku Stav prítomnosti v nastavení.
  • Kliknite na jeden zo stavov Zan eprá zdnený a skopírujte jeho ID Salesforce z panela URL. Identifikátory stavu prítomnosti zač 0N5ínajú napríklad 0N51X0000000AUT.
  • Do tohto poľa vložte ID, za ktorým nasleduje čiarka a ID nečinného kódu Cisco.
  • Jedno alebo viac ru šivých mapovania je možné pridať pomocou oddelenia čiarkami.

Aby sa predišlo problémom so synchronizáciou, Default Not Ready IDmusí byť nakonfigurovaný aj v mapovaní.

Ak ste v rámci konfigurácie prítomnosti nakonfigu ro vali stavy pre Od mietnutie a časový limit Push, pridajte ich aj do mapovania so zodpovedajúcim stavom Cisco Not Ready.

Formát:

  • Zaneprázdnené mapovanie: busyPresenceID1, ciscoAuxCodeID1
  • Predvolené mapovanie, ktoré nie je pripravené:, defaultNotReadyPresenceIDciscoDefaultNotReadyAuxCodeID
  • Online mapovanie: onlinePresenceId, 0

Každé úplné mapovanie oddeľte bodkočiarkou.

Povinné: Áno

Tu je príklad dokončených nečinných kódov na obed, stretnutie, prestávku.

Premenná volania pre ID hlasového volania

Premenná volania používaná na ukladanie ID aktuálneho hlasového hovoru. Používa sa na správnu aktualizáciu stavu hovoru.

Formát: Názov premennej nakonfigurovaný v Webex Contact Center Flow. Napríklad SCV_VoiceCallRecordId

Povinné: Áno

Predvolená hodnota: SCV_VoiceCallRecordId

Ak ste kombinovali ID záznamu hlasového hovoru a kľúč volania dodávateľa do jednej premennej toku, môžete v tomto poli nakonfigurovať jeho názov. Pozrite si tiež pre mennú toku pre ID záznamu hlasového hovoru a kľúč hovoru dodávateľa.

Premenná volania pre volací kľúč dodávateľa

Premenná volania používaná na ukladanie kľúča volania dodávateľa aktuálneho hlasového volania. Používa sa na otvorenie správneho záznamu hlasového hovoru.

Formát: Názov premennej nakonfigurovaný v Webex Contact Center Flow. Napríklad SCV_VendorCallKey

Povinné: Áno

Predvolená hodnota: SCV_VendorCallKey

Ak ste kombinovali ID záznamu hlasového volania a kľúč dodávateľa do jednej premennej toku, môžete ponechať toto pole prázdne a nakonfigurovať názov premennej toku pomocou ID záznamu hlasového volania a klávesom volania dodávateľa v poli „Premenná volania pre ID hlasového volania“. Pozrite si tiež premennú toku pre ID záznamu hlasového hovoru a kľúč hovoru dodávateľa.

Preklad vytáčania telefónneho čísla

Pravidlá prekladu telefónneho čísla, ktoré sa uplatňujú na číslo pred jeho vyto čením.

Pozrite si pre klady telefónnych čísel

Povinné: Nie

Región kontaktného centra Webex

Nájomca sa používa na určenie regiónu Webex Contact Center. Náj dete ho v adrese URL portálu Webex Contact Center, Dev Portal alebo Desktop. Napríklad devportal.wxcc-eu2.cisco.compoužíva región eu2.

Formát: eu2

Povinné: Áno

Regióny Webex Contact Center a zodpovedajúce reťazce:

  • USA: us1
  • Kanada: ca1
  • Veľká Británia: eu1
  • Nemecko: eu2
  • Austrália: anz1
  • Singapur: sg1
  • Japonsko: jp1
Webex Kontaktné centrum WebRTC Doména

Doména sa používa na vytvorenie správneho pripojenia WebRTC. Použite umiest nenie nájomcu Webex Contact Center:

  • USA: rtw.prod-us1.rtmsprod.net
  • ANZ: rtw.prod-as1.rtmsprod.net
  • CA: rtw.prod-ca1.rtmsprod.net
  • JP: rtw.prod-ja1.rtmsprod.net
  • EU1: rtw.prod-uk1.rtmsprod.net
  • EÚ2: rtw.prod-gm1.rtmsprod.net

Povinné: Áno pre WebRTC

Povoliť transkripciu WCCAI

Používa sa na povolenie alebo vypnutie transkripcie WCCAI.

Formát: Truealebo False

Povinné: Nie

Predvolená hodnota: False

Uložiť odkaz na nahrávanie

Používa sa na uloženie odkazu na nahrávanie hovorov Webex do záznamu hlasového hovoru.

Formát: Truealebo False

Povinné: Nie

Predvolená hodnota: True

4

V dolnej časti stránky Kontaktné centrum kliknite na tlačidlo Pridať v časti Použí vatelia kontaktného centra.

5

Kliknite na položku + vedľa používateľov, ktorí majú prístup do otvoreného kontaktného centra.

V tomto zozname sa zobrazia iba používatelia, ktorí majú nastavené Contact Center Agent (Partner Telephony) povolenia a ešte neboli priradení k iným kontakt ným centrom.

Prispôsobiť

Externá klientská aplikácia pre integráciu Webex Contact Center

Nakonfigurujte aplikáciu externého klienta pre Webex Contact Center Salesforce Connector

Ak chcete používať službu Service Cloud Voice v plnom rozsahu, tok hovorov v Contact Center je možné prispôsobiť tak, aby vytvoril záznam hlasového hovoru a vykonával tok OmniChannel Salesforce, keď je hovor na IVR.

Vytvoriť certifikát

Uistite sa, že ste už vytvorili digitálny certifikát podľa bezpečnostných pravidiel 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:<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

    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 []:<password>
    An optional company name []:

openssl x509 -req -sha256 -days 365 -in server.csr -signkey server.key -out server.crt

server.crt => Certificate for the Salesforce External Client App

server.key => Private key for the Salesforce Connector in Webex Control Hub

Sada povolení pre používateľa integrácie SCV

Nasledujúca sada povolení poskytuje prístup k triedam Apex používaným spoločnosťou Connects for SCV na integráciu s tokmi IVR Contact Center a Webex Contact Center for Salesforce pre SCV.

Nasleduje príklad konfigurácie a popisuje minimálne požadované povolenia na 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
    • Názov API sa automaticky vyplní
    • Licencia: Žiadna
    • Kliknite na tlačidlo U ložiť.
  • Otvorí sa nová sada povolení.
  • Prejdite na Apex Class Access.
  • Kliknite na tlačidlo Upraviť a pridajte nasledujúce triedy Apex:
    • cisco_wxcc_scv.servisCestovanie
  • Prejdite na 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 integrácie iba API

Tento profil sa používa na integráciu s Webex Contact Center for Salesforce pre 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 na fungovanie integrácie Contact Center/IVR.

Toto je klon z profilu Minimálny prístup - API Only Integrations.

  • V časti Nastavenie prejdite na položku Používatelia | Profily.
  • V zozname Profily vyhľadajte položku Minimálny prístup do profilu - Integrácie iba API.
  • Kliknutím na názov profilu otvoríte profil Minimálny prístup — API Only Integrations.
  • V profile Minimálny prístup - len integrácie API kliknite na tlačidlo Klonovať.
  • Zadajte nový názov profilu, napríklad: SCV Integration.
  • Kliknite na tlačidlo U ložiť.
  • Otvorí sa nový profil.
  • Skontrolujte, či má váš profil Minimálny prístup — API Only Integrations všetky povolenia odstránené zo samotného profilu.
  • Prejdite na Systémové povolenia.
  • Uistite sa, že sú povolené nasledujúce povolenia:
    • API povolené
    • Iba používateľ Api

Používateľ integrácie SCV

Nasleduje príklad konfigurácie a popisuje minimálne požadované povolenia na fungovanie integrácie Contact Center/IVR. Pre používateľa SCV Integration nie je potrebná žiadna licencia Salesforce Service Cloud Voice alebo Webex Contact Center for Salesforce for SCV License.

  • V časti Nastavenie prejdite na položku Používatelia | Používatelia.
  • Kliknite na tlačidlo Nový použív ateľ.
    • Zadajte Krstné meno, Priezvisko a všetky ostatné povinné polia.
    • Používateľská licencia: Salesforce Integration
    • Profil: vyberte profil vytvorený v predchádzajúcom kroku („SCV Integration profile“, klon profilu Minimálny prístup - API Only Integrations)
  • Kliknite na tlačidlo U ložiť.
  • Otvorte nový užívateľský záznam.
  • Priraďte množinu povol ení vytvorenú predtým („IVR Access to SCV Apex Classes“).
  • Priraďte súpravu povolení License Salesforce API Integration.
Vytvorenie externej klientskej aplikácie Salesforce

V súčasnosti je vytváranie pripojených aplikácií funkcia ovládaná preferenciou Povoliť vytváranie pripojených aplikácií, ktorá je predvolene zakázaná pre nové orgány a je možné ju povoliť na stránke nastavení novej ponuky Nastavenie externých klientskych aplikácií.

  • V časti Nastavenie vyhľadajte Externé klientske aplikácie | Nastavenia.
  • V časti Pripojené aplikácie začiarknite políčko Povoliť vytváranie pripojených aplikácií na Zapnuté, aby ste povol ili tlačidlo Nová pripojená aplikácia.
  • Kliknite na tlačidlo Nová pripojená aplikácia.

Ak sa tlačidlo Nová pripojená aplikácia nezobrazuje v ponuke Aplikácie externého klienta, prejdite na položku Aplikácie | Správca aplikácií | Nová pripojená aplikácia.

Nakonfigurujte aplikáciu Salesforce Connected, ktorú Cisco Webex Contact Center používa. Pozrite si tiež článok: Konfigurácia pripojenej aplikácie pre Webex Contact Center Salesforce Connector na adrese https://help.webex.com/en-us/article/n26v7heb/Configure-Connected-App-for-Webex-Contact-Center-Salesforce-Connector.

1

Pre novú pripojenú aplikáciu zadajte nasledujúce podrobnosti:

  • Názov pripojenej aplikácie: WxCC - SCV
  • Názov API: WxCC_SCV
  • Kontaktný e-mail: Zadajte platnú e-mailovú adresu.
  • API (Povoliť nastavenia OAuth) => Povoliť nastavenia OAuth
  • URL spätného volania: http://localhost:1717/OauthRedirect ako vzorová adresa URL spätného volania
  • Vyberte položku Použiť digitálne podpisy
  • Kliknite na položku Vybrať súbor a nahrajte súbor.crt server.crt, ktorý obsahuje váš digitálny certifikát.
  • Vyberte rozsahy OAuth:
    • Správa používateľských údajov prostredníctvom API (API)
    • Správa používateľských údajov prostredníctvom webových prehliadačov (web)
    • Vykonávanie požiadaviek kedykoľvek (refresh_token,offline_access)
  • Vymazať požadované tajom stvo pre možnosť Flow webového servera.

2

Kliknite na polož ku Uložiť a potom Pokračovať.

3

V časti API (Povoliť nastavenia OAuth) kliknite na položku Spravovať podrobnosti o spotrebit eľovi.

4

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 riadiacom centre Webex Contact Center.

Dôležité: Zachovajte bezpečnosť pravidelným otáčaním tajomstiev

Uistite sa, že sa vaše tokeny ClientID a Client Secrets pravidelne otáčajú. Pozri R otate Spotrebiteľský kľúč a spotrebiteľské tajomstvo

Ak chcete zabezpečiť, aby sa vaše existujúce integrácie neporušili, aktualizujte novo vygenerované ID klienta a Client Secret vo všetkých tokoch kontaktného centra a skriptoch IVR, kde sa tieto tajomstvá používajú.

5

Kliknite na tlači dlo Späť pre správu pripojených aplikácií.

6

Kliknite na polož ku Sprav ovať.

7

Kliknite na polož ku Upraviť politiku.

8

V sekcii Pra vidlá OAuth vyberte polož ku Používatelia schválení správcom sú vo pred autorizovaní pre povolených používateľov.

9

Kliknite na polož ku Uložiť.

10

Prejdite nadol do sek cie Sada povol ení a kliknite na tlačidlo S pravovať sady povol ení. Priraďte množinu povol ení vytvoren ú predtým („IVR Access to SCV Apex Classes“).

Vytvorte aplikáciu externého klienta Salesforce
Vytvorenie novej externej klientskej aplikácie

Existujú dve možnosti pripojenia ú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 External Client Salesforce, ktorú používa: Cisco Webex Contact Center

  1. V časti Nastavenie prejdite na položku Aplikácie | Externé klientske aplikácie | Správca aplikácií externého klienta.
  2. Kliknite na Nová aplikácia externého klienta.
  3. Externá klientská aplikácia — základné informácie
    • Názov aplikácie externého klienta: WxCC - SCV
    • Názov API: WxCC_SCV
    • Kontaktný email: < your email >
    • Stav distribúcie: vyberte položku Lokálne

    Basic information

    Externá klientská aplikácia — API (Povoliť nastavenia OAuth)

    • Vyberte: Povoliť OAuth
    • Nastavenia aplikácie
    • URL spätného volania: http://localhost:1717/OauthRedirect ako vzorová adresa URL spätného volania
    • Rozsahy OAuth
    • Vyberte rozsahy OAuth:
    • Správa používateľských údajov prostredníctvom API (API)
    • Vykonávanie požiadaviek kedykoľvek (refresh_token,offline_access)

    API (Enable oAuth settings)

    Povolenie toku

    • Vyberte: Povoliť tok nosiča JWT
    • Kliknite na položku Nahrať súbory a nah server.crtrajte súbor, ktorý obsahuje váš digitálny certifikát.

    Floe enablement

    Bezpečnosť

    Zrušte začiark nutie možnosti Vyžadovať tajomstvo pre tok webového servera.

    Security

  4. Kliknite na tlačidlo Vyt voriť.
  5. Zmeňte na Politiky tabulácie a potom kliknite na tlačidlo Upraviť.
  6. Zásady — Zásady OAuth
    • Zásady doplnkov
      • Povolení používatelia: vyberte Používatelia schválení správcom sú vopred autorizovaní
      • Potvrďte zmenu
    • Autorizácia aplikácie
      • Pravidlá obnovovania tokenu: vyberte položku Okamžite vyprší obnovovací token
      • Relaxácia IP: vyberte možnosť Presadzovať obmedzenia IP

    OAuth policies

  7. Pravidlá — Politiky aplikácií
    • Úvodná stránka - žiadna
    • Vyberte Súpravy povolení — Priraďte množinu povolení vytvorenú predtým („IVR Access to SCV Apex Classes“) 

    App policies

  8. Kliknite na polož ku Uložiť.
  9. Zmeňte na Nastavenia karty.
    • V sekcii Nastavenia OAuth kliknite na tlačidlo Consumer Key a Secret; počkajte na e-mail a overte svoju totožnosť. Nová karta prehliadača otvorí obrazovku s údajmi o spotrebiteľoch.

      OAuth Settings

    • 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 riadiacom centre Webex Contact Center. 

      External client App name

Konfigurácia Webex Contact Center a skript na vytváranie záznamov hlasových hovorov

Ak chcete získať plnú hodnotu služby Salesforce Service Cloud Voice, musí byť tok hovorov v Webex Contact Center upravený tak, aby sa vytvoril záznam hlasového hovoru v službe Service Cloud Voice hneď, ako hovor dorazí do kontaktného centra.

Voliteľný Omni-Flow je možné vykonať pre smerovanie rozhodnutí a automatizáciu v Salesforce.

Podrobnosti o použitých rozhraní API nájdete v téme Service Cloud Voice API Wrapper.

Predpoklady

Ak chcete používať aplikáciu Service Cloud Voice API Wrapper, musí byť nakonfigurovaná externá klientská aplikácia Salesforce pre integráciu IVR.

Nakonfigurujte konektor Salesforce v ovládacom rozbočovači Webex

Nastavte integračné konektory Salesforce pre Webex Contact Center, ako je popísané 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 na položky Služby> Kontaktné stredisko > Nastavenia nájomcu > Integrácie> Konektory.

2

Na karte Salesforce kliknite na položku Nastaviť alebo Pridať konektor.

  • ID klienta: Ex terná klientská aplikácia Consumer Key
  • E-mailové ID Salesforce: používateľské meno spoločnosti Salesforce pre integráciu SCV (pozri používateľ integrácie SC V)
  • URL: na výrobu použite https://login.salesforce.com alebo ak nastavujete dev/sandbox použite https://test.salesforce.com
  • Súkromný kľúč: obsah súboru server.key

IMPORTANT: MAINTAIN SECURITY BY PERIODICALLY ROTATING SECRETS

Uistite sa, že pravidelne otáčate súkromný kľúč a certifikát, aby ste zabezpečili integráciu.

Aktualizujte súkromný kľúč v konektoru kontaktného centra vo Webex Hub a 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 konektor sa neuloží:

  • Skontrolujte, či nemáte medzery pred/po vašich záznamoch.
  • Uistite sa, že váš súkromný kľúč (server.key) zodpovedá vášmu server.crt. Ak nastavujete viacero orgov a prepínate certifikáty, nebudú fungovať.
  • uistite sa, že váš Server.key začína. ----- Begin RSA Private Key -----

Hlavný tok kontaktného centra Webex

Tabuľka 2. Variabilný prietok
Premenná prietokuPopis
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

  • Názov: SCV_VendorCallKey
  • Typ: String
  • Urobiť agenta viditeľným: P ovolené
Lokálna premenná pre čas spustenia hovoru

Používa sa na vytvorenie záznamu hlasového hovoru a pri aktualizácii hlasového hovoru.

  • Názov: SCV_CallStartTime
  • Typ: String
  • Urobte agenta viditeľným: nie
Lokálna premenná pre Queue Name/id

Vráti sa pomocou funkcie Execute Omni Flow, ktorý sa používa na smerovanie hovorov.

Táto premenná sa vyžaduje iba pri použití Execute Omni Flow

  • Názov: SCV_OmniFlowQueue
  • Typ: String
  • Urobte agenta viditeľným: nie
Lokálna premenná pre Agent name/id

Vráti sa pomocou funkcie Execute Omni Flow, ktorý sa používa na smerovanie hovorov.

Táto premenná sa vyžaduje iba pri použití Execute Omni Flow

  • Názov: SCV_OmniFlowAgent
  • Typ: String
  • Urobte agenta viditeľným: nie

Prehľad hlavného toku

  1. Vytvorte kľúč volania dodávateľa
  2. Nastavenie času začatia hovoru
  3. HTTP požiadavka: Vytvorte záznam hlasového hovoru
  4. Vyhodnotenie odpovede HTTP pre vytvorenie záznamu hlasového hovoru
  5. Riešenie chýb pri vytváraní záznamu hlasového hovoru
  6. HTTP požiadavka: Vykonajte Omni Flow
  7. Vyhodnoťte odpoveď HTTP pre vykonanie Omni Flow
  8. Manipulácia chýb pre Execute Omni Flow
  9. Pokračujte v smerovaní hovorov
Tabuľka 3. Hlavný tok
prietokPopis
Vytvorte kľúč volania dodávateľa

Každý hovor spracovaný v službe Service Cloud Voice vytvára záznam hlasového hovoru v službe Salesforce a vyžaduje jedinečné ID s názvom Vendor Call Key. 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 volaním agentovi pomocou premennej toku.

Hodnota VendorCallKey musí byť v súlade s nasledujúcimi pravidlami:

  • Hodnota musí byť dlhá <= 255 znakov.
  • Hodnota môže obsahovať alfanumerické znaky plus podčiarknutie (_), pomlčku (-) a bodku (.).
  • Hodnota musí začínať písmenom, nesmie obsahovať medzery, nesmie končiť podčiarknutím a nesmie obsahovať dva po sebe idúce podčiarknutia.

  • Značka aktivity: Generate_VendorCallKey
  • Názov premennej: SCV_VendorCallKey
  • Typ premennej: Reťazec
  • Hodnota premennej - Nastaviť hodnotu: wxcc_ {{newPhoneContact.InteractionId}}

Nastavenie času začatia hovoru

Časová pečiatka UTC času začiatku hovoru. Táto časová pečiatka sa používa na vytvorenie záznamu hlas ového hovoru a na aktualizáciu záznamu hlasového hovoru, ak sa volajúci rozloží pred presmerovaním na agenta.

  • Označenie aktivity: setCallStartTime
  • Premenná: SCV_CallStartTime
  • Hodnota premennej - Nastaviť hodno tu: {{now () | replace ({'[UTC]': „})}}
HTTP požiadavka: Vytvorte záznam hlasového hovoru

Tento krok je potrebný pre každý hovor. Po vytvorení záznamu hlasového hovoru musí byť ID záznamu hlasového hovoru odovzdané spolu s volaním agentovi v premennej spolu s kľúčom volania dodávateľa. Nakonfigurujte použitú premennú v konfigurácii Contact Center v službe Service Cloud Voice.

Nastavenia požiadavky HTTP
  • Značka aktivity: Cre ateVoiceCall
  • Použitie overeného koncového bodu: povolené
  • Konektor: Konektor Salesforce vytvorený v predchádzajúcom kroku
  • Cesta žiadosti: /services/apexrest//voice/v1/createVoiceCall cisco_wxcc_scv
  • Metóda: POST
  • Typ obsahu žiadosti: Aplikácia/JSON

HTTP požiadavka: Vytvorte záznam hlasového hovoru

Tento krok je potrebný pre každý hovor. Po vytvorení záznamu hlasového hovoru musí byť ID záznamu hlasového hovoru odovzdané spolu s volaním agentovi v premennej spolu s kľúčom volania dodávateľa. Nakonfigurujte použitú premennú v konfigurácii Contact Center v službe Service Cloud Voice.

Nastavenia požiadavky HTTP

  • Značka aktivity: Cre ateVoiceCall
  • Použitie overeného koncového bodu: povolené
  • Konektor: Konektor Salesforce vytvorený v predchádzajúcom kroku
  • Cesta žiadosti: /services/apexrest/cisco_wxcc_scv/voice/v1/createVoiceCall
  • Metóda: POST
  • Typ obsahu žiadosti: Aplikácia/JSON

Orgán žiadosti

Pri vytváraní záznamu hlasového hovoru môžete aktualizovať aj vlastné polia v zázname hlasového hovoru pomocou údajov hovoru. Nižšie sú uvedené dva príklady tela požiadavky, jeden so všetkými požadovanými poliami, ale bez aktualizácie vlastných polí, a druhý s vlastnými poliami.

Bez aktualizácie vlastných polí v zázname hlasového hovoru:

{
  "callCenterDevName": "<Contact Center API name>",
  "certDevName": "<cert dev name>",
  "vendorCallKey": "{{SCV_VendorCallKey}}",
  "to": "{{NewPhoneContact.DNIS}}",
  "from": "{{NewPhoneContact.ANI}}",
  "initiationMethod": "Inbound",
  "startTime": "{{SCV_CallStartTime}}",
  "participants": [
    {
      "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": "<cert dev name>",
  "vendorCallKey": "{{SCV_VendorCallKey}}",
  "to": "{{NewPhoneContact.DNIS}}",
  "from": "{{NewPhoneContact.ANI}}",
  "initiationMethod": "Inbound",
  "startTime": "{{SCV_CallStartTime}}",
  "participants": [
    {
      "participantKey": "{{NewPhoneContact.ANI}}",
      "type" : "END_USER"
    }
  ],
  "callAttributes": "{\"custfield1__c\": \"<value1>\",\"custfield2__c\": \"<value2>\",\"custfield3__c\": \"<value3>\"}"
}

Parametre
Názov nehnuteľnosti Hodnota
CallCenterDevName Kontaktné centrum Názov vývojára
CertDevName API Názov certifikátu (nakonfigurovaný v kontaktnom centre)
PredávajúciCallkey Jedinečné ID hovoru: {{SCV_VendorCallKey}}
do Volané číslo/DNI: {{NewPhoneContact.DNIS}}
z VolingNumber/Ani: {{NewPhoneContact.ANI}}
Čas štartovania Časová pečiat {{SCV_CallStartTime}}ka UTC (nastaví sa hneď po prijatí hovoru v skripte)
CallAtribúty

Používa callAttributessa len pre vlastné polia v objekte VoiceCall . Použite názov rozhrania API poľa Salesforce, napríklad názov, ktorý končí __c, pre každý pár kľúč-hodnota.

Nepoužívajte callAttributesna aktualizáciu štandardných polí hlasového volania, ako Descriptionnapríklad alebo. CallDurationInSeconds Salesforce vypočítava, CallDurationInSecondskeď sú poskytnuté obi startTime dve a endTimesú poskytnuté.

Príklad:

custfield1__c, custfield2__c, custfield3__c: Názov API vlastného poľa na objekte Voice Call

value1, value2, value3: Hodnota pre vlastné pole

Nastavenia analýzy
  • Typ obsah u: JSON
  • Výstupná premen ná: SCV_VoiceCallRecordId
  • Výraz cesty: $.data.voiceCallId

ID záznamu hlasového hovoru, ktoré sa odošle agentovi.

Vyhodnotenie odpovede HTTP pre vytvorenie záznamu hlasového hovoru

Skontrolujte stav HTTP požiadavky Vytvoriť hlasový hovor http:

  • Označenie: StatusCodeCreateVoiceCall
  • Premenná: CreateVoice Call.HttpStatusCode

Ak kód stavu == 200 => úspešný else => požiadavka zlyhala, spracovanie chýb

Riešenie chýb pri vytváraní záznamu hlasového hovoru

Iba pre ukážko/ladenie prehrávajte správu v závislosti od kódu stavu http.

Ak bolo Vytvorenie hlasového volania úspešné, pokračujte v vykonaní funkcie Execute Omni Flow. V opačnom prípade pokrač ujte v smerovaní hovorov.

HTTP požiadavka: Vykonajte Omni Flow (voliteľný krok)

Použite Execute Omni-Flow, ak chcete:

  • spúšťanie automatizovaných úloh, napríklad vyhľadávanie alebo vytváranie záznamov a prepojenie záznamov so záznamom hlas ového hovoru
  • vyhľadajte záznamy a urobte obrazovku
  • synchronizujte fronty Salesforce a Cisco
  • Nechajte Service Cloud Voice rozhodovať o smerovaní

Táto požiadavka vždy vráti „frontu“ alebo „agenta“, kam musí byť hovor smerovaný.

Po vykonaní tejto žiadosti sa uistite, že ste odoslali vymazať smerovanie, ak sa volajúci rozloží skôr, ako mu agent odpovie. Pozrite si časť Tok udalostí Webex Contact Center.

Nastavenia požiadavky HTTP

  • Značka aktivity: Exec uteOmniFlow
  • Použitie overeného koncového bodu: povolené
  • Konektor: Konektor Salesforce vytvorený v predchádzajúcom kroku
  • Cesta žiadosti: /services/apexrest/cisco_wxcc_scv/voice/v1/executeOmniFlow
  • Metóda: POST
  • Typ obsahu žiadosti: Aplikácia/JSON

Orgán žiadosti

Okrem požadovaných polí môžete do Omni-Flow odovzdať ďalšie údaje ako vstupné premenné. Nižšie sú uvedené dva príklady orgánu žiadosti. Najprv bez ďalších parametrov toku, iba požadované 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>",
  "fallbackQueue": "<fallback queue name>"
}

Príklad aktualizácie vlastných polí v zázname hlasového hovoru:

{
  "callCenterDevName": "<Contact Center API name>",
  "certDevName": "<cert dev name>",
  "voiceCallId": "{{SCV_VoiceCallRecordId}}",
  "dialedNumber": "{{NewPhoneContact.DNIS}}",
  "flowDevName": "<flow api name>",
  "fallbackQueue": "<fallback queue name>",
  "flowInputParameters": 
  {
    "param1": "value1",
    "param2": "value2"
  }
}

Parametre
Názov nehnuteľnosti Hodnota
CallCenterDevName Kontaktné centrum Názov vývojára
CertDevName API Názov certifikátu (nakonfigurovaný v kontaktnom centre)
VoiceCallid ID záznamu hlasového hovoru vytvoreného v predchádzajúcom kroku: {{SCV_VoiceCallRecordId}}
Vytočené číslo Volané číslo/DNI: {{NewPhoneContact.DNIS}}
FlowDevName Názov vývojára programu Omni-Flow na vykonanie
FallbackQueue ID frontu alebo názov rozhrania Queue API záložného frontu Salesforce
FlowInputParameters

Ďalšie vstupy do toku Omni-Channel (pár kľúč-hodnota).

Príklad:

param1, param2: Názov vstupného parametra Omni-Flow

value1, value2: Hodnota parametra

Nastavenia analýzy

Front

  • Typ obsah u: JSON
  • Výstupná premen ná: SCV_OmniFlowQueue
  • Výraz cesty: $.data.queue

Na smerovanie je možné použiť „Queue“ vrátené z Execute Omni-Flow.

Sprostredkovateľ
  • Typ obsah u: JSON
  • Výstupná premen ná: 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 Flow

Skontrolujte stav HTTP požiadavky Execute Omni Flow http:

  • štítok: StatusCodeExecuteOmniFlow
  • Premenná: executeOmniflow.httpStatusCode

Ak kód stavu == 200 => úspešný else => požiadavka zlyhala, spracovanie chýb.

Manipulácia chýb pre Execute Omni Flow

Iba pre ukážko/ladenie prehrávajte správu v závislosti od kódu stavu http.

Ak bol Execute Omni Flow úspešný, premenné SCV_OmniFlowQueue a nie SCV_OmniFlowAgent sú nastavené. Rozhodnutie o smerovaní v toku hovorov.

Pokračujte v smerovaní hovorov

Pokračujte v toku hovorov, smerujte hovor k agentu. Voliteľné, použ SCV_OmniFlowQueue ite SCV_OmniFlowAgent a vyberte frontu a agenta.

Tok udalostí Webex Contact Center

Ak volajúci hovor zavesie skôr, ako ho agent odpovie, musíme aktualizovať službu Service Cloud Voice a hovor ukončiť.

  • Ak bol použitý program Execute Omni-Flow, odošlite vymazať smerovanie, aby ste odstránili smerovanie čakajúcich služieb (PSR)
  • Odoslať aktualizovať hlasový hovor, aktualizovať čas začiatku a ukončenia záznamu hlasového hovoru a zmeniť stav z Nový na Dokončený

  1. PhoneContactended - Táto udalosť sa spustí, keď je odpojený živý hovor a všetci účastníci sú odstránení.
  2. HTTP požiadavka: Vymazať smerovanie
  3. Žiadosť HTTP: Aktualizácia hlasového hovoru
HTTP požiadavka: Vymazať smerovanie

  • Značka: ClearRouting
  • Použitie overeného koncového bodu: povolené
  • Konektor: Konektor Salesforce vytvorený v predchádzajúcom kroku
  • Cesta žiadosti: /services/apexrest/cisco_wxcc_scv/voice/v1/clearRouting
  • Metóda: POST

Typ obsahu žiadosti: Aplikácia/JSON

Orgán žiadosti

{
  "callCenterDevName": "<Contact Center API name>",
  "certDevName": "<cert dev name>",
  "voiceCallId": "{{SCV_VoiceCallRecordId}}"
}

Parametre

Názov nehnuteľnostiHodnota
CallCenterDevName Kontaktné centrum Názov vývojára
CertDevName API Názov certifikátu (nakonfigurovaný v kontaktnom centre)
VoiceCallid ID záznamu hlasového hovoru vytvoreného v predchádzajúcom kroku: SCV_VoiceCallRecordId

Nastavenia analýzy

Žiadne.

Žiadosť HTTP: Aktualizácia hlasového hovoru

  • štítok: UpdateVoiceCall
  • Použitie overeného koncového bodu: povolené
  • Konektor: Konektor Salesforce vytvorený v predchádzajúcom kroku
  • Cesta žiadosti: /services/apexrest/cisco_wxcc_scv/voice/v1/updateVoiceCall
  • Metóda: POST
  • Typ obsahu žiadosti: Aplikácia/JSON

Orgán žiadosti

{
  "callCenterDevName": "<Contact Center API name>",
  "certDevName": "<cert dev name>",
  "voiceCallId": "{{SCV_VoiceCallRecordId}}",
  "startTime": "{{SCV_CallStartTime}}",
  "endTime": "{{now() | replace({'[UTC]': ''})}}",
  "disconnectReason": { "value": "Abandoned in queue", "isError": true }
}

Keď poskytnete obe startTimea endTime, Salesforce vypočí CallDurationInSecondsta. Neprechádzajte dov CallDurationInSecondsnútra callAttributes.

Parametre

Názov nehnuteľnostiHodnota
CallCenterDevName Kontaktné centrum Názov vývojára
CertDevName API Názov certifikátu (nakonfigurovaný v kontaktnom centre)
VoiceCallid ID záznamu hlasového hovoru vytvoreného v predchádzajúcom kroku: SCV_VoiceCallRecordId
Čas štartovania Časová pečiatka UTC spustenia ho {{SCV_CallStartTime}}voru (použitá na vytvorenie záznamu hlasového hovoru)
Koncový čas Aktuálna časová pečiatka UTC `{{now ()
OdpojenieZrada Dôvod odpojenia hovoru. Vlastnosť isError musí byť nastavená tak, trueaby sa mohla správne zobrazovať.

Nastavenia analýzy

Žiadne.

Referencie

Jazykový preklad

(Voliteľné) Povoliť prekladateľský pracovný stôl

Toto nastavenie je použiteľné len vtedy, ak používate nastavenia jazyka prekladu.

1

Prejdite na Nastavenie → Pracovný stôl prekladu → Nastavenia jazyka prekladu.

2

Kliknite na tlači dlo Pov oliť pre výber jazyka prekladu.

(Voliteľné) Povoliť jazyky iba pre platformu

Toto nastavenie platí len pre iné jazyky ako EN-US.

1

Prejdite na Nastavenie → Nastavenia spoločnosti → Nastavenia jazyka.

2

Vyberte požadované jazyky.

3

Začiarknite nasledujúce políčka:

  • Povoliť jazyky koncového používateľa - Pomocník a nastavenie nie sú preložené do jazykov koncového používateľa
  • Povoliť jazyky iba pre platformy - pre jazyky iba na platforme nie sú k dispozícii žiadne predvolené preklady
4

Uložte svoje zmeny.

Aktivujte jazyk a vyberte používateľa (úloha)
1

Prejdite na Nastavenie → Pracovný stôl prekladu → Nastavenia jazyka prekladu.

2

Vyberte jazyk a vyberte používateľa, ktorý ho preloží.

3

Uložte svoje zmeny.

Nastavenia viacerých jazykov
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 Newna zadanie nového prekladu alebo Upraviť (vedľa jazyka), aby ste preklad upravili.

4

Vyberte jazyk, do ktorého prekladáte.

5

Do poľa Text prekladu zadajte preloženú hodnotu. Tento text prepíše hodnotu zadanú v poli Hodnota označenia, ak je predvoleným jazykom používateľa jazykom pre kladu.

6

Uložte svoje zmeny.

Povolenia Salesforce požadované používateľskou funkciou

Sada povolení pre agentov Webex Contact Center SCV obsahuje všetky povolenia potrebné na prácu s gadgetom Webex Contact Center a integráciami vyvinutými pre agentov.

Prístup do triedy Apex (sekcia)

  • cisco_wxcc_scv.ciscoscvwxCC
  • cisco_wxcc_scv.serviceResponseHandler
  • cisco_wxcc_scv.servisCestovanie
  • cisco_wxcc_scv.telephonyIntegrationHandler

Prístupy typu vlastných 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.ciscoscvswNakladač

Služba Cloud Voice API Wrapper

Predpoklady

Ak chcete používať aplikáciu Service Cloud Voice API Wrapper, musí byť nakonfigurovaná externá klientská aplikácia Salesforce pre integráciu IVR.

Používanie služby Cloud Voice API Wrapper

Service Cloud Voice (SCV) pre Salesforce používa rozhranie REST rozhranie Telephony Integration API na vytváranie a aktualizáciu VoiceCalls, vykonávanie tokov Omni-Channel a odstránenie záznamov PendingServiceRouting priradených k VoiceCall. Táto služba vyžaduje autorizáciu JWT a použitie metódy PATCH HTTP, ktorú momentálne nepodporuje Cisco IP Interactive Voice Response (IVR).

S cieľom zjednodušiť používanie rozhrania REST API pre integráciu telefónu pre SCV v (nielen) systéme IVR bola k dispozícii nová sada API, ktoré zahŕňajú existujúce rozhranie API Salesforce a sú prístupné priamo z Salesforce Org, 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 rozhraním API Salesforce a zlepšuje objekty odozvy.

Získajte Access_Token

Vykonajte požiadavku POST na https://<your-domain-name>.my.salesforce.com/services/oauth2/token

Odosielanie nasledujúcich parametrov do tela:

{
 "grant_type": "client_credentials",
 "client_id": "<consumer key of the connected app>",
 "client_secret": "<consumer secret of the connected app>"
 }
If the request is successful, the following JSON response will be returned:
{
 "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>"
 }

Vykonajte požiadavky

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 (napr. https://abc-123.lightning.force.com) vedie k neautorizovanému stavu 401 s vráteným INVALID_SESSION_ID kódom chyby .

Vytvorenie hlasového volania (sekcia)

Vytvorí záznam VoiceCall obsahujúci účastníkov (teda volajúceho a príjemcu) pre záznam VoiceCall. Keď vytvoríte záznam VoiceCall, konverzácia sa vytvorí v aplikácii Salesforce. Toto rozhranie API používajte iba v kontexte v reálnom čase, čo znamená, že toto rozhranie API by ste mali vyvolať iba vtedy, keď je spustený hovor. Toto rozhranie API možno použiť aj na vytváranie záznamov VoiceCall pre prenos a konferenčné hovory zahrnutím parametra ParentVoiceCallid do užitočného zaťaženia žiadosti.

URI koncového bodu

< instance_url >/služby/apexrest/ /hlas/v1/createVoiceCall cisco_wxcc_scv

Metóda HTTP

POST

hlavičky

Autorizácia: Nositeľ < > access_token

Typ obsahu: aplikácia/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"
 }

Používa callAttributessa len pre vlastné polia v objekte VoiceCall . Štandardné polia hlasového volania, ako napríklad Descriptiona CallDurationInSeconds, sa neaktualizujú. callAttributes Ak chcete vyplniť CallDurationInSeconds, zadajte startTimea endTimetak Salesforce môže vypočítať hodnotu.

Podrobný popis parametrov prijatých touto požiadavkou nájdete v oficiálnej dokument ácii Salesforce v časti „Parametre“.

Odpoveď (úspešná)

{
 "data": {
 "voiceCallId": "00X000012345abc"
 },
 "errors": null,
 "success": true
 }

Odpoveď (s chybami)

 
{
 "data": null,
 "errors": ["Error message 1", "Error message 2"],
 "success": false
 }

Aktualizujte hlasový hovor

Aktualizuje hlasové volanie po ukončení hovoru. Toto rozhranie API použite na aktualizáciu parametrov súvisiacich s volaním, ktoré nie sú dostupné počas fázy vytvárania hlasového volania. Rozhranie API Update VoiceCall je asynchrónna operácia. Nemôžete požiadať o stav volania API.

Tento koncový bod sa dá použiť aj na vytvorenie hlasového volania aj po ukončení hovoru. Toto správanie je užitočné v scenároch, v ktorých chcete zaznamenať záznam v Salesforce pre opustené alebo zmeškané hovory, alebo v akomkoľvek inom scenári, v ktorom ešte nebolo vytvorené hlasové volanie.

URI koncového bodu

< instance_url >/služby/apexrest/ /hlas/v1/updateVoiceCall cisco_wxcc_scv

Metóda HTTP

POST

hlavičky

Autorizácia: Nositeľ < > access_token

Typ obsahu: aplikácia/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 prijatých touto požiadavkou nájdete v oficiálnej dokument ácii Salesforce v časti „Parametre“.

Odpoveď (úspešná)

{
 "data": {
 "status": "pending"
 },
 "errors": null,
 "success": true
 }

Rozhranie API Update VoiceCall je asynchrónna operácia. Nemôžete požiadať o stav volania API.

Odpoveď (s chybami)

{
 "data": null,
 "errors": ["Error message 1", "Error message 2"],
 "success": false
 }

Vykonajte Omni-flow

Vykonáva tok Omni-Channel na smerovanie hovorov. Odovzdáva ID hovoru (Salesforce VoiceCallid alebo ContacTid dodávateľa telefónu) ako parametre toku a vráti pokyny na smerovanie agenta alebo frontu do toku kontaktov. V predvolenom nastavení služba Service Cloud Voice používa tok Omni-Channel (alebo záložný front) určený pre telefónny kanál, ktorý zodpovedá vytočenému číslu. Ak sa vytočené číslo nezhoduje s existujúcim telefónnym kanálom, môžete vol iteľne nastaviť nové vytočené číslo, tok Omni-Channel a záložný front ako vstup né parametre tohto volania API.

Služba Cloud Voice používa toto poradie priority na smerovanie hovorov:

  1. Používa nastavenia Omni-Channel Flow a Fallback Queue pre telefónny kanál, ktorý zodpovedá vytočenému č íslu. Tok má prednosť. Ak tok zlyhá, použije sa záložný front.
  2. Používa parametre FlowDevName a FallbackQueue zadané vo volaní Exec ute Omniflow API.

URI koncového bodu

< instance_url >/služby/apexrest/ /hlas/v1/ExecuteOmniFlow cisco_wxcc_scv

Metóda HTTP

POST

hlavičky

Autorizácia: Nositeľ < > access_token

Typ obsahu: aplikácia/json

Parametre

{
  "callCenterDevName": "contactCenterDevName123",
  "certDevName": "certDevName123",
  "voiceCallId": "00X000012345abc",
  "dialedNumber": "+18445791189",
  "flowDevName": "Route_VoiceCall",
  "fallbackQueue": "00G111222333444",
  "flowInputParameters":
  {
    "Input1": "one",
    "Input2": "two"
  }
}

  • Parameter VoiceCallid je Salesforce VoiceCallid alebo kontaktné ID dodávateľa telefónie.
  • Podrobný popis parametrov prijatých touto požiadavkou 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_INFOa QUEUE_INFO zodpovedajú poľa ExternalID v callCenterRoutingMap

Odpoveď (s chybami)

{
 "data": null,
 "errors": ["Error message 1", "Error message 2"],
 "success": false
 }

Vymazať smerovanie

Vymaže záznam PendingServiceRouting (PSR) pre hlasový hovor. Toto rozhranie API nemusí byť volané pre väčšinu scenárov; záznam PSR sa automaticky odstráni, keď hovor už nie je 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 výslovne zavolať toto rozhranie API, aby ste vymazali záznam PSR.

URI koncového bodu

< instance_url >/služby/apexrest/ /hlas/v1/ClearRouting cisco_wxcc_scv

Metóda HTTP

POST

hlavičky

Autorizácia: Nositeľ < > access_token

Typ obsahu: aplikácia/json

Parametre

{
 "callCenterDevName": "contactCenterDevName123",
 "certDevName": "certDevName123",
 "voiceCallId": "00X000012345abc"
 }

  • Parameter VoiceCallid je Salesforce VoiceCallid alebo kontaktné ID dodávateľa telefónie.
  • Podrobný popis parametrov prijatých touto požiadavkou 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": ["Error message 1", "Error message 2"],
 "success": false
 }

Preklady telefónnych čísel

Rôzne interakcie medzi službou Service Cloud Voice a Webex Contact Center závisia od prekladov telefónnych čísel. Vzhľadom na medzinárodné rozdiely a špecifické aplikácie pre zákazníkov 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 hlavných znakov plus (+). Odstraňuje tiež prvý výskyt (0). Toto sa vykoná PRED použitím prekladov telef ónneho čísla.

Táto príručka popisuje, ako nakonfigurovať preklady telefónnych čísel.

Polia

Preklady telefónnych čísel sú uložené v poliach Menov-hodnota. To vám umožní nakonfigurovať ne obmedzené množstvo pravidiel na jednu funkciu.

Konfigurácia je uložená ako reťazec JSON.

Upozorňujeme, že spätné lomky musia byť uniknuté, napr.\ d+ sa stane\\ 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. Je tu potrebné pridať ľudsky čitateľný reťazec, aby sa rýchlo identifikoval účel tohto pravidla. Dobré mená sú napríklad: Odstrániť všetky vedúce nuly, Pridať vedúce plus atď.

Vytváranie pravidiel prekladu

Pravidlá sú poskytované ako regulárne výrazy. Presnejšie: Implementácia regulárnych výraz ov v JavaScripte.

Dobrým spôsobom, ako začať, je čítanie dokumentu 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.

Nasledujúci obrázok zobrazuje všeobecnú syntaxu 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 okrajov a medzier) sa zhodujú.

Predikáty sa vždy zhodujú s pôvodnou dĺžkou čísla. Pomáha to 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 vyberie ich.

Selektor

Selektory definujú konečný formát čísla. Ak je potrebné pridať znaky/číslice, ktoré pôvodne neboli prítomné, je to miesto, kde to urobíte.

Selektor je posledným krokom pri vytváraní čísla. Na základe výstupu vzoru selektor 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.

Tento príklad používa dve pravidlá prekladu (1. a 2.)

Prvé pravidlo v tomto príklade v skutočnosti nemení číslo. V prípade čísel s dĺž kou od 1 do 17 znakov sa odstráni všetko iné okrem číslic. Keďže neexistuje žiadna nečíselná prítomnosť, nič sa nezmení.

Druhé pravidlo platí pre čísla, ktoré majú presne 10 znakov dlhé (pôvodne). 0319175200 sa zhoduje, a preto sa uplatňuje pravidlo. Vzor určuje, že číslo musí začínať skupinou jednočíslic (\ 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ý reťazec čísel. To znamená, že $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.)

  1. Toto číslo je presne dlhé 12 znakov, takže sa uplatňuje pravidlo „Pridať medzery do amerických čí sel“.
  2. (\ +1) hovorí, že číslo musí začínať +1. Ak je číslo dlhé 12 znakov, ale nezačína sa +1, pravidlo sa zruší a nič sa nezmení.
  3. (\ d {3}) hovorí, že +1 musia nasledovať 3 číslice.
  4. (\ d {3}) hovorí, že za poslednými 3 čísličkami musia nasledovať ďalšie 3 číslice.
  5. (\ d {4}) hovorí, že za poslednými 3 čísličkami musia nasledovať 4 číslice.

Ak sa niektorá z týchto údajov nezhoduje, číslo sa nezmení.

Takže všetky pravidlá platia pre „+14693150217“. Preto sa číslo zmení o „$1 $2 $3 $4“:

  1. $1 sa vzťahuje na skupinu (\ +1), číslo, ktoré sa má odoslať do služby Cloud Voice, vyzerá ako +1.
  2. $2 sa vzťahuje na prvú z týchto dvoch (\ d {3}), číslo, ktoré sa má odoslať do služby Cloud Voice, vyzerá ako +1 469.
  3. $3 sa vzťahuje na druhý z týchto dvoch (\ d {3}), číslo, ktoré sa má odoslať do služby Service Cloud Voice, vyzerá ako +1 469 315.
  4. $4 sa vzťahuje na poslednú skupinu (\ d {4}), číslo, ktoré sa má odoslať do služby Cloud Voice, vyzerá ako +1 469 315 0217.

Priamo sa použijú medzery v náhradnej časti pravidla „$1 $2 $3 $4“. Takže ak použijete „$1-$2-$3-$4“ číslo by sa preložilo na: +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ý na: 469 315 0217. [12, 12] -> (\ +1) (\ d {3}) (\ d {3}) (\ d {4}) -> $3 $4 sa preloží na: 315 0217.

Je tiež možné previesť medzinárodné číslo USA na lokálne číslo ako: [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.

Tento príklad používa dve pravidlá prekladu (1. a 2.)

  1. Toto číslo má presne 13 znakov, takže sa uplatňuje pravidlo „Pridať medzery do nemeckých čí sel“.
  2. (\ +49) hovorí, že číslo musí začínať na +49. Ak je číslo dlhé 13 znakov, ale nezačína číslom +49, pravidlo sa zruší a nič sa nezmení.
  3. (\ d {3}) hovorí, že +49 musia nasledovať 3 číslice.
  4. (\ d {4}) hovorí, že za poslednými 3 čísličkami musia nasledovať 4 číslice.
  5. (\ d {3}) hovorí, že za poslednými 4 čísličkami musia nasledovať 3 číslice.

Ak sa niektorá z týchto údajov nezhoduje, číslo sa nezmení.

Takže všetky pravidlá platia pre „+491515555531“. Preto sa číslo zmení o „$1 $2 $3 $4“:

  1. $1 sa vzťahuje na skupinu (\ +49), číslo, ktoré sa má odoslať do služby Cloud Voice, vyzerá ako +49.
  2. $2 sa vzťahuje na prvú z týchto dvoch (\ d {3}), číslo, ktoré sa má odoslať do služby Service Cloud Voice, vyzerá ako +49 151.
  3. $3 sa vzťahuje na druhý z týchto dvoch (\ d {4}), číslo, ktoré sa má odoslať do služby Service Cloud Voice, vyzerá ako +49 151 5555.
  4. $4 sa vzťahuje na poslednú skupinu (\ d {3}), číslo, ktoré sa má odoslať do služby Cloud Voice, vyzerá ako +49 151 5555 531.

To isté platí pre pravidlo 1. Môžete použiť náhradnú časť $1 $2 $3 $4 na výber, čo chcete použiť z čísla.

Ďalšie príklady prekladu Regex

Popis Preklad Regex
Odstráňte všetky znaky okrem číslic [1,17] -> [^\ d] +
Odstráňte všetky znaky 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
Číslo USA s priestorom [12,17] -> (\ d {1}) (\ d {3}) (\ d {3}) (\ d {4}) ->+1 $2 $3 $4
Číslo USA s priestorom [12,17] -> (\ +1) (\ d {3}) (\ d {3}) (\ d {4}) ->$1 $2 $3 $4
Číslo DE s medzerom [12,17] -> (\ d {2}) (\ d {3}) (\ d {4}) (\ d {3}) ->+49 $2 $3 $4
Číslo DE s medzerom [12,17] -> (\ +49) (\ d {3}) (\ d {4}) (\ d {3}) ->$1 $2 $3 $4
Číslo CH s medzerom [12,17] -> (\ d {2}) (\ d {2}) (\ d {3}) (\ d {2}) (\ d {2}) ->+41 $2 $3 $4
Číslo CH s medzerom [12,17] -> (\ +41) (\ d {2}) (\ d {3}) (\ d {2}) (\ d {2}) ->$1 $2 $3 $4

Konfigurácia stránky VoiceCall

Konfigurácia stránky záznamu VoiceCall

Stránka záznamu VoiceCall je predvolene nakonfigurovaná s rozložením 3 stĺpcov a nasledujúcimi komponentmi:

  • Akcie a odporúčania
  • Poznámky k hovorom
  • Podrobnosti o volaní
  • Nahrávky

Komponenty je možné voľne odstrániť alebo pridať na stránku v závislosti od obchodných potrieb. Môžu sa použiť aj rôzne rozloženia stránok, ale niektoré komponenty, ako napríklad pre hrávač nahrávania hovorov a telo konverzácie, sa zmestia iba na stredné a veľké plochy šablóny.

Zobrazenie zložky Wrap-Up Reason

Komponent Rip-Up Reason sa musí zobraziť počas hovoru a počas zápisu.

Pridajte komponent Cisco Wrap-Up Reason na stránku záznamu VoiceCall:

  1. Presuňte webový kompon ent Cisco Wrap-Up Reas on Lightning z vlastnej oblasti zoznamu komponentov Lightning na stránku záznamu VoiceCall.
  2. Kliknite na polož ku Uložiť.
  3. Kliknite na polož ku Aktivovať.
  4. Kliknite na polož ku Priradiť ako predvolené zariadenie.
  5. Kliknite na polož ku Uložiť.
  6. Znova kliknite na tlačidlo U ložiť a potom kliknite na šípku Späť, aby ste sa vrátili na stránku.

Komponent Cisco Wrap-Up Reason sa automaticky zobrazí počas hovoru a počas Wrap Up:

Ak sa pridá na stránku, komponent Cisco Wrap-Up Reason sa zobrazí pre každý hovor, a to aj v prípade, že v Cisco Contact Center nie je nakonfigurovaný žiadny zápis.

Zobrazenie prehrávača nahrávania hovorov

Ak bol pre príslušný hlasový hovor uložený odkaz na nahrávanie, zobrazí sa prehrávač nahrávania hovorov.

Ak chcete pridať komponent Prehrávač nahrávania hovorov na stránku záznamu hlasového volania, postupujte podľa týchto krokov:

  1. Presuňte webovú komponentu Lightning Player Recording Player na stránku nahrávania hlasového volania
  2. Kliknite na polož ku Uložiť.
  3. Kliknite na polož ku Aktivovať.
  4. Kliknite na polož ku Priradiť ako predvolené zariadenie.
  5. Kliknite na polož ku Uložiť.
  6. Znova kliknite na tlačidlo U ložiť a potom kliknite na šípku Späť, aby ste sa vrátili na stránku.

Správcovia Webex

Konfigurácia toku

Vyskakovacia obrazovka

V toku Webex Contact Center Flow je k dispozícii uzol „Screen Pop“. Môže sa použiť na spustenie zobrazenia 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 .

Poskakovanie obrazovky v samostatnom okne

Ak chcete otvoriť okno obrazovky v samostatnom okne, v uzle „Screen Pop“ musí byť poskytnutá absolút na adresa URL. QueryParameters sa pripojí ako parametre vyhľadávania k adrese URL.

Podporované sú nasledujúce režimy:

  • Nová karta prehliadača - Vždy otvorí novú kartu prehliadača.
  • Karta existujúceho prehliadača - Na prvom vyskakovacom okne na karte Existujúci prehliadač sa otvorí nová karta prehliadača. Táto karta bude vyhradenou kartou pre nasledujúce vyskakovacie zobrazenia kariet existujúceho prehliadača a adresa URL sa obnoví v rámci konkrétnej karty prehliadača.
  • Inside Desktop - spracováva sa rovnakým spôsobom ako karta Nový prehliadač.

Aktuálne otvorená stránka môže zabrániť presmerovaniu. V takom prípade sa na novej karte prehliadača otvorí obrazovka karty Existujúci prehliadač.

Bol tento článok užitočný?
Bol tento článok užitočný?