Благодарим вас за обратную связь.

Прежде чем продолжить, убедитесь, что вы соответствуете следующим требованиям:

• Пользователь, выполняющий настройку, должен быть администратором организации Salesforce, в которой должна быть установлена интеграция.
• Для этой интеграции требуется как минимум версия Salesforce Enterprise. Дополнительные сведения см. в разделе Salesforce Editions.
• Для обеспечения необходимых функций, включая обмен сообщениями, встречи и звонки, в организации должны быть настроены соответствующие лицензии Webex.
• Все пользователи, использующие интеграцию, должны иметь доступ к Salesforce и необходимые лицензии Salesforce.
• Все пользователи должны иметь необходимые лицензии Webex для использования определенных функций Webex, таких как Salesforce и в Salesforce. Webex Meetings Webex Calling

  CUCM и Broadworks поддерживаются с частичной функциональностью. Дополнительные сведения см. в разделе Ограничения на звонки в разделе «Вызовы».

• Эта интеграция доступна для Salesforce Lightning.

  Если вы хотите использовать компоненты Lightning, вам необходимо развернуть My Domain в своей организации. Дополнительные сведения см. в разделе Мой домен Salesforce.

• Необходимо настроить доступ пользователей к интеграциям в вашей организации.
  • Без Pro Pack — если у вас есть базовый Control Hub, вы можете разрешить или запретить доступ ко всем интеграциям для всех пользователей.
  • Пакет 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. Дополнительные сведения см. в разделе Salesforce Editions.

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

Если вы хотите использовать компоненты Lightning, вам необходимо развернуть My Domain в своей организации. Дополнительные сведения см. в документации My Domain Salesforce.

Доступ пользователей в Control Hub

Необходимо настроить доступ пользователей к интеграциям в вашей организации.

• Без Pro Pack — если у вас есть базовый Control Hub, вы можете разрешить или запретить доступ ко всем интеграциям для всех пользователей.

• Пакет 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. Введите имя подключенного приложения, например MyExampleApp.
6. Введите контактный адрес электронной почты.
7. Установите флажок «Включить настройки OAuth».
8. Укажите URL-адрес обратного вызова-заполнителя (мы обновим его позже), например. https://localhost/placeholder

   

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

   

   Область «Выполнять запросы в любое время» позволяет Named Credentials обновлять ваш токен доступа по истечении сеанса.

10. Прокрутите страницу вниз и нажмите «Сохранить», затем нажмите «Продолжить».
11. На следующей странице перейдите к разделу API (включите настройки OAuth) и нажмите «Управление сведениями о потребителе».

    

    Возможно, вам потребуется повторно пройти аутентификацию в Salesforce.

12. Запишите «Потребительский ключ» и «Секрет потребителя».

    

Создайте поставщика аутентификации

Затем создайте поставщика аутентификации, который упростит аутентификацию в вашей организации Salesforce.

1. В разделе «Настройка» найдите Auth и выберите Auth. Поставщики. Нажмите кнопку Создать.

   

2. Выберите Salesforce в качестве типа поставщика.
3. Введите имя поставщика аутентификации, например ApexMDtapi.
4. Вставьте ключ потребителя и секрет потребителя, которые вы сохранили при настройке подключенного приложения.
5. Введите полные значения refresh_token offline_access в поле «Области по умолчанию».
6. Оставьте все остальное пустым и нажмите «Сохранить».

   

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

   

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

   

9. Сохраните подключенное приложение.

   Чтобы настройки вступили в силу и распространились по всей инфраструктуре Salesforce, может потребоваться до 10 минут.

Создайте именованные учетные данные

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 Auth:

1. В текстовом поле «Быстрый поиск» введите Auth. Затем выберите поставщика из списка.
2. Выберите ссылку Del в начале записи поставщика аутентификации Webex.
3. Нажмите «ОК», когда вас попросят подтвердить.

Перейдите к следующему разделу, чтобы создать новое приложение Webex Connected для авторизации Salesforce .

Создайте новое приложение Webex Connected для авторизации Salesforce

Чтобы создать новое приложение Webex Connected для авторизации Salesforce, выполните следующие действия:

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

   

4. В разделе Внешние клиентские приложения выберите Настройки.
5. Включите опцию Разрешить создание подключенных приложений. Если кнопка «Новое подключенное приложение» уже включена, вы можете создать новое подключенное приложение.

   

6. Чтобы создать новое подключенное приложение, нажмите «Новое подключенное приложение» и введите необходимые данные.

   

7. В текстовом поле «Быстрый поиск» введите «Диспетчер приложений» и выберите его из списка.
8. Введите имя подключенного приложения, например Webex Salesforce Authorization.
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) нажмите Включить OAuth.
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. Оригинальное приложение Connected остается после миграции.

1. В разделе «Настройка» найдите «Диспетчер приложений» и выберите его.
2. Найдите существующее подключенное приложение, нажмите стрелку вниз в правой части строки и выберите «Просмотр».
3. На странице сведений о подключенном приложении нажмите «Перенести во внешнее клиентское приложение».
4. Ознакомьтесь со сводкой по миграции и нажмите «Перенести».
5. По завершении миграции Salesforce откроет новую страницу сведений о приложении для внешних клиентов.

Проверьте миграцию

1. В разделе «Настройка» выберите «Диспетчер приложений» > «Диспетчер приложений для внешних клиентов».
2. Убедитесь, что авторизация Webex Salesforce отображается в списке.
3. Выберите приложение и убедитесь, что на вкладке «Настройки» указаны правильные URL-адреса обратных вызовов и области OAuth:
   • Полный fullдоступ ()
   • Выполняйте запросы в любое время (refresh_token, offline_access)
4. (Необязательно) Извлеките ключ потребителя и Секрет потребителя и убедитесь, что они соответствуют исходным значениям.

Деактивируйте оригинальное приложение Connected (опционально)

Убедившись, что внешнее клиентское приложение работает, выполните следующее:

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.meta/platform_events/platform_event_limits.htm.

• Компоненты утилиты вызовов Webex недоступны в мобильном приложении Salesforce.