Альфа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}}} }
Нажмите Создать.
Настройка завершена 🙂