---
title: "Уход с ThunderPhone"
description: "Экспортируйте агента в виде открытых файлов, воссоздайте его на LiveKit Agents, Pipecat, Vapi или Retell с навыком работы с агентами для написания кода, а также скачайте историю звонков и записи."
ui: zeus
---

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

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

| Что | Как |
|---|---|
| Агент: инструкции, инструменты, номера для перевода, этапы, настройки, маршрутизация номеров и вебхуки | [Экспорт агента](#export-an-agent), один ZIP-архив на агента |
| Файлы знаний агента | Внутри экспорта агента |
| История звонков и расшифровки | [Экспорт звонков](#call-history-and-recordings), до 1 000 звонков за запрос |
| Записи | Одна запись за запрос, по звонку |
| Номера телефонов у вашего оператора | Они никогда не покидали вашего оператора. См. [Номера телефонов](#phone-numbers) |

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

### В Zeus

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

### Через API

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

ZIP-архив создаётся по запросу. Экспортировать его может любой, у кого есть
доступ на чтение агента. База знаний, номера и вебхуки включаются, только если
учётные данные позволяют их читать: токен 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}`](/api-reference/agents#agent-object), без учётных данных |
| `prompt.md` | Актуальные инструкции |
| `knowledge/index.json` и файлы рядом с ним | База знаний агента. Каждый документ — это исходный файл, если он хранится, иначе извлечённый из него текст |
| `numbers.json` | Номера, направленные этому агенту для входящих и исходящих звонков, с закреплённой версией или вариантом, если есть |
| `webhooks.json` | [Конечные точки вебхуков](/ru/webhooks/endpoints), ограниченные этим агентом, без секретов |
| `README.md` | Описание каждого файла |

Файл базы знаний размером более 25 МБ исключается, как и всё, что превышает
100 МБ для всего экспорта. Каждый такой файл указан в `manifest.json` вместе с
конечной точкой для его загрузки:
[`GET /v1/knowledge/documents/{document_id}/original`](/api-reference/knowledge-bases#download-the-original-file).

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

- **Значения учётных данных.** Заголовки инструмента перечисляются только по
  имени. Значения заголовков в ThunderPhone доступны только для записи: ни один
  ответ API не возвращает их, поэтому экспорт тоже не может их вернуть. Их
  нужно повторно ввести в другой системе. Это относится к учётным данным,
  которые ThunderPhone хранит как учётные данные. Ваши инструкции и файлы базы
  знаний копируются точно в том виде, в котором вы их написали или загрузили,
  поэтому если ключ когда-либо был вставлен в промпт или документ, он будет в
  ZIP-архиве. Проверьте это перед тем, как делиться архивом.
- **История звонков и записи.** Для них предусмотрены отдельные экспорты; см.
  [История звонков и записи](#call-history-and-recordings).
- **История версий.** Экспорт содержит агента в его текущем опубликованном
  состоянии. Более ранние версии по-прежнему перечислены в
  [`GET /v1/agents/{agent_id}/versions`](/api-reference/agents#version-history).
- **Другие агенты, которым этот агент передаёт звонки.** Экспортируйте каждый
  из них таким же способом.

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

Навык `migrate-off-thunderphone` проведёт вашего агента для программирования через
переход. Установите [навыки ThunderPhone](/ru/guides/coding-agents):

```bash
npx skills add thunderphone/skills
```

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

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

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

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

- **Поставщики речи, языковой модели и голоса.** Вы выбираете их на целевой
  платформе. Нет гарантии, что голос или звучание вызова совпадут.
- **Учётные данные.** Значения заголовков инструментов и секреты вебхуков.
- **Телефония.** Способ подключения номеров к агенту на каждой платформе
  настраивается по-разному.
- **Этапы и передачи.** На целевой платформе с функцией потоков или передач
  они пересобираются там. В остальных случаях навык включает этапы в
  инструкции и сообщает вам об этом.
- **Настройки ThunderPhone без аналога.** Настройки интеллектуальности,
  распознавания и скорости ответа, встроенные инструменты для email и текстовых
  сообщений, а также оценка вызовов, сводки и метки результатов не переносятся,
  если вы не пересоберёте их.
- **Подписи запросов.** ThunderPhone подписывает отправляемые запросы
  инструментов и вебхуки. Другая платформа использует собственный способ
  подписи, поэтому для конечной точки, которая
  [проверяет подпись ThunderPhone](/ru/guides/verify-webhook-signatures),
  нужна новая проверка.
- **Тестирование.** Протестируйте пересобранного агента на целевой платформе
  перед переносом номера.

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

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

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

- **Номер у вашего оператора** (подключение через [VoIP](/ru/guides/bring-your-own-numbers))
  остаётся у этого оператора. Укажите новую платформу в консоли оператора.
  Затем выберите **Освободить** для номера в ThunderPhone и не устанавливайте
  флажок **Также отменить этот номер в моём аккаунте …**: номер отключается
  от ThunderPhone и остаётся в аккаунте вашего оператора. Через API
  [освободите](/api-reference/phone-numbers#release-a-phone-number) его с помощью
  `DELETE /v1/phone-numbers/{phone_number_id}?confirm=true` и не отправляйте
  `release_at_provider`.
- **Номер, предоставленный ThunderPhone.** Обратитесь в
  [поддержку](mailto:support@thunderphone.com), прежде чем освобождать номер,
  который хотите сохранить. Освобождение номера ThunderPhone необратимо:
  он возвращается в пул и может быть передан другому клиенту.

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

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

- **Вызовы.** [`GET /v1/calls/export`](/api-reference/calls#export-calls)
  возвращает до 1 000 вызовов за запрос в формате CSV (метаданные) или JSON
  (с расшифровками). Фильтруйте по `agent_id` и разбивайте историю на страницы
  с помощью `start_date` и `end_date`. Заголовок ответа `X-Truncated` имеет
  значение `true`, если найдено больше вызовов, чем было возвращено.
- **Записи.** [`GET /v1/calls/{call_id}/audio`](/api-reference/calls#get-recording-audio)
  возвращает краткосрочный URL для записи одного вызова. Массовая загрузка
  записей недоступна.

<CodeGroup>
```bash 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
```
</CodeGroup>

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

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

## После ухода

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

Полный текст приведён в
[Условиях обслуживания](https://thunderphone.com/terms#term-termination), в разделе
**Срок обслуживания; приостановка; прекращение**. Условия имеют преимущественную силу; это краткое изложение.

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

- [Импорт агентов с другой платформы](/ru/guides/import-agents)
- [Навыки для агентов программирования](/ru/guides/coding-agents)
- [API агентов](/api-reference/agents)
- [API звонков](/api-reference/calls)
