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

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

Виджет «Чат для сайта» JivoSite.

С виджета чата для сайта JivoSite обращения в UIS передаются как Чаты. В UIS будут отображаться:

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

Загрузка может происходить:

• раз в сутки: в UIS будут загружены все чаты (завершенные и незавершенные);
• в режиме реального времени: в UIS будут загружены только завершенные чаты.

Непринятые или отклоненные оператором чаты в виджете JivoSite в UIS загружены не будут.

Виджеты WhatsApp, VK, Telegram JivoSite

С виджета мессенджеров JivoSite обращения в UIS передаются как Заявки. В UIS будут отображаться:

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

Загрузка может происходить:

• раз в сутки;
• в режиме реального времени.

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

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

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

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

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

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

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

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

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

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

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

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

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

Когда ваш менеджер UIS предоставит вам адрес, на который требуется отправлять веб-хук, в личном кабинете JivoSite вам нужно перейти в раздел: «Управление — Каналы связи». Выбираете нужный сайт и нажимаете кнопку «Настроить».

Затем слева переходите в раздел «Настройки интеграции для разработчиков» и вставляете полученный от менеджера адрес в поле «URL для Webhooks».

Также установите код на сайт, полученный от вашего менеджера.

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