Карта подключения к VideoGrace

Для интеграции важны три независимых пути: управление, медиа и передача файлов. Клиент подключается к серверу, а не строит обязательную peer-to-peer сеть со всеми участниками. Сервисные участники используют свои учётные записи и разрешения.

flowchart LR
    C[Клиент / сервис]
    W[HTTPS / WSS: управление]
    M[WebRTC / WSMedia: медиа]
    S[HTTPS storage: файлы]
    V[VideoGrace Server]
    B[Backend CRM / платформы]
    C <-->|команды и события| W
    C <-->|звук и видео| M
    C <-->|файлы и результаты| S
    W <--> V
    M <--> V
    S <--> V
    B <-->|Integration API / webhooks| V

Как выбрать интерфейс

Задача	Интерфейс
Создать встречу из CRM, получить персональные ссылки и результат	Integration API
Написать свой клиент: логин, участники, устройства, чаты	WebSocket/WSS API
Передать и принять браузерное медиа	WebRTC
Загрузить файл или получить запись	Транспорты и storage, Records API
Подключить recorder/transcriber worker	CAN, Recorder, Transcriber

Устройство и транспорт — разные сущности. device_connect сообщает о media endpoint, а не требует нового WebSocket на каждое устройство. Внутри одного медиатранспорта могут передаваться несколько потоков с разными SSRC.

Сервер определяет права и видимость. Успешный HTTP-запрос не подтверждает работу двустороннего медиа; она проверяется звонком из целевых сетей. Наличие внешних медиаузлов само по себе не является гарантией отказоустойчивости управления.

Начните с CRM → встреча → транскрипт или минимального клиентского lifecycle.