HOLLIHOP - CRM для учебных центров
Функциональность интеграции с Hollihop
Звонки
- всплывающие уведомления о входящих звонках
- история общения с клиентом с возможностью прослушивания записанных разговоров:
- добавление нового лида:
- исходящий звонок по клику из Hollihop
- история звонков с возможностью прослушивания записанных разговоров
- список пропущенных звонков:
Маркетинг
- передача UTM-меток из UIS в Hollihop (только при использовании коллтрекинга)
Подключение и настройка интеграции
В Личном кабинете UIS войдите в раздел Тарифы и опции, разверните Все опции:
И подключите API «Базовые отраслевые решения»:
Чтобы UIS и Hollihop могли обмениваться данными, необходимо внести IP-адрес 195.211.122.131 в белый список UIS и создать авторизационный ключ API.
Перейдите в раздел Аккаунт — Правила и настройки безопасности — вкладка API добавьте 195.211.122.131 в белый список:
195.211.122.131
Чтобы получить авторизационный ключ API, войдите в Управление пользователями и разрешите одному из пользователей (например, Администратору) доступ к API по ключу. Обязательно скопируйте и сохраните ключ — он показывается только один раз, при создании, и понадобится для дальнейшей настройки:
Настройка сотрудников
Сотрудники не копируются автоматически из одного сервиса в другой. Это значит, что сотрудники должны быть созданы вручную и в личном кабинете UIS, и в сервисе Hollihop.
В личном кабинете UIS перейдите в раздел Сотрудники и выберите из списка нужного сотрудника:
Присвойте сотрудникам внутренние номера, если этого не было сделано ранее. Внутренние номера понадобятся в настройках сервиса Hollihop:
Перейдите по адресу: https://custom.uiscom.ru/hollihop/
Авторизуйтесь с помощью ключа API, полученного в личном кабинете UIS. В случае успешной авторизации вы увидите настройки:
Не закрывайте это окно, оно понадобится для дальнейшей настройки.
В новой вкладке браузера откройте Hollihop, перейдите в меню Настройки — Интеграция — API. Выберите вкладку Данные и скопируйте ключ из поля Общий ключ:
Перейдите на вкладку с настройкой интеграции и вставьте ключ в верхнее поле:
В следующее поле введите URL адрес вашей CRM — его вы можете скопировать из письма, которое вам пришло при регистрации, или из адреса в браузере:
Адрес (домен) нужно скопировать без https://* и до .ru включительно, как на скриншоте. Не забудьте Сохранить:
После заполнения обоих полей включите кнопку Интеграция. Если интеграция неактивна, внимательно проверьте заполненные поля.
Настройка на https://custom.uiscom.ru/hollihop/ завершена.
Перейдите в аккаунт Hollihop, вкладка Телефония, поставьте галочку в чек-боксе Использовать API для телефонии и заполните поля:
- в поле Исходящий вызов вставляем: https://custom.uiscom.ru/hollihop/api/call/out/
- в поле Завершение звонка: https://custom.uiscom.ru/hollihop/api/call/end/
- в поле Ключ вставляем ключ API пользователя UIS, по которому авторизовались на https://custom.uiscom.ru/hollihop/:
Настройка добавочного номера у сотрудника Hollihop
В разделе Компания войдите в меню Сотрудники и откройте карточку сотрудника, которого нужно связать с UIS:
В правом верхнем меню выберите Телефония:
В открывшейся форме введите внутренний номер сотрудника, который вы задали в настройках UIS и кликните Сохранить.
Повторите с каждым сотрудником, которого нужно связать с UIS.
Для того, чтобы CRM Hollihop могла фиксировать пропущенные звонки без ответственного сотрудника, необходимо создать в CRM Hollihop «системного» сотрудника без внутреннего (добавочного номера). В разделе Компания войдите в меню Сотрудники и кликните Добавить:
Заполните необходимые поля и кликните Зарегистрировать:
В открывшейся форме в правом верхнем меню выберите пункт Телефония:
И в поле Внутренний номер введите «Нет добавочного»:
Не забудьте сохранить.
Настройка в Hollihop завершена.
Настройка уведомлений для передачи данных
Чтобы данные из UIS передавались в CRM Hollihop, необходимо настроить три типа HTTP-уведомлений о событиях.
Перейдите в раздел Сервисы и статистика — Уведомления и кликните Добавить.
Потребуется настроить три уведомления:
1) Название уведомления: Ожидание ответа (Hollihop)
Тип события: Ожидание ответа
Способ уведомления: HTTP
Метод: POST
URL: https://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}},
"utm": {"source": {{utm_source}},
"medium": {{utm_medium}},
"campaign": {{utm_campaign}},
"term":{{utm_term}},
"content":{{utm_content}}}
}2) Название уведомления: Начало разговора (Hollihop)
Тип события: Начало разговора
Способ уведомления: HTTP
Метод: POST
URL: https://custom.uiscom.ru/hollihop/api/webhook/
В тело уведомления вставьте текст:
{
"app_id":{{app_id}},
"action":"answer",
"direction":{{direction}},
"callId":{{call_session_id}},
"answer": {{extension_phone_number}}
}3) Название уведомления: Завершение звонка (Hollihop)
Тип события: Завершение звонка
Способ уведомления: HTTP
Метод: POST
URL: https://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}},
"ext": {{extension_phone_number}}
}Пример отображения звонка в HolliHop:
Если вы используете коллтрекинг в UIS, то в описании обращения в HolliHop отобразятся UTM-метки.
