АльфаCRM - CRM для детского учебного центра и школы
Функциональность интеграции
- открытие карточки клиента при входящих и исходящих звонках
- исходящий звонок по клику из АльфаCRM
- история звонков
- прослушивание записей звонков из интерфейса АльфаCRM
В карточках клиентов отображаются только успешные вызовы. Пропущенные вызовы и причины их пропуска отображаются в разделе Звонки:
Подключение и настройка
В Личном кабинете UIS войдите в раздел Тарифы и опции, разверните Все опции:
И подключите API «Базовые отраслевые решения»:
Чтобы UIS и АльфаCRM могли обмениваться данными, необходимо внести IP-адрес 195.211.122.131 в белый список UIS и создать авторизационный ключ API.
Перейдите в раздел Аккаунт — Правила и настройки безопасности — вкладка API добавьте 195.211.122.131 в белый список:
195.211.122.131
Чтобы получить авторизационный ключ API, войдите в Управление пользователями и разрешите одному из пользователей (например, Администратору) доступ к API по ключу. Обязательно скопируйте и сохраните ключ — он показывается только один раз, при создании, и понадобится для дальнейшей настройки:
Перейдите по адресу: https://custom.uiscom.ru/alfacrm/ и в открывшейся форме вставьте ключ API, полученный в Личном кабинете UIS:
В случае успешной авторизации откроется окно с настройками:
Не закрывайте это окно, оно понадобится для дальнейшей настройки.
В новой вкладке браузера откройте аккаунт АльфаCRM: в верхнем меню, рядом с логотипом, перейдите в Настройки и в открывшемся списке выберите Интеграции — Телефония:
Выберете поставщика UIS:
В открывшемся окне вставьте ключ API, полученный в личном кабинете UIS, в поле API ключ; скопируйте URL из поля Webhook URL, он понадобится для дальнейшей настройки; задайте логику для всплывающих уведомлений и создания лидов:
Не забудьте сохранить.
Вернитесь на вкладку с авторизацией, вставьте ключ в поле Webhook URL АльфаCRM и сохраните:
Включите интеграцию:
Настройка сотрудников
Сотрудники не копируются автоматически из одного сервиса в другой. Это значит, что сотрудники должны быть созданы вручную и в личном кабинете UIS, и в сервисе AlfaCCRM.
В личном кабинете UIS перейдите в раздел Сотрудники и выберите из списка нужного сотрудника:
Присвойте сотрудникам внутренние номера, если этого не было сделано ранее. Внутренние номера понадобятся в настройках сервиса AlfaCRM:
Перейдите в аккаунт AlfaCRM и в меню слева выберите пункт Доступ в CRM. Выберете нужного сотрудника и нажмите Править:
В поле Номер SIP введите добавочный соответствующего сотрудника в UIS и сохраните:
Повторите со всеми сотрудниками, которые будут работать со звонками.
Настройка уведомлений для передачи данных о звонках
Чтобы данные из UIS передавались в АльфаCRM, необходимо настроить четыре типа HTTP-уведомлений (вебхуков) о событиях.
В Личном кабинете UIS войдите в раздел Уведомления и кликните Добавить:
Необходимо настроить четыре вида уведомлений:
1) Название уведомления: Входящий звонок на виртуальный номер
Тип события: Входящий звонок на виртуальный номер
Способ уведомления: 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}}}
}2) Название уведомления: Завершение звонка
Тип события: Завершение звонка
Способ уведомления: 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}}
}3) Название уведомления: Начало разговора
Тип события: Начало разговора
Способ уведомления: 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}}
}4) Название уведомления: Ожидание ответа
Тип события: Ожидание ответа
Способ уведомления: 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}}}
}Настройка завершена.
