Добавление браузерных звонков через Webphone SDK

Используйте актуальный SDK, храните постоянные секреты на сервере и безопасно тестируйте звонки.

Начните с поддерживаемого пакета и справочника

Откройте Документация API → Webphone SDK. Загрузите веб-пакет или указанные ресурсы и используйте примеры той же версии. Перед старой копией прочитайте связанные уведомления безопасности. Это веб-SDK, не замена нативной мобильной интеграции.

Разработчику нужны аутентифицированное HTTPS-приложение, разрешённая SIP-идентичность, микрофон и ресурсы актуального SDK. SDK Playground помогает проверить аккаунт и браузер, но звонки реальны и могут оплачиваться.

Держите постоянные секреты на сервере

1. Обычно начинайте производство с примера управляемого токена.
2. Backend проверяет пользователя и доступную ему идентичность IllyVoIP.
3. По API-ключу он получает документированное краткосрочное разрешение браузера. Возвращайте только нужные SDK данные, не постоянный ключ.
4. Инициализируйте по этим данным и актуальному примеру. Обрабатывайте истечение, выход и ошибки, не создавайте сессии бесконечно.

Не принимайте произвольную идентичность из неавторизованного браузера и не выдавайте токены для чужого аккаунта. Ключи и SIP-пароли не должны попасть в публичный JavaScript, репозитории, URL или снимки. Прямой SIP — продвинутая альтернатива, не причина раздавать постоянные секреты во frontend.

Показывайте готовность

Отображайте подключение, готовность, входящий, активный, завершённый и неудачный вызов по событиям SDK. Запрашивайте микрофон понятным действием, позволяйте выбирать поддерживаемые устройства и показывайте отказ. Клавиатура не доказывает регистрацию, а регистрация — двусторонний звук.

Не считайте SDK полной политикой нескольких устройств. Следуйте циклу соединения/разрыва и показывайте конфликты. Отключённая сессия не должна выглядеть активной. Очищайте состояние аккаунта при выходе, инициализируйте разрешённую идентичность нового пользователя, не старую из кеша.

Проведите небольшой приёмочный тест

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

Используйте разрешённые тестовые направления, проверьте цены, не считайте повторы бесплатными. Не собирайте и не передавайте записи без нужных уведомлений и полномочий.

Разбирайте по этапам

При ошибке авторизации проверьте backend и права без логирования секретов. При сигнализации — регион и совместимость сети/браузера. При отсутствии аудио — устройства, микрофон и сетевой доступ медиа. Сохраните версии SDK/браузера, очищенную ошибку, время/пояс и публичный ID для поддержки.

Справочник API определяет методы, данные и сроки токенов. См. Быстрый старт API для доступа и безопасных запросов.