ThunderPhone v3 уже доступен.Самостоятельный запуск — от 2 ¢/мин.Читать анонс

Using the dashboard

Уход с ThunderPhone

Экспортируйте агента в виде открытых файлов, воссоздайте его на LiveKit Agents, Pipecat, Vapi или Retell с навыком работы с агентами для написания кода, а также скачайте историю звонков и записи.

Вы можете уйти из ThunderPhone в любой момент. Любого агента можно бесплатно экспортировать в ZIP-архив с открытыми файлами, а навык поможет вашему агенту для программирования восстановить его на LiveKit Agents, Pipecat, Vapi или Retell. На этой странице описано, что вы можете забрать, как это экспортировать и что потребуется заново настроить на другой стороне.

Что можно забрать с собой

ЧтоКак
Агент: инструкции, инструменты, номера для перевода, этапы, настройки, маршрутизация номеров и вебхукиЭкспорт агента, один ZIP-архив на агента
Файлы знаний агентаВнутри экспорта агента
История звонков и расшифровкиЭкспорт звонков, до 1 000 звонков за запрос
ЗаписиОдна запись за запрос, по звонку
Номера телефонов у вашего оператораОни никогда не покидали вашего оператора. См. Номера телефонов

Экспорт агента

В Zeus

Откройте агента и перейдите к его настройкам (Обработка звонков в редакторе агента). Внизу, в разделе Экспорт, копирование или удаление, выберите Экспорт. ZIP-архив будет загружен на ваш компьютер.

Через API

cURL
curl 'https://api.thunderphone.com/v1/agents/12/export' \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -o agent-12.zip

ZIP-архив создаётся по запросу. Экспортировать его может любой, у кого есть доступ на чтение агента. База знаний, номера и вебхуки включаются, только если учётные данные позволяют их читать: токен OAuth должен иметь knowledge:read, numbers:read и integrations:read, а для вебхуков также требуются права администратора или владельца. Исключённая часть указана в omitted файла manifest.json. API возвращает 429, если выполняется более 30 экспортов в минуту.

Параметр запросаОписание
include_url_pathstrue сохраняет путь каждого URL в экспорте, например конечную точку инструмента. По умолчанию каждый URL сокращается до хоста. Имена пользователей, пароли и строки запроса удаляются из URL в любом случае

Используйте include_url_paths=true, если собираетесь восстановить агента в другом месте, потому что там понадобятся конечные точки инструментов. Не включайте его для копии, которой планируете поделиться.

Что содержит ZIP-архив

ФайлСодержимое
manifest.jsonФормат (thunderphone.agent-export/v1), включённые данные и список omitted, в котором указано, что исключено и почему
agent.jsonАгент в виде, в котором его возвращает GET /v1/agents/{agent_id}, без учётных данных
prompt.mdАктуальные инструкции
knowledge/index.json и файлы рядом с нимБаза знаний агента. Каждый документ — это исходный файл, если он хранится, иначе извлечённый из него текст
numbers.jsonНомера, направленные этому агенту для входящих и исходящих звонков, с закреплённой версией или вариантом, если есть
webhooks.jsonКонечные точки вебхуков, ограниченные этим агентом, без секретов
README.mdОписание каждого файла

Файл базы знаний размером более 25 МБ исключается, как и всё, что превышает 100 МБ для всего экспорта. Каждый такой файл указан в manifest.json вместе с конечной точкой для его загрузки: GET /v1/knowledge/documents/{document_id}/original.

Что никогда не включается

  • Значения учётных данных. Заголовки инструмента перечисляются только по имени. Значения заголовков в ThunderPhone доступны только для записи: ни один ответ API не возвращает их, поэтому экспорт тоже не может их вернуть. Их нужно повторно ввести в другой системе. Это относится к учётным данным, которые ThunderPhone хранит как учётные данные. Ваши инструкции и файлы базы знаний копируются точно в том виде, в котором вы их написали или загрузили, поэтому если ключ когда-либо был вставлен в промпт или документ, он будет в ZIP-архиве. Проверьте это перед тем, как делиться архивом.
  • История звонков и записи. Для них предусмотрены отдельные экспорты; см. История звонков и записи.
  • История версий. Экспорт содержит агента в его текущем опубликованном состоянии. Более ранние версии по-прежнему перечислены в GET /v1/agents/{agent_id}/versions.
  • Другие агенты, которым этот агент передаёт звонки. Экспортируйте каждый из них таким же способом.

Переход на другую платформу

Навык migrate-off-thunderphone проведёт вашего агента для программирования через переход. Установите навыки ThunderPhone:

npx skills add thunderphone/skills

Затем попросите агента для программирования перенести агента с ThunderPhone и укажите целевую платформу: LiveKit Agents, Pipecat, Vapi или Retell. Навык скачивает экспорт, запрашивает у вас все учётные данные, пересобирает агента по сопоставлению для этой платформы и тестирует его там до переноса любого номера. Преобразование выполняется в вашем агенте для программирования с использованием ваших ключей. ThunderPhone никогда не записывает данные в ваш аккаунт на другой платформе.

Что переносится в виде файлов, которые навык сопоставляет для вас:

  • Инструкции, включая общие инструкции и этапы.
  • Инструменты: те же конечная точка, метод и схема параметров. request_format каждого инструмента указывает структуру тела запроса, которую ожидает ваша конечная точка.
  • Номера для перевода, а также настройки завершения вызова и тонального набора.
  • Файлы базы знаний.
  • Настройки голосовой почты, тишины и длительности вызова.
  • Номера, на которые агент отвечает и с которых совершает вызовы.

Что нужно настроить заново на другой стороне:

  • Поставщики речи, языковой модели и голоса. Вы выбираете их на целевой платформе. Нет гарантии, что голос или звучание вызова совпадут.
  • Учётные данные. Значения заголовков инструментов и секреты вебхуков.
  • Телефония. Способ подключения номеров к агенту на каждой платформе настраивается по-разному.
  • Этапы и передачи. На целевой платформе с функцией потоков или передач они пересобираются там. В остальных случаях навык включает этапы в инструкции и сообщает вам об этом.
  • Настройки ThunderPhone без аналога. Настройки интеллектуальности, распознавания и скорости ответа, встроенные инструменты для email и текстовых сообщений, а также оценка вызовов, сводки и метки результатов не переносятся, если вы не пересоберёте их.
  • Подписи запросов. ThunderPhone подписывает отправляемые запросы инструментов и вебхуки. Другая платформа использует собственный способ подписи, поэтому для конечной точки, которая проверяет подпись ThunderPhone, нужна новая проверка.
  • Тестирование. Протестируйте пересобранного агента на целевой платформе перед переносом номера.

Оставьте агента ThunderPhone на месте, пока новый не пройдёт ваши тесты. Это ваш путь для возврата.

Номера телефонов

Переносите номера в последнюю очередь, после того как новый агент пройдёт тесты.

  • Номер у вашего оператора (подключение через VoIP) остаётся у этого оператора. Укажите новую платформу в консоли оператора. Затем выберите Освободить для номера в ThunderPhone и не устанавливайте флажок Также отменить этот номер в моём аккаунте …: номер отключается от ThunderPhone и остаётся в аккаунте вашего оператора. Через API освободите его с помощью DELETE /v1/phone-numbers/{phone_number_id}?confirm=true и не отправляйте release_at_provider.
  • Номер, предоставленный ThunderPhone. Обратитесь в поддержку, прежде чем освобождать номер, который хотите сохранить. Освобождение номера ThunderPhone необратимо: он возвращается в пул и может быть передан другому клиенту.

История вызовов и записи

Они хранятся отдельно от экспорта агента.

  • Вызовы. GET /v1/calls/export возвращает до 1 000 вызовов за запрос в формате CSV (метаданные) или JSON (с расшифровками). Фильтруйте по agent_id и разбивайте историю на страницы с помощью start_date и end_date. Заголовок ответа X-Truncated имеет значение true, если найдено больше вызовов, чем было возвращено.
  • Записи. GET /v1/calls/{call_id}/audio возвращает краткосрочный URL для записи одного вызова. Массовая загрузка записей недоступна.
cURL
curl 'https://api.thunderphone.com/v1/calls/export?export_format=json&agent_id=12&start_date=2026-10-01T00:00:00Z&end_date=2026-11-01T00:00:00Z' \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -o calls-2026-10.json

Сколько это стоит

Ничего. Экспорт агентов, экспорт звонков и скачивание записей бесплатны. ThunderPhone работает по модели оплаты по мере использования, без подписки и платы за место. Номер ThunderPhone перестаёт тарифицироваться после его освобождения.

После ухода

Фиксированного срока нет. Вы можете прекратить соглашение, направив письменное уведомление на legal@thunderphone.com с административного email аккаунта или через другой проверяемый канал. Просрочка оплаты может приостановить обслуживание; сама по себе она никогда не прекращает соглашение и не запускает удаление данных клиента. О данных в Условиях сказано: «После официального прекращения Поставщик вернёт или удалит данные клиента в течение шестидесяти (60) дней с учётом прав Клиента на экспорт, циклов резервного копирования, юридических ограничений, хранения, требуемого законом, DPA и любого подписанного BAA».

Полный текст приведён в Условиях обслуживания, в разделе Срок обслуживания; приостановка; прекращение. Условия имеют преимущественную силу; это краткое изложение.

Связанные материалы