АльфаCRM - CRM для детского учебного центра и школы

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

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

В карточках клиентов отображаются только успешные вызовы. Пропущенные вызовы и причины их пропуска отображаются в разделе Звонки:

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

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

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

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

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

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

Перейдите по адресу: https://custom.uiscom.ru/alfacrm/ и в открывшейся форме вставьте ключ API, полученный в Личном кабинете UIS:

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

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

В новой вкладке браузера откройте аккаунт АльфаCRM: в верхнем меню, рядом с логотипом, перейдите в Настройки и в открывшемся списке выберите Интеграции - Телефония:

Выберете поставщика Uiscom:

В открывшемся окне вставьте ключ API, полученный в личном кабинете UIS, в поле API ключ; скопируйте URL из поля Webhook URL, он понадобится для дальнейшей настройки; задайте логику для всплывающих уведомлений и создания лидов:

Не забудьте сохранить.

Вернитесь на вкладку с авторизацией, вставьте ключ в поле Webhook URL АльфаCRM и сохраните:

Включите интеграцию:

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

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

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

Присвойте сотрудникам внутренние номера, если этого не было сделано ранее. Внутренние номера понадобятся в настройках сервиса AlfaCRM:

Перейдите в аккаунт AlfaCRM и в меню слева выберите пункт Доступ в CRM. Выберете нужного сотрудника и нажмите Править:

В поле Номер SIP введите добавочный соответствующего сотрудника в UIS и сохраните:

Повторите со всеми сотрудниками, которые будут работать со звонками.

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

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

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

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

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

Название уведомления: Входящий звонок на виртуальный номер

Тип события: Входящий звонок на виртуальный номер

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

Метод: POST

URL: https://custom.uiscom.ru/alfacrm/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}}}
 }

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

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

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

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

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

Метод: POST

URL: https://custom.uiscom.ru/alfacrm/webhook/

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

{
"app_id":{{app_id}},
"action":"hangup",
"direction":{{direction}},
"callId":{{call_session_id}},
"cause":{{lost_reason}},
"audioUrl":{{record_file_links}},
 "from": {{contact_phone_number}},
"local_number": {{extension_phone_number}},
"duration": {{total_time_duration}},
"is_lost": {{is_lost}},
"finish_reason": {{lost_reason}},
"noanswered_employee_full_names":{{noanswered_employee_full_names}}
}

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

• для третьего типа:

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

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

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

Метод: POST

URL: https://custom.uiscom.ru/alfacrm/webhook/

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

{
 "app_id":{{app_id}},
 "action":"answer",
 "direction":{{direction}},
 "callId":{{call_session_id}},
 "answer": {{extension_phone_number}},
 "from": {{contact_phone_number}}
}

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

• четвертое:

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

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

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

Метод: POST

URL: https://custom.uiscom.ru/alfacrm/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}}}
 }

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

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