Дякуємо за відгук.

Перш ніж продовжувати, переконайтеся, що ви відповідаєте наступним передумовам:

• Користувач, який виконує налаштування, повинен бути адміністратором організації 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.

Вимоги

Корпоративне видання Salesforce

Для цієї інтеграції потрібна мінімальна версія Salesforce Enterprise Edition. Для отримання додаткової інформації див. Видання Salesforce.

Мій домен в організації Salesforce

Якщо ви хочете використовувати компоненти Lightning, ви повинні розгорнути М ій до мен у своїй організації. Докладніші відо мості див. у документації 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. Введіть ім'я провайдера авторизації, наприклад Ap exmdTaPi.
4. Вставте ключ споживача та секрет споживача, які ви зберегли під час налаштування підключеного додатка.
5. Введіть повне refresh_token offline_access значення в області за замовчуванням.
6. Залиште все інше порожнім і натисніть З берегти.

   

7. Скопіюйте URL-адресу зворотного дзвінка з розділу Кон фігурація Salesforce.

   

8. Відредагуйте підключену програму та замініть заповнюючу URL-адресу URL-адресою URL-адреси зворотного дзвінка, скопійованою з конфігурації Salesforce вище.

   

9. Збережіть підключений додаток.

   Це може зайняти до 10 хвилин, щоб налаштування вступили в силу та поширилися по всій інфраструктурі Salesforce.

Створення іменованого облікового запису

1. У програ мі Налаш тування знайдіть ім'я та виберіть Імен овані облікові дані. Натисніть кнопку Створити спадщи ну.

   

2. Введіть ApexmdTaPi в мітку.
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 для авторизації, іменованих облікових даних та постачальників авторизації, а потім створіть нову програму Webex Connected для авторизації Salesforce.

Видаліть усі існуючі програми Webex Connected, іменовані облікові дані та постачальників авторизації

Якщо ви раніше створили авторизації Webex Connected App, іменовані облікові дані або постачальника авторизації, вам потрібно буде видалити їх, перш ніж продовжувати. В іншому випадку продовжуйте Створити нову програму Webex Connected нижче.

Видаліть існуючу програму Webex Connected:

1. У верхньому правому куті цільової сторінки Salesforce натисніть , потім виберіть Н алаштування.
2. У текстов ому полі Швид кий пошук введіть Менеджер програм, а потім виберіть його зі списку.
3. Прокрутіть до програми Webex Connected у списку, клацніть піктограму зі стрілкою вниз праворуч від запису, а потім виберіть Перегля д.
4. Виберіть Видал ити, а потім знову виберіть Видал ити, коли вам буде запропоновано підтвердити.

Видаліть усі існуючі іменовані облікові дані Webex:

1. У текстов ому полі Швид кий пошук введіть Іменовані облі кові дані, а потім виберіть їх зі списку.
2. Клацніть стрілку вниз праворуч від запису облікових даних Webex, а потім натисніть Ви дал ити.
3. Натисніть кнопку Видал ити ще раз, коли вам буде запропоновано підтвердити.

Видаліть існуючих постачальників авторизації Webex:

1. У текстов ому полі Швид кий пошук введіть Auth. Прова йдери, потім виберіть його зі списку.
2. Виберіть посилання Del на початку запису постачаль ника авторизації Webex.
3. Натисніть OK, коли вам буде запропоновано підтвердити.

Перейдіть до наступного розділу, щоб створити нову програму Webex Connected для авторизації Salesforce .

Створіть нову підключену програму Webex для авторизації Salesforce

Щоб створити нову підключену програму Webex для авторизації Salesforce:

1. У верхньому правому куті цільової сторінки Salesforce натисніть , потім виберіть Н алаштування.
2. Отримати URL-адресу домену: у Швид кому пошуку знайдіть і виберіть До мени та збережіть URL-адресу з М ій домен.
3. У розділі Налаш тування знайдіть додаток зовнішнього клієнта.

   

4. У розділі Зовнішні клієнтські програми виберіть Н алаштування.
5. Увімк ніть Дозволити створення підключених програм. Якщо кнопка «Нова підключена програма» вже ввімкнена, ви можете створити нову підключену програму.

   

6. Щоб створити нову підключену програму, натисніть кнопку Нова підключена програма та введіть необхідні дані.

   

7. У текстов ому по лі Швидкий пошук введіть Менеджер програм і виберіть його зі списку.
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 у вибраних областях O Auth:
    • Повний доступ (повний)
    • Виконувати запити в будь-який час (refresh_token,offline_access)
13. Зніміть прапорець Ви магати підтверджувального ключа для розширення обміну кодами (PKCE) для підтримуваних потоків авторизації.
14. Натисніть «Зберегти».
15. Скопіюйте та надійно збережіть ключ споживача та секрет споживача. Ці значення вам потрібні, коли ви налаштовуєте авторизацію Salesforce в Контрольному центрі.

Для інтеграції 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) натисніть У ві мк нути OAuth.
2. Налаштуйте URL-адреси зворотного виклику. Заміні [your-domain]ть на значення Salesforce «Мій домен» та введіть кожну URL-адресу в окремому рядку:
   • https://[your-domain].my.salesforce.com/apex/webexsfdcauth
   • https://[your-domain].my.salesforce.com/apex/cisco_webex__webexsfdcauth
3. Додайте ці області OAuth до вибраних областей O Auth:
   • Повний доступ (full)
   • Виконувати запити в будь-який час (refresh_token, offline_access)
4. У розділі Безпе ка позначте пункт Вимагати підтверджувальний ключ для обміну кодом (PKCE).
5. Натисніть «Створити».

Отримати ключ споживача та секрет споживача

1. У розділі Н алаштування виберіть «Мене джер програм» > «Диспетче р програм зовнішнього клієнта».
2. Натисніть кнопку Авторизація Webex Salesforce.
3. Натисніть вкладку Налаш тування, а потім відкрийте Параме три OAuth.
4. Натисніть Споживчий ключ і секрет.
5. Перевірте свою електронну пошту на наявність коду підтвердження від Salesforce.
6. На сторінці Під твердити свою особ у введіть код і натисніть Підтвер дити.
7. Скопіюйте та надійно збережіть ключ споживача та секрет споживача. Ці значення вам потрібні, коли ви налаштовуєте авторизацію Salesforce в Контрольному центрі.

Перенесення існуючої підключеної програми

Якщо у вас вже є підключена програма для авторизації Webex Salesforce, перенесіть його на додаток зовнішнього клієнта. Це зберігає споживчий ключ, зберігає дійсність існуючих токенів та переносить налаштування OAuth. Оригінальна підключена програма залишається після міграції.

1. У налашт уваннях знайдіть Менеджер додатків і виберіть його.
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.htm.

• Компоненти утиліти виклику Webex недоступні в мобільному додатку Salesforce.