ThunderPhone v3 já está no ar.Contrate online, a partir de 2¢/min.Leia o anúncio

Using the dashboard

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 queComo
Um agente: instruções, ferramentas, números de transferência, etapas, configurações, roteamento de números e webhooksA exportação do agente, um zip por agente
Os arquivos de conhecimento do agenteDentro da exportação do agente
Histórico de chamadas e transcriçõesA exportação de chamadas, até 1.000 chamadas por solicitação
GravaçõesUma gravação por solicitação, por chamada
Números de telefone na sua própria operadoraEles 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
curl 'https://api.thunderphone.com/v1/agents/12/export' \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -o agent-12.zip

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 consultaDescrição
include_url_pathstrue 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

ArquivoConteúdo
manifest.jsonO 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.jsonO agente conforme GET /v1/agents/{agent_id} o retorna, com as credenciais removidas
prompt.mdAs instruções ativas
knowledge/index.json e os arquivos ao ladoO conhecimento do agente. Cada documento é o arquivo original quando houver um armazenado; caso contrário, é o texto extraído
numbers.jsonOs números encaminhados para este agente, de entrada e saída, com qualquer versão ou variante fixada
webhooks.jsonOs endpoints de webhook vinculados a este agente, sem seus segredos
README.mdO 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/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 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=true e não envie release_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/export 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 retorna uma URL de curta duração para a gravação de uma chamada. Não há download em massa de gravações.
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

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

Relacionados