HOLLIHOP - CRM для учебных центров

Со свежими изменениями:


Функциональность интеграции с CRM Hollihop

  • открытие карточки клиента при:
    • входящем звонке
    • исходящем звонке
  • исходящий звонок из CRM Hollihop
  • история звонков
  • прослушивание записей звонков из интерфейса CRM Hollihop
  • завершение звонка из CRM Hollihop

Подключение и настройка интеграции

Интеграция доступна на любом тарифном плане, кроме "Первого шага" и только при использовании SIP-телефонии.

Для интеграции необходимо подключить компоненты Уведомления и Call API в личном кабинете UIS. Уведомления понадобятся, чтобы передавать информацию о звонках из UIS в Hollihop, а Call API - для работы исходящего звонка по клику из Hollihop.

В личном кабинете UIS войдите в раздел Администратор - Аккаунт - Тариф и опции и подключите компоненты:

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

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

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

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

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

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



Перейдите в раздел Сотрудники и выберите из списка нужного сотрудника:

Укажите внутренний номер сотрудника. Он понадобится в настройках сервиса Hollihop:

Перейдите по адресу: http://custom.uiscom.ru/hollihop/

Авторизуйтесь с помощью ключа API, полученного в личном кабинете UIS.

Если какой либо из компонентов API не подключен, вы увидите окно с ошибкой:

В случае успешной авторизации вы увидите настройки:

ВНИМАНИЕ! Не закрывайте это окно, оно понадобится для дальнейшей настройки.

В другой вкладке браузера откройте Hollihop.

  1. Перейдите в меню Настройки
  2. Выберете Интеграции
  3. Перейдите на вкладку API
  4. Выберете вкладку Данные (если она не выбрана)
  5. Скопируйте ключ из поля Общий ключ

Перейдите на вкладку с настройкой интеграции и вставьте ключ в первое поле:

Во второе поле введите url адрес вашей CRM. Адрес вы можете скопировать из письма которое вам пришло при регистрации или с адреса в браузере:

Внимание! Адрес нужно скопировать без http://* и после RU не должно быть */

Нажмите сохранить:

После этого возможность включить интеграцию станет доступна. Включите её нажатием на переключатель Интеграция. При верно заполненных полях, интеграция включится. Если этого не произошло, то проверьте внимательно заполненные поля.

Настройка на http://custom.uiscom.ru/hollihop/ завершена. Переходим обратно в CRM Hollihop.

  1. Выбираем вкладку Телефония
  2. В поле Исходящий вызов пишем адрес: http://custom.uiscom.ru/hollihop/api/call/out/
  3. В поле Завершение звонка пишем адрес: http://custom.uiscom.ru/hollihop/api/call/end/
  4. В поле Ключ вставляем Ключ API, который мы получили в личном кабинете UIS (по нему мы ранее авторизовались на http://custom.uiscom.ru/hollihop/)

Настройка добавочного номера у сотрудника Hollihop

  1. Перейдите в раздел Компания
  2. Выберете Сотрудники
  3. Выберете необходимого сотрудника, кликнув по нему

В правом верхнем меню Дополнительно выберете Телефония

В появившемся окне введите необходимый номер сотрудника, который вы задали ране в настройках UIS. Вы можете добавлять ещё номера, кликая на плюс рядом с полем ввода. Нажмите сохранить.

На этом настройка в Hollihop закончена.

Настройка уведомлений для передачи данных

Чтобы данные из UIS передавались в CRM Hollihop, необходимо настроить три типа HTTP-уведомлений о событиях.

Перейдите в раздел Сервисы и статистика - Уведомления и кликните Добавить

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

  • для первого типа уведомлений (Ожидание ответа):

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

Тип события: Ожидание ответа

Способ уведомления: HTTP

Метод: POST

URL: http://custom.uiscom.ru/hollihop/api/webhook/

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

{
 "action": "wait", 
 "app_id": {{app_id}}, 
 "callId": {{call_session_id}}, 
 "call_source": {{call_source}}, 
 "communication_type": {{communication_type}}, 
 "from":{{contact_phone_number}}, 
 "direction": {{direction}}, 
 "is_transferred": {{is_transferred}}, 
 "leg_id": {{leg_id}}, 
 "startTime": {{start_time}}, 
 "called_phone_number": {{called_phone_number}}, 
 "trunkNumber": {{virtual_phone_number}},
 "to": {{extension_phone_number}}
}

Нажмите "Создать".

  • для второго типа уведомлений (Начало разговора):

Название уведомления: Начало разговора (Hollihop)

Тип события: Начало разговора

Способ уведомления: HTTP

Метод: POST

URL: http://custom.uiscom.ru/hollihop/api/webhook/

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

{
"app_id":{{app_id}},
"action":"answer",
"direction":{{direction}},
"callId":{{call_session_id}}
}

Нажмите "Создать".

  • для третьего типа уведомлений (Завершение звонка):

Название уведомления: Завершение звонка (Hollihop)

Тип события: Завершение звонка

Способ уведомления: HTTP

Метод: POST

URL: http://custom.uiscom.ru/hollihop/api/webhook/

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

{
"app_id":{{app_id}},
"action":"hangup",
"direction":{{direction}},
"callId":{{call_session_id}},
"cause":{{lost_reason}},
"audioUrl":{{record_file_links}}
}

Нажмите "Создать".

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


Эта статья помогла Вам?
Подпишитесь на рассылку

Обещаем присылать только полезную информацию