создание лида или открытие карточки клиента при входящем звонке
исходящий звонок по клику на номер
история звонков
прослушивание записей звонков из интерфейса EnvyCRM
соединение звонящего с персональным менеджером из CRM (доступно при подключении опции «API Расширенный»)

Шаг 1: Подключение интеграции

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

И подключите API «Базовые отраслевые решения».

Если вы будете использовать соединение звонящего с персональным менеджером, выберите опцию «API Расширенный».

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

В личном кабинете UIS войдите в раздел Правила и настройки безопасности, вкладка API, и добавьте IP-адреса 82.202.217.214 и 45.12.65.147 в белый список.

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

В аккаунте EnvyCRM войдите в раздел Настройки — Интеграции, выберите UIS и нажмите Подключить.

Теперь внесите ключ API в настройки интеграции.

Далее внесите в настройки EnvyCRM виртуальные номера UIS и добавьте номера для сотрудников.

Виртуальные номера UIS можно получить в разделе Управление номерами в личном кабинете UIS.

Скопируйте номер и внесите его в настройки интеграции в аккаунте EnvyCRM. На этом же шаге скопируйте и сохраните ссылку для оповещений, она понадобится для дальнейшей настройки.

Шаг 2: Настройка сотрудников

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

Важно:

не используйте для этой цели добавочные номера сотрудников, это не будет работать.

Шаг 3: Настройка вебхуков

Чтобы данные из UIS передавались в EnvyCRM, нужно настроить три типа HTTP-уведомлений о событиях.

В личном кабинете UIS войдите в раздел Уведомления, нажмите Добавить уведомление.

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

1) Название уведомления: Входящий звонок

Тип события: Входящий звонок на виртуальный номер
Способ уведомления: HTTP
Метод: GET
URL: вставьте ссылку для оповещений, скопированную в настройках CRM (на Шаге 1)

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

Копировать

event=call_start
&direction={{direction}}
&line_number={{virtual_phone_number}}
&client_number={{contact_phone_number}}
&call_hash={{call_session_id}}

Кликните Создать.

2) Название уведомления: Исходящий звонок

Тип события: Исходящий звонок
Способ уведомления: HTTP
Метод: GET
URL: вставьте ссылку для оповещений, скопированную в настройках CRM (на Шаге 1)

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

Копировать

event=call_start
&direction={{direction}}
&line_number={{virtual_phone_number}}
&client_number={{contact_phone_number}}
&extension={{employee_phone_number}}
&call_hash={{call_session_id}}

Кликните Создать.

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

Тип события: Завершение звонка
Способ уведомления: HTTP
Метод: GET
URL: вставьте ссылку для оповещений, скопированную в настройках CRM (на Шаге 1)

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

Копировать

event=call_end
&line_number={{virtual_phone_number}}
&client_number={{contact_phone_number}}
&extension={{employee_phone_number}}
&call_hash={{call_session_id}}
&direction={{direction}}
&talk_time_duration={{talk_time_duration}}
&record_links={{record_file_links}}

Кликните Создать.

Настройка соединения с персональным менеджером

При подключении опции API Расширенный можно настроить автоматическое соединение звонящего с его персональным менеджером. Если он не ответит, звонок будет обработан по любому другому алгоритму, заданному в настройках UIS.

В личном кабинете UIS войдите в раздел Виртуальная АТС → Сценарии и кликните Добавить сценарий.

Задайте название сценария, кликните + и в настройках Распределения вызовов выберите операцию Интерактивная обработка вызова.

Заполните поле URL для авторизации. В тело запроса вставьте текст формата:

https://поддомен.envycrm.com/hook/uis?event=redirect_incoming (вместо слова поддомен указать поддомен вашей EnvyCRM, например, https://test.envycrm.com/hook/uis?event=redirect_incoming) и поставьте галочку в поле «Номер абонента»

Для случаев, когда звонок поступает от клиента, не добавленного в CRM, возможен вариант звонка группе ответственных сотрудников.

Нажмите на «+» и выберите «Ошибка http-запроса».

Далее выберите операция «Переадресация» — «Переадресация».

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

Добавьте группу сотрудников для обработки звонков, настройте способ дозвона до сотрудников и задайте связанные операции на случай, если сотрудники не ответят на звонок. Сохраните новый сценарий и прикрепите его к виртуальному номеру. Мы рекомендуем не удалять предыдущие правила обработки звонков — так вам будет проще вернуться к прежнему алгоритму, если вы откажетесь от использования CRM.

Настройка интеграции завершена.

Эта статья была полезна для людей. Эта статья помогла Вам?

Да, помогла!

Вопрос не решён