Open in
Уход с ThunderPhone
Экспортируйте агента в виде открытых файлов, воссоздайте его на LiveKit Agents, Pipecat, Vapi или Retell с навыком работы с агентами для написания кода, а также скачайте историю звонков и записи.
Вы можете уйти из ThunderPhone в любой момент. Любого агента можно бесплатно экспортировать в ZIP-архив с открытыми файлами, а навык поможет вашему агенту для программирования восстановить его на LiveKit Agents, Pipecat, Vapi или Retell. На этой странице описано, что вы можете забрать, как это экспортировать и что потребуется заново настроить на другой стороне.
Что можно забрать с собой
| Что | Как |
|---|---|
| Агент: инструкции, инструменты, номера для перевода, этапы, настройки, маршрутизация номеров и вебхуки | Экспорт агента, один ZIP-архив на агента |
| Файлы знаний агента | Внутри экспорта агента |
| История звонков и расшифровки | Экспорт звонков, до 1 000 звонков за запрос |
| Записи | Одна запись за запрос, по звонку |
| Номера телефонов у вашего оператора | Они никогда не покидали вашего оператора. См. Номера телефонов |
Экспорт агента
В Zeus
Откройте агента и перейдите к его настройкам (Обработка звонков в редакторе агента). Внизу, в разделе Экспорт, копирование или удаление, выберите Экспорт. ZIP-архив будет загружен на ваш компьютер.
Через API
curl 'https://api.thunderphone.com/v1/agents/12/export' \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-o agent-12.zipZIP-архив создаётся по запросу. Экспортировать его может любой, у кого есть
доступ на чтение агента. База знаний, номера и вебхуки включаются, только если
учётные данные позволяют их читать: токен OAuth должен иметь knowledge:read,
numbers:read и integrations:read, а для вебхуков также требуются права
администратора или владельца. Исключённая часть указана в omitted файла
manifest.json. API возвращает 429, если выполняется более 30 экспортов в минуту.
| Параметр запроса | Описание |
|---|---|
include_url_paths | true сохраняет путь каждого 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 '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».
Полный текст приведён в Условиях обслуживания, в разделе Срок обслуживания; приостановка; прекращение. Условия имеют преимущественную силу; это краткое изложение.