Додати відеодзвінки на сайт — критичне завдання для телемедицини, 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 та отримайте стабільний відеозв'язок вже наступного дня.