---
title: "Saindo do ThunderPhone"
description: "Exporte um agente como arquivos abertos, recrie-o no LiveKit Agents, Pipecat, Vapi ou Retell com uma habilidade de agente de programação e baixe seu histórico de chamadas e gravações."
ui: zeus
---

Você pode sair do ThunderPhone quando quiser. Qualquer agente pode ser exportado gratuitamente como um zip de arquivos abertos, e uma skill ajuda seu agente de programação a recriá-lo no LiveKit Agents, Pipecat, Vapi ou Retell. Esta página aborda o que você pode levar, como exportar e o que precisa refazer do outro lado.

## O que você pode levar com você

| O que | Como |
|---|---|
| Um agente: instruções, ferramentas, números de transferência, etapas, configurações, roteamento de números e webhooks | A [exportação do agente](#export-an-agent), um zip por agente |
| Os arquivos de conhecimento do agente | Dentro da exportação do agente |
| Histórico de chamadas e transcrições | A [exportação de chamadas](#call-history-and-recordings), até 1.000 chamadas por solicitação |
| Gravações | Uma gravação por solicitação, por chamada |
| Números de telefone na sua própria operadora | Eles nunca saíram da sua operadora. Consulte [Números de telefone](#phone-numbers) |

## Exportar um agente

### No Zeus

Abra o agente e acesse as configurações dele (**Tratamento de chamadas** no
editor do agente). Na parte inferior, em **Exportar, copiar ou excluir**, escolha **Exportar**.
O arquivo zip é baixado para o seu computador.

### Com a 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>

O arquivo zip é criado quando você o solicita. Qualquer pessoa que possa ler o agente pode
exportá-lo. Conhecimento, números e webhooks são incluídos somente quando a
credencial pode lê-los: um token OAuth precisa de `knowledge:read`,
`numbers:read` e `integrations:read`, e os webhooks também exigem um administrador ou
proprietário. Uma parte que for deixada de fora será listada em `omitted` no `manifest.json`.
A API responde com `429` acima de 30 exportações por minuto.

| Parâmetro de consulta | Descrição |
|---|---|
| `include_url_paths` | `true` mantém o caminho de cada URL na exportação, como o endpoint de uma ferramenta. Por padrão, cada URL é reduzida ao host. Nomes de usuário, senhas e strings de consulta são removidos das URLs de qualquer forma |

Use `include_url_paths=true` quando estiver prestes a recriar o agente
em outro lugar, porque os endpoints das ferramentas são necessários lá. Deixe-o desativado para
uma cópia que você pretende compartilhar.

### O que o arquivo zip contém

| Arquivo | Conteúdo |
|---|---|
| `manifest.json` | O formato (`thunderphone.agent-export/v1`), o que está incluído e uma lista `omitted` que nomeia tudo o que foi deixado de fora e o motivo |
| `agent.json` | O agente conforme [`GET /v1/agents/{agent_id}`](/api-reference/agents#agent-object) o retorna, com as credenciais removidas |
| `prompt.md` | As instruções ativas |
| `knowledge/index.json` e os arquivos ao lado | O conhecimento do agente. Cada documento é o arquivo original quando houver um armazenado; caso contrário, é o texto extraído |
| `numbers.json` | Os números encaminhados para este agente, de entrada e saída, com qualquer versão ou variante fixada |
| `webhooks.json` | Os [endpoints de webhook](/pt/webhooks/endpoints) vinculados a este agente, sem seus segredos |
| `README.md` | O que é cada arquivo |

Um arquivo de conhecimento maior que 25 MB é deixado de fora, assim como qualquer conteúdo que exceda
100 MB para toda a exportação. Cada um é listado no `manifest.json` com o
endpoint que o baixa,
[`GET /v1/knowledge/documents/{document_id}/original`](/api-reference/knowledge-bases#download-the-original-file).

### O que nunca é incluído

- **Valores de credenciais.** Os cabeçalhos de uma ferramenta são listados apenas pelo nome. Os valores dos
  cabeçalhos são somente para gravação no ThunderPhone: nenhuma resposta da API os retorna, portanto nenhuma
  exportação pode retorná-los. Você os insere novamente do outro lado. Isso abrange as credenciais
  que o ThunderPhone armazena como credenciais. Suas instruções e arquivos de conhecimento são
  copiados exatamente como você os escreveu ou enviou, portanto, se uma chave tiver sido colada
  em um prompt ou documento, ela estará no arquivo zip. Verifique antes de compartilhá-lo.
- **Histórico de chamadas e gravações.** Eles têm suas próprias exportações; consulte
  [Histórico de chamadas e gravações](#call-history-and-recordings).
- **Histórico de versões.** A exportação contém o agente como ele está ativo agora. As versões
  anteriores continuam listadas em
  [`GET /v1/agents/{agent_id}/versions`](/api-reference/agents#version-history).
- **Outros agentes para os quais este transfere chamadas.** Exporte cada um deles da mesma forma.

## Migrar para outra plataforma

A habilidade `migrate-off-thunderphone` orienta seu agente de programação durante a
migração. Instale as [habilidades do ThunderPhone](/pt/guides/coding-agents):

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

Em seguida, peça ao seu agente de programação para migrar um agente do ThunderPhone e informe o
destino: **LiveKit Agents**, **Pipecat**, **Vapi** ou **Retell**. A
habilidade baixa a exportação, solicita cada credencial, recria o agente
a partir de um mapeamento para esse destino e o testa lá antes de migrar qualquer número.
A conversão é executada no seu agente de programação, com suas próprias chaves.
O ThunderPhone nunca grava nada na sua conta em outra plataforma.

O que é transferido, como arquivos que a habilidade mapeia para você:

- Instruções, incluindo instruções compartilhadas e etapas.
- Ferramentas: o mesmo endpoint, método e esquema de parâmetros. O
  `request_format` de cada ferramenta registra o formato do corpo esperado pelo seu endpoint.
- Números de transferência e as configurações de encerramento de chamada e teclado.
- Arquivos de conhecimento.
- Configurações de correio de voz, silêncio e duração da chamada.
- Quais números o agente atende e usa para realizar chamadas.

O que você refaz no outro lado:

- **Provedores de fala, modelo de linguagem e voz.** Você os escolhe no
  destino. Nada garante que uma voz, ou como uma chamada soa, será
  igual.
- **Credenciais.** Valores de cabeçalhos de ferramentas e segredos de webhook.
- **Telefonia.** A forma como os números chegam ao agente é configurada de maneira diferente em cada
  plataforma.
- **Etapas e transferências.** Um destino com um recurso de fluxo ou transferência
  recebe esses elementos recriados nele. Em outros casos, a habilidade incorpora as etapas às
  instruções e avisa você.
- **Configurações do ThunderPhone sem equivalente.** Inteligência, configurações de
  escuta e velocidade de resposta, as ferramentas integradas de e-mail e mensagem de texto, além de
  avaliação de chamadas, resumos e rótulos de resultado não são transferidos, a menos que você os recrie.
- **Assinaturas de solicitação.** O ThunderPhone assina as solicitações de ferramentas e webhooks
  que envia. Outra plataforma assina à sua própria maneira, portanto, um endpoint que
  [verifica a assinatura do ThunderPhone](/pt/guides/verify-webhook-signatures)
  precisa de uma nova verificação.
- **Testes.** Teste o agente recriado no destino antes de migrar um
  número.

Mantenha o agente do ThunderPhone ativo até que o novo passe nos seus
testes. Ele é seu caminho de volta.

## Números de telefone

Migre os números por último, depois que o novo agente passar nos testes.

- **Um número na sua própria operadora** (uma [conexão VoIP](/pt/guides/bring-your-own-numbers))
  permanece nessa operadora. Direcione-o para a nova plataforma no console da sua operadora.
  Em seguida, escolha **Liberar** no número no ThunderPhone e deixe
  **Também cancelar este número na minha conta de …** desmarcado: o número é
  desconectado do ThunderPhone e permanece na conta da sua operadora. Pela
  API, [libere](/api-reference/phone-numbers#release-a-phone-number) o número
  com `DELETE /v1/phone-numbers/{phone_number_id}?confirm=true` e não
  envie `release_at_provider`.
- **Um número fornecido pelo ThunderPhone.** Entre em contato com o
  [suporte](mailto:support@thunderphone.com) antes de liberar um número que você
  deseja manter. Liberar um número do ThunderPhone é permanente: ele retorna ao
  pool e pode ser destinado a outro cliente.

## Histórico de chamadas e gravações

Esses itens são separados da exportação do agente.

- **Chamadas.** [`GET /v1/calls/export`](/api-reference/calls#export-calls)
  retorna até 1.000 chamadas por solicitação como CSV (metadados) ou JSON (com
  transcrições). Filtre por `agent_id` e percorra seu histórico com
  `start_date` e `end_date`. O cabeçalho de resposta `X-Truncated` é `true`
  quando mais chamadas corresponderam ao filtro do que foram retornadas.
- **Gravações.** [`GET /v1/calls/{call_id}/audio`](/api-reference/calls#get-recording-audio)
  retorna uma URL de curta duração para a gravação de uma chamada. Não há
  download em massa de gravações.

<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>

## Quanto custa

Nada. A exportação de agentes, a exportação de chamadas e os downloads de gravações são
gratuitos. O ThunderPhone é [pré-pago](/pt/guides/pricing), sem assinatura
nem taxa por usuário. Um número do ThunderPhone deixa de ser cobrado quando você o libera.

## Depois que você sair

Não há prazo fixo. Você pode encerrar o contrato mediante aviso por escrito para
legal@thunderphone.com, enviado do e-mail administrativo da conta ou
por outro canal verificável. Uma inadimplência pode suspender o serviço; por si só,
ela nunca encerra o contrato nem aciona a exclusão dos Dados do Cliente. Sobre os dados,
os Termos dizem: "Após a rescisão formal, o Provedor devolverá ou excluirá os Dados do Cliente
em até sessenta (60) dias, sujeito aos direitos de exportação do Cliente, ciclos de backup,
retenções legais, retenção exigida por lei, o DPA e qualquer BAA firmado."

O texto completo está nos
[Termos de Serviço](https://thunderphone.com/terms#term-termination), em
**Prazo do serviço; suspensão; rescisão**. Os Termos prevalecem; isto é um resumo.

## Relacionados

- [Importar agentes de outra plataforma](/pt/guides/import-agents)
- [Habilidades para agentes de programação](/pt/guides/coding-agents)
- [API de agentes](/api-reference/agents)
- [API de chamadas](/api-reference/calls)
