Open in
Saindo do ThunderPhone
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.
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, 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, 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 |
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
curl 'https://api.thunderphone.com/v1/agents/12/export' \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-o agent-12.zipO 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} 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 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.
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.
- 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. - 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:
npx skills add thunderphone/skillsEm 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_formatde 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 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)
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 o número
com
DELETE /v1/phone-numbers/{phone_number_id}?confirm=truee não envierelease_at_provider. - Um número fornecido pelo ThunderPhone. Entre em contato com o suporte 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/exportretorna até 1.000 chamadas por solicitação como CSV (metadados) ou JSON (com transcrições). Filtre poragent_ide percorra seu histórico comstart_dateeend_date. O cabeçalho de respostaX-Truncatedétruequando mais chamadas corresponderam ao filtro do que foram retornadas. - Gravações.
GET /v1/calls/{call_id}/audioretorna uma URL de curta duração para a gravação de uma chamada. Não há download em massa de gravações.
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.jsonQuanto 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, 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, em Prazo do serviço; suspensão; rescisão. Os Termos prevalecem; isto é um resumo.