YUcrm - CRM для недвижимости
Функциональность интеграции с 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}}
¬ification_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}}
¬ification_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}}
¬ification_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}}
¬ification_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}}
¬ification_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}}
¬ification_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}}
¬ification_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}}
¬ification_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}}
¬ification_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}}
¬ification_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}}
¬ification_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}}
¬ification_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}}
¬ification_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}}
¬ification_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}}
¬ification_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}}
¬ification_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}}
¬ification_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}}
¬ification_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}}
¬ification_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}}
¬ification_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}}
¬ification_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}}
¬ification_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.
Настройка интеграции завершена.
