Документация пользователя

1. Настройки в личном кабинете UIS

1.1. Войдите в личный кабинет UIS

1.2. Создание и настройки пользователя

1.2.1. Перейдите в настройки на вкладку Управление пользователями

1.2.2. Добавьте нового пользователя либо выберите уже имеющегося.

1.2.3. Заполните карточку пользователя

1.2.4. Определите Права доступа к функциональности пользователю

1.2.5. Определите Доступы к функциональности API пользователя. Выберите Использовать ключ API. Ключ API виден только при создании ключа, желательно сохранить этот ключ.

1.3. Создание, настройка сотрудника с привязкой к SIP-линии и виртуальному номеру

1.3.1. Перейдите на вкладку сотрудники и добавьте нового сотрудника.

1.3.2. Заполните карточку сотрудника. Укажите внутренний номер и в блоке Телефоны добавьте SIP-линию по кнопке «Добавить номер».

• Если Вам необходимо получать записи звонков выберите в поле «Запись разговора» значение «Для всех звонков», «Только для входящих», «Только для исходящих».

1.3.3. Сохраните карточку сотрудника. После сохранения UIS отображает уведомление о создании новой SIP-линии. Необходимо перейти по ссылке из уведомления.

1.3.4. Заполните данные SIP-линии и сохраните.

1.3.5. Вернитесь в карточку сотрудника. Переходите на вкладку «Использование сервисов».

• Установите настройки.

1.3.6. Вернитесь в карточку пользователя созданного в пункте 1.2. Укажите в поле «Связать с сотрудником» созданного сотрудника

2. Установка плагина

2.1. Загрузите плагин UIS

2.2. В модальном окне установки плагина заполните поле Ключ API (из ЛК UIS), Ключом API полученным при создании пользователя в личном кабинете UIS

Выберите настройки соответствующие вашим требованиям. Где:

1. Уведомлять только ответственного за контрагента:

• Уведомление о звонке отображается только ответственному за контрагента.
• Если контрагент не найден по номеру, то уведомление отображается сотруднику определив по внутреннему номеру на который поступил звонок.
• Если звонок поступил без указания внутреннего номера, то уведомление отобразится всем сотрудникам указанным в настройках плагина.

2. Создавать контакт при звонке:

• Настройка отвечает за создание Документа Контакты по звонкам.

3. Добавлять звонок в последнюю активную сделку контрагента:

• Настройка отвечает за добавление записи разговора в последнюю сделку в блок история, определив по телефону указанному в полях «Рабочий телефон» либо «Мобильный телефон».

4. Создавать задачу о пропущенном звонке для ответственного:

• Создается задача «Пропущенный звонок» для ответственного за контрагента.
• Если контрагент не найден по номеру, то задача создастся первому сотруднику указанному в настройках плагина.

5. Созданным контактам по неизвестным номерам присваивать одного контрагента:

• Для корректной работы данной настройки необходимо внести идентификатор контрагента в поле «ID Контрагента» и включить настройку «Создавать контакт при звонке».
  
• Если звонок поступил с неизвестного номера, то для созданного документа «Контакт» будет присваиваться фиксированный контрагент вместо создания нового.

2.3. Заполните таблицу соответствий пользователей CRM с внутренними номерами UIS

2.4. Сохраните настройки плагина.

3. Настройка отправления уведомлений в личном кабинете UIS

3.1. В личном кабинете UIS перейдите на вкладку «Уведомления», нажмите на «Добавить уведомление». Для корректной интеграции UIS потребуется создать 3 шаблона уведомлений, если выбрана настройка «Создавать задачу о пропущенном звонке для ответственного» добавляется еще один шаблон уведомлений.

• Инициализация входящего звонка;
• Ответ на входящий звонок;
• Получение записи разговора;

Опционально:

• Пропущенный звонок;

3.2. Шаблоны уведомлений имеют общие настройки обязательные для корректной работы интеграции.

• Указать название уведомления;
• Выбор типа события;
• Установка активного статуса;
• Добавление условия/блоков условий при котором Виртуальная АТС UIS будет отправлять данные в CRM;
  
• Выбор способа уведомления HTTP, Метод POST.
  
  URL указываете ссылку из настроек плагина в CRM из блока «Адрес внешней системы (вставить в поле в ЛК UIS)»
  

3.3. Шаблон инициализации входящего звонка.

3.3.1. Тип события — «Входящее плечо».

3.3.2. Тело запроса:

{
    "from_number":{{contact_phone_number}},
    "diversion":{{virtual_phone_number}},
    "direction":{{direction}},
    "call_id":{{call_session_id}},
    "user_extension":{{extension_phone_number}},
    "call_state":"RINGING"
}

3.4. Шаблон ответ на входящий звонок.

3.4.1 Тип события — «Начало разговора».

3.4.2. Тело запроса:

{
    "from_number":{{contact_phone_number}},
    "diversion":{{virtual_phone_number}},
    "direction":{{direction}},
    "call_id":{{call_session_id}},
    "user_extension":{{extension_phone_number}},
    "call_state":"ANSWERED"
}

3.5. Шаблон получение записи разговора

3.5.1 Тип события — «Записанный разговор»

3.5.2. Тело запроса:

{
    "from_number":{{contact_phone_number}},
    "diversion":{{virtual_phone_number}},
    "direction":{{direction}},
    "call_id":{{call_session_id}},
    "user_extension":{{extension_phone_number}},
    "call_record_url":{{file_link}},
    "call_state":"HANGUP"
}

3.6. Шаблон пропущенный звонок

3.6.1 Тип события — «Потерянный звонок»

3.6.2. Тело запроса:

{
    "from_number":{{contact_phone_number}},
    "diversion":{{virtual_phone_number}},
    "direction":{{direction}},
    "call_id":{{call_session_id}},
    "user_extension":null,
    "call_state":"MISSED"
}