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

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

Звонки

• всплывающие уведомления о входящих звонках

• история общения с клиентом с возможностью прослушивания записанных разговоров:

• добавление нового лида:

• исходящий звонок по клику из Hollihop

• история звонков с возможностью прослушивания записанных разговоров

• список пропущенных звонков:

Маркетинг

• передача UTM-меток из UIS в Hollihop (только при использовании коллтрекинга)

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

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

И подключите API Оптимальный:

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

Перейдите в раздел Аккаунт - Правила и настройки безопасности - вкладка API добавьте 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-уведомлений о событиях.

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

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

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

Название уведомления: Ожидание ответа (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}}}
 }

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

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

Название уведомления: Начало разговора (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}}
 }

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

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

Название уведомления: Завершение звонка (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-метки.