Благодарим за обратната връзка.

Преди да продължите, уверете се, че отговаряте на следните предпоставки:

• Потребителят, извършващ настройката, трябва да бъде администратор на организацията Salesforce, където трябва да бъде инсталирана интеграцията.
• Тази интеграция изисква минимум Salesforce Enterprise Edition. Вижте изданията на Salesforce за повече информация.
• Организацията трябва да има конфигуриран Webex с правилните лицензи за необходимата функционалност, включително съобщения, срещи и обаждания.
• Всички потребители, използващи интеграцията, трябва да имат достъп до Salesforce и необходимите лицензи за Salesforce.
• Всички потребители трябва да имат необходимите лицензи на Webex, за да използват специфични функции на Webex, като Webex Meetings и Webex Calling от Salesforce.

  CUCM и Broadworks се поддържат с частична функционалност. Вижте Ограничения за пови кване в секцията Обаждане за повече подробности.

• Тази интеграция е достъпна за Salesforce Lightning.

  Трябва да разгърнете Моят домей н във вашата организация, ако искате да използвате компоненти на Lightning. Вижте Моят домейн Salesforce за повече информация.

• Трябва да конфигурирате потребителския достъп до интеграциите във вашата организация.
  • Без Pro Pack — Когато имате основен контролен център, можете да разрешите или откажете достъп до всички интеграции за всички ваши потребители.
  • С Pro Pack — С Pro Pack имате разширена функционалност за управление на достъпа на потребителите до интеграции.

  Вижте Конфигуриране на потребителски достъп до интеграции за повече информация.

За версии на интеграцията на Webex Salesforce, по-късни от 1.14, вече можете да над строите с помощта на Salesforce Exchange.

За да инсталирате интеграцията на Webex с помощта на Salesforce Exchange:

1. Придвижете се до приложението Webex за Salesforce в AppExchange.
2. Изберете В земи го сега.
3. Изберете свързаната организация, в която искате да инсталирате интеграцията.
4. Инсталирайте приложението само за администратори.
5. Продължете с У пълномощаване на интеграцията на Webex в раздела Инсталиране и администриране .

Преди да следвате стъпките за конфигуриране, първо трябва да отидете в бележките за изданието и да изтеглите най-новата версия на Webex App Salesforce Package.

Изисквания

Предприятно издание на Salesforce

Тази интеграция изисква минимум Salesforce Enterprise Edition. Вижте изданията на Salesforce за повече информация.

Моят домейн в Salesforce org

Трябва да разгърнете Моят домей н във вашата организация, ако искате да използвате компоненти на Lightning. Вижте документацията My Domain Salesforce за повече информация.

Достъп на потребителя в контролния център

Трябва да конфигурирате потребителския достъп до интеграциите във вашата организация.

• Без Pro Pack — Когато имате основен контролен център, можете да разрешите или откажете достъп до всички интеграции за всички ваши потребители.

• С Pro Pack — С Pro Pack имате разширена функционалност за управление на достъпа на потребителите до интеграции.

Вижте Конфигуриране на потребителски достъп до интеграции за повече информация.

Обаждане

• Webex Callingсе поддържа изцяло за входящи и изходящи повиквания за контрол на повикванията в Salesforce.

• Обаждането в Webex (Unified CM) се поддържа частично. Само изходящите повиквания отварят изскачащ прозорец за влизане в Salesforce. За входящи повиквания приложението Webex звъни, но Salesforce не може да прихване повикването, така че изскачащият прозорец за регистриране не се показва.

Ако работите с Webex за Salesforce версия 1.18 или по-стара, трябва да конфигурирате разрешение за Salesforce, преди да можете да работите с него в Salesforce. Webex Calling

Създаване на свързано приложение

1. В На стройка потърсете Прилож ение за външен клиент.

   

2. Под Приложения за външни клиенти изберете На стройки.
3. Включете Раз решаване на създаването на свързани приложения. Ако бутонът Ново свързано приложение вече е активиран, можете да продължите и да създадете ново свързано приложение.

   

4. За да създадете ново свързано приложение, щракнете върху Ново свързано приложение и въведете необходимите подробности.

   

5. Въведете име на свързано приложение, като например MyExample App.
6. Въведете имейл адрес за контакт.
7. Поставете отметка в квадратчето за А ктивиране на настройките на OAuth.
8. Посочете URL адрес за обратно извикване (ще го актуализираме по-късно), като например. https://localhost/placeholder

   

9. Превъртете надолу и изберете следните обхвати на OAuth:
   • Пълен достъп (пълен)
   • Изпълнявайте заявки по всяко време (refresh_token,offline_access)

   

   Обхватът Извършване на заявки по всяко време позволява на Имен ените идентификационни данни да опресняват вашия токен за достъп, когато сесията изтече.

10. Превъртете до долната част на страницата и щракнете върху За паз ване, след което щракнете върху Продължи.
11. На следващата страница превъртете до API (Активиране на настройките на OAuth) и щракнете върху Управление на потребителските данни.

    

    Може да се наложи да удостоверявате отново със Salesforce .

12. Забележете потребителския ключ и потреб ителската тай на.

    

Създайте доставчик на автономни услуги

След това създайте доставчик на удостоверяване, който улеснява удостоверяването с вашата организация Salesforce.

1. В На стройка потърсете Auth и изберете Auth. Доставчици. Щракнете върху Н ово.

   

2. Изберете Salesforce като тип доставчик.
3. Въведете име за доставчика на Auth, като например Ap exMDTapi.
4. Поставете в потребителския ключ и потреб ителската тай на, които сте запазили, когато конфигурирате свързаното си приложение.
5. Въведете пълно refresh_token offline_access в обх вата по подразбиране.
6. Оставете всичко останало празно и щракнете върху За пазване.

   

7. Копирайте URL адреса за обратно повикване от секцията Конфигу рация на Salesforce.

   

8. Редактирайте свързаното приложение и заменете URL адреса за заместване с URL адреса за обратно пови кване, който сте копирали от конфигурацията на Salesforce по-горе.

   

9. Запазете свързаното си приложение.

   Може да отнеме до 10 минути, докато настройките влязат в сила и да се разпространят в цялата инфраструктура на Salesforce.

Създайте наименован идентификационен номер

1. В На стройка потърсете Именов ани и изберете Именени идентификационни данни. Щракнете върху Ново наследство.

   

2. Въведете ApexMDT api в етикет.
3. Въведете URL адреса на екземпляра на организацията си в URL адрес, като например https://na1.salesforce.com; или, ако използвате Моят домей н, напълно квалифицираното име на моя домей н, като например https://mycompany.my.salesforce.com.
4. За Тип самолич ност изберете На именован главен.
5. За Протокол за удостоверяване изберете OAuth 2.0.
6. За Достав чик на удостоверяване изберете доставчи ка на автентикации, който сте създали по-рано.
7. Въведете пълно refresh_token offline_access в обхват.
8. Поставете отметка в квадратчето до Стартиране на потока за удостоверяване при запаз ване.

   

9. В Опции за извикване поставете отметка в квадратчето до Разрешаване на сливащи полета в HTTP тяло, след което щракнете върху За паз ване.

   

10. Влезте във вашата организация. След като влезете, щракнете върху Разреш аване в Раз решаване на достъп.
11. На екрана с на именовани идентификационни данни състоянието на удостоверяване показва У достове рено като your-email@domain.com.

Създайте вашия сайт в администраторския екран на Webex

Продължете към Създаване на сайт за оба ждане в сек цията Обаждане.

За интеграциите на Webex за Salesforce версия 1.19 и по-нова версия, следвайте инструкциите в тази статия, за да премахнете съществуващото Webex Connected App за разрешения, наимен овани идентификационни данни и доставчици на авт, и след това да създадете ново Webex Connected App за разрешение на Salesforce.

Премахнете всички съществуващи приложения, свързани с Webex, именувани идентификационни данни и доставчици на авт

Ако преди това сте създали разрешения за Webex Connected App, наименовани идентификационни данни или доставчик на автентизация, ще трябва да ги премахнете, преди да продължите. В противен случай продължете да създавате ново приложение, свързано с Webex по-долу.

Премахнете съществуващото приложение Webex Connected:

1. В горния десен ъгъл на целевата страница на Salesforce щракнете върху , след което изберете На стройка.
2. В текстов ото поле Бързо намиране въведете App Manager, след което го изберете от списъка.
3. Превъртете до вашето Webex Connected App в списъка, щракнете върху иконата със стрелка надолу вдясно от записа, след което изберете Преглед.
4. Изберете Из трий, след което изберете Из трий отново, когато бъдете помолени за потвърждение.

Премахнете всички съществуващи идентификационни данни на Webex с име:

1. В текстов ото поле Бърз о търсене въведете И менени иденти фикационни данни, след което го изберете от списъка.
2. Щракнете върху стрелката надолу вдясно от записа за идентификационни данни на Webex, след което щракнете върху Изтриване.
3. Щракнете върху Изтри ване отново, когато бъдете помолени за потвърждение.

Премахнете всички съществуващи доставчици на Webex Auth:

1. В текстовото поле Б ързо търсене въведете Auth. Доставчици, след това го изберете от списъка.
2. Изберете връзката Del в началото на записа на доставчика на Auth на Webex.
3. Щракнете върху OK, когато бъдете помолени за потвърждение.

Продължете към следващия раздел, за да създадете ново Webex свързано приложение за разрешение на Salesforce .

Създайте ново Webex свързано приложение за разрешение на Salesforce

За да създадете ново Webex свързано приложение за разрешение Salesforce:

1. В горния десен ъгъл на целевата страница на Salesforce щракнете върху , след което изберете На стройка.
2. Изтеглете URL адреса на вашия домейн: в Бързо нами ране потърсете и изберете До мейни и запазете URL адреса от Моят домейн.
3. В На стройка потърсете Прилож ение за външен клиент.

   

4. Под Приложения за външни клиенти изберете На стройки.
5. Включете Раз решаване на създаването на свързани приложения. Ако бутонът Ново свързано приложение вече е активиран, можете да продължите и да създадете ново свързано приложение.

   

6. За да създадете ново свързано приложение, щракнете върху Ново свързано приложение и въведете необходимите подробности.

   

7. В текстов ото поле Бързо намиране въведете App Manager и го изберете от списъка.
8. Въведете име на свързано приложение, например Webex Salesforce разрешение.
9. Въведете имейл адрес за имейл за контакт.
10. Поставете отметка в квадратчето за А ктивиране на настройките на OAuth.
11. Въведете два URL адреса за обратно обаждане, като използвате URL адреса, който сте изтеглили по-рано, по един на ред и като добавяне /apex/ webexsfdcauthи /apex/ cisco_webex__webexsfdcauthкато наставки. Например:

    https://my-company.my.salesforce.com/apex/webexsfdcauth

    https://my-company.my.salesforce.com/apex/cisco_webex__webexsfdcauth

12. Изберете следните обхвати от списъка Налични обхвати на OAuth в Избрани обхвати на OAuth:
    • Пълен достъп (пълен)
    • Изпълнявайте заявки по всяко време (refresh_token,offline_access)
13. Премахнете отметката от квадратчето Изискване на ключа за доказване за разширение за обмен на кодове (PKCE) за поддържани пото ци от оторизация.
14. Щракнете върху Запаз ване.
15. Копирайте и запазете безопасно потребителския ключ и потребителската тайна. Имате нужда от тези стойности, когато конфигурирате разрешение за Salesforce в Control Hub.

За интеграция на Webex за Salesforce версия 1.22 и по-нова версия конфигурирайте разрешение на Salesforce с приложение за външен клиент. Ако вече имате свързано приложение за оторизация на Webex Salesforce, можете да го мигрирате към приложение за външен клиент и да запазите потребителския му ключ.

Преди да започнете

• Имате нужда от достъп до системния администратор на Salesforce.
• Моят домей н трябва да е активиран във вашата организация Salesforce.

Изтеглете URL адреса „Моят домейн“

1. В горния десен ъгъл на целевата страница на Salesforce щракнете върху , след което щракнете върху Настройка.
2. В полето Бързо търсене потърсете домейни и го изберете.
3. Забележете вашия URL адрес на моя домей н. Ще го използвате, за да конфигурирате URL адресите за обратно обаждане. Например, вашият URL адрес може да бъде https://my-company.my.salesforce.com.

Създайте ново приложение за външен клиент

1. В На стройка потърсете М ениджър на приложения в полето Бързо нами ране и го изберете.
2. Щракнете върху Ново приложение за външен клиент.

   Въведете следните данни:

   • Име на приложение за външен клиент - Отори зация на Webex Salesforce
   • Име на API — Webex_Salesforce_Authorization(автоматично попълване)
   • Имейл за контакт — Вашият имейл адрес на администратора
   • Състояние на разпространение - М естно

3. Щракнете върху Създа ване.

Конфигуриране на настройките на OAuth

1. Под API (Активиране на настройките на OAuth) щракнете върху Активиране на OA uth.
2. Конфигурирайте URL адресите за обратно обаждане. Зам [your-domain]енете със стойността на Salesforce My Domain и въведете всеки URL адрес в отделен ред:
   • https://[your-domain].my.salesforce.com/apex/webexsfdcauth
   • https://[your-domain].my.salesforce.com/apex/cisco_webex__webexsfdcauth
3. Добавете тези обхвати на OAuth към избрани обхвати на OAuth:
   • Пълен достъп (full)
   • Изпълнявайте заявки по всяко време (refresh_token, offline_access)
4. Под За щита запазете отмет ката „Изискване на доказателствен ключ за обмен на код“ (PKCE).
5. Щракнете върху Създа ване.

Изтеглете потребителския ключ и потребителската тайна

1. В На стройка изберете М ениджър на приложения > Въ ншен клиентски мениджър на приложения.
2. Щракнете върху У пълномощаване на Webex Salesforce.
3. Щракнете върху раздел а Настройки, след което отворете Настройки на OAuth.
4. Щракнете върху Потребителски ключ и тай на.
5. Проверете имейла си за кода за потвърждение от Salesforce.
6. На страницата Потвър дете самоличността си въведете кода и щракнете върху Пот върдете.
7. Копирайте и запазете безопасно потребителския ключ и потребителската тайна. Имате нужда от тези стойности, когато конфигурирате разрешение за Salesforce в Control Hub.

Мигриране на съществуващо свързано приложение

Ако вече имате свързано приложение за оторизация на Webex Salesforce, мигрирайте го към приложение за външен клиент. Това запазва потребителския ключ, запазва съществуващите токени валидни и прехвърля настройките на OAuth. Оригиналното свързано приложение остава след миграцията.

1. В Настройка потърсете App Manager и го изберете.
2. Намерете съществуващото свързано приложение, щракнете върху стрелката надолу вдясно от неговия ред и изберете Изглед.
3. На страницата Подробности за свързаното приложение щракнете върху М игриране към приложение за външен клиент.
4. Прегледайте резюмето на мигрирането, след което щракнете върху Мигри ране.
5. Когато мигрирането приключи, Salesforce отваря новата страница с подробности за приложението за външен клиент.

Проверете миграцията

1. В На стройка изберете Мениджър на приложения > Менидж ър на приложения за външен клиент.
2. Потвърдете, че разрешение за Webex Salesforce се появява в списъка.
3. Щракнете върху приложението и проверете дали разделът Настрой ки показва правилните URL адреси за обратно повикване и обхватите на OAuth:
   • Пълен достъп (full)
   • Изпълнявайте заявки по всяко време (refresh_token, offline_access)
4. (Незадължително) Изтеглете потребителския ключ и потребителската тайна и потвърдете, че съответстват на първоначалните стойности.

Деактивирайте оригиналното свързано приложение (по избор)

След като проверите дали приложението за външен клиент работи, направете следното:

1. В На стройка изберете М ениджър на приложения.
2. Намерете оригиналното свързано приложение и щракнете върху стрелката надолу вдясно от неговия ред.
3. Изберете Управление.
4. Под Правила на OAuth задайте Разреш ените потребители да блокират нови разрешения или да оставят свързаното приложение активно по време на преходен период.

Препоръчваме да запазите оригиналното свързано приложение активно за кратък преходен период, така че интеграциите да продължат да работят, преди да го деактивирате.

Когато е наличен нов пакет, следвайте стъпките в Инсталиране на приложението Webex в Salesforce по-горе. Не е необходимо първо да деинсталирате старата версия и няма да загубите конфигурираните си настройки.

За да видите информация за новите инсталационни пакети и къде да ги изтеглите, вижте бележките за изданието за интеграция на Webex Salesforce.

За да активирате или деактивирате историята на обажданията:

1. Отидете на администратора на Webex.
2. Превъртете надолу до Историята на обажданията на Webex.
3. Превключете превключвателя към желаната настройка, активирана или деактивирана.

   Когато е активирана, Историята на обажданията е достъпна за всички потребители и профили.

За потребителите на CUCM и Broadworks следната функционалност не се поддържа:

• Получаване на входящи повиквания в глобалния набирач на Salesforce (приложението Webex все още ще получава входящи повиквания)
• Преглед на продължителността на обажданията в прозореца на дневника на повикванията на Salesforce след успешно извършване на изходя що повикване
• Прекратяване на повиквания чрез бутона в прозореца на дневника на повикванията на Salesforce след успешно извършване на изходящо повикване
• Автоматично попълване на продължителността на обажданията в прозореца на дневника на повикванията на Salesforce след приключване на изходящо пови кване

За всички интеграции на Salesforce обърнете внимание на следното ограничение:

• Salesforce налага ограничение за броя на събитията (25 000), което може да доведе до неуспех на интеграциите при тежка употреба. Налични са пакети Salesforce за увеличаване на този лимит. За повече информация вижте https://developer.salesforce.com/docs/atlas.en-us. platform_events.мета/platform_events/platform_event_limits. хтм.

• Компонентите на помощната програма за извикване на Webex не са налични в мобилното приложение Salesforce.