Введение
Документация по запуску голосовых агентов в продакшене для реальных телефонных звонков и встраиваемых веб-виджетов: быстрые старты, руководства и полное справочное руководство по API ThunderPhone.
ThunderPhone позволяет создавать голосовых AI-агентов, которые совершают и принимают реальные телефонные звонки и обеспечивают разговоры через микрофон на вашем сайте. Документация разделена на четыре вкладки:
Быстрый старт, основные понятия и инструкции для панели управления и API. Начните здесь, если вы новичок.
Все эндпоинты, поля запросов и структуры ответов.
Встраиваемый веб-виджет — компонент React, headless-хук и тег CDN-скрипта.
События в реальном времени, подпись и семантика доставки.
Что можно создать
Отвечайте на звонки на принадлежащий вам номер с помощью AI-агента, который следует вашему промпту, использует ваши инструменты и при необходимости передаёт звонок человеку.
Совершайте программные звонки из своего кода — для опросов, повторных контактов или подтверждений.
Добавьте наш встраиваемый веб-виджет на свой сайт, чтобы клиенты могли нажать и начать разговор. Номер телефона не требуется.
Запускайте подготовленные сценарии через своего агента пакетами, чтобы выявлять регрессии до того, как их услышат клиенты.
Два способа начать
В панели управления (рекомендуется для первого агента) — зарегистрируйтесь, и панель управления проведёт вас через мастер настройки из пяти этапов: создайте агента, настройте оплату, добавьте номер телефона, запустите симуляцию и проверьте звонок. Быстрый старт в панели управления повторяет этот мастер шаг за шагом.
Из терминала — быстрый старт API выполняет тот же первый звонок за четыре REST-вызова.
- Просмотрите основные понятия
Основные понятия — карта всех объектов, с которыми вы будете работать, и их расположение в панели управления.
- Запустите быстрый старт
Быстрый старт в панели управления или быстрый старт API — выполните первый звонок с AI-агентом.
- Выберите руководство
Следуйте практическому руководству для своего сценария или изучите справочник API.
Обзор руководств
Создайте агента, пополните баланс, получите номер, выполните симуляцию и проверьте звонки.
OAuth-приложения, пользовательские API, MCP-серверы и VoIP-провайдеры.
Отчёты, наблюдаемость, эксперименты, проблемы и оповещения.
Приглашения и роли, API-ключи, безопасность и SSO.
Базовый URL
https://api.thunderphone.com/v1
Для аутентификации используется стандартная схема OAuth 2.0 Bearer с
API-ключом организации sk_live_. Ваш ключ автоматически определяет целевую
организацию — идентификатор организации не используется в URL-путях. Подробнее см. в разделе
Аутентификация.