Настройка модуля «Видеозвонки»

Модуль для видео- и аудиозвонков между пользователями в чате. Эта инструкция написана для владельца ADWOS CMS: что подготовить, где включить модуль, какие поля проверить и как понять, что запуск прошел корректно.

Когда стоит подключать модуль

• Маркетплейсам, где покупатель и продавец активно договариваются внутри чата.
• Площадкам услуг, аренды и объявлений, где качество диалога влияет на конверсию.
• Администраторам, которым важно управлять вложениями, статусами, модерацией или автоматизацией сообщений.

Что изменится на сайте

• В диалогах появляется функция модуля «Видеозвонки».
• Пользователи быстрее обмениваются информацией без перехода во внешние мессенджеры.
• Администратор может проверить работу функции на тестовом диалоге.
• Чат остается частью платформы, а не отдельным неподконтрольным каналом.

Что подготовить заранее

Подготовьте доступы и тестовые данные до включения модуля. Так вы проверите сценарий спокойно и не затронете реальные заказы, пользователей или публичные страницы.

• Убедитесь, что базовый чат ADWOS CMS включен и доступен нужным ролям пользователей.
• Создайте два тестовых аккаунта, чтобы проверить сценарий с обеих сторон диалога.
• Определите допустимые форматы вложений, сообщений или автоматических действий.
• Если функция связана с модерацией, подготовьте понятные правила для администратора.

Установка в ADWOS CMS

• Откройте административную панель ADWOS CMS под учетной записью администратора.
• В меню выберите раздел «Каталог», затем откройте «Маркетплейс».
• Найдите модуль «Видеозвонки» по названию или через список модулей.
• Если модуль еще не установлен, нажмите «Установить» и дождитесь завершения установки.
• Откройте карточку установленного модуля, выберите «Управлять», затем перейдите в «Настройки».
• Заполните обязательные поля, сохраните настройки и включите модуль переключателем.

Настройка модуля

В настройках модуля заполняйте только те значения, которые относятся к вашему проекту. Секретные ключи храните в защищенных полях и не переносите их в открытые тексты, письма или инструкции для пользователей.

• «[Legacy verif] Авто-отклонение pending видеопроверок старше N дней». Укажите числовое значение. Для TTL, лимитов и таймаутов используйте разумное стартовое значение и проверьте результат на тестовом сценарии. Значение по умолчанию: 0.
• «Макс. участников в групповом звонке». Укажите числовое значение. Для TTL, лимитов и таймаутов используйте разумное стартовое значение и проверьте результат на тестовом сценарии. Значение по умолчанию: 10. Limit для room.create. LiveKit Server позволяет 100+, но при росте кол-ва участников нужен больший CPU/полоса.
• «Категории с кнопкой видеозвонка». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Список категорий где появляется кнопка. По умолчанию заполняется автоматически по slug-pattern (realty/apartments/houses/auto/motorcycles/services/electronics/antiques/collectibles) — если у вашего маркетплейса категории с такими slug'ами, они включатся сразу. Админ может полностью переписать список здесь — multiselect показывает все категории, добавляйте/убирайте по вкусу.
• «Slug'и категорий-по-умолчанию». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Значение по умолчанию: realty,apartments,houses,commercial,auto,motorcycles,services,electronics,antiques,collectibles,art. Когда listing_call_category_ids не задан явно, кнопка появляется в категориях с этими slug'ами. Меняется только если у маркетплейса другая таксономия.
• «LiveKit API Key». Секретное поле. Вставьте значение из кабинета провайдера и не публикуйте его в описаниях, письмах или открытых страницах. Автогенерируется при установке.
• «LiveKit API Secret». Секретное поле. Вставьте значение из кабинета провайдера и не публикуйте его в описаниях, письмах или открытых страницах. Автогенерируется при установке. Используется только на бэке для подписи JWT.
• «LiveKit URL». Укажите полный адрес страницы, callback или webhook, который должен использовать внешний сервис. Автоматически назначается при установке модуля.
• «[Legacy verif] Макс. длительность видео (сек)». Укажите числовое значение. Для TTL, лимитов и таймаутов используйте разумное стартовое значение и проверьте результат на тестовом сценарии. Значение по умолчанию: 60.
• «[Legacy verif] Макс. размер видео (МБ)». Укажите числовое значение. Для TTL, лимитов и таймаутов используйте разумное стартовое значение и проверьте результат на тестовом сценарии. Значение по умолчанию: 100.
• «1:1 звонки в чате». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Значение по умолчанию: true. Кнопка «Позвонить» в шапке личной переписки. Identity LiveKit — user_id, room — детерминированный hash от пары участников.
• «Групповые звонки». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Значение по умолчанию: false. Разрешить создавать публичные комнаты по share-link через `/room/create`. Без этого только 1:1.
• «Кнопка «Видеозвонок продавцу» в карточке объявления». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Значение по умолчанию: false. Покупатель сможет позвонить продавцу прямо со страницы объявления (без перехода в чат). По умолчанию доступно для всех категорий; ограничить можно ниже.
• «[Legacy verif] Требовать селфи дополнительно к видео». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Значение по умолчанию: false.
• «Время жизни LiveKit JWT (часов)». Секретное поле. Вставьте значение из кабинета провайдера и не публикуйте его в описаниях, письмах или открытых страницах. Значение по умолчанию: 6. JWT действителен только указанное время. После — клиент перезапросит.

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

Проверка перед запуском

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

Частые ошибки

• Функция не видна в диалоге. Проверьте права пользователей и включение базового чата.
• Сообщение или вложение не отправляется. Проверьте размер, формат и ограничения модуля.
• Статусы не обновляются. Проверьте фоновые задачи и соединение клиента.
• Модерация не срабатывает. Проверьте правила, права администратора и тестовый пример.

Когда тест проходит без ошибок, оставьте модуль включенным и зафиксируйте, какие данные использовались для проверки. Это поможет быстро восстановить настройку после обновления или смены ключей.