- Начало
- /
- Статия
Webex Contact Center за услугата на Salesforce Cloud Voice интегрира стабилния CCaaS на Cisco (Contact Center като услуга) с CRM на Salesforce, което позволява на бизнеса да управлява многоканалните взаимодействия с клиенти (гласови, цифрови) в интерфейса на Salesforce, като използва Webex AI за виртуални агенти, препис и интелигентно маршрутизиране, трансформирайки агентите в „супер агенти“ с унифицирани данни за по-добро изживяване на клиентите.
Общ преглед
Webex Contact Center за гласови услуги в облака на услугата Salesforce
Webex Contact Center за услугата Cloud Voice е решение за интегриране извън кутията, което внася силата на Webex Contact Center в конзолата на агентите за Salesforce Service Cloud Voice Omni-канал.
Преди да продължите инсталирането, вижте следния раздел:
за да научите за предварителните изисквания и ограниченията за Salesforce Service Cloud Voice и да се уверите, че вашата организация на Salesforce е готова да разреши и инсталира пакета Webex Contact Center за услугата Cloud Voice.
Предварителни изисквания и ограничения
Предварителни изисквания (подтема)
Потребителски интерфейси: Услугата Cloud Voice е налична само в Salesforce Lightning Experience.
Услугата Cloud Voice е налична в тези издания.
- Предприятие
- Неограничено
- Разработчик
Лицензи
-
Клиентите трябва да закупят новия лиценз за добавка A-SF-VOICE за всеки влязъл агент в допълнение към лицензите Flex 3 Standard или Premium за Webex Contact Center. За повече информация вижте ръководството за поръчки на Flex 3.
- Salesforce глас за телефония на партньор
Преди да включите Voice, трябва да настроите услугите за предварителни изисквания във вашата организация.
- Придвижете се до Информация за фирмата > Задаване на лиценз за разрешение
- Проверете за Потребител на гласова услуга в облака (партньорска телефония).
Всички издания на разработчици вече се предлагат с 5 лицензи за телефония на партньори, налични за тестване.
- Проверете за Потребител на гласова услуга в облака (партньорска телефония).
- Като алтернатива, можете да потвърдите това, като отидете в настройката на Salesforce и потърсите „voice“ в лявата странична лента.
- Ако се появи Центрове за контакти за телефония на партньори, имате SCV лиценз.
- Ако опцията Центрове за контакти за телефония на партньори не се вижда, тогава „Разрешаване на глас за услугата в облака“, като следвате стъпките по-долу.
- Отидете в „Настройка на Salesforce“ и потърсете и изберете „Настройка на телефония на партньор“ и превключете бутона, за да „Активиране на service Cloud Voice“.
- Активирайте Omni-Channel, за да позволите на агентите ви да извършват и получават повиквания.
- Отидете в „Настройка на Salesforce“ и потърсете и изберете „Настройка на телефония на партньор“ и превключете бутона, за да „Активиране на service Cloud Voice“.
Разрешаване на Omni-канал
Ако Omni-Channel вече е разрешен във вашата организация, пропуснете тази стъпка.
- От настройката въведете Omni-Channel Settings в полето \„Бързо търсене\“, след което изберете Omni-Channel Settings.


- Избор Enable Omni-Channel.
- Щракнете върху Save.
Ограничения
- Гласът е достъпен само в Lightning Experience.
- „Глас“ се поддържа в облака за услуги и облака за продажби като допълнителен лиценз.
- Voice не се поддържа на Salesforce Mobile или на iPad Safari.
- Voice се поддържа само на уеб браузърите Google Chrome, Microsoft Edge (Chromium) и Mozilla Firefox. Бисквитките трябва да са активирани, за да позволяват еднократна идентификация (SSO).
- Стандартната навигация не се поддържа.
- Телефонията е силно регулирана, така че попитайте вашия представител на Salesforce за наличността на гласови услуги във вашия регион.
Изисквания
Кодове на престой
Намиране на кодове за неактивност
| 1 |
Влезте в портала за управление. |
| 2 |
Навигирайте до Contact Center > DESKTOP EXPERIENCE > Idle/Wrap-up Codes. |
| 3 |
Уверете се, че кодовете за неактивност са показани, в противен случай щракнете върху падащия бутон на филтъра и изберете Idle Code в горната част на страницата. |
| 4 |
Щракнете върху код за неактивност, за да отворите подробния изглед. Там можете да намерите ИД на кода за неактивност.
ИД могат да се копират и след това да се използват за конфигурацията на съпоставяне на състоянието на присъствие. Един от ИД трябва да се използва като причина за По подразбиране за Cisco Not Ready. |
Интегрират
Инсталиране
Преди да продължите инсталирането, вижте раздела Предварителни изисквания и ограничения, за да научите за предварителните изисквания и ограниченията на облака за услугата на Salesforce.
Инсталиране и конфигуриране на Webex Contact Center за гласова услуга в облака
Когато се получи лиценз за Глас на услугата в облака за партньорска телефония, страницата Настройка на партньорска телефония се появява в менюто за настройка.
Повече информация можете да намерите в официалната препратка на Salesforce (директна връзка).
| 1 |
От настройката въведете
|
| 2 |
Разрешаване Turn on Voice with Partner Telephony. The Partner Telephony Contact Centers страницата се появява в Setup меню.
Ако планирате да разположите пакета в пясъчна кутия на Salesforce, сменете
|
Инсталиране на пакета
За да инсталирате пакета:
| 1 |
Отворете предоставената връзка към пакета, за да започнете инсталирането. |
| 2 |
Влезте в организацията на Salesforce, където трябва да се инсталира пакетът. |
| 3 |
В съветника за инсталиране изберете опцията за защита „Инсталиране само за администратори“ (1) и щракнете върху Инсталиране (2). Определете кои потребители получават определени разрешения за обектите и компонентите, които се предлагат с пакета Webex Contact Center за услугата Cloud Voice. Освен това им дайте тези разрешения; зададените разрешения, които идват с пакета Webex Contact Center за услугата Cloud Voice помагат на този процес. Съветник за инсталиране на пакет – появява се приветственият екран: Инсталационният пакет не е достъпен директно чрез Salesforce AppExchange. Клиентите трябва да използват бутона „Получете сега“ на списъка на AppExchange, който отваря формуляр за контакт, за да заявят връзката за инсталиране на връзката и активирането на Cisco. |
| 4 |
Дайте следните разрешения, зададени на поне един потребител, за да можете да създадете център за контакти:
|
| 5 |
Щракнете върху Настройка | Потребители | Потребители. |
| 6 |
Търсене и избор на потребител. |
| 7 |
Превъртете надолу до \„Зададени с разрешение\“. |
| 8 |
Щракнете върху Edit Assignments |
| 9 |
За администратори на Contact Center: задайте зададено разрешение за администратор на Contact Center (партньорска телефония).
|
| 10 |
За Агенти за Contact Center: задайте зададеното разрешение за Агент за Contact Center (телефония на партньор) и зададеното разрешение за агент на SCV за Webex Contact Center.
Не се препоръчва да изберете Install for All Users опция, тъй като това предоставя всички разрешения (четене, създаване, редактиране и изтриване) на компонентите и обектите на пакета на всеки потребител, който използва потребителски профил. |
| 11 |
Задайте лиценз на пакет, за да могат потребителите да работят с Connects for Service Cloud Voice.
|
| 12 |
Можете също да щракнете върху Настройка | Потребители | Потребители.. |
| 13 |
Потърсете и изберете потребител. |
| 14 |
Превъртете надолу до Managed Packages. |
| 15 |
Щракнете върху Assign Licenses. |
| 16 |
Избери Webex Contact Center for Service Cloud Voice пакет от списъка. |
| 17 |
Щракнете върху Add. |
| 18 |
Създайте статусите на присъствие, за да определите кои канали за услуги са зададени на различните статуси. Агентите могат да влизат в Omni-Channel с различни статуси в зависимост от вида на работата, която имат право да получават. |
| 19 |
От настройката въведете
|
| 20 |
Щракнете върху New. Създайте поне един статус за \„Онлайн\“ и един за \„Зает\“.
|
Задайте статусите на присъствие на агенти
| 1 |
От „Настройка“ въведете „Задаване на разрешение“ в полето „Бързо намиране“, след което изберете „Задаване на разрешение“. |
| 2 |
Щракнете, за да отворите Partner Telephony Permission Set. |
| 3 |
Щракнете върху Service Presence Statuses Access. |
| 4 |
Щракнете върху Edit. |
| 5 |
В Available Service Presences списък, изберете създадените преди това статуси на присъствие и щракнете върху Add за да ги свържете със зададеното разрешение. Агентите, които са зададени на това зададено разрешение, могат да влизат в Omni-Channel с някой от статусите на присъствие, които са им предоставени. |
| 6 |
Щракнете върху Save. |
| 7 |
Щракнете върху Manage Assignments на същата страница. След това щракнете Add Assignment в горния десен ъгъл изберете желания потребител, щракнете върху Next, изберете Expiration Option за зададените потребители (по избор) и след това щракнете върху Assign. Service Cloud Voice използва външен домейн за работа със записа на VoiceCall. Следните URL адреси трябва да се добавят към „Настройки на отдалечен сайт“ в настройката (щракнете тук, за да отворите официалната документация):
Пример: Как се намира URL адрес на екземпляр. |
| 8 |
След влизане погледнете URL адреса в адресната лента на браузъра си. URL адресът на екземпляра е частта преди \„.my.salesforce.com\“ или \„.salesforce.com\“ или .\“lightning.force.com. Например, ако вашият URL адрес е https://orgfarm-54a38e30ad-dev-ed.develop.my.salesforce-setup.com/, тогава „orgfarm-54a38e30ad-dev-ed.develop“ е вашият URL адрес за екземпляр. Пример: URL адрес на организацията източник: https://cisco.lightning.force.com Пример: URL адрес за добавяне:
|
| 9 |
Елементът на помощната програма Omni-Channel се изисква в приложението Lightning Service Console, за да може агентът да използва Service Cloud Voice.
Официалната препратка от Salesforce може да бъде намерена, като щракнете върху Let's Do This бутон, който отваря страницата Конфигуриране на опита на агента за обслужване на облак за глас с партньорска телефония в портала за помощ на Salesforce (директна връзка). |
| 10 |
От настройката въведете Partner Telephony Setup в полето \„Бързо търсене\“, след което изберете Partner Telephony Setup. |
| 11 |
Превъртете надолу до раздела 5 More Voice Settings. |
| 12 |
За да Активирате защита чрез clickjack за страниците на Visualforce със забранени заглавки, докато работите със софтуерен телефон в Lightning Experience, трябва да добавите домейните, от които софтуерният телефон и персонализираните ленти с инструменти се зареждат като надеждни домейни, в допълнение към URL адреса на екземпляра на Salesforce. Тези настройки и списъкът с надеждни домейни могат да бъдат намерени под Настройка | Защита | Настройки на сесия. За да извлечете правилния домейн на Visualforce, отидете на Настройка | Персонализиран код | Страници на Visualforce и щракнете върху бутона за визуализация за
Пример: Име на моя домейн – cisco_wxcc_scv.vf.force.com За да получите домейна на екземпляра на Salesforce, копирайте URL адреса, показан в URL лентата на браузъра, и я добавете към Trusted Domains for Inline Frames List избор на списък Visualforce Pages като тип IFrame. Пример: MyDomainName.lightning.force.com
Ако нямате внедрен \„Моят домейн\“ във вашата организация, форматът на URL адреса ви е различен. Ако имате разположен \„Моят домейн\“ и подобрените домейни не са разрешени във вашата организация, форматът на URL адреса ви е различен. Ако подобрените домейни не са разрешени, настройката за стабилизиране на URL в Visualforce, Experience Builder, Site.com Studio и файловете за съдържание Моят домейн също оказва влияние върху този формат. За подробности вижте Формати на URL адреса на моя домейн в помощта на Salesforce. Настройки за защита на Clickjack и надеждни домейни за Lightning Experience
|
| 13 |
За да покажат контролите за запис по време на повиквания, агентите се нуждаят от
За да го зададете, добавете към зададеното разрешение, създадено в стъпка Статуси на присъствие.
|
Конфигурация
Contact Center
Файл с дефиниции на център за контакти указва набор от полета и стойности, които се използват за дефиниране на център за контакти в Salesforce за конкретна CTI система. Salesforce използва файлове с дефиниции на Contact Center, за да поддържа интеграция с множество доставчици на CTI система.
Повече информация можете да намерите в официалната документация на Salesforce (директна връзка).
Импортиране на центъра за контакти
Изтеглете най-новата версия на Contact Center тук.
Надстройване от бета-версия: Това ръководство описва чиста инсталация на изданието за обща наличност (GA) на интеграцията на Webex Contact Center за Salesforce Service Cloud Voice.
Ако надстройвате от бета версия на интеграцията, не използвайте повторно съществуващ запис на Partner Contact Center. Вместо това:
- Импортирайте XML файла на Partner Contact Center, включен с изданието на GA.
- Създайте нов запис на Partner Contact Center с помощта на импортирания XML.
- Актуализирайте конфигурацията си, за да използвате новосъздадения Partner Contact Center.
XML на GA Partner Contact Center съдържа актуализирани стойности на конфигурацията, включително правилния URL адрес на конектор и други метаданни. Повторното използване на запис на Contact Center за партньори, създаден от бета XML, може да запази остарели стойности на конфигурацията и да попречи на правилното функциониране на интеграцията.
| 1 |
От настройката въведете Partner Telephony Contact Centers в Quick Find поле, след което изберете Partner Telephony Contact Centers. Показва се списъкът на съществуващите (ако има такива) контактни центрове.
|
| 2 |
Щракнете върху Create Contact Center от дясната страна на страницата. |
| 3 |
Избор Webex Contact Center като ваш доставчик на телефония. След това щракнете Next.
Отваря се файлов браузър.
|
| 4 |
Изберете |
| 5 |
Щракнете върху Open. Файлът е импортиран.
|
| 6 |
Проверете дали вашият център за контакти е показан в списъчния изглед на центровете за контакти.
|
Конфигуриране на центъра за контакти
| 1 |
От настройката въведете Partner Telephony Contact Centers в Quick Find поле, след което изберете Partner Telephony Contact Centers. | ||||||||||||||||||||||||||||||
| 2 |
Щракнете върху Contact Center, който е импортиран преди това. | ||||||||||||||||||||||||||||||
| 3 |
Щракнете върху Edit.
| ||||||||||||||||||||||||||||||
| 4 |
В долната част на Contact Center страница, щракнете върху Add бутон под Contact Center Users раздел. | ||||||||||||||||||||||||||||||
| 5 |
Щракнете върху + до потребителите, които имат достъп до отворения Contact Center. Само потребители с |
Персонализиране
Приложение за външен клиент за интегриране на Webex Contact Center
Конфигуриране на приложението за външен клиент за конектор за Webex Contact Center за Salesforce
За да използвате изцяло услугата Cloud Service Voice, потокът на повиквания в Contact Center може да бъде адаптиран, за да създаде запис за гласово повикване и да изпълни поток на Salesforce Omni-Channel, докато повикването е на IVR.
Създаване на сертификат
Уверете се, че вече сте създали цифров сертификат в съответствие с правилата за защита на вашата организация.
За да генерирате цифров сертификат, вижте документацията на Salesforce на адрес https://developer.salesforce.com/docs/atlas.en-us.voice_pt_developer_guide.meta/voice_pt_developer_guide/voice_pt_generate_certificate.htm.
Пример
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 => Сертификат за приложението за външен клиент на Salesforce
server.key => Частен ключ за конектора за Salesforce в Webex Control Hub
Зададено е разрешение за потребител с интеграция с SCV
Следният набор за разрешения предоставя достъп до класове Apex, използвани от конектори за SCV за интегриране с IVR потоци на Contact Center и Webex Contact Center за Salesforce за SCV.
Следва примерна конфигурация и описва минималните необходими разрешения за работа на Contact Center/IVR интеграцията.
- От „Настройка“ се придвижете до Потребители | Задавания на разрешения.
- Щракнете върху New бутон.
- Въведете етикет, например: IVR достъп до SCV Apex класове
- Името на API се попълва автоматично
- Лиценз: Няма
- Щракнете върху Save бутон.
- Отваря се новият набор за разрешения.
- Навигирайте до Apex Class Access.
- Щракнете върху Edit бутон и добавете следните класове на Apex:
- cisco_wxcc_scv.Маршрутизиране на услугата
- Навигирайте до System Permissions.
- Щракнете върху Edit бутон и активирайте следните разрешения:
- Услуги Apex REST
- API е активиран
Минимален достъп – профил за интеграции само на API
Този профил се използва за интегриране с Webex Contact Center за Salesforce за SCV за създаване на записи на гласови повиквания и изпълнение на Omni-Flow от IVR потока.
Следва примерна конфигурация и описва минималните необходими разрешения за работа на Contact Center/IVR интеграцията.
Това е клонинг от профила за минимален достъп – интеграции само с API.
- От настройката се придвижете до Потребители | Профили.
- В списъка с профили потърсете профил Минимален достъп – Интеграции само с API.
- Щракнете върху името на профила, за да отворите Minimum Access - API Only Integrations профил.
- На Minimum Access - API Only Integrations профила, щракнете върху Clone бутон.
- Въведете ново име на профил, например: Интегриране с SCV.
- Щракнете върху Save бутон.
- Отваря се новият профил.
- Потвърдете, че вашият профил за минимален достъп – интеграции само с API има всички разрешения премахнати от самия профил.
- Навигирайте до System Permissions.
- Уверете се, че следните разрешения са разрешени:
- API е активиран
- Потребител само на API
Потребител на SCV интеграция
Следва примерна конфигурация и описва минималните необходими разрешения за работа на Contact Center/IVR интеграцията. За потребителя на SCV интеграция не се изисква лиценз за гласова услуга за Salesforce или лиценз за Webex Contact Center за Salesforce за SCV.
- От „Настройка“ се придвижете до Потребители | Потребители.
- Щракнете върху New User бутон.
- Въведете собствено име, фамилно име и всички други задължителни полета.
- Лиценз на потребителя: Интеграция на Salesforce
- Профил: изберете профила, създаден в предишната стъпка („Профил за интегриране на SCV“, клонинг на Минимален достъп – профил за интегриране само на API)
- Щракнете върху Save бутон.
- Отворете новия запис на потребител.
- Задайте Permission Set създадени преди ("IVR Достъп до SCV Apex класове").
- Задайте лиценз с зададени разрешения Интегриране на Salesforce API.
Създаване на приложение за външен клиент на Salesforce
Създаване на ново приложение за външен клиент
Има две опции за свързване на вашите данни от Salesforce с приложения на трети страни. И двете Connected Apps и External Client Apps са рамки за интегриране на данни. Приложенията за външни клиенти са следващото поколение свързани приложения.
За да конфигурирате приложението за външен клиент на Salesforce, което се използва от Cisco Webex Contact Center:
- От Setup, навигирайте до Apps | External Client Apps | External Client App Manager.
- Щракнете върху New External Client App.
- External Client App—Basic Information
- Име на приложение на външен клиент: WxCC-SCV
- Име на API: WxCC_SCV
- Имейл за контакт: < вашият имейл >
- Състояние на разпространение: изберете локално

External Client App—API (Enable OAuth Settings)
- Изберете: Активиране на OAuth
- Настройки на приложението
- URL адрес за обратно повикване: http://localhost:1717/OauthRedirect като примерен URL адрес за обратно повикване
- OAuth
- Изберете скоби за OAuth:
- Управление на потребителски данни чрез API (api)
- Извършване на заявките по всяко време (refresh_token, offline_access)

Flow Enablement
- Изберете: Активиране на поток на JWT носител
- Щракнете върху \„Качване на файлове\“ и качете
server.crtфайл, който съдържа вашия цифров сертификат.

Security
Премахнете отметката от Require secret for the Web Server Flow опция.

- Щракнете върху Create бутон.
- Промяна на Tab Policies и след това щракнете върху Edit бутон.
- Правила – Правила за OAuth
- Правила на приставките
- Разрешени потребители: изберете „Одобрените от администратор потребители са предварително упълномощени“
- Потвърдете промяната
- Упълномощаване на приложения
- Правила за маркерите за обновяване: изберете „Незабавно изтичане на маркера за обновяване“
- Релаксация на IP: изберете Налагане на ограничения за IP

- Правила на приставките
- Правила – Правила за приложенията
- Начална страница – няма
- Избор на зададени разрешения – Задайте зададения преди зададен набор за разрешения („IVR достъп до SCV Apex класове“)

- Щракнете върху Save.
- Променете на „Настройки за разделите“.
-
Раздел „Настройки за OAuth“, щракнете върху Consumer Key и Secret бутон; изчакайте имейл и потвърдете самоличността си. Нов раздел на браузъра отваря екран с подробности за потребителите.

- Щракнете върху Copy и запишете Consumer Key. Потребителският ключ се използва по-късно за създаване на конектора за Salesforce в контролния център на Webex Contact Center.

-
Конфигурация и скрипт на Webex Contact Center за създаване на записи на гласови повиквания
За да се получи пълната стойност на гласовите услуги в облака на Salesforce, потокът от повиквания в Webex Contact Center трябва да бъде променен, за да се създаде запис за гласови повиквания в облака на услугата глас веднага след като повикването пристигне в Contact Center.
Опционалният Omni-Flow може да се изпълнява за решения за маршрутизиране и автоматизация в Salesforce.
За подробности относно използваните API вижте Wrapper на гласовия API в облака на услугата.
Предварителни изисквания
За да се използва wrapper на Service Cloud Voice API, трябва да се конфигурира приложение на Salesforce външен клиент за интегриране на IVR.
Конфигуриране на конектора за Salesforce в Webex Control Hub
Настройте конекторите за интегриране на Salesforce за Webex Contact Center, както е описано в статията на https://help.webex.com/en-us/article/7fuy63/Set-Up-Integration-Connectors-for-Webex-Contact-Center#id_133211.
| 1 |
Влезте във вашата организация на клиент на https://admin.webex.com и се придвижете до „Услуги > Contact Center > Настройки на клиента > Интеграции>Конектори“. |
| 2 |
На картата на Salesforce щракнете върху Настройка или Добавяне на конектор.
ВАЖНО: ПОДДЪРЖАЙТЕ ЗАЩИТАТА ЧРЕЗ ПЕРИОДИЧНО ВЪРТЕНЕ НА ТАЙНИ Уверете се, че редовно сменяте своя частен ключ и сертификат, за да поддържате интеграциите си защитени. Актуализирайте частния ключ в конектора за Contact Center в Webex Hub и сертификата в приложението за външен клиент в Salesforce. Съвет за отстраняване на неизправности След като щракнете върху Готово и конекторът не се запише:
|
Основен поток на Webex Contact Center
| Променлива на поток | Описание |
|---|---|
| Променлива на потока за ИД на запис на гласово повикване | Уникален ИД за идентифициране на повикването. Изисква се за създаване на запис за гласово повикване. Формат: wxcc_<ИД на Взаимодействие> Пример: wxcc_fc4ec7d8-4c91-49aa-b764-081fbba344a8
|
| Локална променлива за началния час на Повикването |
Използва се за създаване на запис за гласово повикване и при актуализиране на гласовото повикване.
|
| Локална променлива за име/ид на опашката |
Върнато от Изпълнение на Omni Flow, използван за маршрутизиране на повиквания. Тази променлива се изисква само когато се използва \„Изпълнение на Omni поток\“
|
| Локална променлива за име/ИД на агент |
Върнато от Изпълнение на Omni Flow, използван за маршрутизиране на повиквания. Тази променлива се изисква само когато се използва \„Изпълнение на Omni поток\“
|
Общ преглед на главния поток

- Генериране на ключ за повикване от доставчик
- Задаване на начален час на повикването
- HTTP заявка: Създаване на запис за гласово повикване
- Оценка на HTTP отговора за създаване на запис на гласови повиквания
- Обработка на грешки за създаване на запис на гласово повикване
- HTTP заявка: Изпълнение на Omni поток
- Оценка на HTTP отговор за изпълнение на Omni поток
- Обработка на грешки за Execute Omni Flow
- Продължаване с маршрутизирането на повикванията
| Поток | Описание |
|---|---|
| Генериране на ключ за повикване от доставчик |
Всяко повикване, обработено в Service Cloud Voice, създава запис за гласови повиквания в Salesforce и изисква уникален ИД, наречен ключ за повикване на доставчик. За записи за гласови повиквания, създадени в Webex Contact Center, ключът за повикване на доставчик трябва да бъде дефиниран в потока WxCC и след това предаден заедно с повикването към агента с помощта на променлива на поток. Стойността на vendorCallKey трябва да отговаря на следните правила:
|
| Задаване на начален час на повикването |
Времево клеймо в UTC на началния час на повикването. Това времево клеймо се използва за създаване на запис за гласово повикване и за актуализиране на записа за гласово повикване, ако повикващият затвори, преди да бъде маршрутизиран към агента.
|
| HTTP заявка: Създаване на запис за гласово повикване |
Тази стъпка се изисква за всяко повикване. След като записът на гласовото повикване е създаден, ИД на записа на гласовото повикване трябва да бъде предаден с повикването към агента в променлива заедно с ключа на доставчика за повикване. Конфигурирайте използваната променлива в конфигурацията на Contact Center в Service Cloud Voice. |
| Настройки на HTTP искане |
|
HTTP заявка: Създаване на запис за гласово повикване
Тази стъпка се изисква за всяко повикване. След като записът на гласовото повикване е създаден, ИД на записа на гласовото повикване трябва да бъде предаден с повикването към агента в променлива заедно с ключа на доставчика за повикване. Конфигурирайте използваната променлива в конфигурацията на Contact Center в Service Cloud Voice.
Настройки на HTTP искане
- Етикет за активност: Създаване на гласово повикване
- Използване на удостоверена крайна точка: Разрешено
- Конектор: Конектор за Salesforce, създаден на предишната стъпка
- Път на заявката:
/services/apexrest/cisco_wxcc_scv/voice/v1/createVoiceCall - Метод: POST
- Тип на съдържанието, изискано за заявката: Приложение/JSON
Тяло на заявката
Когато създавате записа на гласово повикване, можете също да актуализирате персонализирани полета на записа на гласово повикване с данни за повикванията. По-долу са дадени два примера за тялото на заявката, един с всички задължителни полета, но без актуализиране на персонализирани полета, и един с персонализирани полета.
Без актуализиране на персонализирани полета в записа на гласово повикване:
{
"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"
}
]
}
Пример с актуализиране на персонализирани полета в записа за гласово повикване:
{
"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>\"}"
}
Параметри
| Име на свойство | Стойност |
|---|---|
| callCenterDevName | Име на разработчика на Contact Center |
| certDevName | Име на API на сертификата (както е конфигурирано в центъра за контакти) |
| vendorCallKey | Уникален ИД на повикване: {{SCV_VendorCallKey}}
|
| до | НабранНомер/DNIS: {{NewPhoneContact.DNIS}}
|
| от | Номер за набиране/ANI: {{NewPhoneContact.ANI}}
|
| начален час | Времево клеймо за UTC {{SCV_CallStartTime}} (трябва да бъде зададено веднага след приемане на повикването в скрипта) |
| Атрибути на call |
Представлява допълнителни стандартни и персонализирани полета в записа на гласово повикване, където всяка двойка ключови стойности съответства на стандартно или персонализирано поле и неговите стойности. Пример:
|
Настройки за синтактичен анализ
- Тип съдържание: JSON
- Променлива на изхода: SCV_VoiceCallRecordId
- Израз на пътя:
$.data.voiceCallId
ИД на запис на гласово повикване, който да бъде предаден на агента.
Оценка на HTTP отговора за създаване на запис на гласови повиквания
Проверете HTTP състоянието на заявката за създаване на гласово повикване http:
- Етикет: statusCodeCreateVoiceCall
- Променлива: CreateVoiceCall.httpStatusCode
Ако кодът за статус == 200 => успешна иначе => заявка е неуспешна, обработката на грешка
Обработка на грешки за създаване на запис на гласово повикване
Само за демо/отстраняване на грешки, пускане на съобщение в зависимост от кода за статус http.
Ако създаването на гласово повикване е било успешно, продължете с Изпълнение на Omni Flow. В противен случай продължете с маршрутизирането на повикванията.
HTTP заявка: Изпълнение на Omni Flow (незадължителна стъпка)
Използвайте Execute Omni-Flow, когато искате да:
- изпълнете автоматизирани задачи, например търсене или създаване на записи, и свържете записите със записа за гласови повиквания
- търсене на записи и изскачащ прозорец
- Синхронизиране на опашки на Salesforce и Cisco
- нека Service Cloud Voice вземе решение за маршрутизиране
Тази заявка винаги връща „опашката“ или „агента“ към мястото, където трябва да бъде маршрутизирано повикването.
След като изпълните това искане, трябва да изпратите „Ясно маршрутизиране“, ако повикващият затвори, преди да му бъде отговорено от агент. Вижте Поток на събития в Webex Contact Center.
Настройки на HTTP искане
- Етикет за активност: ExecuteOmniFlow
- Използване на удостоверена крайна точка: Разрешено
- Конектор: Конектор за Salesforce, създаден на предишната стъпка
- Път на заявката:
/services/apexrest/cisco_wxcc_scv/voice/v1/executeOmniFlow - Метод: POST
- Тип на съдържанието, изискано за заявката: Приложение/JSON
Тяло на заявката
Освен задължителните полета, можете да предадете допълнителни данни като входни променливи към Omni-Flow. По-долу са представени два примера за тялото на искането. Първо без допълнителни параметри на потока, само задължителни полета, вторият с две входни променливи.
Пример с параметри на 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>"
}
Пример с актуализиране на персонализираните полета в записа на гласово повикване:
{
"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"
}
}
Параметри
| Име на свойство | Стойност |
|---|---|
| callCenterDevName | Име на разработчика на Contact Center |
| certDevName | Име на API на сертификата (както е конфигурирано в центъра за контакти) |
| ИД на гласово повикване | ИД на записа на гласово повикване, създаден в предишната стъпка:
{{SCV_VoiceCallRecordId}}
|
| набранНомер | НабранНомер/DNIS: {{NewPhoneContact.DNIS}}
|
| flowDevName | Име на разработчика на Omni-Flow за изпълнение |
| резервна опашка | ИД на опашката или API на опашката на резервната опашка на Salesforce |
| flowInputParameters |
Допълнителни входове към потока Omni-канал (двойка ключ-стойност). Пример:
|
Настройки за синтактичен анализ
Опашка
- Тип съдържание: JSON
- Променлива на изхода: SCV_OmniFlowQueue
- Израз на пътя:
$.data.queue
„Опашка“, върната от Execute Omni-Flow, може да се използва за маршрутизиране.
Агент- Тип съдържание: JSON
- Променлива на изхода: SCV_OmniFlowAgent
- Израз на пътя:
$.data.agent
„Агент“ от Execute Omni-Flow, може да се използва за маршрутизиране.
Оценка на HTTP отговор за изпълнение на Omni поток
Проверете HTTP състоянието на заявката за изпълнение на Omni Flow http:
- Етикет: statusCodeExecuteOmniFlow
- Променлива: ExecuteOmniFlow.httpStatusCode
Ако заявката за код за статус == 200 => успешна else => е неуспешна, обработката на грешката.
Обработка на грешки за Execute Omni Flow
Само за демо/отстраняване на грешки, пускане на съобщение в зависимост от кода за статус http.
Ако изпълнението на Omni Flow е успешно, променливите SCV_OmniFlowQueue и SCV_OmniFlowAgent не са зададени. Решение за маршрутизиране в потока на повиквания.
Продължаване с маршрутизирането на повикванията
Продължете в потока на повикванията, маршрутизирайте повикването към агент. По желание използвайте SCV_OmniFlowQueue и SCV_OmniFlowAgent, за да изберете опашка и агент.
Поток на събития в Webex Contact Center
Ако повикващият затвори повикването, преди да му бъде отговорено от агент, трябва да актуализираме Service Cloud Voice и да прекратим повикването.
- Ако е използвано изпълнение на Omni-Flow, изпратете ясно маршрутизиране, за да изтриете чакащите услуги за маршрутизиране (PSR)
- Изпращане на актуализиране на гласово повикване, за да се актуализират началните и крайните часове на записа на гласово повикване и за промяна на статуса от „Ново на „Завършено“

- PhoneContactEnded – Това събитие се задейства, когато връзката на повикване на живо бъде прекъсната и всички участници бъдат премахнати.
- HTTP заявка: Изчистване на маршрутизирането
- HTTP заявка: Актуализиране на гласово повикване
HTTP заявка: Изчистване на маршрутизирането
- Етикет: Изчистване на маршрутизирането
- Използване на удостоверена крайна точка: Разрешено
- Конектор: Конектор за Salesforce, създаден на предишната стъпка
- Път на заявката:
/services/apexrest/cisco_wxcc_scv/voice/v1/clearRouting - Метод: POST
Тип на съдържанието, изискано за заявката: Приложение/JSON
Тяло на заявката
{
"callCenterDevName": "<Contact Center API name>",
"certDevName": "<cert dev name>",
"voiceCallId": "{{SCV_VoiceCallRecordId}}"
}
Параметри
| Име на свойство | Стойност |
|---|---|
| callCenterDevName | Име на разработчика на Contact Center |
| certDevName | Име на API на сертификата (както е конфигурирано в центъра за контакти) |
| ИД на гласово повикване | ИД на записа на гласово повикване, създаден в предишната стъпка: SCV_VoiceCallRecordId |
Настройки за синтактичен анализ
Няма.
HTTP заявка: Актуализиране на гласово повикване
- Етикет: Актуализиране на VoiceCall
- Използване на удостоверена крайна точка: Разрешено
- Конектор: Конектор за Salesforce, създаден на предишната стъпка
- Път на заявката:
/services/apexrest/cisco_wxcc_scv/voice/v1/updateVoiceCall - Метод: POST
- Тип на съдържанието, изискано за заявката: Приложение/JSON
Тяло на заявката
{
"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 }
}
Параметри
| Име на свойство | Стойност |
|---|---|
| callCenterDevName | Име на разработчика на Contact Center |
| certDevName | Име на API на сертификата (както е конфигурирано в центъра за контакти) |
| ИД на гласово повикване | ИД на записа на гласово повикване, създаден в предишната стъпка: SCV_VoiceCallRecordId |
| начален час | Времево клеймо за начало на повикването в UTC {{SCV_CallStartTime}} (както се използва за създаване на запис за гласово повикване) |
| час на приключване | Текущо времево клеймо за UTC `{{now() |
| прекъсванеReason | Причина за прекъсването на връзката с повикването. Свойството isError
трябва да бъде настроен на true за да се покаже правилно. |
Настройки за синтактичен анализ
Няма.
Препратки
- Създаване на частен ключ и самоподписан цифров сертификат
- Конфигуриране на свързано приложение за конектор за Salesforce за Webex Contact Center
- Настройване на интеграционни конектори за Webex Contact Center – Salesforce
- Ръководство за настройка и администриране на Cisco Webex Contact Center > Flow Designer
- API на REST за интегриране на телефония
Превод на език
(По избор) Активиране на работна пейка за превод
Тази настройка е приложима само ако използвате настройки за език за превод.
| 1 |
Отидете на Настройка → Работна пейка за превод → Настройки на езика за превод. |
| 2 |
Щракнете върху Enable за да изберете език за превод.
|
(По избор) Разрешаване на езици само за платформата
Тази настройка е приложима само за езици, различни от EN-US.
| 1 |
Отидете на Настройка → Настройки на фирмата → Настройки за езика. |
| 2 |
Изберете необходимите езици. |
| 3 |
Изберете следните квадратчета за отметка:
|
| 4 |
Запазете промените си.
|
Активирайте езика и изберете потребителя (задача)
| 1 |
Отидете на Настройка → Работна пейка за превод → Настройки на езика за превод. |
| 2 |
Изберете езика и изберете потребителя, който ще го превежда. |
| 3 |
Запазете промените си.
|
Настройки за много езици
Превод на потребителски етикети
| 1 |
Отидете на „Настройка“ → Персонализирани етикети. |
| 2 |
Изберете името на етикета по избор, който да отворите.
|
| 3 |
В свързания списък за преводи щракнете върху |
| 4 |
Изберете езика, на който превеждате.
|
| 5 |
Въведете преведената стойност в полето \„Текст за превод\“. Този текст замества стойността, посочена в полето за стойност на етикета, когато езикът по подразбиране на потребителя е езикът за превод. |
| 6 |
Запазете промените си. |
Разрешения за Salesforce, Изисквани От Потребителската Функция
Зададеното разрешение за агент за SCV на Webex Contact Center съдържа всички разрешения, необходими за работа с притурката Webex Contact Center и интеграциите, разработени за агенти.
Достъп до клас APEX (раздел)
- cisco_wxcc_scv.CiscoScvWxcc
- cisco_wxcc_scv.ServiceResponseHandler
- cisco_wxcc_scv.Маршрутизиране на услугата
- cisco_wxcc_scv.HandlerTelephonyIntegrationHandler
Достъп до потребителски тип метаданни (раздел)
- cisco_wxcc_scv.WxCC връзка
Visualforce достъп до страница (раздел)
- cisco_wxcc_scv.CiscoScvLoginWxCC
- cisco_wxcc_scv.CiscoScvMainWxCC
- cisco_wxcc_scv.CiscoScvOAuthRedirect
- cisco_wxcc_scv.CiscoScvSwLoader
Wrapper за гласови API на услугата в облака
Предварителни изисквания
За да се използва wrapper на Service Cloud Voice API, трябва да се конфигурира приложение на Salesforce външен клиент за интегриране на IVR.
Използване на wrapper на Service Cloud Voice API
Услугата „Глас в облака“ (SCV) за Salesforce използва REST API за интегриране на телефония, за да създава и актуализира гласови повиквания, да изпълнява Omni-канали потоци и да изтрива записите за маршрутизиране на чакащи услуги, свързани с гласово повикване. Тази услуга изисква JWT упълномощаване и използване на метода PATCH HTTP, който в момента не се поддържа от Cisco IP Interactive Voice Response (IVR).
За да се опрости използването на Telephony Integration REST API за SCV в (не само) IVR система, е предоставен нов набор от API, които ограждат съществуващия Salesforce API и са достъпни директно от организацията Salesforce, където е инсталиран пакетът Webex Contact Center за услугата Cloud Voice.
Wrapper на Service Cloud Voice API премахва необходимостта от удостоверяване на JWT маркер, извършва допълнителни проверки на данните, изисквани от API на Salesforce, и подобрява обектите за отговор.
Извличане на маркера за достъп
Изпълнете POST заявка към https://<your-domain-name>.my.salesforce.com/services/oauth2/маркер
Изпращане на следните параметри в тялото:
{
"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>"
}
Изпълнение на заявките
URL адресът на екземпляра трябва да съдържа my.salesforce.com.
Пример за правилен URL адрес на екземпляр: https://abc-123.my.salesforce.com
Използването на който и да е друг домейн като URL адрес на екземпляр (т.е. https://abc-123.lightning.force.com ) води до статус на 401 Неупълномощен с НЕВАЛИДЕН_SESSION_ID код на грешка на НЕВАЛИДЕН_SESSION_ID.
Създаване на гласово повикване (раздел)
Създава запис на VoiceCall, съдържащ участниците (т.е. повикващия и получателя) за записа на VoiceCall. Когато създадете запис за VoiceCall, се създава разговор в Salesforce. Използвайте този API само в контекст в реално време, което означава, че трябва да извикате този API само когато се инициира повикване. Този API може да се използва и за създаване на записи на VoiceCall за прехвърляне и конферентни разговори чрез включване на параметъра parentVoiceCallId в полезния обем на заявката.
URI на крайна точка
<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/createVoiceCall
Метод на HTTP
POST
Заглавки
Упълномощаване: Носител <access_token>
Тип съдържание: приложение/json
Параметри
{
"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"
}
Отговор (успешно)
{
"data": {
"voiceCallId": "00X000012345abc"
},
"errors": null,
"success": true
}
Отговор (с грешки)
{
"data": null,
"errors": ["Error message 1", "Error message 2"],
"success": false
}
Актуализиране на гласово повикване
Актуализира VoiceCall след края на разговора. Използвайте този API, за да актуализирате свързаните с повикванията параметри, които не са достъпни по време на етапа на създаване на VoiceCall. Актуализиране на API за VoiceCall е асинхронна операция. Не можете да заявите състоянието на повикването на API.
Тази крайна точка може да се използва и за създаване на VoiceCall дори след края на разговора. Това поведение е полезно в сценарии, при които искате да регистрирате запис в Salesforce за изоставени или пропуснати повиквания или за всеки друг сценарий, при който VoiceCall вече не е създадено.
URI на крайна точка
<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/updateVoiceCall
Метод на HTTP
POST
Заглавки
Упълномощаване: Носител <access_token>
Тип съдържание: приложение/json
Параметри
{
"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
}
}
Подробно описание на параметрите, приети с това искане, може да бъде намерено в официалната документация на Salesforce 3} в раздела „Параметри“.
Отговор (успешно)
{
"data": {
"status": "pending"
},
"errors": null,
"success": true
}
Актуализиране на API за VoiceCall е асинхронна операция. Не можете да заявите състоянието на повикването на API.
Отговор (с грешки)
{
"data": null,
"errors": ["Error message 1", "Error message 2"],
"success": false
}
Изпълнение на Omni- flow
Изпълни потока Omni-Channel, за да маршрутизира повикванията. Той предава към потока ИД на повикване (Salesforce VoiceCallId или доставчик на телефония ContactId) като параметри и връща инструкциите за маршрутизиране на агента или опашката към потока на контакта. По подразбиране гласовият облак на услугата използва омни-канал поток (или резервна опашка), посочен за телефонния канал, който съответства на набрания номер. Ако набраният номер не съответства на съществуващ телефонен канал, можете по желание да зададете нов набран номер, поток Omni-канал и резервна опашка като входни параметри за това повикване в API.
Service Cloud Voice използва този ред на предимство за маршрутизиране на повиквания:
- Използва настройките за поток и резервна опашка на омни-канала за телефонния канал, който съответства на набрания номер. Потокът има предимство. Ако потокът е неуспешен, се използва резервна опашка.
- Използва параметрите flowDevName и fallbackQueue, посочени в повикването Изпълнение на Omniflow API.
URI на крайна точка
<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/executeOmniFlow
Метод на HTTP
POST
Заглавки
Упълномощаване: Носител <access_token>
Тип съдържание: приложение/json
Параметри
{
"callCenterDevName": "contactCenterDevName123",
"certDevName": "certDevName123",
"voiceCallId": "00X000012345abc",
"dialedNumber": "+18445791189",
"flowDevName": "Route_VoiceCall",
"fallbackQueue": "00G111222333444",
"flowInputParameters":
{
"Input1": "one",
"Input2": "two"
}
}
- Параметърът voiceCallId е voiceCallId на Salesforce или ИД на контакт на доставчика на телефония.
- Подробно описание на параметрите, приети с това искане, може да бъде намерено в официалната документация на Salesforce 3} в раздела „Параметри“.
Отговор (успешно)
{
"data": {
"queue": "queue info",
"agent": "agent info"
},
"errors": null,
"success": true
}
AGENT_INFO и QUEUE_INFO съответстват на полето ExternalId в CallCenterRoutingMap
Отговор (с грешки)
{
"data": null,
"errors": ["Error message 1", "Error message 2"],
"success": false
}
Изчистване на маршрутизирането
Изтрива записа PendingServiceRouting (PSR) за гласово повикване. Този API не е необходимо да се извиква за повечето сценарии; PSR записът се изтрива автоматично, когато повикването вече не се маршрутизира. Има обаче някои сценарии, като за пропуснати или изоставени повиквания при използване на партньорски системи за телефония, където трябва изрично да се обадите на този API, за да изчистите PSR записа.
URI на крайна точка
<instance_url>/services/apexrest/cisco_wxcc_scv/voice/v1/clearМаршрутизиране
Метод на HTTP
POST
Заглавки
Упълномощаване: Носител <access_token>
Тип съдържание: приложение/json
Параметри
{
"callCenterDevName": "contactCenterDevName123",
"certDevName": "certDevName123",
"voiceCallId": "00X000012345abc"
}
- Параметърът voiceCallId е voiceCallId на Salesforce или ИД на контакт на доставчика на телефония.
- Подробно описание на параметрите, приети с това искане, може да бъде намерено в официалната документация на Salesforce 3} в раздела „Параметри“.
Отговор (успешно)
{
"data": {
"status": "Success"
},
"errors": null,
"success": true
}
Отговор (с грешки)
{
"data": null,
"errors": ["Error message 1", "Error message 2"],
"success": false
}
Преводи на телефонни номера
Различните взаимодействия между Service Cloud Voice и Webex Contact Center зависят от преводите на телефонни номера. Поради международни различия и специфични за клиентите приложения, е необходим персонализируем инструмент за прехвърляне на телефонни номера от формат А във формат Б.
Решението Webex Contact Center за услугата Cloud Voice автоматично премахва всички знаци с изключение на цифри, хаштагове (#), звездички (*), запетаи (,) и водещи знаци плюс (+). Също така премахва първото повторение на (0). Това ще стане ПРЕДИ да бъдат приложени преводите на телефонните ви номера.
Това ръководство описва как да конфигурирате преводи на телефонни номера.
Полета
Преводите на телефонни номера се съхраняват в полетата за стойност за име. Това ви позволява да конфигурирате неограничено количество правила за функция.
Конфигурацията се съхранява като JSON низ.
Имайте предвид, че обратните наклони трябва да бъдат избегнати, напр. \d+ става \\d+.
{"Remove all characters but digits":"[1,17]->[^\\d]+","To internal number":"[7,17]->(\\d{7})(\\d{4})->$2"}
Името на полето Не се използва технически. Той е там, за да се добави човешки четлив низ, за да се идентифицира бързо целта на това правило. Добрите имена са например: Премахнете всички водещи нули, Добавяне на водещи плюс и т.н.
Създаване на правила за превод
Правилата се предоставят като регулярни изрази. За по-точно: Внедряване на регулярни изрази в JavaScript.
Добър начин да започнете е като прочетете документа RegExp от уеб документите на MDN.
Въпреки това, създаването на сложни регулярни изрази често е тромаво. Ето защо добавихме допълнителен синтаксис, за да направим конфигурацията възможно най-лесна.
Фигурата по-долу показва общия синтаксис на правилото за транслация на телефонни номера:
Предсказване
Предикатът се използва за посочване на интервал, определящ дължината на числото, което да съвпада.
Предикатът по-горе указва, че всички номера с дължина между 7 и 11 знака (включително ръбовете + интервалите) съвпадат.
Прогнозите винаги съвпадат с първоначалната дължина на числото. Това помага за опростяване на конфигурацията чрез намаляване на риска от сблъскване на правила за вътрешни/външни номера.
Модел
Моделът указва формата на номера, който да съвпада.
Моделът по-горе посочва, че числото трябва да се състои само от цифри, и ги избира.
Селектор
Селекторите определят окончателния формат на номера. Ако трябва да се добавят знаци/цифри, които първоначално не са присъствали, това е мястото, където да го направите.
Селекторът е последната стъпка в изграждането на числото. Въз основа на изхода на модела селекторът изгражда новия номер.
Пример 1
Следващият пример показва как да прехвърлите номер, получен от Contact Center във формат 0319175200, в швейцарския формат E164 +41 31 917 52 00.
Този пример използва две правила за превод (1. и 2.)
Първото правило в този пример всъщност не променя числото. За номера с дължина между 1 и 17 знака ще бъде премахнато всичко друго, освен цифрите. Тъй като няма нецифрен подарък, нищо не се променя.
Второто правило се прилага за числа, които са точно 10 знака (първоначално). 0319175200 съвпада и следователно правилото се прилага. Моделът указва, че номерът трябва да започва с група от една цифра (\d{1}), последвана от група от две цифри (\d{2}), последвани от група от три цифри (\d{3}) и т.н.
След това селекторът осъществява достъп до групите шаблони, за да дефинира новия низ на номера. Това означава, че $2 препраща към първия (\d{2}) и следователно съдържа 31.
Пример 2
Следващият пример показва как да прехвърлите номер, получен от Contact Center във формат +14693150217, във формат E164 на САЩ +1 469 315 0217.
Този пример използва две правила за превод (1. и 2.)
- Този номер е с дължина точно 12 знака, така че се прилага правилото „Добавяне на места към номера в САЩ“.
- (\+1) казва, че номерът трябва да започва с +1. Ако номерът е дълъг 12 знака, но не започва с +1, правилото се отменя и нищо не се променя.
- (\d{3}) казва, че +1 трябва да бъде последван от 3 цифри.
- (\d{3}) казва, че последните 3 цифри трябва да бъдат последвани от още 3 цифри.
- (\d{4}) казва, че последните 3 цифри трябва да бъдат последвани от 4 цифри.
Ако някое от тези неща не съвпада, номерът няма да бъде променен.
Така че всички правила се прилагат за „+14693150217“. Следователно номерът се променя с „$1 $2 $3 $4“:
- $1 се отнася за групата (\+1), като номерът за изпращане на глас в облака за услуги изглежда като +1.
- $2 се отнася за първото от двете (\d{3}), номерът за изпращане към услугата Cloud Voice изглежда като +1 469.
- $3 се отнася за втората от двете (\d{3}), номерът за изпращане към услугата Cloud Voice изглежда като +1 469 315.
- $4 се отнася за последната група (\d{4}), номерът за изпращане към услугата Cloud Service изглежда като +1 469 315 0217.
Интервалите в заместващата част на правилото „$1 $2 $3 $4“ се използват директно. Така че, ако използвате „$1-$2-$3-$4“, числото ще бъде преведено на: +1-469-315-0217
И ви е позволено да премахвате групи: [12, 12]->(\+1)(\d{3})(\d{3})(\d{4})->$2 $3 $4 ще бъдат преведени в: 469 315 0217. [12, 12]->(\+1)(\d{3})(\d{3})(\d{4})-> $3 $4 ще бъдат преведени в: 315 0217.
Възможно е също да конвертирате международен номер в САЩ в местен, например: [12, 12]->(\+1)(\d{3})(\d{3})(\d{4})->($2) $3-$4.
След това входящият номер „+14693150217“ ще бъде преведен на: (469) 315-0217.
Пример 3
Следващият пример показва как да прехвърлите номер, получен от Contact Center във формат +491515555531, в немски формат E164 +49 151 5555 531.
Този пример използва две правила за превод (1. и 2.)
- Този номер е с дължина точно 13 знака, така че се прилага правилото „Добавяне на места към немски номера“.
- (\+49) казва, че номерът трябва да започва с +49. Ако номерът е дълъг 13 знака, но не започва с +49, правилото се отменя и нищо не се променя.
- (\d{3}) казва, че +49 трябва да бъде последван от 3 цифри.
- (\d{4}) казва, че последните 3 цифри трябва да бъдат последвани от 4 цифри.
- (\d{3}) казва, че последните 4 цифри трябва да бъдат последвани от 3 цифри.
Ако някое от тези неща не съвпада, номерът няма да бъде променен.
Така че всички правила се прилагат за „+491515555531“. Следователно номерът се променя с „$1 $2 $3 $4“:
- $1 се отнася за групата (\+49), като номерът за изпращане на глас в облака за услуги изглежда като +49.
- $2 се отнася за първото от двете (\d{3}), номерът за изпращане към услугата Cloud Voice изглежда като +49 151.
- $3 се отнася за втората от двете (\d{4}), номерът за изпращане към услугата Cloud Voice изглежда като +49 151 5555.
- $4 се отнася за последната група (\d{3}), номерът за изпращане към услугата Cloud Service изглежда като +49 151 5555 531.
Същото важи и за правило 1. Можете да използвате заместващата част $1 $2 $3 $4, за да изберете какво да използвате от номера.
Още примери за Translation Regex
| Описание | Регламент за превод |
|---|---|
| Премахване на всички знаци без цифрите | [1,17]->[^\d]+ |
| Премахване на всички знаци освен цифрите и + | [1,17]->[^+\d]+ |
| Описание | Регламент за превод |
|---|---|
| Премахни +1 | [12,12]->(.{1})(\d{1})(\d{10})->$3 |
| Премахни +1 | [10,12]->(^\+1+)(\d+)->$2 |
| Премахни +49 | [10,15]->(^\+49+)(\d+)->$2 |
| Премахни +49 | [10,15]->(.{1})(\d{2})(\d{9})->$3 |
| Премахни +41 | [10,13]->(^\+41+)(\d+)->$2 |
| Премахни +41 | [10,13]->(.{1})(\d{2})(\d{9})->$3 |
| Премахване на +XX | [10,14]->(^\++)(\d{2})(\d+)->$3 |
| Описание | Регламент за превод |
|---|---|
| Премахване на + и заместване с нули US E164 | [10,12]->(.{1})(\d{1})(\d{10})-> 001 $3 |
| Премахнете +1 и го заменете с нули US E164 | [10,12]->(^\+1+)(\d+)-> 001$2 |
| Премахнете + и го заменете с нули DE E164 | [12,15]->(.{1})(\d{2})(\d{10})-> 0049 $3 |
| Премахнете +49 и го заменете с нули DE E164 | [10,12]->(^\+49+)(\d+)-> 0049$2 |
| Премахнете + и го заменете с нули CH E164 | [10,13]->(.{1})(\d{2})(\d{9})-> 0041 $3 |
| Премахнете +41 и го заменете с нули CH E164 | [10,12]->(^\+41+)(\d+)-> 0041$2 |
| Описание | Регламент за превод |
|---|---|
| Номер в САЩ с интервал | [12,17]->(\d{1})(\d{3})(\d{3})(\d{4})->+1 $2 $3 $4 |
| Номер в САЩ с интервал | [12,17]->(\+1)(\d{3})(\d{3})(\d{4})->$1 $2 $3 $4 |
| DE номер с интервал | [12,17]->(\d{2})(\d{3})(\d{4})(\d{3})->+49 $2 $3 $4 |
| DE номер с интервал | [12,17]->(\+49)(\d{3})(\d{4})(\d{3})->$1 $2 $3 $4 |
| CH номер с интервал | [12,17]->(\d{2})(\d{2})(\d{3})(\d{2})(\d{2})->+41 $2 $3 $4 |
| CH номер с интервал | [12,17]->(\+41)(\d{2})(\d{3})(\d{2})(\d{2})->$1 $2 $3 $4 |
Конфигурация на страницата за VoiceCall
Конфигуриране на страницата за запис на VoiceCall
Страницата за запис на VoiceCall се предлага предварително конфигурирана по подразбиране, с оформление с колона 3 и следните компоненти:
- Действия и препоръки
- Бележки за повикването
- Подробности за повикването
- Записи
Компонентите могат да бъдат свободно премахнати или добавени към страницата в зависимост от бизнес нуждите. Могат да се използват и различни оформления на страници, но някои компоненти, като плейъра за запис на повиквания и тялото на разговори, могат да се поберат само в средни и големи области на шаблона.
Показване на компонента за причина за приключване
Компонентът причина за приключване трябва да се показва по време на повикването и по време на приключването.
Добавете компонента причина за приключване на Cisco към страницата за запис на VoiceCall:
- Плъзнете файла Cisco Wrap-Up Reason Уеб компонент за осветление от зоната по избор на списъка с компоненти за осветление на страницата за запис на VoiceCall.
- Щракнете върху Save.
- Щракнете върху Activate.
- Щракнете върху Assign as Org Default.
- Щракнете върху Save.
- Щракнете върху Save отново, след което щракнете върху Back arrow за да се върнете на страницата.
The Cisco Wrap-Up Reason компонентът автоматично ще се показва по време на разговора и по време на WrapUp:
Ако е добавен към страницата, за всяко повикване се показва компонентът причина за приключване на Cisco, дори ако в Cisco Contact Center не е конфигурирано приключване.
Показване на плейъра за запис на повиквания
Плейърът за запис на повиквания ще се показва, ако е запазена връзка за запис за съответното гласово повикване.
Изпълнете тези стъпки, за да добавите компонента плейър за запис на повиквания към страницата за запис на VoiceCall:
- Плъзнете уеб компонента за осветление на плейъра за запис на повиквания към страницата за запис на VoiceCall
- Щракнете върху Save.
- Щракнете върху Activate.
- Щракнете върху Assign as Org Default.
- Щракнете върху Save.
- Щракнете върху Save след това щракнете върху стрелката назад, за да се върнете на страницата.
Администратори на Webex
Конфигурация на потока
Изскачащ прозорец
В потока на Webex Contact Center е наличен възел за изскачащ екран. Може да се използва за задейства изскачащ прозорец в Service Cloud Voice или в отделен прозорец.
Повече информация за тази функция можете да намерите в документацията на Flow Designer .
Изскачащ екран в отделен прозорец
За да отворите изскачащия екран в отделен прозорец, във възела „Изскачащ екран“ трябва да бъде предоставен абсолютен URL адрес. queryParameters ще бъдат приложени като параметри за търсене към URL.
Поддържат се следните режими:
- Раздел „Нов браузър“ – винаги отваря нов раздел на браузъра.
- Съществуващ раздел на браузъра – В първия изскачащ прозорец на съществуващия раздел на браузъра се отваря нов раздел на браузъра. Този раздел ще бъде специализиран раздел за следващите съществуващи изскачащи прозорци на раздела на браузъра, а URL адресът ще бъде опреснен в рамките на този конкретен раздел на браузъра.
- Вътре в работния плот – обработва се по същия начин като Нов раздел на браузъра.
Текущо отворената страница може да предотврати пренасочване. В този случай се отваря изскачащ прозорец на съществуващ раздел на браузъра в нов раздел на браузъра.





