Voice API
Создавайте вызовы и управляйте ими: речь, воспроизведение аудио, ввод с клавиатуры и перевод.
Изучить программируемую телефониюIllyVoIP для разработчиков
Ваше приложение.
Со связью внутри.
Добавьте голос, сообщения и управление номерами в своё ПО. Используйте серверные API для процессов и Webphone SDK для звонков в браузерном интерфейсе.
Начните со своих SIP-аккаунтовcURL
# Пример серверного запроса
curl -X GET \
"https://api.illyvoip.com/api/v1/sip/identities" \
-H "X-Api-Key: YOUR_API_KEY"HTTPS · JSONВаш аккаунт. Ваша интеграция.
Создайте связь,
нужную вашему продукту.
Выберите услугу и изучите её документацию: аутентификацию, параметры, ответы и доступные действия.
Телефонные номера
Ищите в каталоге, запрашивайте стоимость, заказывайте номера и настраивайте маршрутизацию через API.
Узнать о номерахSMS
Отправляйте сообщения, проверяйте результаты по получателям и следите за доставкой в приложении.
Узнать об SMSПроверка номеров и HLR
Нормализуйте номера или запрашивайте поддерживаемые сведения о текущей сети и переносе.
Изучить проверку номеровРечевые сервисы
Преобразуйте аудио в текст или создавайте озвучку из текста через отдельные речевые API. Выбирайте языки и голоса из документированных вариантов.
Изучить речевые APIКонтакты и данные звонков
Работайте с контактами, историей звонков и доступом к записям через документированные методы.
Открыть справочник APIWebphone SDK
Звонок остаётся
в вашем приложении.
Добавьте браузерные звонки в CRM, интерфейс сотрудника или своё рабочее пространство. JavaScript SDK обеспечивает регистрацию, управление звонками и устройствами через SIP поверх WSS.
Ваш серверAPI-ключ хранится здесь
Управляемая аутентификацияКраткосрочный токен браузера
Ваш браузерный интерфейсWebphone SDK
Ваш интерфейс. Управление звонками включено.
Подключайтесь, регистрируйтесь, звоните и отвечайте, отключайте микрофон, ставьте на удержание и возобновляйте, отправляйте DTMF и переводите вызовы через JavaScript.
Устройства и диагностика
Выбирайте аудиоустройства, выполняйте предварительные проверки и смотрите статистику текущего звонка. Выбор устройства вывода зависит от браузера.
Регионы и сессии
Выбирайте регион, настраивайте резервирование сигнализации и обновляйте учётные данные браузера для длительных сессий.
Вебхуки
Пусть приложение
следит за разговором.
Получайте уведомления о звонках, SMS, контактах и голосовой почте. Обновляйте свои записи или запускайте следующий шаг процесса.
Проверяйте подписи, быстро подтверждайте получение и безопасно обрабатывайте повторные ID событий.
Документация вебхуковЗвонки
call_ringing
call_answered
call_completedSMS
sms_sent
sms_delivered
sms_failedРабочее пространство
contact_added
voicemail_receivedОт документации —
к реализации.
Документация API, примеры и инструменты разработки собраны в вашем кабинете.
Изучите запрос
Проверьте аутентификацию, обязательные параметры и поля ответа нужного метода.
Начало работыРаботайте со схемой
Используйте опубликованную спецификацию OpenAPI вместе с документацией методов.
Спецификация OpenAPIПопробуйте инструменты
Создавайте примеры в API Playground. Отправленные запросы выполняются в вашем аккаунте и могут приводить к списаниям.
Открыть API PlaygroundСпланируйте
интеграцию.
Спросить командуКак аутентифицировать серверные запросы?+
Обычные клиентские API-запросы используют заголовок X-Api-Key. Храните ключ на своём сервере. Актуальное руководство описывает область действия аккаунта и требования отдельных методов.
Как управлять доступом к API-ключу?+
Показ, копирование и пересоздание ключа защищены проверкой личности. Следуйте запросам пароля и двухэтапной проверки. API Playground использует временную разблокировку; проверяйте запрос перед запуском. При пересоздании ключа согласуйте обновление всех использующих его приложений.
Как аутентифицируются браузерные звонки?+
В рекомендуемой управляемой схеме SDK ваш сервер выдаёт краткосрочный браузерный токен. Определяйте SIP-аккаунт по аутентифицированному пользователю на сервере; не позволяйте браузеру выбирать произвольный аккаунт. API-ключ остаётся на сервере.
Webphone SDK подходит для мобильных приложений?+
Это JavaScript SDK только для звонков в браузере. Он отделён от опубликованных приложений IllyVoIP для Windows, iOS и Android.
Где получить SDK?+
В документации Webphone SDK есть ссылки на размещённый браузерный файл и скачиваемый пакет для собственного хостинга с определениями TypeScript. Используйте актуальный пакет, изучите примечания к выпуску и рекомендации по безопасности.
Можно управлять номерами через API?+
Да. Описаны поиск в каталоге, расчёт цены, заказ, маршрутизация и работа с необходимыми документами. Наличие и активация зависят от направления и регистрационных требований.
Вебхук приходит только один раз?+
Доставка может повторяться. Проверяйте подпись и используйте постоянный ID события, чтобы не обработать его дважды. Поддерживаемые события и порядок повторов описаны в документации.
Добавьте связь
в свой продукт.
Начните с актуального справочника API и выберите нужные услуги.