Перейти к содержанию

Встречи: Google Meet, Zoom, Контур Толк и МТС Линк

В кабинете появился раздел «Встречи» с основным режимом «Бот по ссылке». Google Meet и экспериментальный Zoom browser используют собственное развёртывание Vexa. Для гостевого входа в Толк и МТС Линк добавлен изолированный Chromium worker. Дополнительные режимы — импорт штатных записей Толка/МТС и официальный Zoom RTMS без участника-бота. Полученное аудио сохраняется в «Моих записях» с обычными ограничениями размера и квоты хранилища.

Браузерные адаптеры Толка/МТС и Zoom экспериментальные: проверены локальные контракты и сценарии интерфейса на тестовых моделях; успешная работа в живой встрече ещё не подтверждена. По умолчанию все новые способы подключения выключены. Запрос ссылки на тестовую встречу не означает, что такая проверка уже выполнена.

При включённом «Распознать и подготовить резюме» запускается существующая очередь STT с шаблоном conversation. Владелец задания берётся из сохранённой встречи; применяется обычный биллинг распознавания и LLM. Вкладку можно закрыть. При ошибке обработки полученный файл остаётся доступен для повторного запуска из архива.

Первый запуск

  1. Скопировать .env.meetings.example в .env.meetings. Файл с ключами исключён из Git.
  2. Для бота заполнить серверные подключения и MEETING_CAPTURE_PROVIDERS. Ключи видеосервиса обычному пользователю для гостевого входа не нужны. Для дополнительных режимов MEETING_ACCOUNTS — JSON-объект, ключи которого точно совпадают с username пользователей кабинета. Для импорта штатных записей нужны ключи Толка и МТС Линк. Для Google Meet достаточно google_meet: true и общих серверных настроек Vexa.
  3. Настроить провайдеров по разделам ниже, затем включить MEETING_ENABLED=true.
  4. Применить код и конфигурацию при обычном перезапуске API. Новая таблица meeting_session добавляется при runtime schema reconciliation; также есть отдельная миграция. Существующие записи не меняются.
  5. Выполнить контролируемую тестовую встречу и проверить полный путь: захват → завершение → файл в архиве → расшифровка → резюме и списание с нужного аккаунта.

Пример настроек без действующих секретов:

MEETING_ENABLED=true
MEETING_ACCOUNTS={"owner@example.com":{"google_meet":true,"kontur_talk":{"base_url":"https://SPACE.ktalk.ru","api_key":"REPLACE"},"mts_link_api_key":"REPLACE","zoom":{"account_id":"ACCOUNT_ID","host_id":"ORIGINAL_HOST_USER_ID"}}}

В этой версии подключениями управляет администратор через конфигурацию. Формы OAuth/ввода ключей в кабинете, календарная автоподписка и управление организациями ещё не реализованы. Пользователь видит только доступные способы подключения. MEETING_CAPTURE_PROVIDERS разрешает перечисленные capture-сервисы всем авторизованным пользователям портала; это не список настроек отдельных клиентов.

Собственный браузерный бот Толка / МТС Линк

Настроить случайный MEETING_BROWSER_WORKER_TOKEN (минимум 32 символа), MEETING_BROWSER_WORKER_URL и MEETING_CAPTURE_PROVIDERS=["kontur_talk","mts_link"]. MEETING_ACCOUNTS может оставаться пустым. Имя участника задаётся через MEETING_BOT_NAME; рекомендуется явно обозначить запись, например «Speech Expert — запись». Вход выполняется по публичной гостевой ссылке; организатор допускает участника. SSO, CAPTCHA, обязательная регистрационная анкета и отдельный ввод PIN в портале пока не поддержаны. Автоматизация не обходит ограничения доступа.

docker compose --env-file .env --env-file .env.meetings -f docker-compose.yml -f docker-compose.meetings.yml --profile meeting-bots build meeting-browser
docker compose --env-file .env --env-file .env.meetings -f docker-compose.yml -f docker-compose.meetings.yml --profile meeting-bots up -d --no-deps meeting-browser

Docker Engine должен уже работать. Для API вне Docker worker URL — http://127.0.0.1:8092; запуск/перезапуск такого API выполняет пользователь вручную. Стандартный максимум — два одновременных браузера, ожидание допуска до 5 минут. Каждый участник получает отдельный Chromium без профиля пользователя. Виртуальные микрофон/камера выключены; записываются полученные WebRTC-аудиодорожки, без видео. Выход по остановке пользователя, явному окончанию встречи или лимиту длительности. Тишина не считается окончанием встречи. Автоуход «остался один» пока не реализован.

Worker запускается в одном процессе, хранит состояния на Docker volume и принимает идемпотентный UUID задания. После перезапуска незавершённое задание помечается ошибкой: автоматический повторный вход не выполняется. Исходная ссылка/пароль в state-файлы worker не записываются; ссылки встреч сохраняются в owner-scoped базе портала. Временное аудио удаляется через 24 часа после окончания; небольшой state остаётся для защиты от повторного запуска. Завершённые записи в архиве портала живут по его обычным правилам хранения. При сбое до финализации частичное аудио не публикуется.

Ограничения: интерфейс гостевого входа может измениться; запись из вложенного iframe ещё не поддержана, а роли говорящих определяются последующим STT. Наличие кнопки выхода в зале ожидания не считается входом. Если адаптер не распознаёт интерфейс, он завершает задание ошибкой. МТС официально не гарантирует работу веб-клиента в Linux.

Источники: гостевой вход Толка, настройки входа МТС, требования МТС.

Zoom: бот по ссылке (эксперимент)

Добавить zoom в MEETING_CAPTURE_PROVIDERS при настроенной Vexa. Этот вариант входит через веб-клиент Zoom как участник; это другой режим, чем RTMS ниже. Нужны допуск организатора, доступный веб-вход и разрешённая запись. Если Vexa возвращает policy block / zoom_requires_rtms, задание явно завершается ошибкой и не переключается на RTMS. Поддержка конкретной ссылки подтверждается контролируемым live-тестом, а не одним успешным HTTP-запросом.

Для будущего варианта на native Meeting SDK требуется отдельная проверка правил Zoom: OBF описывает ботов, но Linux SDK usage policy содержит ограничения для AI notetakers. Нельзя обещать безусловную совместимость SDK-бота со сторонними аккаунтами без review и подтверждения применимых условий.

Google Meet / Vexa

Настроить MEETING_VEXA_URL, MEETING_VEXA_API_KEY, MEETING_BOT_NAME. Инструкция Vexa фиксирует проверенный commit и способ сборки. Бот приходит под именем из MEETING_BOT_NAME; организатор допускает его, если встреча требует подтверждения. Мы отправляем transcribe_enabled=false и recording_enabled=true: распознавание и резюме выполняет наш конвейер.

Пользователь вставляет ссылку https://meet.google.com/abc-defg-hij, подтверждает право на запись и добавляет встречу. Кнопка остановки отключает захват, затем ожидается финальный файл. Работа Vexa в браузере зависит от допуска бота и изменений интерфейса Google Meet; тесты HTTP-контракта не заменяют реальную встречу.

Если Vexa выдаёт URL внутреннего S3/MinIO, перечислить точные origins в MEETING_MEDIA_ORIGINS. Остальные адреса должны быть публичными HTTPS. Каждый редирект проверяется; ключи провайдера не передаются на другой origin.

Zoom / RTMS

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

  • Worker: ZOOM_RTMS_CLIENT_ID, ZOOM_RTMS_CLIENT_SECRET, случайный MEETING_RTMS_WORKER_TOKEN длиной не менее 32 символов.
  • API: MEETING_RTMS_WORKER_URL, тот же worker token и MEETING_ZOOM_WEBHOOK_SECRET — Zoom webhook secret token, отдельный от client secret.
  • Endpoint Zoom: https://YOUR_DOMAIN/api/meetings/webhooks/zoom. Подписки: meeting.rtms_started, meeting.rtms_stopped; URL challenge поддержан.
  • Привязка пользователя: zoom.account_id и zoom.host_id. В signed started-event второй идентификатор сверяется с payload.operator_id, причём is_original_host должен быть true. Запуски коорганизатора в этой версии игнорируются. Непривязанные аккаунты не создают задания.

Подпись проверяется по исходным байтам с окном 5 минут. Повторные события одного потока не создают повторный захват. Stopped-event сопоставляется по UUID встречи и ID потока; в официальном примере stopped нет account_id.

Worker устанавливает официальный rtms==1.1.0 только внутри Linux x86_64 контейнера. Он принимает mixed PCM 16 kHz mono и выдаёт WAV. Встреча Zoom не получает дополнительного участника-бота. Имена участников и раздельные дорожки RTMS пока не переносятся в транскрипт.

Docker overlay (из корня проекта, Docker Engine должен уже работать):

docker compose --env-file .env --env-file .env.meetings -f docker-compose.yml -f docker-compose.meetings.yml --profile meetings build zoom-rtms
docker compose --env-file .env --env-file .env.meetings -f docker-compose.yml -f docker-compose.meetings.yml --profile meetings up -d --no-deps zoom-rtms

Команды выше запускают только capture worker; применение кода к API проводится в обычном порядке развёртывания проекта. Для API в Docker worker URL — http://zoom-rtms:8091; для API вне Docker — http://127.0.0.1:8091. API вне Docker запускает/перезапускает пользователь вручную. Подробности лимитов, хранения и восстановления worker: README.

Контур Толк

В конфигурации пользователя указать kontur_talk.base_url=https://SPACE.ktalk.ru и API-ключ с правом чтения записей application.recording.read. URL пространства проверяется; произвольный сервер пользователь подставить не может.

В кабинете добавляется ключ штатной записи, доступной этому API-ключу. Готовность проверяется по документированным endpoint записи и скачивания. Предположение о несуществующем универсальном REST media stream не используется. При ещё не готовом файле опрос продолжается до установленного срока.

Клиент содержит метод запуска штатной записи комнаты, но пользовательский API этого первого этапа предоставляет только импорт; он не управляет самой встречей. Основные источники: API Толка, настройка ключа.

МТС Линк

Указать mts_link_api_key для пользователя. В кабинете передаётся числовой eventSessionId, а не ссылка на мероприятие или record ID. Запись включается штатными средствами МТС Линк. После завершения сессии адаптер находит запись, ожидает/запрашивает конвертацию, сохраняет conversion_id, получает download URL. Повторный опрос продолжает уже созданную конвертацию.

Запросы с одним ключом разделены паузой минимум 550 мс в пределах процесса API; ответ 429 передаётся механизму повторов. При нескольких процессах и общей организации ограничение частоты нужно координировать между процессами отдельно.

Методы запуска и остановки мероприятия не вызываются: это не управление записью. Пока поддержана одна запись на сессию. Несколько частей дают явную ошибку, чтобы пользователь не получил неполное резюме. Объединение частей — отдельное расширение. Каталог API, конвертация, получение файла.

Надёжность и границы версии

  • Состояние встреч хранится в PostgreSQL. Lease и атомарный claim не позволяют двум poller одновременно обрабатывать одно задание. Повторная загрузка использует заранее выбранный recording UUID и блокировку на этот UUID.
  • Создание через API принимает request_id (UUID). Повтор с изменёнными параметрами отвергается. Нативные импорты дополнительно дедуплицируются по пользователю, провайдеру и ID источника.
  • При неопределённом результате прерванного запуска Vexa автоматического повторного приглашения нет: нужно проверить встречу. Комната остаётся закреплена за заданием до проверки администратором; после подтверждённой остановки ботa администратор может снять meeting_session.room_key у этого задания. При известных ID повторяются попытки остановки; пропажа API-доступа не считается подтверждением завершения. Успешная запись освобождает комнату после сохранения файла в архиве. Для подключения используйте выделенный API-ключ Vexa, который не применяется другими ботами вне этого приложения. Zoom POST восстанавливается по UUID. После перезапуска RTMS worker незавершённый захват отмечается ошибкой; запись с разрывом не выдаётся за полную.
  • Импорт можно отменить, затем повторить. Остановка импорта не останавливает встречу провайдера. После ошибки STT повторная обработка запускается из архива.
  • STT использует существующую очередь приложения. Если перезапуск API прервал распознавание, запись остаётся в архиве, а задание получает ошибку; автоматический повтор платной обработки не запускается.
  • По умолчанию 3 активных задания на пользователя, 4 часа захвата, 24 часа ожидания готовности, до 1 GiB на файл и дополнительно общий лимит загрузки API.
  • Публичные ответы не содержат ключей, подписанных media URL или сырых webhook. Журнал ошибок сохраняет тип сбоя, а не тела ответов с возможными секретами.
  • Телемост и остальные платформы в этот этап не входят. Набор адаптеров позволяет подключать их позже без замены архива, биллинга и обработки.

Все эти подключения требуют live-проверки с действующими аккаунтами. Локальные тесты используют синтетические события и HTTP-ответы, а не чужие встречи.

Проверка реализации — 10 ноября 2026

Дополнение для бота-участника: проверены API capabilities, изоляция владельцев, разные режимы захвата, идемпотентный browser worker, отмена/восстановление и экспериментальные DOM-адаптеры. Production UI собран, 38 Node-тестов прошли. Docker-образ браузерного worker собран; реальный Chromium WebRTC loopback с синтетическим тоном прошёл весь путь MediaRecorder → ffmpeg → ненулевой PCM WAV 16 kHz mono. Это проверка аудиоконвейера, не тест реального Толка/МТС/Zoom. Сервисы с подключением к настоящим встречам не включены.

Первоначальная проверка режимов импорта/RTMS:

  • 227 серверных тестов: адаптеры, RTMS worker, владельцы и leases, импорт, биллинг/обработка, отмена, восстановление и смежные тесты архива.
  • 35 Node-тестов интерфейса встреч и навигации на собранном static/app.js; JSX собран через esbuild. Визуальная проверка в браузере не выполнена.
  • Ruff и проверка Compose-конфигурации проходят.
  • Образ RTMS собран; импорт официального SDK, поля AudioParams, callbacks и EventLoop проверены внутри контейнера с отключённой сетью, без join.
  • Миграция/runtime DDL, ограничения уникальности и advisory locks проверены на временном PostgreSQL 17 без production volumes или сетевых портов.

Проверка серверных тестов из корня проекта, с отдельным тестовым окружением:

$env:POSTGRES_PASSWORD = 'unit-tests-no-database'
.\.venv\Scripts\python.exe -m pytest app/tests/infrastructure/test_meeting_vexa.py app/tests/infrastructure/test_meeting_native_providers.py app/tests/infrastructure/test_meeting_zoom.py app/tests/infrastructure/test_meeting_core.py app/tests/api/test_meetings.py zoom_rtms_worker/tests/test_worker.py app/tests/infrastructure/test_playground_recording_service.py app/tests/infrastructure/test_credit_billing.py -q
node --test static/tests/meetings-ui.test.mjs static/tests/workspace-navigation.test.mjs

Все выбранные Python-тесты помечены no_database: общий fixture не подключается к серверной БД; тесты API самостоятельно создают изолированную SQLite in-memory.