Инструкция по интеграции UIS с Chat2Desk

Обращения через виджеты Chat2Desk можно загружать в UIS в виде чатов.

В UIS отображаются:

• контактные данные посетителя сайта (телефон и/или email);
• ФИО посетителя сайта;
• рекламный источник, с которого посетитель перешел на сайт.

Чаты загружаются раз в сутки.

Чтобы подключить интеграцию, вам понадобятся помощь вашего менеджера UIS и выполнение части настроек в кабинете UIS.

1. Подключение опции API

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

В меню слева переходим в раздел «Тарифы и опции». В правом столбце сначала нажимаем «Все опции» и находим нужную для подключению опцию.

2. Генерация ключа API

Чтобы отправлять запросы для загрузки данных UIS, требуется сформировать ключ API. В правом верхнем углу переходим в «Администратор — Управление пользователями».

Далее либо добавляем нового пользователя, либо переходим в редактирование текущего нажатием на название пользователя.

В настройках пользователя внизу ставим галочки: DataAPI, Использовать ключ API. Переводим чек-бокс в статус «Вкл», копируем сгенерированный ключ API и сохраняем настройки пользователя.

Сгенерированный ключ нужно будет передать вашему менеджеру UIS.

3. Добавления IP-адреса в список разрешенных

В целях безопасности для отправления запросов на загрузку данных в личный кабинет UIS требуется указывать список IP-адресов, с которых будут поступать запросы.

В меню слева переходим в раздел «Правила и настройки безопасности», далее жмем на вкладку «API». После этого нажимаем кнопку «Добавить», вводим IP-адреса: 195.211.121.59 и 195.211.122.132 и нажимаем на значок дискеты.

4. Создание сотрудника в личном кабинете UIS

Для загрузки чатов из Chat2Desk в личном кабинете UIS требуется создать сотрудника или использовать действующего.

Чтобы создать нового сотрудника, в левом меню переходим в раздел «Сотрудники» и жмем кнопку «Добавить сотрудника».

Указываем у сотрудника ФИО, телефон, канальность и нажимаем кнопку «Создать».

Чтобы узнать ID сотрудника, который требуется передать вашему менеджеру, после создания сотрудника нужно перейти в его настройки нажатием на имя сотрудника.

Когда откроется окно с настройками сотрудника, вам нужно из адресной строки браузера взять цифры из параметра controller.params.recordId=XXXXXXX.

5. Создание рекламного источника

Для загрузки заявок из Chat2Desk в личном кабинете UIS требуется создать рекламный источник.

В левом меню переходим в раздел «Аналитика — Рекламные кампании» и нажимаем кнопку «Добавить рекламную кампанию».

В Шаг 1 выбираем «Самостоятельная настройка». В Шаг 2 указываем название кампании и нажимаем кнопку «Создать кампанию».

Чтобы узнать ID рекламной кампании, который требуется передать вашему менеджеру, после создания рекламной кампании нужно перейти в его настройки нажатием на название рекламной кампании.

Когда откроется окно с настройками рекламной кампании, вам нужно из адресной строки браузера взять цифры из параметра controller.params.adCampaignId=XXXXXXX.

Для настройки интеграции вашему менеджеру UIS требуется передать API-токен из личного кабинета Chat2Desk.

В меню слева перейдите в раздел «API» и нажмите кнопку «Показать» напротив строки API-токен. Отобразившийся токен нужно скопировать и передать вашему менеджеру.

Настройка завершена.