Как правильно настроить интеграцию телефонии в 1С:УНФ при работе через веб-клиент?

При настройке телефонии в 1С:УНФ часто возникает конфликт между веб-доступом пользователей и служебным соединением для АТС. Разберем, как решить эту проблему, обеспечив стабильную работу обеих функций.

Суть проблемы

Основная сложность заключается в том, что при публикации базы через конфигуратор 1С все настройки (включая параметры http-сервисов) записываются в один файл default.vrd. Если в него добавить настройки для телефонии, веб-клиент может автоматически авторизовать всех пользователей под служебным аккаунтом TelephonyService, что лишает сотрудников возможности выбора своей учетной записи.

Решение: разделение публикаций

Наиболее надежный способ — создать две разные веб-публикации одной и той же базы данных. Одна публикация будет предназначена для обычных пользователей, а вторая — исключительно для приема запросов от АТС (сервисная).

Шаг 1: Создание публикаций

Рассмотрим, как это реализовать на веб-сервере Apache:

1. Первую публикацию оставьте для работы пользователей (например, с именем /UNF).
2. Создайте вторую публикацию в отдельном каталоге (например, /TEL).
3. Для второй публикации в файле default.vrd пропишите настройки http-сервисов, которые были сгенерированы в 1С:УНФ для телефонии.

Шаг 2: Настройка доступа и прав

После создания отдельной публикации для телефонии, крайне важно настроить права для служебного пользователя:

• Откройте конфигуратор или предприятие от имени администратора.
• Найдите пользователя TelephonyService, созданного системой автоматически.
• Назначьте ему необходимые права доступа, чтобы он мог выполнять операции по регистрации входящих и исходящих звонков, но при этом имел минимально достаточный уровень доступа (принцип минимальных привилегий).
• В файле default.vrd для публикации /TEL обязательно укажите логин и пароль пользователя, чтобы избежать ошибок 403 Forbidden. Пример структуры файла:

<?xml version="1.0" encoding="UTF-8"?>
<vrs xmlns="http://v8.1c.ru/8.1/data/dt/publishing">
  <httpServices publishByDefault="false">
    <service name="TelephonyApi" rootUrl="telephony" enable="true" reuseSessions="dontuse" sessionMaxAge="20" poolSize="10" poolTimeout="5"/>
  </httpServices>
  <standardOdata enable="false"/>
  <analytics enable="false"/>
</vrs>

Шаг 3: Проверка адресов и диагностика ошибок

Если вы получаете ошибку 404 Not Found при обращении к /hs/telephony/itoolabs, проверьте следующие моменты:

1. Убедитесь, что сервис правильно опубликован в default.vrd.
2. Проверьте полный путь в настройках АТС. Он должен соответствовать виду: http://имя_сервера/TEL/hs/telephony/itoolabs/метод.
3. Используйте инструменты разработчика в браузере (клавиша F12, вкладка Network), чтобы увидеть, какой именно ответ возвращает сервер. Если ответ 404, значит, запрос не доходит до нужного http-сервиса внутри публикации.

Важные рекомендации по работе веб-клиента

Для корректного отображения уведомлений о звонках в веб-интерфейсе 1С важно учитывать следующее:

• SSL-сертификаты: Для работы современных API и механизмов уведомлений крайне рекомендуется использовать протокол HTTPS. Многие браузеры блокируют фоновые запросы на незащищенных соединениях.
• Оповещения: Веб-клиент работает на основе длительных запросов или регулярного опроса (polling). Если окно входящего звонка не появляется, проверьте, не блокирует ли антивирус или фаервол активность браузера в фоновом режиме.
• Логирование: Если проблема сохраняется, включите Технологический журнал 1С с фильтром по событиям HTTP. Это позволит увидеть, доходят ли пакеты от АТС до сервера 1С.

Таким образом, разделение публикаций решает проблему авторизации, а корректная настройка прав и путей в vrd-файле гарантирует, что АТС сможет успешно передавать данные в 1С без ошибок доступа.