Настройка
Обновлено
Где менять настройки
Откройте CRM → Плагины → Телефония UIS с правами администратора CRM. После изменения параметров нажмите «Сохранить».
1. Подключение
| Настройка | Что делает | Значения / по умолчанию |
|---|---|---|
| Площадка | Выбирает серверы Data API, Call API и записей | «UIS — uiscom.ru» или «CoMagic — comagic.ru»; по умолчанию UIS |
| Ключ API | Авторизует запросы к выбранной площадке | По умолчанию не задан. Пустое поле при сохранении оставляет прежний ключ |
Ключи двух площадок невзаимозаменяемы. Сохранённый ключ отображается маской с последними четырьмя символами. Чтобы заменить ключ, введите новый и сохраните форму. Очистка поля не удаляет сохранённый ключ.
«Проверить связь» обращается к UIS, загружает справочник сотрудников и линий, определяет часовой пояс аккаунта, проверяет настройки записи сотрудников и доступность перевода. Результат виден рядом с кнопкой. Для сохранения введённого ключа и площадки отдельно нажмите «Сохранить».
«Сотрудники и линии» показывает загруженные данные и ссылку CRM → Настройки → Телефония для привязки пользователей. Это информационный блок, а не настройка.
Показаны выбор площадки, ключ API, проверка связи и загрузка звонков за 30 дней.
История звонков
| Настройка | Что делает | Значения / по умолчанию |
|---|---|---|
| Загрузить звонки | Задаёт период разовой загрузки отчёта для кнопки «Загрузить из UIS» | От 1 до 90 дней; при открытии страницы — 30 дней. Не сохраняется как постоянный параметр |
Подробности — в статье об истории и cron.
2. Адрес для уведомлений
| Настройка | Что делает | Значения / по умолчанию |
|---|---|---|
| Сменить секрет при сохранении | Создаёт новый секрет в адресе при следующем сохранении | Флажок по умолчанию снят; после смены нужно обновить URL всех четырёх уведомлений UIS |
| Адрес старого плагина | Включает приём уведомлений старого плагина «Телефония Uiscom» по прежнему адресу | Выключено; требуется отключить старый плагин |
«Адрес» формируется автоматически по публикации CRM и содержит секрет. Кнопка «Скопировать» копирует URL, «Проверить адрес» отправляет проверочный запрос с сервера сайта на этот URL. Успех этой проверки не подтверждает получение уведомления именно от UIS.
3. Уведомления в UIS
Здесь находятся инструкция, шаблоны четырёх уведомлений и даты их последнего получения. Используйте «Скопировать шаблон» или «Показать шаблон». В этом блоке нет сохраняемых параметров: уведомления создаются в кабинете UIS.
Порядок настройки описан в отдельной статье.
4. Звонки
| Настройка | Что делает | Значения / по умолчанию |
|---|---|---|
| Номер для исходящих | Задаёт виртуальный номер для звонка по клику, если своего номера нет у SIP-линии сотрудника UIS | «Первая линия» или конкретная загруженная линия; по умолчанию «Первая линия» |
| Перевод звонков | Разрешает перевод активного разговора средствами Call API | По умолчанию выключено; «Проверить связь» автоматически включает или выключает по результату проверки |
Номер SIP-линии сотрудника имеет приоритет над «Номер для исходящих». Перевод доступен для соединённого звонка с известной сессией UIS. Включение переключателя не подключает компонент в самом UIS.
5. Записи разговоров
| Настройка | Что делает | Значения / по умолчанию |
|---|---|---|
| Скачивание | Выбирает автоматическую или отложенную загрузку файлов | «Скачивать все записи автоматически» — по умолчанию; либо «Скачивать только при прослушивании или запросе» |
| Не сохранять записи короче | Не ставит запись короткого разговора в очередь | Целое число секунд от 0; по умолчанию 10. Разговор ровно указанной длительности допускается |
| Хранить записи | Задаёт срок удаления скачанных файлов фоновым заданием | Целое число дней от 0; по умолчанию 90. Значение 0 — бессрочно |
Срок отсчитывается от создания записи в очереди плагина. Величина «Занято на диске:» показывает общий размер файлов в каталоге записей. Подробности — в статье о записях.
6. Состояние
| Настройка | Что делает | Значения / по умолчанию |
|---|---|---|
| Отладочный лог | Включает подробные сообщения об уведомлениях и ответах API | Выключено; файл wa-log/crm/plugins/ewcrmuis.log |
Ошибки могут записываться и при выключенной отладке. При включённой отладке журнал содержит тела уведомлений, в том числе номера клиентов, и части ответов API.
Остальные поля блока служат для наблюдения:
| Показатель | Что показывает |
|---|---|
| Фоновые задачи | Последний запуск и источник cli или backend. Предупреждение появляется, если запусков CLI ещё не было либо последний был более 15 минут назад |
| Баллы API UIS | Сохранённый остаток и лимит на сегодня, время получения этих данных. При неизвестном лимите показано тире |
| Очередь записей | Ненулевые количества записей по состояниям |
Подписи состояний очереди: «ждут», «есть в UIS», «скачано», «нет в UIS», «ошибки», «удалено по сроку». «Есть в UIS» означает, что плагин сохранил ссылку; доступность файла проверяется при скачивании.
Показаны настройки скачивания и хранения, время фонового запуска, баллы API и очередь записей.