- Domů
- /
- Článek
Webex Contact Center pro Salesforce Service Cloud Voice integruje robustní CCaaS (Contact Center as a Service) společnosti Cisco s CRM Salesforce, což umožňuje podnikům spravovat omnikanálové interakce se zákazníky (hlasové, digitální) v rámci rozhraní Salesforce pomocí Webex AI pro virtuální agenty, přepisy a inteligentní směrování, transformovat agenty na superagenty s jednotnými daty pro lepší zkušenosti zákazníků.
Přehled
Webex Contact Center pro hlasovou službu Salesforce Service Cloud
Webex Contact Center pro Service Cloud Voice je předem připravené integrační řešení, které přináší sílu Webex Contact Center do konzoly agenta Salesforce Service Cloud Voice Omni-channel.
Před pokračováním v instalaci si přečtěte následující část:
Se dozvíte o předpokladech a omezeních služby Salesforce Service Cloud Voice a zajistíte, aby vaše organizace Salesforce byla připravena povolit a nainstalovat Webex Contact Center pro balíček Service Cloud Voice .
Předpoklady a omezení
Předpoklady (podtéma)
Uživatelská rozhraní: Hlasová služba Service Cloud je k dispozici pouze v prostředí Lightning Experience služby Salesforce.
V těchto edicích je k dispozici hlasová služba Service Cloud.
- Podnik
- Neomezené
- Vývojář
Opravňuje licencí
-
Zákazníci si musí zakoupit novou doplňkovou licenci A-SF-VOICE na přihlášeného agenta kromě licencí Flex 3 Standard nebo Premium pro Webex Contact Center. Další informace naleznete v průvodci objednáváním Flex 3.
- Salesforce hlas pro partnerskou telefonii
Než se TURN na hlas, musíte ve vaší organizaci nastavit požadované služby.
- Přejděte do části Informace o společnosti > Sada oprávnění Licence
- Zkontrolujte hlasového uživatele služby Cloud (partnerská telefonie).
Všechny edice Developer jsou nyní k dispozici pro testování s 5 partnerskými telefonními licencemi.
- Zkontrolujte hlasového uživatele služby Cloud (partnerská telefonie).
- Případně to můžete ověřit tak, že přejdete do Nastavení služby Salesforce a v levém postranním panelu vyhledáte "hlas".
- Pokud se zobrazí "Kontaktní centra partnerského telefonního subsystému", máte licenci SCV.
- Pokud možnost "Kontaktní centra telefonního subsystému" není viditelná, postupujte podle níže uvedených kroků "Povolit hlasovou službu v cloudu".
- Přejděte do nastavení služby Salesforce a vyhledejte a vyberte možnost "Nastavení telefonie partnera" a přepněte tlačítko na "Povolit hlasovou službu Service Cloud".
- Povolte Omni-Channel, abyste umožnili svým operátorům uskutečňovat a přijímat hovory.
- Přejděte do nastavení služby Salesforce a vyhledejte a vyberte možnost "Nastavení telefonie partnera" a přepněte tlačítko na "Povolit hlasovou službu Service Cloud".
Povolit omnikanál
Pokud je Omni-Channel už ve vaší organizaci povolený, tento krok přeskočte.
- V nabídce Nastavení zadejte do pole Rychlé hledání položku Nastavení omnikanálů a pak vyberte možnost Nastavení omnikanálu.


- Vyberte možnost Povolit omnikanál.
- Klikněte na položku Uložit.
Omezení
- Hlas je k dispozici pouze v prostředí Lightning.
- Hlas je podporován v Service Cloud a Sales Cloud jako doplňková licence.
- Hlas není podporován v mobilním zařízení Salesforce ani v Safari iPad.
- Hlas je podporován pouze ve webových prohlížečích Google Chrome, Microsoft Edge (Chromium) a Mozilla Firefox. Chcete-li povolit jednotné přihlášení (SSO), musí být povoleny soubory cookie.
- Standardní navigace není podporována.
- Telefonování je vysoce regulované, proto se informujte u zástupce Salesforce o dostupnosti hlasových služeb ve vaší oblasti.
Viz Omezení hlasového cloudu služby Service Cloud a Průvodce instalací a konfigurací.
Požadavky
Kódy nečinnosti
Najít kódy pro nečinnost
| 1 |
Přihlaste se k portálu pro správu. |
| 2 |
Přejděte do části Kontaktní centrum > DESKTOPOVÉ PROSTŘEDÍ> Nečinné/Wrap-up kódy. |
| 3 |
Ujistěte se, že jsou zobrazeny Kódy nečinnosti, jinak klikněte na rozevírací tlačítko filtru a vyberte možnost Kód nečinnosti v horní části stránky. |
| 4 |
Kliknutím na kód nečinnosti otevřete podrobné zobrazení. Zde najdete kód nečinnosti ID.
ID lze zkopírovat a poté použít pro konfiguraci mapování stavu přítomnosti. Jedno z ID musí být použito jako výchozí důvod Cisco není připraven. |
INTEGROVAT
Instalace
Než budete pokračovat v instalaci, přečtěte si část Požadavky a omezení , kde se dozvíte o předpokladech a omezeních služby Salesforce Service Cloud.
Instalace a konfigurace Webex Contact Center pro službu Service Cloud Voice
Po získání licence Service Cloud Voice for Partner Telephony se v nabídce Nastavení zobrazí stránka Nastavení telefonního subsystému partnera.
Další informace naleznete v oficiálním odkazu Salesforce ( přímý odkaz).
| 1 |
V části Instalační program zadejte
|
| 2 |
Povolte TURN na hlas s partnerskou telefonií. Stránka Kontaktní centra partnerského telefonování se zobrazí v nabídce Nastavení .
Pokud plánujete nasadit balíček v izolovaném prostoru Salesforce, nahraďte |
Instalace balíčku
Instalace balíčku:
| 1 |
Otevřete poskytnutý odkaz balíčku a spusťte instalaci. |
| 2 |
Přihlaste se k organizaci Salesforce, kde má být balíček nainstalován. |
| 3 |
V průvodci instalací zvolte možnost zabezpečení"Instalovat pouze pro správce" (1) a klikněte na Instalovat (2). Určete, kteří uživatelé získají určitá oprávnění k objektům a komponentám, které jsou součástí balíčku Webex Contact Center pro Service Cloud Voice. Dále jim udělte tato oprávnění; Sady oprávnění, které jsou součástí balíčku Webex Contact Center pro Service Cloud Voice, tento proces usnadňují. Průvodce instalací balíčku – zobrazí se uvítací obrazovka: |
| 4 |
Udělte alespoň jednomu uživateli následující sady oprávnění, abyste mohli vytvořit Kontaktní centrum:
|
| 5 |
Klikněte na Nastavení | Uživatelé | uživatelů. |
| 6 |
Vyhledávání a výběr uživatele. |
| 7 |
Posuňte se dolů na "Přiřazení sady oprávnění". |
| 8 |
Klikněte na Upravit přiřazení |
| 9 |
Pro správce kontaktního centra: přiřaďte sadu oprávnění správce kontaktního centra (partnerská telefonie).
|
| 10 |
Pro agenty kontaktního centra: přiřaďte sadu oprávnění Agent kontaktního centra (partnerská telefonie) a sadu oprávnění Webex Contact Center Agent SCV.
Nedoporučuje se zvolit možnost Instalovat pro všechny uživatele , protože ta uděluje všechna oprávnění (čtení, vytváření, úpravy a odstraňování) komponent a objektů balíčku každému uživateli, který používá vlastní profil uživatele. |
| 11 |
Přiřaďte uživatelům licenci balíčku, se kterou budou pracovat připojení pro hlasovou službu Service Cloud.
|
| 12 |
Případně můžete kliknout na Nastavení | Uživatelé | Uživatelé.. |
| 13 |
Vyhledejte a vyberte uživatele. |
| 14 |
Posuňte se dolů na spravované balíčky. |
| 15 |
Klikněte na Přiřadit licence. |
| 16 |
V seznamu zvolte Webex Contact Center pro balíček Service Cloud Voice . |
| 17 |
Klikněte na tlačítko Přidat. |
| 18 |
Vytvořte stavy přítomnosti a definujte, které servisní kanály jsou přiřazeny k různým stavům. Agenti se mohou přihlásit do Omni-Channel s různými stavy v závislosti na druhu práce, na kterou mají nárok. |
| 19 |
V nabídce Nastavení zadejte
|
| 20 |
Klikněte na možnost Nový. Vytvořte alespoň jeden stav pro "Online" a jeden pro "Zaneprázdněn".
|
Přiřazení stavů agentům
| 1 |
V části Nastavení zadejte do pole Rychlé hledání položku Sady oprávnění a pak vyberte Sady oprávnění. |
| 2 |
Klepnutím otevřete nástroj Sada oprávnění telefonního subsystému partnera. |
| 3 |
Klikněte na Přístup ke stavům služby Presence. |
| 4 |
Klikněte na Upravit. |
| 5 |
V seznamu Dostupné informace o stavu služby vyberte dříve vytvořené stavy stavu a kliknutím na tlačítko Přidat je přidružte k sadě oprávnění. Agenti, kteří jsou přiřazeni k této sadě oprávnění, se mohou přihlásit do Omni-Channel s libovolným stavem, který mají k dispozici. |
| 6 |
Klikněte na položku Uložit. |
| 7 |
Na stejné stránce klikněte na Spravovat přiřazení . Pak klikněte na Přidat přiřazení v pravém horním rohu, vyberte požadovaného uživatele, klikněte na Další, vyberte možnost vypršení platnosti pro přiřazené uživatele (volitelné) a pak klikněte na Přiřadit. Služba Service Cloud Voice používá k provozu se záznamem hlasového hovoru externí doménu. Následující adresy URL musí být přidány do "Nastavení vzdáleného webu" v nastavení ( klikněte zde pro otevření oficiální dokumentace):
Příklad: Jak najít adresu URL instance. |
| 8 |
Po přihlášení se podívejte na adresu URL v adresním řádku prohlížeče. Adresa URL instance je část před ".my.salesforce.com" nebo ".salesforce.com" nebo ." lightning.force.com". Pokud je například vaše adresa URL https://orgfarm-54a38e30ad-dev-ed.develop.my.salesforce-setup.com/, pak "orgfarm-54a38e30ad-dev-ed.develop" je adresa URL vaší instance. Příklad: Adresa URL původní organizace: https://cisco.lightning.force.com Příklad: Adresy URL, které chcete přidat:
|
| 9 |
Aby mohl agent používat hlasovou službu Service Cloud, vyžaduje se v aplikaci Lightning Service Console položka nástroje Omni-Channel.
Oficiální odkaz ze služby Salesforce najdete kliknutím na tlačítko Let's Do This (Pojďme to udělat), které otevře stránku Konfigurace prostředí agenta pro Service Cloud Voice s partnerskou telefonií na portálu nápovědy služby Salesforce ( přímý odkaz). |
| 10 |
V části Nastavení zadejte do pole Rychlé hledání text Nastavení telefonního subsystému partnera a pak vyberte Nastavení telefonního subsystému partnera. |
| 11 |
Posuňte se dolů k části 5 Další nastavení hlasu. |
| 12 |
Chcete-li povolit ochranu proti clickjackingu pro stránky Visualforce se zakázanými záhlavími při práci se softwarovým telefonem v prostředí Lightning, musíte kromě adresy URL instance služby Salesforce přidat domény, ze kterých jsou softwarový telefon a vlastní panely nástrojů načteny, jako důvěryhodné domény. Tato nastavení a seznam důvěryhodných domén najdete v části Nastavení | Bezpečnost | Nastavení relace. Pokud chcete načíst správnou doménu Visualforce, přejděte do nabídky Nastavení | Vlastní kód | Visualforce Pages a klikněte na tlačítko Náhled pro Příklad: MyDomainName--cisco_wxcc_scv.vf.force.com Chcete-li získat doménu instance služby Salesforce, zkopírujte adresu URL zobrazenou v řádku adres URL prohlížeče a přidejte ji do seznamu Důvěryhodné domény pro seznam vložených rámců a vyberte možnost Stránky Visualforce jako Typ IFrame. Příklad: MyDomainName.lightning.force.com
Pokud ve vaší organizaci nemáte nasazenou doménu, formát adresy URL se liší. Pokud máte nasazenou My Domain a rozšířené domény nejsou ve vaší organizaci povolené, formát adresy URL se liší. Pokud nejsou povoleny rozšířené domény, ovlivní tento formát také nastavení Stabilizovat adresy URL v aplikacích Visualforce, Experience Builder, Site.com studio a obsah Moje doména. Podrobnosti naleznete v části Formáty adresy URL mé domény v nápovědě služby Salesforce. Nastavení ochrany Clickjack a důvěryhodných domén pro prostředí Lightning
|
| 13 |
Aby bylo možné zobrazit ovládací prvky nahrávání během hovorů, potřebují Chcete-li ji přiřadit, přidejte ji do sady oprávnění vytvořené v kroku Stavy stavu.
|
Konfigurace
Kontaktní centrum
Definiční soubor kontaktního centra určuje sadu polí a hodnot, které se používají k definování kontaktního centra ve službě Salesforce pro konkrétní systém CTI. Salesforce používá definiční soubory kontaktního centra k podpoře integrace s více dodavateli systému CTI.
Import kontaktního centra
| 1 |
V části Nastavení zadejte do pole Rychlé hledání text Kontaktní centra telefonního subsystému partnerů a poté vyberte možnost Kontaktní centra telefonního subsystému partnerů. Zobrazí se seznam existujících (pokud existují) kontaktních center.
|
| 2 |
Klikněte na Vytvořit kontaktní centrum na pravé straně stránky. |
| 3 |
Jako zprostředkovatele telefonních služeb vyberte Webex Contact Center . Potom klikněte na tlačítko Další.
Otevře se prohlížeč souborů.
|
| 4 |
|
| 5 |
Klikněte na Otevřít. Soubor se importuje.
|
| 6 |
Zkontrolujte, zda je vaše kontaktní centrum zobrazeno v zobrazení seznamu Kontaktní centra.
|
Konfigurace kontaktního centra
| 1 |
V části Nastavení zadejte do pole Rychlé hledání text Kontaktní centra telefonního subsystému partnerů a poté vyberte možnost Kontaktní centra telefonního subsystému partnerů. | ||||||||||||||||||||||||||||||
| 2 |
Klikněte na dříve importované kontaktní centrum. | ||||||||||||||||||||||||||||||
| 3 |
Klikněte na Upravit.
| ||||||||||||||||||||||||||||||
| 4 |
V dolní části stránky Kontaktní centrum klikněte na tlačítko Přidat v části Uživatelé kontaktního centra. | ||||||||||||||||||||||||||||||
| 5 |
Klikněte na tlačítko + vedle uživatelů, kteří mají přístup k otevřenému kontaktnímu centru. V tomto seznamu se zobrazí pouze uživatelé, kteří mají |
Přizpůsobit
Externí klientská aplikace pro integraci Webex Contact Center
Konfigurace aplikace externího klienta pro Webex Contact Center konektor Salesforce
Aby bylo možné používat hlasovou službu Service Cloud v plném rozsahu, lze tok volání kontaktního centra přizpůsobit tak, aby vytvořil záznam hlasového hovoru a provedl tok Salesforce Omni-Channel, zatímco je hovor na IVR.
Vytvořit certifikát
Ujistěte se, že jste již vytvořili digitální certifikát podle zásad zabezpečení vaší organizace.
Chcete-li vygenerovat digitální certifikát, přečtěte si dokumentaci služby 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.
Příklad
openssl genrsa -des3 -passout pass:<heslo> -out server.pass.key 2048 openssl RSA -passin pass:<heslo> -in server.pass.key -out server.key rm server.pass.key openssl req -new -key server.key -out server.CSR Název země (2písmenný kód) [AU]:CH Název státu nebo provincie (celé jméno) [Některý-stát]: Název lokality (např. město) []: Název organizace (např. společnost) [Internet Widgits Pty Ltd]: Název organizační jednotky (např. sekce) []: Běžný název (např. server FQDN nebo VAŠE jméno) []: E-mailová adresa []: my-api-user@my-example-org.com Zadejte následující atributy 'extra', které mají být zaslány spolu s žádostí o certifikát Heslo výzvy []:<heslo> Volitelný název společnosti []: openssl x509 -req -sha256 -days 365 -in server.CSR -signkey server.key -out server.crt
server.crt => certifikát pro aplikaci externího klienta služby Salesforce
server.key => Privátní klíč konektoru Salesforce v Webex Control Hub
Sada oprávnění pro uživatele integrace SCV
Následující sada oprávnění uděluje přístup ke třídám Apex používaným připojením pro SCV pro integraci s toky IVR kontaktního centra a Webex Contact Center pro Salesforce pro SCV.
Následuje příklad konfigurace a popisuje minimální požadovaná oprávnění pro fungování integrace Kontaktního centra / IVR.
- V části Nastavení přejděte na Uživatelé | Sady oprávnění.
- Klikněte na tlačítko Nový .
- Zadejte popisek, například: IVR Přístup ke třídám SCV Apex
- API Jméno se vyplní automaticky
- Licence: Žádná
- Klikněte na tlačítko Uložit .
- Otevře se nová sada oprávnění.
- Přejděte na Přístup ke třídě Apex.
- Klikněte na tlačítko Upravit a přidejte následující třídy Apex:
- cisco_wxcc_scv. ServiceRouting
- Přejděte na Systémová oprávnění.
- Klikněte na tlačítko Upravit a povolte následující oprávnění:
- Služby Apex REST
- API povoleno
Minimální přístup – API pouze profil integrací
Tento profil se používá k integraci s Webex Contact Center for Salesforce for SCV k vytváření záznamů hlasových hovorů a provádění Omni-Flow z toku IVR.
Následuje příklad konfigurace a popisuje minimální požadovaná oprávnění pro fungování integrace Kontaktního centra / IVR.
Toto je klon z profilu Minimální přístup – API Pouze integrace.
- V části Nastavení přejděte na Uživatelé | Profily.
- V seznamu Profily vyhledejte Minimální přístup k profilu – pouze API Integrace.
- Kliknutím na název profilu otevřete profil Minimální přístup – API Pouze integrace .
- V profilu Minimální přístup – pouze integrace API klikněte na tlačítko Klonovat .
- Zadejte nový název profilu, například: Integrace SCV.
- Klikněte na tlačítko Uložit .
- Otevře se nový profil.
- Ověřte, zda má váš profil Minimální přístup – pouze integrace API všechna oprávnění odebraná ze samotného profilu.
- Přejděte na Systémová oprávnění.
- Ujistěte se, že jsou povolena následující oprávnění:
- API povoleno
- API Pouze uživatel
Uživatel integrace SCV
Následuje příklad konfigurace a popisuje minimální požadovaná oprávnění pro fungování integrace Kontaktního centra / IVR. Pro uživatele integrace SCV není vyžadována žádná licence Salesforce Service Cloud Voice ani Webex Contact Center pro licenci Salesforce for SCV.
- V části Nastavení přejděte na Uživatelé | Uživatelé.
- Klikněte na tlačítko Nový uživatel .
- Zadejte Jméno, Příjmení a všechna ostatní povinná pole.
- Uživatelská licence: Integrace Salesforce
- Profil: vyberte profil vytvořený v předchozím kroku ("profil integrace SCV", klon profilu minimálního přístupu - API pouze integrace)
- Klikněte na tlačítko Uložit .
- Otevřete nový záznam uživatele.
- Přiřaďte sadu oprávnění vytvořenou dříve ("IVR Access to SCV Apex Classes").
- Přiřaďte sadu oprávnění Integrace licence Salesforce API.
Vytvoření aplikace externího klienta Salesforce
Vytvoření nové aplikace externího klienta
Existují dvě možnosti, jak propojit data Salesforce s aplikacemi třetích stran. Připojené aplikace i externí klientské aplikace jsou architektury pro integraci dat. Externí klientské aplikace představují další generaci připojených aplikací.
Konfigurace aplikace externího klienta Salesforce, kterou používá Cisco Webex Contact Center:
- V části Nastavení přejděte do nabídky Aplikace | Externí klientské aplikace | Správce aplikací externího klienta.
- Klikněte na Nová externí klientská aplikace.
- Externí klientská aplikace – základní informace
- Název aplikace externího klienta: WxCC – SCV
- API Název: WxCC_SCV
- Kontaktní e-mail: < e-mailové >
- Stav distribuce: vyberte Místní

Externí klientská aplikace – API (povolit nastavení OAuth)
- Vyberte: Povolit OAuth
- Nastavení aplikace
- Adresa URL pro zpětné volání: http://localhost:1717/OauthRedirect jako ukázková adresa URL pro zpětné volání
- Obory OAuth
- Vyberte obory OAuth:
- Správa uživatelských dat prostřednictvím rozhraní API (API)
- Provádění požadavků kdykoli (refresh_token, offline_access)

Umožnění toku
- Vyberte: Povolit tok nosiče JWT
- Klepněte na tlačítko Odeslat soubory a odešlete
soubor server.crt, který obsahuje váš digitální certifikát.

Zabezpečení
Zrušte zaškrtnutí políčka Vyžadovat tajný klíč pro tok webového serveru.

- Klikněte na tlačítko Vytvořit .
- Změňte zásady # Tab a poté klikněte na tlačítko Upravit .
- Zásady – zásady OAuth
- Zásady zásuvných modulů
- Oprávnění uživatelé: vyberte možnost Uživatelé schválení správcem jsou předběžně autorizováni
- Potvrďte změnu
- Autorizace aplikací
- Zásady aktualizovat tokeny: vyberte okamžitě vyprší platnost obnovovacího tokenu
- IP Relaxace: vyberte možnost Vynutit IP omezení

- Zásady zásuvných modulů
- Zásady – zásady aplikací
- Úvodní stránka – žádná
- Vybrat sady oprávnění – přiřaďte sadu oprávnění vytvořenou dříve ("IVR přístup k vrcholovým třídám SCV")

- Klikněte na položku Uložit.
- Přejděte na Tab Nastavení.
-
V části Nastavení OAuth klikněte na tlačítko Spotřebitelský klíč a tajný klíč ; počkejte na e-mail a ověřte svou identitu. Nový prohlížeč Tab otevře obrazovku s podrobnostmi o spotřebiteli.

- Klikněte na Kopírovat a uložte spotřebitelský klíč. Klíč příjemce se později použije k vytvoření konektoru Salesforce v Webex Contact Center Control Hub.

-
Webex Contact Center Konfigurace a skript pro vytváření záznamů hlasových hovorů
Chcete-li získat plnou hodnotu Salesforce Service Cloud Voice, je nutné upravit tok volání v Webex Contact Center tak, aby se záznam hlasového hovoru v Service Cloud Voice vytvořil ihned po doručení hovoru do kontaktního centra.
Volitelný Omni-Flow lze spustit pro rozhodování o směrování a automatizaci v Salesforce.
Podrobnosti o použitých rozhraních API najdete v tématu Service Cloud hlasová obálka API.
Předpoklady
Aby bylo možné použít obálku Service Cloud Voice API, musí být nakonfigurovaná aplikace externího klienta Salesforce pro integraci IVR.
Konfigurace konektoru Salesforce v Webex Control Hub
Nastavte integrační konektory Salesforce pro Webex Contact Center, jak je popsáno v článku na # https://help.webex.com/en-us/article/7fuy63/SetUp-Integration-Connectors-for-Webex-Contact-Center#id_133211.
| 1 |
Přihlaste se ke své zákaznické organizaci na adrese https://admin.webex.com a přejděte na Služby > Kontaktní centrum > Nastavení tenanta > Integrace>konektory. |
| 2 |
Na kartě Salesforce klikněte na Nastavit nebo Přidat konektor.
DŮLEŽITÉ: UDRŽUJTE ZABEZPEČENÍ PRAVIDELNÝM STŘÍDÁNÍM TAJNÝCH KLÍČŮ Ujistěte se, že pravidelně střídáte svůj soukromý klíč a certifikát, abyste udrželi své integrace zabezpečené. Aktualizujte privátní klíč v konektoru kontaktního centra v Webex Hubu a certifikát v externí klientské aplikaci ve službě Salesforce. Tip pro řešení potíží Po kliknutí na Hotovo a konektor se neuloží:
|
Webex Contact Center Hlavní tok
| Proměnná průtok | Popis |
|---|---|
| Proměnná toku pro záznam hlasového hovoru ID | Jedinečný ID pro identifikaci hovoru. Vyžadováno k vytvoření záznamu hlasového hovoru. Formát: wxcc_<Interakce ID> Příklad: wxcc_fc4ec7d8-4c91-49aa-b764-081fbba344a8
|
| Místní proměnná pro čas zahájení hovoru |
Používá se k vytvoření záznamu hlasového hovoru a při aktualizaci hlasového hovoru.
|
| Místní proměnná pro Název fronty/ID |
Vráceno pomocí Execute Omni Flow, používá se pro směrování hovorů. Tato proměnná je vyžadována pouze při použití příkazu Execute Omni Flow
|
| Místní proměnná pro název agenta/ID |
Vráceno pomocí Execute Omni Flow, používá se pro směrování hovorů. Tato proměnná je vyžadována pouze při použití příkazu Execute Omni Flow
|
Přehled hlavního toku

- Generovat klíč volání dodavatele
- Nastavení času zahájení hovoru
- Požadavek HTTP: Vytvoření záznamu hlasového hovoru
- Vyhodnotit odpověď HTTP pro vytvoření záznamu hlasového hovoru
- Zpracování chyb při vytváření záznamu hlasového hovoru
- Požadavek HTTP: Spustit Omni Flow
- Vyhodnocení odpovědi HTTP pro spuštění toku Omni
- Zpracování chyb pro Execute Omni Flow
- Pokračovat ve směrování hovorů
| Tok | Popis |
|---|---|
| Generovat klíč volání dodavatele |
Každý hovor zpracovaný v Service Cloud Voice vytvoří záznam hlasového hovoru ve službě Salesforce a vyžaduje jedinečný ID nazvaný Klíč volání dodavatele. U záznamů hlasových hovorů vytvořených v Webex Contact Center musí být volací klíč dodavatele definován v toku WxCC a poté předán spolu s voláním agentovi pomocí proměnné toku. Hodnota vendorCallKey musí splňovat následující pravidla:
|
| Nastavení času zahájení hovoru |
Časové razítko času zahájení hovoru UTC. Toto časové razítko se používá k vytvoření záznamu hlasového hovoru a k aktualizaci záznamu hlasového hovoru, pokud volající zavěsí před přesměrováním na agenta.
|
| Požadavek HTTP: Vytvoření záznamu hlasového hovoru |
Tento krok je vyžadován pro každý hovor. Po vytvoření záznamu hlasového hovoru musí být záznam hlasového hovoru ID předán s voláním agentovi v proměnné společně s klíčem volání dodavatele. Nakonfigurujte použitou proměnnou v konfiguraci kontaktního centra v hlasové službě Service Cloud. |
| Nastavení požadavků HTTP |
|
Požadavek HTTP: Vytvoření záznamu hlasového hovoru
Tento krok je vyžadován pro každý hovor. Po vytvoření záznamu hlasového hovoru musí být záznam hlasového hovoru ID předán s voláním agentovi v proměnné společně s klíčem volání dodavatele. Nakonfigurujte použitou proměnnou v konfiguraci kontaktního centra v hlasové službě Service Cloud.
Nastavení požadavků HTTP
- Název aktivity: CreateVoiceCall
- Použít ověřený koncový bod: povoleno
- Konektor: Konektor Salesforce vytvořený v předchozím kroku
- Cesta požadavku:
/services/apexrest/cisco_wxcc_scv/voice/v1/createVoiceCall - Metoda: POST
- Typ obsahu požadavku: aplikace/JSON
Text požadavku
Při vytváření záznamu hlasových hovorů můžete také aktualizovat vlastní pole v záznamu hlasových hovorů daty hovorů. Níže jsou uvedeny dva příklady textu požadavku, jeden se všemi požadovanými poli, ale bez aktualizace vlastních polí, a jeden s vlastními poli.
Bez aktualizace vlastních polí v záznamu hlasových hovorů:
{ "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" } ] }
Příklad aktualizace vlastních polí v záznamu 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\": \"<hodnota3>\"}" }
Parametry
| Název vlastnosti | Hodnota |
|---|---|
| callCenterDevName | Název vývojáře kontaktního centra |
| certDevName | API Název certifikátu (jak je nakonfigurován v Kontaktním centru) |
| vendorCallKey | Jedinečné volání ID: {{SCV_VendorCallKey}}
|
| k | CalledNumber/DNIS: {{NewPhoneContact.DNIS}}
|
| od | CallingNumber/ANI: {{NewPhoneContact.ANI}}
|
| startTime | Časové razítko UTC{{SCV_CallStartTime}} (nastaví se ihned po přijetí hovoru ve skriptu) |
| callAttributes |
Představuje další standardní a vlastní pole v záznamu hlasového hovoru, kde každá dvojice klíč-hodnota odpovídá standardnímu nebo vlastnímu poli a jeho hodnotám. Příklad:
|
Nastavení analýzy
- Typ obsahu: JSON
- Výstupní proměnná: SCV_VoiceCallRecordId
- Výraz cesty:
$.data.voiceCallId
Záznam hlasového hovoru ID, který bude předán agentovi.
Vyhodnotit odpověď HTTP pro vytvoření záznamu hlasového hovoru
Zkontrolujte stav HTTP požadavku HTTP Vytvořit hlasový hovor:
- Popisek: statusCodeCreateVoiceCall
- Proměnná: CreateVoiceCall.httpStatusCode
Pokud stavový kód == 200 => úspěšný else => požadavek se nezdařil, zpracování chyb
Zpracování chyb při vytváření záznamu hlasového hovoru
Pouze pro demo / debug přehrajte zprávu v závislosti na stavovém kódu http.
Pokud bylo vytvoření hlasového hovoru úspěšné, pokračujte příkazem Provést Omni Flow. V opačném případě pokračujte ve směrování hovorů.
Požadavek HTTP: Spuštění toku Omni (volitelný krok)
Provést Omni-Flow použijte, pokud chcete:
- Spouštět automatizované úlohy, například vyhledávat nebo vytvářet záznamy, a propojovat záznamy se záznamem hlasového volání
- Vyhledávejte záznamy a pop obrazovky
- Synchronizace front Salesforce a Cisco
- Nechte Service Cloud Voice rozhodnout o směrování
Tento požadavek vždy vrátí "frontu" nebo "agenta", kam musí být hovor směrován.
Po provedení tohoto požadavku se ujistěte, že jste odeslali Clear Routing (Vymazat směrování), pokud volající zavěsí předtím, než ho odpoví agent. Viz Webex Contact Center tok událostí.
Nastavení požadavků HTTP
- Název aktivity: ExecuteOmniFlow
- Použít ověřený koncový bod: povoleno
- Konektor: Konektor Salesforce vytvořený v předchozím kroku
- Cesta požadavku:
/services/apexrest/cisco_wxcc_scv/voice/v1/executeOmniFlow - Metoda: POST
- Typ obsahu požadavku: aplikace/JSON
Text požadavku
Kromě povinných polí můžete do Omni-Flow předat další data jako vstupní proměnné. Níže jsou uvedeny dva příklady textu požadavku. První bez dalších parametrů průtoku, pouze povinná pole, druhá se dvěma vstupními proměnnými.
Příklad s parametry Omni-Flow:
{ "callCenterDevName": "<Contact Center API name>", "certDevName": "<cert dev name>", "voiceCallId": "{{SCV_VoiceCallRecordId}}", "dialedNumber": "{{NewPhoneContact.DNIS}}", "flowDevName": "<flow API name>", "fallbackQueue": "<název záložní fronty>" }
Příklad aktualizace vlastních polí v záznamu hlasového hovoru:
{ "callCenterDevName": "<Contact Center API name>", "certDevName": "<cert dev name>", "voiceCallId": "{{SCV_VoiceCallRecordId}}", "dialedNumber": "{{NewPhoneContact.DNIS}}", "flowDevName": "<flow API name>", "fallbackQueue": "<název záložní fronty>", "flowInputParameters": { "param1": "value1", "param2": "value2" } }
Parametry
| Název vlastnosti | Hodnota |
|---|---|
| callCenterDevName | Název vývojáře kontaktního centra |
| certDevName | API Název certifikátu (jak je nakonfigurován v Kontaktním centru) |
| voiceCallId | ID záznamu hlasového hovoru vytvořeného v předchozím kroku: {{SCV_VoiceCallRecordId}}
|
| Vytočené číslo | CalledNumber/DNIS: {{NewPhoneContact.DNIS}}
|
| flowDevName | Název vývojáře Omni-Flow, který se má spustit |
| fallbackQueue | Queue ID nebo Queue API název záložní fronty služby Salesforce |
| flowInputParameters |
Další vstupy do toku Omni-Channel (pár klíč-hodnota). Příklad:
|
Nastavení analýzy
Fronta
- Typ obsahu: JSON
- Výstupní proměnná: SCV_OmniFlowQueue
- Výraz cesty:
$.data.queue
"Fronta" vrácená z Execute Omni-Flow může být použita pro směrování.
Agent- Typ obsahu: JSON
- Výstupní proměnná: SCV_OmniFlowAgent
- Výraz cesty:
$.data.agent
"Agent" vrácený z Execute Omni-Flow, lze použít pro směrování.
Vyhodnocení odpovědi HTTP pro spuštění toku Omni
Zkontrolujte stav HTTP požadavku Execute Omni Flow:
- Popisek: statusCodeExecuteOmniFlow
- Proměnná: ExecuteOmniFlow.httpStatusCode
Pokud stavový kód == 200 => úspěšný else => požadavek se nezdařil, zpracování chyb.
Zpracování chyb pro Execute Omni Flow
Pouze pro demo / debug přehrajte zprávu v závislosti na stavovém kódu http.
Pokud bylo provedení Omni Flow úspěšné, proměnné SCV_OmniFlowQueue a SCV_OmniFlowAgent nejsou nastaveny. Rozhodnutí o směrování v toku hovoru.
Pokračovat ve směrování hovorů
Pokračujte v toku hovoru, směrujte hovor agentovi. Volitelné můžete použít SCV_OmniFlowQueue a SCV_OmniFlowAgent k výběru fronty a agenta.
Webex Contact Center Tok událostí
Pokud volající zavěsí hovor dříve, než jej přijme agent, musíme aktualizovat hlasovou službu Service Cloud a hovor ukončit.
- Pokud byla použita možnost Spustit omni-Flow, odešlete příkaz Vymazat směrování, čímž odstraníte čekající směrování služby (PSR)
- Odeslat aktualizovaný hlasový hovor pro aktualizaci počátečního a koncového času v záznamu hlasového hovoru a pro změnu stavu z Nového na Dokončeno

- PhoneContactEnded - Tato událost se aktivuje, když je živý hovor odpojen a všichni účastníci jsou odebráni.
- Požadavek HTTP: Vymazat směrování
- Požadavek HTTP: Aktualizace hlasového hovoru
Požadavek HTTP: Vymazat směrování
- Popisek: ClearRouting
- Použít ověřený koncový bod: povoleno
- Konektor: Konektor Salesforce vytvořený v předchozím kroku
- Cesta požadavku:
/services/apexrest/cisco_wxcc_scv/voice/v1/clearRouting - Metoda: POST
Typ obsahu požadavku: aplikace/JSON
Text požadavku
{ "callCenterDevName": "<Kontaktní centrum API name>", "certDevName": "<cert dev name>", "voiceCallId": "{{SCV_VoiceCallRecordId}}" }
Parametry
| Název vlastnosti | Hodnota |
|---|---|
| callCenterDevName | Název vývojáře kontaktního centra |
| certDevName | API Název certifikátu (jak je nakonfigurován v Kontaktním centru) |
| voiceCallId | ID záznamu hlasového hovoru vytvořeného v předchozím kroku: SCV_VoiceCallRecordId |
Nastavení analýzy
Žádný.
Požadavek HTTP: Aktualizace hlasového hovoru
- Vydavatel: UpdateVoiceCall
- Použít ověřený koncový bod: povoleno
- Konektor: Konektor Salesforce vytvořený v předchozím kroku
- Cesta požadavku:
/ služby / apexrest / cisco_wxcc_scv / hlas / v1 / updateVoiceCall - Metoda: POST
- Typ obsahu požadavku: aplikace/JSON
Text požadavku
{ "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 } }
Parametry
| Název vlastnosti | Hodnota |
|---|---|
| callCenterDevName | Název vývojáře kontaktního centra |
| certDevName | API Název certifikátu (jak je nakonfigurován v Kontaktním centru) |
| voiceCallId | ID záznamu hlasového hovoru vytvořeného v předchozím kroku: SCV_VoiceCallRecordId |
| startTime | Časové razítko začátku hovoru UTC{{SCV_CallStartTime}} (jak se používá k vytvoření záznamu hlasového hovoru) |
| Čas ukončení | Aktuální časové razítko UTC '{{now() |
| disconnectReason | Důvod odpojení hovoru. Vlastnost isError musí být nastavena na true , aby se správně zobrazovala. |
Nastavení analýzy
Žádný.
Odkazy
- Vytvoření soukromého klíče a digitálního certifikátu podepsaného svým držitelem
- Konfigurace připojené aplikace pro Webex Contact Center konektor Salesforce
- Nastavení integračních konektorů pro Webex Contact Center - Salesforce
- Cisco Webex Contact Center Průvodce nastavením a správou > Flow Designer
- Integrace telefonního subsystému REST API
Jazykový překlad
(Volitelné) Povolit překladovou pracovní plochu
Toto nastavení platí pouze v případě, že používáte nastavení jazyka překladu.
| 1 |
Přejděte do části Nastavení nástroje → Translation Workbench → Nastavení jazyka překladu. |
| 2 |
Kliknutím na tlačítko Povolit vyberte jazyk překladu.
|
(Volitelné) Povolit jazyky pouze pro platformu
Toto nastavení platí pouze pro jiné jazyky než EN-US.
| 1 |
Přejděte na Nastavení → Nastavení společnosti → Nastavení jazyka. |
| 2 |
Zvolte požadované jazyky. |
| 3 |
Zaškrtněte následující políčka:
|
| 4 |
Uložte provedené změny.
|
Aktivujte jazyk a vyberte uživatele (úkol)
| 1 |
Přejděte do části Nastavení nástroje → Translation Workbench → Nastavení jazyka překladu. |
| 2 |
Vyberte jazyk a vyberte uživatele, který jej bude překládat. |
| 3 |
Uložte provedené změny.
|
Vícejazyčná nastavení
Překlad vlastních štítků
| 1 |
Přejděte na Nastavení → vlastních štítků. |
| 2 |
Vyberte název vlastního štítku, který chcete otevřít.
|
| 3 |
V souvisejícím seznamu Překlady klepněte na tlačítko Nový |
| 4 |
Vyberte jazyk, do kterého překládáte.
|
| 5 |
Přeloženou hodnotu zadejte do pole Text překladu. Tento text přepíše hodnotu zadanou v poli Hodnota popisku, pokud je výchozím jazykem uživatele jazyk překladu. |
| 6 |
Uložte provedené změny. |
Oprávnění Salesforce vyžadovaná funkcí uživatele
Sada oprávnění agenta Webex Contact Center SCV obsahuje všechna oprávnění potřebná pro práci s miniaplikací Webex Contact Center a integracemi vyvinutými pro agenty.
Přístup třídy Apex (sekce)
- cisco_wxcc_scv. CiscoScvWxcc
- cisco_wxcc_scv. ServiceResponseHandler
- cisco_wxcc_scv. ServiceRouting
- cisco_wxcc_scv. TelephonyIntegrationHandler
Přístup k vlastnímu typu metadat (sekce)
- cisco_wxcc_scv. Připojení WxCC
Visualforce Page Access (sekce)
- cisco_wxcc_scv. CiscoScvLoginWxCC
- cisco_wxcc_scv. CiscoScvMainWxCC
- cisco_wxcc_scv. CiscoScvOAuthRedirect
- cisco_wxcc_scv. CiscoScvSwLoader
Hlasová obálka služby Service Cloud API
Předpoklady
Aby bylo možné použít obálku Service Cloud Voice API, musí být nakonfigurovaná aplikace externího klienta Salesforce pro integraci IVR.
Použití obálky Service Cloud Voice API
Service Cloud Voice (SCV) pro Salesforce používá REST API integrace telefonního subsystému k vytváření a aktualizaci hlasových hovorů, provádění toků Omni-Channel a odstraňování záznamů PendingServiceRouting přidružených k hlasovému volání. Tato služba vyžaduje autorizaci JWT a použití metody HTTP PATCH, která není v současné době podporována Cisco IP Interactive Voice Response (IVR).
Aby se zjednodušilo použití REST API integrace telefonního subsystému pro SCV (nejen) v systému IVR, byla zpřístupněna nová sada rozhraní API, která zabalují stávající Salesforce API a jsou přístupná přímo z organizace Salesforce, kde je nainstalován balíček Webex Contact Center pro Service Cloud Voice.
Service Cloud Voice API Wrapper odstraňuje potřebu ověřování tokenu JWT, implementuje další kontroly dat vyžadovaných službou Salesforce API a vylepšuje objekty odpovědí.
Načtení Access_Token
Provedení požadavku a POST na https://<your-domain-name>.my.salesforce.com/services/oauth2/token
Odesílání následujících parametrů do těla:
{ "grant_type": "client_credentials", "client_id": "<spotřebitelský klíč připojené aplikace>", "client_secret": "<spotřebitelský tajný klíč připojené aplikace>" } Pokud je požadavek úspěšný, vrátí se následující odpověď 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>" }
Provedení požadavků
Adresa URL instance musí obsahovat my.salesforce.com.
Příklad správné instance url: https://abc-123.my.salesforce.com
Použití jakékoli jiné domény jako adresy URL instance (tj. https://abc-123.lightning.force.com ) má za následek stav 401 Unauthorized s vráceným INVALID_SESSION_ID errorCode.
Vytvořit hlasový hovor (sekce)
Vytvoří záznam VoiceCall obsahující účastníky (tj. volajícího a příjemce) pro záznam VoiceCall. Když vytvoříte záznam hlasového hovoru, vytvoří se konverzace ve službě Salesforce. Tento API používejte pouze v kontextu v reálném čase, což znamená, že byste měli vyvolat tento API pouze při zahájení volání. Tento API lze také použít k vytvoření záznamů hlasových hovorů pro přepojování a konferenční hovory zahrnutím parametru parentVoiceCallId do datové části požadavku.
Koncový bod URI
<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/createVoiceCall
HTTP – metoda
POST
Záhlaví
Autorizace: Nositel <access_token>
Content-Type: application/json
Parametry
{ "callCenterDevName": "contactCenterDevName123", "certDevName": "certDevName123", "vendorCallKey": "5324881f-1e84-4367-8930-f69a74b30ca6", "to": "8002345678", "from": "4081456688", "initiationMethod": "Inbound", "startTime": "2019-07-02T17:32:28Z", "účastníci": [ { "participantKey": "4081456688", "type" : "END_USER" } ], "callAttributes": "{\"devscv24__AAA_Test__c\":\"hodnota pole\",\"Other_Field__c\":\"jiná hodnota\"}", "parentVoiceCallId": "fsdfzuhsdfsa-43556fgef3-56g44gv4ew", "callOrigin": "Náhled", "fronta": "queue123" }
Odpověď (úspěšná)
{ "data": { "voiceCallId": "00X000012345abc" }, "errors": null, "success": true }
Odpověď (s chybami)
{ "data": null, "chyby": ["Chybová zpráva 1", "Chybová zpráva 2"], "úspěch": false }
Aktualizace hlasového hovoru
Aktualizuje hlasový hovor po skončení hovoru. Pomocí tohoto API můžete aktualizovat parametry související s voláním, které nejsou k dispozici během fáze vytváření hlasového hovoru. Aktualizace hlasového volání API je asynchronní operace. Nemůžete se dotazovat na stav volání API.
Tento koncový bod lze také použít k vytvoření hlasového hovoru i po jeho skončení. Toto chování je užitečné ve scénářích, kdy chcete do služby Salesforce zaznamenat záznam o opuštěných nebo zmeškaných hovorech, nebo v jakémkoli jiném scénáři, kdy hlasové volání ještě nebylo vytvořeno.
Koncový bod URI
<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/updateVoiceCall
HTTP – metoda
POST
Záhlaví
Autorizace: Nositel <access_token>
Content-Type: application/json
Parametry
{ "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\":\"hodnota pole\",\"Other_Field__c\":\"jiná hodnota\"}", "disconnectReason": { "value": "TELECOM_PROBLEM", "isError": true } }
Podrobný popis parametrů přijatých touto žádostí naleznete v oficiální dokumentaci Salesforce v sekci "Parametry".
Odpověď (úspěšná)
{ "data": { "status": "pending" }, "errors": null, "success": true }
Aktualizace hlasového volání API je asynchronní operace. Nemůžete se dotazovat na stav volání API.
Odpověď (s chybami)
{ "data": null, "chyby": ["Chybová zpráva 1", "Chybová zpráva 2"], "úspěch": false }
Spuštění Omni-flow
Spustí tok Omni-Channel pro směrování hovorů. Předá volání ID (Salesforce VoiceCallId nebo ContactId dodavatele telefonie) jako parametry toku a vrátí agentovi nebo pokyny pro směrování fronty do toku kontaktu. Ve výchozím nastavení používá služba Service Cloud Voice omnikanálový tok (nebo záložní frontu) určený pro telefonní kanál, který odpovídá volanému číslu. Pokud volané číslo neodpovídá existujícímu telefonnímu kanálu, můžete volitelně nastavit nové vytáčené číslo, tok omnikanálu a záložní frontu jako vstupní parametry tohoto volání API.
Service Cloud Voice používá ke směrování hovorů toto pořadí přednosti:
- Použije nastavení Omnikanálový tok a záložní fronta pro telefonní kanál, který odpovídá volanému číslu. Tok má přednost. Pokud tok selže, použije se záložní fronta.
- Používá parametry flowDevName a fallbackQueue zadané ve volání Execute Omniflow API.
Koncový bod URI
<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/executeOmniFlow
HTTP – metoda
POST
Záhlaví
Autorizace: Nositel <access_token>
Content-Type: application/json
Parametry
{ "callCenterDevName": "contactCenterDevName123", "certDevName": "certDevName123", "voiceCallId": "00X000012345abc", "dialedNumber": "+18445791189", "flowDevName": "Route_VoiceCall", "fallbackQueue": "00G111222333444", "flowInputParameters": { "Input1": "one", "Input2": "two" } }
- Parametr voiceCallId je Salesforce voiceCallId nebo kontakt dodavatele telefonního subsystému ID.
- Podrobný popis parametrů přijatých touto žádostí naleznete v oficiální dokumentaci Salesforce v sekci "Parametry".
Odpověď (úspěšná)
{ "data": { "queue": "queue info", "agent": "agent info" }, "errors": null, "success": true }
AGENT_INFO a QUEUE_INFO odpovídají poli ExternalId v mapě CallCenterRoutingMap
Odpověď (s chybami)
{ "data": null, "chyby": ["Chybová zpráva 1", "Chybová zpráva 2"], "úspěch": false }
Vymazat směrování
Odstraní záznam PendingServiceRouting (PSR) pro hlasové volání. Tento API nemusí být volán pro většinu scénářů; záznam PSR se automaticky odstraní, jakmile hovor již není směrován. Existují však některé scénáře, například pro zmeškané nebo opuštěné hovory při použití partnerských telefonních systémů, kde je nutné explicitně volat tento API pro vymazání záznamu PSR.
Koncový bod URI
<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/clearRouting
HTTP – metoda
POST
Záhlaví
Autorizace: Nositel <access_token>
Content-Type: application/json
Parametry
{ "callCenterDevName": "contactCenterDevName123", "certDevName": "certDevName123", "voiceCallId": "00X000012345abc" }
- Parametr voiceCallId je Salesforce voiceCallId nebo kontakt dodavatele telefonního subsystému ID.
- Podrobný popis parametrů přijatých touto žádostí naleznete v oficiální dokumentaci Salesforce v sekci "Parametry".
Odpověď (úspěšná)
{ "data": { "status": "Success" }, "errors": null, "success": true }
Odpověď (s chybami)
{ "data": null, "chyby": ["Chybová zpráva 1", "Chybová zpráva 2"], "úspěch": false }
Překlady telefonních čísel
Různé interakce mezi hlasovou službou Service Cloud a Webex Contact Center závisí na překladech telefonních čísel. Vzhledem k mezinárodním rozdílům a aplikacím specifickým pro zákazníka je zapotřebí přizpůsobitelný nástroj pro přenos telefonních čísel z formátu A do formátu B.
Řešení Webex Contact Center pro Service Cloud Voice automaticky odebere všechny znaky kromě čísel, hashtagů (#), hvězdiček (*), čárek (,) a počátečních znamének plus (+). Odstraní také první výskyt (0). To bude provedeno PŘED použitím překladů telefonního čísla.
Tato příručka popisuje, jak nakonfigurovat překlady telefonních čísel.
Pole
Překlady telefonních čísel jsou uloženy v polích název-hodnota. To vám umožní konfigurovat neomezené množství pravidel pro každou funkci.
Konfigurace se uloží jako řetězec JSON.
Všimněte si, že zpětná lomítka musí být escapována, např. \d+ se změní na \\d+.
{"Odstranit všechny znaky kromě číslic":"[1,17]->[^\\d]+","Na interní číslo":"[7,17]->(\\d{7})(\\d{4})->$2"}
Pole Název se technicky nepoužívá. Je zde přidání lidsky čitelného řetězce, aby bylo možné rychle identifikovat účel tohoto pravidla. Dobré názvy jsou například: Odstraňte všechny úvodní nuly, přidejte úvodní plus atd.
Vytváření pravidel překladu
Pravidla jsou poskytována jako regulární výrazy. Přesněji: Implementace regulárních výrazů v JavaScriptu.
Dobrým způsobem, jak začít, je přečíst si dokument RegExp z webových dokumentů MDN.
Vytváření složitých regulárních výrazů je však často těžkopádné. Proto jsme přidali další syntaxi, aby byla konfigurace co nejjednodušší.
Následující obrázek ukazuje obecnou syntaxi pravidla překladu telefonního čísla:
Predikátu
Predikát se používá k určení intervalu definujícího délku odpovídajícího čísla.
Výše uvedený predikát určuje, že všechna čísla s délkou mezi 7 a 11 znaky (včetně hran + mezer) se shodují.
Predikáty vždy odpovídají původní délce čísla. To pomáhá zjednodušit konfiguraci tím, že snižuje riziko kolize pravidel pro interní / externí čísla.
Vzor
Vzor určuje formát odpovídajícího čísla.
Výše uvedený vzor uvádí, že číslo se musí skládat pouze z číslic a vybírá je.
Volič
Selektory definují konečný formát čísla. Pokud je třeba přidat znaky / číslice, které původně nebyly přítomny, je to místo, kde to můžete udělat.
Selektor je posledním krokem při vytváření čísla. Na základě výstupu vzoru selektor vytvoří nové číslo.
Příklad 1
Následující příklad ukazuje, jak převést číslo přijaté z kontaktního centra ve formátu 0319175200 do švýcarského formátu E164 +41 31 917 52 00.
V tomto příkladu jsou použita dvě pravidla překladu (1. a 2.)
První pravidlo v tomto příkladu ve skutečnosti číslo nemění. U čísel o délce 1 až 17 znaků bude odstraněno cokoli jiného než číslice. Vzhledem k tomu, že není přítomna žádná číslice, nic se nemění.
Druhé pravidlo platí pro čísla, která jsou přesně 10 znaků dlouhá (původně). 0319175200 se shoduje, a proto se pravidlo použije. Vzor určuje, že číslo musí začínat skupinou jedné číslice (\d{1}), následovanou skupinou dvou číslic (\d{2}), následovanou skupinou tří číslic (\d{3}) atd.
Selektor pak přistupuje ke skupinám vzorů a definuje nový číselný řetězec. To znamená, že $2 odkazuje na první (\d{2}) a proto obsahuje 31.
Příklad 2
Následující příklad ukazuje, jak přenést číslo přijaté z Kontaktního centra ve formátu +14693150217 do amerického formátu E164 +1 469 315 0217.
V tomto příkladu jsou použita dvě pravidla překladu (1. a 2.)
- Toto číslo má přesně 12 znaků, proto platí pravidlo "Přidat mezery k americkým číslům".
- (\+1) říká, že číslo musí začínat +1. Pokud je číslo dlouhé 12 znaků, ale nezačíná +1, pravidlo se zruší a nic se nezmění.
- (\d{3}) říká, že +1 musí být následováno 3 číslicemi.
- (\d{3}) říká, že za posledními 3 číslicemi musí následovat další 3 číslice.
- (\d{4}) říká, že za posledními 3 číslicemi musí následovat 4 číslice.
Pokud se něco z toho neshoduje, číslo se nezmění.
Všechna pravidla tedy platí pro "+14693150217". Proto je číslo změněno o "$ 1 $2 $3 $4":
- $1 odkazuje na skupinu (\+1), číslo, které se má odeslat do služby Service Cloud Voice, vypadá jako +1.
- $2 odkazuje na první ze dvou (\d{3}), číslo odesílané do služby Service Cloud Voice vypadá takto: +1 469.
- $3 odkazuje na druhou ze dvou (\d{3}), číslo, které se má odeslat do služby Service Cloud Voice, vypadá takto: +1 469 315.
- $4 odkazuje na poslední skupinu (\d{4}), číslo, které se má odeslat do služby Service Cloud Voice, vypadá takto: +1 469 315 0217.
Mezery v náhradní části pravidla "$1 $2 $3 $4" se používají přímo. Takže pokud použijete "$1-$2-$3-$4", číslo bude přeloženo na: +1-469-315-0217
Můžete také odstranit skupiny: [12, 12]->(\+1)(\d{3})(\d{3})(\d{4})->$2 $3 $4 bude přeloženo na: 469 315 0217. [12, 12]->(\+1)(\d{3})(\d{3})(\d{4})-> $3 $4 bude přeloženo na: 315 0217.
Je také možné převést mezinárodní americké číslo na místní, například: [12, 12]->(\+1)(\d{3})(\d{3})(\d{4})->($2) $3-$4.
Poté bude příchozí číslo "+14693150217" přeloženo na: (469) 315-0217.
Příklad 3
Následující příklad ukazuje, jak převést číslo přijaté z kontaktního centra ve formátu +491515555531 do německého formátu E164 +49 151 5555 531.
V tomto příkladu jsou použita dvě pravidla překladu (1. a 2.)
- Toto číslo má přesně 13 znaků, proto platí pravidlo "Přidat mezery k německým číslům".
- (\+49) říká, že číslo musí začínat +49. Pokud je číslo dlouhé 13 znaků, ale nezačíná +49, pravidlo se zruší a nic se nezmění.
- (\d{3}) říká, že +49 musí být následováno 3 číslicemi.
- (\d{4}) říká, že za posledními 3 číslicemi musí následovat 4 číslice.
- (\d{3}) říká, že za posledními 4 číslicemi musí následovat 3 číslice.
Pokud se něco z toho neshoduje, číslo se nezmění.
Takže všechna pravidla platí pro "+491515555531". Proto je číslo změněno o "$ 1 $2 $3 $4":
- $1 odkazuje na skupinu (\+49), číslo, které se má odeslat do služby Service Cloud Voice, vypadá takto: +49.
- $2 odkazuje na první ze dvou (\d{3}), číslo, které se má odeslat do služby Service Cloud Voice, vypadá takto: +49 151.
- $3 odkazuje na druhou ze dvou (\d{4}), číslo odesílané do služby Service Cloud Voice vypadá jako +49 151 5555.
- $4 odkazuje na poslední skupinu (\d{3}), číslo, které se má odeslat do služby Service Cloud Voice, vypadá takto: +49 151 5555 531.
Totéž platí pro pravidlo jedna. Můžete použít náhradní díl $1 $2 $3 $4 k výběru toho, co chcete z čísla použít.
Další příklady regulárních výrazů překladu
| Popis | Regulární výraz v překladu |
|---|---|
| Odebrání všech znaků kromě číslic | [1,17]->[^\d]+ |
| Odstraňte všechny znaky kromě číslic & + | [1,17]->[^+\d]+ |
| Popis | Regulární výraz v překladu |
|---|---|
| Odebrat +1 | [12,12]->(.{ 1})(\d{1})(\d{10})->$3 |
| Odebrat +1 | [10,12]->(^\+1+)(\d+)->$2 |
| Odebrat +49 | [10,15]->(^\+49+)(\d+)->$2 |
| Odebrat +49 | [10,15]->(.{ 1})(\d{2})(\d{9})->$3 |
| Odebrat +41 | [10,13]->(^\+41+)(\d+)->$2 |
| Odebrat +41 | [10,13]->(.{ 1})(\d{2})(\d{9})->$3 |
| Odebrat +XX | [10,14]->(^\++)(\d{2})(\d+)->$3 |
| Popis | Regulární výraz v překladu |
|---|---|
| Odstraňte + a nahraďte jej nulami US E164 | [10,12]->(.{ 1})(\d{1})(\d{10})-> 001 $3 |
| Odstraňte +1 a nahraďte jej nulami US E164 | [10,12]->(^\+1+)(\d+)-> 001$2 |
| Odstraňte + a nahraďte jej nulami DE E164 | [12,15]->(.{ 1})(\d{2})(\d{10})-> 0049 $3 |
| Odstraňte +49 a nahraďte jej nulami DE E164 | [10,12]->(^\+49+)(\d+)-> 0049$2 |
| Odstraňte + a nahraďte jej nulami CH E164 | [10,13]->(.{ 1})(\d{2})(\d{9})-> 0041 $3 |
| Odstraňte +41 a nahraďte jej nulami CH E164 | [10,12]->(^\+41+)(\d+)-> 0041$2 |
| Popis | Regulární výraz v překladu |
|---|---|
| Americké číslo s mezerou | [12,17]->(\d{1})(\d{3})(\d{3})(\d{4})->+1 $2 $3 $4 |
| Americké číslo s mezerou | [12,17]->(\+1)(\d{3})(\d{3})(\d{4})->$1 $2 $3 $4 |
| Číslo DE s mezerou | [12,17]->(\d{2})(\d{3})(\d{4})(\d{3})->+49 $2 $3 $4 |
| Číslo DE s mezerou | [12,17]->(\+49)(\d{3})(\d{4})(\d{3})->$1 $2 $3 $4 |
| Číslo CH s mezerou | [12,17]->(\d{2})(\d{2})(\d{3})(\d{2})(\d{2})->+41 $2 $3 $4 |
| Číslo CH s mezerou | [12,17]->(\+41)(\d{2})(\d{3})(\d{2})(\d{2})->$1 $2 $3 $4 |
Konfigurace stránky hlasového volání
Konfigurace stránky záznamu hlasových hovorů
Stránka záznamu hlasového volání je ve výchozím nastavení předkonfigurována s rozložením 3 sloupců a následujícími součástmi:
- Akce a doporučení
- Poznámky k hovoru
- Podrobnosti hovoru
- Nahrávky
Komponenty lze libovolně odebírat nebo přidávat na stránku v závislosti na obchodních potřebách. Lze také použít různá rozvržení stránky, ale některé komponenty, například přehrávač nahrávání hovorů a tělo konverzace, se vejdou pouze do středních a velkých oblastí v šabloně.
Zobrazení komponenty Důvod zabalení
Komponenta Důvod zabalení musí být zobrazena během hovoru a během zabalení.
Přidejte komponentu Cisco Wrap-Up Reason na stránku záznamu hlasového hovoru:
- Přetáhněte webovou komponentu Cisco Wrap-Up Reason Lightning z oblasti Vlastní v seznamu Lightning Components na stránku záznamu hlasových hovorů.
- Klikněte na položku Uložit.
- Klikněte na Aktivovat.
- Klikněte na Přiřadit jako výchozí nastavení organizace.
- Klikněte na položku Uložit.
- Znovu klikněte na Uložit a pak se kliknutím na šipku zpět vraťte na stránku.
Komponenta Cisco Wrap-Up Reason se během hovoru a během WrapUp automaticky zobrazí:
Je-li komponenta Cisco Wrap-Up Reason přidána na stránku, zobrazí se pro každý hovor také v případě, že v Cisco Contact Center není nastavena žádná možnost Wrap-Up.
Zobrazení přehrávače nahrávání hovorů
Přehrávač nahrávání hovorů se zobrazí, pokud byl pro odpovídající hlasový hovor uložen odkaz pro nahrávání.
Chcete-li přidat komponentu přehrávače nahrávání hovorů na stránku záznamu hlasového hovoru, postupujte takto:
- Přetáhněte webovou komponentu Lightning přehrávače nahrávání hovorů na stránku záznamu hlasového hovoru
- Klikněte na Uložit.
- Klikněte na Aktivovat.
- Klikněte na Přiřadit jako výchozí nastavení organizace.
- Klikněte na Uložit.
- Znovu klikněte na Uložit a pak se kliknutím na šipku zpět vraťte na stránku.
Webex Správci
Konfigurace toku
Automaticky otevírané okno
Uzel "Screen Pop" je k dispozici v toku Webex Contact Center. Lze jej použít ke spuštění vyskakovacího okna obrazovky uvnitř služby Service Cloud Voice nebo v samostatném okně.
Další informace o této funkci naleznete v dokumentaci k aplikaci Flow Designer.
Pop obrazovky v samostatném okně
Chcete-li otevřít pop obrazovky v samostatném okně, musí být v uzlu "Screen Pop" zadána absolutní adresa URL. Parametry dotazu budou připojeny jako parametry vyhledávání k adrese URL.
Podporovány jsou následující režimy:
- Nový prohlížeč Tab - Vždy otevře nový prohlížeč Tab.
- Existující prohlížeč Tab - Na první obrazovce Tab existujícího prohlížeče se otevře nový prohlížeč Tab. Tento Tab bude vyhrazený Tab pro následné zobrazení obrazovky Tab existujícího prohlížeče a adresa URL bude obnovena v rámci tohoto konkrétního prohlížeče Tab.
- Inside Desktop - Zpracovává se stejným způsobem jako Nový prohlížeč Tab.
Aktuálně otevřená stránka může zabránit přesměrování. V takovém případě se v novém prohlížeči Tab otevře obrazovka Tab existujícího prohlížeče.





