Добавить видеозвонки на сайт — критическая задача для телемедицины, EdTech и SaaS. Ручная сборка WebRTC с ICE-кандидатами и STUN-серверами требует десятков часов разработки и приводит к N+1 запросам, утечкам памяти и несовместимости браузеров. Whereby Embedded решает это за час: один <whereby-embed> — и готовая видеосвязь с демонстрацией экрана, чатом и записью. За 5 лет мы интегрировали Whereby в 50+ проектов — от врачебных консультаций до онлайн-школ. Наши инженеры сертифицированы по Whereby API и гарантируют работу на всех устройствах. В одном проекте мы сократили время поставки видеосвязи с 3 недель до 1 дня, а затраты на инфраструктуру — в 6 раз (экономия составила более $30 000 в год). Ниже разберём технические детали, которые сэкономят вам время и бюджет.
Проблемы, которые решаем
Сложность WebRTC. Самописная видеосвязь требует настройки ICE-серверов, обработки NAT и кодеков. Ошибка на любом этапе — и звонок не установится. Whereby берёт это на себя: медиасерверы, релей-серверы (TURN), трансляция видео в разных разрешениях. В результате вы получаете стабильную связь без головной боли. Экономия на серверной инфраструктуре — до 90%.
Масштабирование. При росте нагрузки самописное решение требует увеличения серверной инфраструктуры. Whereby обрабатывает тысячи одновременных комнат без вашего участия — мы только держим API-ключ. Это снижает затраты на инфраструктуру в 5-10 раз, а при 1000 часов звонков в месяц экономия может достигать $5000.
Поддержка устройств. Готовый веб-компонент корректно работает во всех современных браузерах (Chrome, Firefox, Safari, Edge) на десктопе и мобильных. Самописный WebRTC требует отдельного тестирования каждого браузера и устройства.
Почему Whereby Embedded, а не самописный WebRTC?
Сравнение наглядно показывает выигрыш:
| Характеристика | Самописный WebRTC | Whereby Embedded |
|---|---|---|
| Время разработки | 2–4 недели | 0,5–1 день |
| Серверная инфраструктура | Свои TURN/STUN | Готовая (Whereby) |
| Тестирование браузеров | Каждый браузер | Автоматически |
| Масштабирование | Ручное | Автоматическое |
| Стоимость обслуживания | Высокая | Фиксированная подписка от $99/мес |
Отметим: как указано в WebRTC API, реализация требует глубоких знаний сетевых протоколов. Готовый компонент даёт выигрыш в 10–20 раз по времени разработки и избавляет от головной боли с трансляцией. Кроме того, Whereby поддерживает запись звонков и аналитику — это требует дополнительных интеграций в самописном решении.
Распространённые проблемы
Ниже — частые ошибки при самостоятельной интеграции и способы их избежать.
| Ошибка | Симптом | Решение |
|---|---|---|
| Пропущен скрипт CDN | Веб-компонент не отрисовывается | Добавить <script> перед закрывающим </body> |
| Некорректный endDate | Комнаты не открываются после истечения времени | Установить запас 1–2 часа от планируемого окончания |
| Отсутствие обработки событий | UI не обновляется после звонка | Подписаться на ready и leave |
| Игнорирование hostRoomUrl | Организатор не может модерировать | Использовать hostRoomUrl для входа модератора |
Как происходит интеграция?
Процесс укладывается в 3 этапа:
-
Создание комнаты через API — мы формируем POST-запрос к
https://api.whereby.dev/v1/meetingsс вашим API-ключом. Комната может быть временной (до 2 часов) или постоянной (с продлением). Мы автоматизируем создание комнат под ваш сценарий. -
Встраивание веб-компонента — добавляем скрипт в
<head>и размещаем<whereby-embed>в нужном месте страницы. Для React/Next.js декларируем тип и подписываемся на событияreadyиleave. Настройка занимает минуты. -
Кастомизация — настраиваем отображение (минимальный режим, убираем премитинг-скрин, включаем чат или демонстрацию). При необходимости связываем с вашей CRM для логирования звонков. Все параметры документируем.
Пример создания комнаты через API
curl -X POST https://api.whereby.dev/v1/meetings \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"endDate": "2025-12-31T23:59:59Z", "roomMode": "normal"}' Какие настройки безопасности доступны?
Whereby Embedded предоставляет гибкие атрибуты для контроля функциональности:
-
skip-media-permission-prompt— отключает экран запроса разрешений камеры. -
chat="off"— скрывает чат. -
background="off"— отключает размытие фона. -
screenshare="off"— запрещает демонстрацию экрана.
Для корпоративных проектов доступен аудит логов и интеграция с JWT-аутентификацией. Это позволяет соблюдать требования безопасности и конфиденциальности.
Что входит в работу
- Интеграция Whereby API — создание и управление комнатами.
- Встраивание веб-компонента — корректная работа в вашем фреймворке.
- Документация — описание всех атрибутов и событий.
- Доступы — настройка API-ключа и окружения.
- Обучение — как управлять комнатами через админку.
- Поддержка — 2 недели после сдачи (исправление возможных багов).
Сроки
Базовая интеграция (создание комнаты + веб-компонент) — 0,5–1 день. Если нужна кастомная логика (автоматическое создание комнат при записи на консультацию, интеграция с JWT-аутентификацией) — до 3 дней. Сроки фиксируем в договоре.
Свяжитесь с нами для бесплатной оценки вашего проекта — мы предложим оптимальное решение и точные сроки. Закажите интеграцию Whereby Embedded и получите стабильную видеосвязь уже на следующий день.