Продукты Решения Тарифы Партнерам
Клиентам
Получить консультацию
Связаться

YUcrm - CRM для недвижимости

Дата публикации: 7 июля 2021

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

  • открытие карточки клиента при:
    • входящем звонке
    • исходящем звонке
    • переадресации (трансфере) от другого сотрудника
  • исходящий звонок из YUcrm
  • история звонков
  • прослушивание записей звонков из интерфейса YUcrm
  • дополнительная информация в истории звонка:
    • звонок из CRM
    • обратный звонок
    • звонок через пин-код
    • аналитика
    • звонок из ВАТС
    • звонок с SIP линии
    • целевое событие
    • офлайн заявка
    • чат
  • соединение звонящего с персональным менеджером из CRM (доступно при подключении опции «API Расширенный»)

Для подключения функциональности коллтрекинга обратитесь к вашему персональному менеджеру в YUcrm.

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

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

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

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

Перейдите в раздел Аккаунт — Правила и настройки безопасности — вкладка API добавьте 0.0.0.0/0 в белый список:

Копировать
0.0.0.0/0

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

Важно:

для подключения интеграции обязательно передайте сгенерированный ключ API с логином и паролем инженерам технической поддержки в YUcrm.

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

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

Перейдите в раздел Сервисы и статистика — Уведомления и кликните Добавить

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

1) Название уведомления: YUcrm. Входящее плечо

Тип события: Входящее плечо
Способ уведомления: HTTP
Метод: GET
URL: https://вашдомен.yucrm.ru/webhooks/uiscom

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

Копировать
notification_name={{notification_name}}
&notification_time={{notification_time}}
&external_id={{external_id}}
&contact_phone_number={{contact_phone_number}}
&contact_id={{contact_id}}
&employee_full_name={{employee_full_name}}
&employee_id={{employee_id}}
&call_source={{call_source}}
&call_session_id={{call_session_id}}
&direction={{direction}}
&leg_id={{leg_id}}
&notification_mnemonic={{notification_mnemonic}}
&start_time={{start_time}}
&called_phone_number={{called_phone_number}}
&talk_time_duration={{talk_time_duration}}

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

Тип события: Входящий звонок на виртуальный номер
Способ уведомления: HTTP
Метод: GET
URL: https://вашдомен.yucrm.ru/webhooks/uiscom

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

Копировать
notification_name={{notification_name}}
&virtual_phone_number={{virtual_phone_number}}
&notification_time={{notification_time}}
&scenario_name={{scenario_name}}
&contact_phone_number={{contact_phone_number}}
&communication_number={{communication_number}}
&contact_id={{contact_id}}
&contact_full_name={{contact_full_name}}
&call_session_id={{call_session_id}}
&notification_mnemonic={{notification_mnemonic}}
&start_time={{start_time}}
&called_phone_number={{called_phone_number}}
&talk_time_duration={{talk_time_duration}}

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

Тип события: Завершение звонка
Способ уведомления: HTTP
Метод: GET
URL: https://вашдомен.yucrm.ru/webhooks/uiscom

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

Копировать
notification_name={{notification_name}}
&virtual_phone_number={{virtual_phone_number}}
&notification_time={{notification_time}}
&external_id={{external_id}}
&contact_phone_number={{contact_phone_number}}
&contact_phone_number={{contact_phone_number}}
&communication_number={{communication_number}}
&employee_full_name={{employee_full_name}}
&employee_id={{employee_id}}
&call_source={{call_source}}
&call_session_id={{call_session_id}}
&direction={{direction}}
&scenario_name={{scenario_name}}
&talk_time_duration={{talk_time_duration}}
&total_time_duration={{total_time_duration}}
&wait_time_duration={{wait_time_duration}}
&notification_mnemonic={{notification_mnemonic}}
&record_file_links={{record_file_links}}
&start_time={{start_time}}
&called_phone_number={{called_phone_number}}
&finish_reason={{finish_reason}}
&talk_time_duration={{talk_time_duration}}

4) Название уведомления: YUcrm. Завершение плеча

Тип события: Завершение плеча
Способ уведомления: HTTP
Метод: GET
URL: https://вашдомен.yucrm.ru/webhooks/uiscom

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

Копировать
notification_name={{notification_name}}
&notification_time={{notification_time}}
&external_id={{external_id}}
&contact_phone_number={{contact_phone_number}}
&contact_id={{contact_id}}
&employee_full_name={{employee_full_name}}
&employee_id={{employee_id}}
&call_source={{call_source}}
&call_session_id={{call_session_id}}
&direction={{direction}}
&leg_id={{leg_id}}
&notification_mnemonic={{notification_mnemonic}}
&start_time={{start_time}}
&called_phone_number={{called_phone_number}}
&talk_time_duration={{talk_time_duration}}

5) Название уведомления: YUcrm. Записанный разговор

Тип события: Записанный разговор
Способ уведомления: HTTP
Метод: GET
URL: https://вашдомен.yucrm.ru/webhooks/uiscom

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

Копировать
notification_name={{notification_name}}
&virtual_phone_number={{virtual_phone_number}}
&notification_time={{notification_time}}
&scenario_name={{scenario_name}}
&contact_phone_number={{contact_phone_number}}
&communication_number={{communication_number}}
&contact_id={{contact_id}}
&contact_full_name={{contact_full_name}}
&call_session_id={{call_session_id}}
&employee_full_name={{employee_full_name}}
&file_duration={{file_duration}}
&file_link={{file_link}}
&notification_mnemonic={{notification_mnemonic}}
&start_time={{start_time}}
&called_phone_number={{called_phone_number}}
&finish_reason={{finish_reason}}
&talk_time_duration={{talk_time_duration}}
&leg_ids={{leg_ids}}

6) Название уведомления: YUcrm. Исходящее плечо

Тип события: Исходящее плечо
Способ уведомления: HTTP
Метод: GET
URL:https://вашдомен.yucrm.ru/webhooks/uiscom

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

Копировать
notification_name={{notification_name}}
&notification_time={{notification_time}}
&external_id={{external_id}}
&contact_phone_number={{contact_phone_number}}
&contact_id={{contact_id}}
&employee_full_name={{employee_full_name}}
&employee_id={{employee_id}}
&call_source={{call_source}}
&call_session_id={{call_session_id}}
&direction={{direction}}
&leg_id={{leg_id}}
&notification_mnemonic={{notification_mnemonic}}
&start_time={{start_time}}
&called_phone_number={{called_phone_number}}
&talk_time_duration={{talk_time_duration}}

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

Тип события: Исходящий звонок
Способ уведомления: HTTP
Метод: GET
URL: https://вашдомен.yucrm.ru/webhooks/uiscom

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

Копировать
notification_name={{notification_name}}
&virtual_phone_number={{virtual_phone_number}}
&notification_time={{notification_time}}
&contact_phone_number={{contact_phone_number}}
&contact_id={{contact_id}}
&contact_full_name={{contact_full_name}}
&call_session_id={{call_session_id}}
&employee_full_name={{employee_full_name}}
&employee_id={{employee_id}}
&employee_phone_number={{employee_phone_number}}
&notification_mnemonic={{notification_mnemonic}}
&start_time={{start_time}}
&called_phone_number={{called_phone_number}}
&talk_time_duration={{talk_time_duration}}

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

Тип события: Начало разговора
Способ уведомления: HTTP
Метод: GET
URL:https://вашдомен.yucrm.ru/webhooks/uiscom

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

Копировать
notification_name={{notification_name}}
&notification_time={{notification_time}}
&external_id={{external_id}}
&contact_phone_number={{contact_phone_number}}
&contact_id={{contact_id}}
&employee_full_name={{employee_full_name}}
&employee_id={{employee_id}}
&call_source={{call_source}}
&call_session_id={{call_session_id}}
&direction={{direction}}
&leg_ids={{leg_ids}}
&notification_mnemonic={{notification_mnemonic}}
&start_time={{start_time}}
&called_phone_number={{called_phone_number}}
&talk_time_duration={{talk_time_duration}}}

9) Название уведомления: YUcrm. Окончание разговора

Тип события: Окончание разговора
Способ уведомления: HTTP
Метод: GET
URL: https://вашдомен.yucrm.ru/webhooks/uiscom

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

Копировать
notification_name={{notification_name}}
&virtual_phone_number={{virtual_phone_number}}
&notification_time={{notification_time}}
&external_id={{external_id}}
&contact_phone_number={{contact_phone_number}}
&communication_number={{communication_number}}
&contact_fullname={{contact_full_name}}
&employee_full_name={{employee_full_name}}
&employee_id={{employee_id}}
&call_source={{call_source}}
&direction={{direction}}
&call_session_id={{call_session_id}}
&scenario_name={{scenario_name}}
&talk_time_duration={{talk_time_duration}}
&leg_ids={{leg_ids}}
&notification_mnemonic={{notification_mnemonic}}
&start_time={{start_time}}
&called_phone_number={{called_phone_number}}
&finish_reason={{finish_reason}}
&talk_time_duration={{talk_time_duration}}

10) Название уведомления: YUcrm. Поднятие трубки

Тип события: Поднятие трубки
Способ уведомления: HTTP
Метод: GET
URL: https://вашдомен.yucrm.ru/webhooks/uiscom

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

Копировать
notification_name={{notification_name}}
&notification_time={{notification_time}}
&external_id={{external_id}}
&contact_phone_number={{contact_phone_number}}
&contact_id={{contact_id}}
&employee_full_name={{employee_full_name}}
&employee_id={{employee_id}}
&call_source={{call_source}}
&call_session_id={{call_session_id}}
&direction={{direction}}
&leg_id={{leg_id}}
&notification_mnemonic={{notification_mnemonic}}
&start_time={{start_time}}
&called_phone_number={{called_phone_number}}
&talk_time_duration={{talk_time_duration}}

11) Название уведомления: YUcrm. Потерянный звонок

Тип события: Потерянный звонок
Способ уведомления: HTTP
Метод: GET
URL: https://вашдомен.yucrm.ru/webhooks/uiscom

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

Копировать
notification_name={{notification_name}}
&virtual_phone_number={{virtual_phone_number}}
&notification_time={{notification_time}}
&scenario_name={{scenario_name}}
&contact_phone_number={{contact_phone_number}}
&communication_number={{communication_number}}
&contact_id={{contact_id}}
&contact_full_name={{contact_full_name}}
&call_session_id={{call_session_id}}
&wait_time_duration={{wait_time_duration}}
&employee_ids={{employee_ids}}
&notification_mnemonic={{notification_mnemonic}}
&start_time={{start_time}}
&called_phone_number={{called_phone_number}}
&finish_reason={{finish_reason}}
&talk_time_duration={{talk_time_duration}}

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

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

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

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

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

Метод: GET

https://поддомен.yucrm.ru/webhooks/uiscom_forward (вместо слова поддомен указать поддомен вашей YUcrm, например, https://test.yucrm.ru/webhooks/uiscom_forward) и поставьте галочку в поле Номер абонента и Виртуальный номер.

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

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

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

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

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

Эта статья была полезна для людей. Эта статья помогла Вам?
Да, помогла!
Вопрос не решён
Полезные кейсы, статьи и исследования от экспертов UIS
Подписаться
Нажимая кнопку вы подтверждаете, что согласны получать рассылку
Вы успешно подписаны на новости!
Спасибо за обращение
Понятно