Клиентикс CRM

Для того, чтобы UIS и Клиентикс могли обмениваться данными, необходимо внести IP-адрес 195.211.122.131 в белый список UIS и создать авторизационный ключ API.

Перейдите в раздел Аккаунт — Правила и настройки безопасности — вкладка API добавьте 195.211.122.131 в белый список:

Копировать

195.211.122.131

Чтобы получить авторизационный ключ API, войдите в Управление пользователями и разрешите одному из пользователей (например, Администратору) доступ к API по ключу. Обязательно скопируйте и сохраните ключ — он показывается только один раз, при создании, и понадобится для дальнейшей настройки:

Дальнейшая настройка интеграции выполняется для каждого аккаунта (базы) Клиентикс отдельно, если у вас их несколько.

Настройка сотрудников

Сотрудники не копируются автоматически из одного сервиса в другой. Это значит, что сотрудники должны быть созданы вручную и в личном кабинете UIS, и в сервисе Клиентикс.

В личном кабинете UIS перейдите в раздел Сотрудники и откройте карточку нужного сотрудника:

Обязательно укажите внутренний номер сотрудника (произвольный), он понадобится в настройках сервиса Клиентикс:

Внутренний номер может быть любым.

Войдите в Клиентикс под ролью «Владелец», в новом окне откройте ссылку и добавьте поля:

Первое поле:

Имя поля: itool_labs_voip_internal_number
Метка: Внутренний номер сотрудника
Модель: Сотрудники
Сценарий: editEmployee
Тип поля: text

Кликните Сохранить

Второе поле:

Имя поля: itool_labs_voip_internal_number
Метка: Внутренний номер сотрудника
Модель: Сотрудники
Сценарий: edit
Тип поля: text

Кликните Сохранить

Третье поле:

Имя поля: itool_labs_voip_internal_number
Метка: Внутренний номер сотрудника
Модель: Сотрудники
Сценарий: editOwner
Тип поля: text

Кликните Сохранить

Должно получиться так:

Откройте меню Клиентикс, раздел Сотрудники:

Выберите нужного сотрудника или добавьте нового:

Задайте сотруднику тот же внутренний номер, что указывали в личном кабинете UIS:

Настройка исходящих звонков

В меню Клиентикс войдите в раздел Настройки:

Перейдите в раздел Виджеты и выберите Добавить виджеты IP-телефонии IToolLabs:

Добавьте все три виджета:

Для настройки всех трех виджетов в поле «Данные виджета (в JSON)» вставьте код:

Копировать

{"ITOOLLABS_AUTH_TOKEN":"КЛЮЧ API UIS","ITOOLLABSWEBADDRESS":"https://custom.uiscom.ru/klientiks/api/call"}

Выражение «КЛЮЧ API UIS» замените на реальный ключ, полученный в личном кабинете UIS при подключении API.

Кликните Сохранить.

Пример заполнения:

Чтобы позвонить клиенту по клику, сотруднику нужно зайти в карточку клиента и кликнуть на «Звонок клиенту»

Получение данных для обработки входящих звонков

Передача данных о звонках из UIS осуществляется путем отправки http-запроса на URL-адрес вашего аккаунта в Клиентикс CRM. Для формирования этого URL-адреса необходимо получить данные из Клиентикс CRM:

{account_id} — API ID аккаунта
{user_id} — API ID пользователя
{access_token} — API токен авторизации

Чтобы получить эти данные, в Клиентикс CRM войдите в раздел Меню — Настройки:

Включите API:

Если раздел API отсутствует в списке, обратитесь в поддержку Клиентикс CRM для его подключения (использование API доступно не на всех тарифных планах).

После успешного подключения API вы увидите данные, необходимые для формирования URL-адреса:

Важно:

если вы видите вместо трех полей — два, нажмите «Перегенерировать».

URL-адрес формируется следующим образом:

Копировать

https://klientiks.ru/clientix/Restapi/add/a/{account_id}/u/{user_id}/t/{access_token}/m/Calls/

где:
{account_id} — полученный API ID аккаунта
{user_id} — полученный API ID юзера
{access_token} — полученный API токен авторизации

Вставьте полученные данные на место названия параметров и сохраните полученный URL, он понадобится для дальнейшей настройки.

Настройка HTTP-уведомлений

В личном кабинете UIS нужно создать три уведомления, которые будут передавать данные в Клиентикс CRM. Если у вас несколько баз, уведомления нужно создать для каждой отдельно.

Войдите в раздел Уведомления, кликните Добавить уведомление:

В открывшейся форме заполните следующие поля:

1) Название уведомления: Ожидание ответа

Тип события: Ожидание ответа
Способ уведомления: HTTP
Метод: GET
URL: вставьте URL, полученный на предыдущем этапе

В тело уведомления вставьте код:

Копировать

phone={{contact_phone_number}}&type={{direction}}&link=LINK&status=ANSWERED&duration=0&ext={{extension_phone_number}}&callid={{call_session_id}}&cmd=event&app={{app_id}}

2) Название уведомления: Записанный разговор

Тип события: Записанный разговор
Способ уведомления: HTTP
Метод: GET
URL: вставьте URL, полученный на предыдущем этапе

В тело уведомления вставьте код:

Копировать

phone={{contact_phone_number}}&type={{direction}}&link={{file_link}}&status=ANSWERED&duration={{file_duration}}&ext={{extension_phone_number}}&callid={{call_session_id}}&cmd=history&app={{app_id}}

3) Название уведомления: Потерянный звонок

Тип события: Потерянный звонок
Способ уведомления: HTTP
Метод: GET
URL: вставьте URL, полученный на предыдущем этапе

В тело уведомления вставьте код:

Копировать

phone={{contact_phone_number}}&type={{direction}}&link=LINK&status=ANSWERED&duration=0&ext=0&callid={{call_session_id}}&cmd=history&app={{app_id}}

Работа со звонками в Клиентикс CRM

При входящем вызове в Клиентикс CRM всплывает окно:

Для более детальной информации окно можно развернуть, а также выполнить дополнительные действия: открыть карточку клиента, записать клиента или просто «Принять» для скрытия сообщения.