EnvyCRM - универсальная CRM
Функциональность интеграции с EnvyCRM
- создание лида или открытие карточки клиента при входящем звонке
- исходящий звонок по клику на номер
- история звонков
- прослушивание записей звонков из интерфейса 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.
Настройка интеграции завершена.
