Интегрируйте airfocus с Salesforce.

Преимущества использования интеграции Salesforce

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

• Беспрепятственно импортируйте обращения и возможности Salesforce в качестве объектов в airfocus, чтобы получать аналитические данные для поиска и приоритизации продуктов.
• Возможность гибко сопоставлять множество полей системы Salesforce с полями airfocus.

требования

Для использования системы Salesforce пользователям необходимо выполнить следующие требования:

На аэрофокусе

• Пользователи должны иметь полные права доступа к рабочему пространству.
• команде airfocus необходимо подключиться к тарифному плану «Корпоративный».

В Salesforce

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

• По крайней мере, должны быть предоставлены права на чтение всех объектов/информации, которые должны синхронизироваться через интеграцию.
• Параметры «API включен» и «Управление подключенными приложениями» были включены. Системные администраторы могут проверить это для любого из своих настроенных профилей через меню «Настройка» > «Администрирование» > «Управление пользователями» > «Профили».
• По умолчанию при создании приложения в Salesforce включена опция "Требовать расширения Proof Key for Code Exchange (PKCE) для поддерживаемых потоков авторизации". Этот флаг необходимо отключить.

Дополнительные параметры для синхронизации "обращений":

• Для работы с Salesforce организации необходимо иметь подписку на Salesforce Service Cloud и доступ к «Web Services API», который в настоящее время доступен в версиях «Professional» (за дополнительную плату), «Корпоративный» и «Unlimited».
  

Дополнительные параметры для синхронизации «возможностей»:

• Для работы с Salesforce организации необходимо иметь подписку на Salesforce Sales Cloud и доступ к «Web Services API», который в настоящее время доступен в версиях «Professional» (за дополнительную плату), «Корпоративный» и «Unlimited».
  

Настройка интеграции

Настройка интерфейса проста и займет всего несколько минут. Вот как это сделать:

Войдите в AirFocus

Сначала зарегистрируйтесь в airfocus или войдите в свою существующую учетную запись. Создайте новое рабочее пространство в AirFocus или выберите то, с которым вы хотите интегрировать Salesforce.

Добавьте интеграцию Salesforce в airfocus

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

Для настройки интеграции перейдите в раздел «Управление интеграцией» в ваших расширениях и подключитесь к Salesforce.

На следующем экране вам нужно выбрать пункт «Подключить новый экземпляр Salesforce» из выпадающего меню. Если вы ранее подключались к экземплярам Salesforce в своей команде, в этом раскрывающемся списке будут отображены все доступные экземпляры Salesforce. Вы можете создать столько интеграций Salesforce с одним экземпляром Salesforce, сколько захотите.

Далее вам нужно присвоить имя новому подключению к экземпляру Salesforce (которое позже будет отображаться в AirFocus). Ниже вы можете вставить ключ потребителя (идентификатор клиента) и секретный ключ потребителя (секретный ключ клиента) вашего приложения, подключенного к Salesforce, чтобы иметь возможность подключиться к Salesforce.

Настройте подключенное приложение в Salesforce.

1. Войдите в свою организацию Salesforce.
2. Откройте страницу настроек подключенных приложений:
   • Если вы используете Salesforce Classic, перейдите в раздел Настройка > Настройка приложений > Создать > Приложения.
     
   • Если вы используете Salesforce Lightning, перейдите в Настройки > Инструменты платформы > Приложения > Диспетчер приложений.
     
     
3. Создайте новое подключенное приложение:
   • Если вы используете Salesforce Classic : в разделе «Подключенные приложения» нажмите «Создать».
     
   • Если вы используете Salesforce Lightning : рядом с "Lightning Experience App Manager" нажмите "Создать новое подключенное приложение".
     
4. Заполните раздел с основной информацией:
   • Название подключенного приложения: например, «airfocus».
   • Название API: например, “airfocus”.
   • Контактный адрес электронной почты: ваш адрес электронной почты.
     
5. В разделе API (Включить настройки OAuth):
   • Установите флажки напротив пункта «Включить настройки OAuth».
   • В зависимости от вашего сервера AirFocus (см. примечание ниже) — скопируйте этот URL-адрес обратного вызова:
     • Европейский сервер : https://app.airfocus.com/api/integration-providers/salesforce/callback и вставьте его в поле "URL обратного вызова".
     • Сервер в США: https://app.airfocus.com/api/integration-providers/salesforce/callback и вставьте его в поле "URL обратного вызова".
     • Новый сервер в США (если вы находитесь в США или Азиатско-Тихоокеанском регионе и ваша учетная запись была создана после сентября 2025 года): https://app.airfocus.app/api/integration-providers/salesforce/callback и вставьте его в поле "URL обратного вызова".
   • В разделе «Выбранные области действия OAuth» добавьте следующие области действия:
     • Управление пользовательскими данными через API (API).
     • Выполняйте запросы в любое время (refresh_token, offline_access).
       
     • Примечание: чтобы узнать местоположение вашего сервера AirFocus, проверьте URL-адрес AirFocus. Если он содержит us.airfocus, значит, сервер находится в США; если нет, то в Европе. Например: teamname.us.airfocus.com вместо teamname.airfocus.com
     • Обратите внимание: если вы находитесь в США или Азиатско-Тихоокеанском регионе и ваша учетная запись была создана после сентября 2025 года, URL-адрес будет teamname.airfocus.app
6. Нажмите «Сохранить». На следующем экране вы увидите сообщение о том, что для применения изменений может потребоваться до 10 минут. Нажмите «Продолжить». Подождите 10 минут.
   

Примечание: Вы будете перенаправлены на страницу управления подключенным приложением, поэтому вы можете сразу перейти к пункту 4 в следующем разделе этого руководства.

Подключите AirFocus к Salesforce.

1. Войдите в свою организацию Salesforce.
2. Откройте страницу настроек подключенных приложений:
   • Если вы используете Salesforce Classic, перейдите в раздел Настройка > Настройка приложений > Создать > Приложения.
     
   • Если вы используете Salesforce Lightning, перейдите в Настройки > Инструменты платформы > Приложения > Диспетчер приложений.
     
3. Откройте обзор подключенного приложения:
   • Если вы используете Salesforce Classic, в разделе «Подключенные приложения» щелкните по названию подключенного приложения airfocus.
     
   • Если вы используете Salesforce Lightning, в таблице щелкните стрелку раскрывающегося списка вашего приложения и выберите «Просмотреть».
     
4. В разделе «API (Включить настройки OAuth)» нажмите «Управление данными потребителя».
   
5. Возможно, вам потребуется подтвердить свою личность в Salesforce.
6. Скопируйте «Ключ потребителя» и «Секрет потребителя» и вставьте их в соответствующие поля в настройках интеграции airfocus с Salesforce.
   
   
7. Нажмите кнопку «Подключиться» на airfocus.
8. Вы будете перенаправлены на экран подтверждения Salesforce. Нажмите «Разрешить».
   

Настройте свою интеграцию

Вы можете присвоить имя интеграции, введя его в поле «Имя», расположенное в верхней части страницы настроек интеграции Salesforce. Это название также будет отображаться во всплывающем окне обзора интеграции и расширений для удобства идентификации.

Фильтры

Выберите тип объекта Salesforce, который вы хотите импортировать/синхронизировать с airfocus. В настоящее время интеграция поддерживает обращения и возможности Salesforce. Если вы хотите синхронизировать оба типа объектов, вам необходимо настроить отдельное интеграция для каждого из них (они могут подключаться через один и тот же экземпляр Salesforce, поэтому вам не нужно создавать отдельное приложение для каждого типа объекта).

Выберите дату с помощью средства выбора даты в поле «Импортировать объекты, созданные после», чтобы импортировать только объекты, созданные после выбранной даты. Если вы не укажете здесь дату, интеграция импортирует все объекты Salesforce выбранного вами типа.

Вы можете дополнительно отфильтровать объекты, подлежащие синхронизации, введя условие WHERE для языка запросов к объектам Salesforce (SOQL). Объедините несколько условий с помощью операторов И или ИЛИ. Если вы выберете начальную дату в поле выше, она будет автоматически добавлена в условие WHERE. Для всех полей, на которые здесь даны ссылки, необходимо определить соответствие в разделе «Соответствие полей» ниже. Узнать больше.

Картирование полей

Используйте функцию сопоставления, чтобы определить, как информация из Salesforce должна сопоставляться с airfocus. Названия и описания объектов всегда сопоставляются по умолчанию при настройке нового объекта и могут быть удалены или изменены по желанию.

Как добавить новое сопоставление полей

При выборе поля в выпадающем списке на стороне AirFocus будут отображаться только поля, соответствующие типу поля. Наша интеграция позволяет сопоставлять поля основного типа объекта (выбранного выше), а также поля непосредственно связанных объектов.

В приведенном ниже примере пользователь выбрал «Обращение» в качестве типа объекта Salesforce для импорта/синхронизации. Поле «Приоритет» (выделено красным) является системным полем объекта «Обращение». Поле "Идентификатор дела" (выделено зеленым) является системным полем объекта "Основная запись", который напрямую связан с "Делом".

Проще говоря: если поле находится максимум в одном клике от синхронизированного объекта в Salesforce, вы можете сопоставить его с элементом AirFocus (применяются условия, описанные в этой статье).

В настоящее время интеграция позволяет синхронизировать информацию из Salesforce в airfocus только в одном направлении.

После выбора двух полей, которые вы хотите сопоставить, вы можете выбрать параметры полей и способ их сопоставления. Вы также можете сопоставить несколько параметров полей Salesforce с одним параметром поля airfocus.

Доступные типы полей для сопоставления

В настоящее время интеграция позволяет синхронизировать системные поля из Salesforce в airfocus только в одном направлении. Вот список возможных вариантов сопоставления полей, которые вы можете настроить:

Как определить тип поля в Salesforce

Список всех доступных/настроенных полей для вашего типа объекта Salesforce (например, «Обращение» или «Возможность») можно найти в настройках Salesforce:

1. Войдите в организацию Salesforce, которую вы подключаете к airfocus.
2. На главной панели управления Salesforce нажмите на значок шестеренки рядом с вашим аватаром профиля и выберите « Настройка ».
   
3. На боковой панели настроек щелкните «Инструменты платформы» > «Объекты и поля» > « Менеджер объектов ».
   
4. Найдите тип объекта, для которого вы хотите просмотреть типы полей, и щелкните по метке этого объекта.
   
5. В боковой панели типа объекта (например, «Обращение») щелкните «Поля и связи» и просмотрите столбец «Тип данных» таблицы, чтобы определить тип поля для любого поля, которое вы настроили для этого типа объекта.
   
6. Определить, является ли поле пользовательским или системным, можно, просмотрев столбец «Название поля» в таблице. Если имя поля заканчивается на «__c», это пользовательское поле.
   

Дополнительные настройки

Если включена опция "Архивировать неизвестные объекты" , ранее импортированные объекты будут архивированы в AirFocus, если они больше не присутствуют в Salesforce или больше не соответствуют фильтрам, установленным для интеграции.

Если включена функция « Автоматическая синхронизация», ваша интеграция будет автоматически синхронизироваться каждые 10 минут и каждый раз при доступе к рабочему пространству.

Нажав кнопку « Просмотреть журналы», вы сможете просмотреть журналы интеграции и опросов Salesforce и увидеть, какие изменения были внесены до последней синхронизации.

Чтобы сохранить настройки и импортировать объект в AirFocus, нажмите «Обновить и синхронизировать».

Важные примечания

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

В настоящее время интеграция ограничивается синхронизацией максимального количества файлов. 2000 объектов Salesforce.

В системе Salesforce ваше подключенное приложение считается "приложением, не относящимся к SDFC". Пожалуйста, ознакомьтесь с основным соглашением об оказании услуг Salesforce, если вы хотите изучить их политику в отношении использования приложений, не относящихся к SDFC, и использования таких приложений для обслуживания модулей.

Оставьте отзыв об этой статье