Open in
Importe agentes de outra plataforma
Traga agentes, ferramentas e bases de conhecimento do Vapi, Retell, ElevenLabs Agents ou Bland com uma chave de API ou uma exportação JSON, revise o mapeamento e importe.
Se seus agentes estão no Vapi, Retell, ElevenLabs Agents ou Bland, o importador os busca, mapeia todos os campos para o ThunderPhone e mostra o resultado antes que qualquer item seja criado.
Inicie uma importação
- Abra Agentes e escolha Importar agentes ou peça ao Zeus para trazer seus agentes.
- Selecione a plataforma.
- Siga as etapas para criar uma chave nessa plataforma (elas abrem a página de configurações correta para você) e cole-a ou escolha Colar JSON exportado em vez disso e cole um ou mais objetos de agente do painel ou da API dessa plataforma.
- Escolha Buscar meus agentes (o botão menciona sua plataforma). A busca e o mapeamento geralmente levam menos de um minuto; você pode sair da página e voltar depois. Uma importação ainda aberta e suas importações anteriores são listadas na página Importar agentes.
Na visualização antiga, Importar fica em Agentes de voz e abre as mesmas etapas em uma caixa de diálogo.
Revise o plano
Cada agente mostra o nome, a voz correspondente (com o nível de confiança da correspondência), as ferramentas e bases de conhecimento que traz, além de observações sobre qualquer alteração feita na tradução. Expanda uma linha para ler o prompt:
- Revisado (Reescrito na visualização antiga) — um prompt coerente no estilo do guia de prompts, com todos os números de telefone, URLs, nomes de ferramentas e placeholders da fonte preservados.
- Como no Vapi, ou o nome da sua plataforma (Estruturado na visualização antiga) — a configuração de origem organizada sob títulos, exatamente como extraída. Usado automaticamente quando a reescrita não puder ser verificada ou quando a reescrita ficar muito mais curta que a fonte.
Um agente importado de um fluxo mostra Instruções compartilhadas em vez do prompt e quantas etapas ele mantém do fluxo. A revisão da visualização antiga lista o nome de cada etapa, o que ela instrui o agente a fazer e para onde ela vai em seguida, e Mostrar como um único prompt exibe o mesmo agente como um único prompt, que é o que ele executa sempre que as etapas não estão disponíveis. Agentes com transferências listam os agentes para os quais transferem quem liga; se você desmarcar um deles, a revisão informa que essa transferência não será configurada.
Todos os agentes começam selecionados, exceto os vazios e os agentes iniciais padrão que a plataforma criou para você. Desmarque os agentes que não quiser, edite nomes, vozes, configurações ou a opção de prompt e selecione Importar. Os agentes são salvos com suas conexões de API e bases de conhecimento vinculadas; abra um para verificar e faça uma chamada de teste antes de vinculá-lo a um número.
Fluxos, Squads e transferências de agentes
Agentes de várias etapas mantêm sua estrutura. Consulte Etapas do agente para saber como as etapas e transferências funcionam em uma chamada.
- Fluxos se tornam etapas. Estados com vários prompts e fluxos de conversa do Retell,
caminhos do Bland e fluxos de trabalho do ElevenLabs são importados como etapas
do agente. O prompt global da origem se torna as instruções compartilhadas.
- As instruções, linha fixa, valores a coletar e ferramentas de cada nó são mantidos.
- Condições de borda escritas em palavras se tornam transições decididas pelo
agente. Uma única comparação em um valor coletado ou em uma resposta de webhook
(
age >= 18) se torna uma transição verificada exatamente. - Nós de webhook e função executam sua ferramenta quando a etapa começa. Nós globais podem ser alcançados de qualquer etapa; um sem saídas próprias devolve a chamada à etapa que interrompeu.
- Nós de transferência e encerramento se tornam etapas finais que transferem ou encerram a chamada. Um nó de transferência do Retell mantém sua saída para quando a transferência não é concluída.
- Um nó de ramificação que apenas escolhe a próxima etapa é incorporado à etapa anterior quando possível. Caso contrário, permanece como uma etapa própria, com uma observação.
- Um fluxo grande demais para etapas, ou que o ThunderPhone não consegue representar como etapas, é importado como um único prompt que lista todas as etapas, com uma observação.
- Squads, transferências e trocas de agentes se tornam transferências. Cada membro
de uma Squad do Vapi é importado como um agente próprio, com o nome do membro e da
Squad. O primeiro membro atende às chamadas da Squad, e os demais são acessados por
transferência. Transferências do ElevenLabs para outro agente e trocas de agentes
do Retell também se tornam transferências. Quem liga permanece na linha, e a conversa
até aquele momento é mantida.
- Uma chamada recebida por transferência mantém as configurações de chamada do agente que a atendeu: caixa postal, limites de chamada, idiomas e gravação. O agente para o qual ela é transferida traz seu próprio prompt, etapas, ferramentas e voz.
- Uma transferência só pode apontar para um agente importado na mesma execução. Se o outro agente não estiver na importação ou se você desmarcá-lo, a observação indicará isso, e você poderá adicionar a transferência depois nas configurações do agente.
O que é importado
Como obter uma chave
- Abra dashboard.vapi.ai/org/api-keys (Configurações da organização → Chaves de API).
- Crie uma chave e escolha Privada — chaves públicas não podem listar assistentes.
- Copie-a para a caixa de diálogo. As chaves da Vapi não têm escopo; exclua a chave na Vapi após a importação se você a criou apenas para isso.
| Campo do Vapi | ThunderPhone |
|---|---|
model.messages[system] | Prompt |
firstMessage, firstMessageMode | Frase de abertura no prompt; quem fala primeiro |
voice.provider + voiceId | Voz mais próxima do catálogo, com busca de melhor esforço na biblioteca do Vapi (confiança da correspondência exibida) |
transcriber.language, languages, palavras-chave/termos-chave | Idiomas e vocabulário de reconhecimento de fala |
model.model | Não mapeado: os agentes importados começam com inteligência Pro e audição Standard |
model.tools, toolIds, toolRefs (function, apiRequest) | Conexões de API; envelopes de solicitação do Vapi e alternativas de servidor no nível do assistente são preservados |
Destinos de transferCall | Transferências telefônicas no prompt; destinos SIP, de assistente e dinâmicos são informados para revisão |
Ferramentas handoff | Transferências para os assistentes nomeados importados na mesma execução |
endCall, dtmf | Recursos integrados |
Google Calendar, Google Sheets, sms | Informados com a integração do ThunderPhone ou a configuração de SMS necessária |
| Slack | Informado como não importado: o ThunderPhone ainda não pode se conectar ao Slack |
Ferramentas query e knowledgeBase, além do legado knowledgeBaseId | Base de conhecimento com arquivos enviados acessíveis como documentos |
endCallMessage, endCallPhrases, voicemailMessage, planos de mensagens ociosas e gatilhos de tempo limite | Seções do prompt; configurações de correio de voz e silêncio |
maxDurationSeconds, desativações de gravação | Duração máxima da chamada (o padrão de 600 segundos do Vapi é mantido); uma desativação de gravação é informada na página de revisão |
| Squads | Um agente por membro, com seu próprio prompt, substituições, voz, ferramentas e conhecimento. assistantDestinations tornam-se transferências entre eles; o primeiro membro mantém os números do Squad |
| Servidores personalizados de conhecimento/modelo, planos de conformidade, outros gatilhos, fluxos de trabalho e ferramentas hospedadas não compatíveis | Informados com uma ação específica de revisão ou reconstrução; planos e credenciais brutos não são armazenados |
Como obter uma chave
- Abra dashboard.retellai.com/apiKeys (Configurações do sistema → Chaves de API) e escolha Criar chave.
- Ative Restringir permissões e defina Agente, Base de conhecimento e Telefone como Leitura. Deixe todos os outros grupos desmarcados; o importador nunca grava dados no Retell.
- Copie a chave para a caixa de diálogo.
| Campo do Retell | ThunderPhone |
|---|---|
| Agente publicado mais recente + sua versão exata de LLM / fluxo do Retell | Prompt e comportamento publicados; rascunhos mais recentes são informados para revisão |
LLM do Retell general_prompt, begin_message, start_speaker, estados | Instruções compartilhadas; comportamento de abertura; uma etapa por estado, com suas ferramentas e transições e os valores coletados por cada transição |
Fluxo de conversa global_prompt, nós, componentes, nós globais e conexões | Instruções e etapas compartilhadas; condições de equação sobre valores coletados são verificadas exatamente; texto de abertura e etapas de transferência exatos |
Ferramentas e nós agent_swap | Transferências para os agentes do Retell importados na mesma execução |
| Ferramentas personalizadas | Conexões de API com parâmetros de consulta, tempo limite e formato de solicitação exclusivo do Retell/args; uma alteração de assinatura e qualquer configuração não padrão de fala, nova tentativa, variável de resposta ou codificação de formulário são informadas |
transfer_call, end_call, press_digit | Transferências condicionais, incluindo ramais, + recursos integrados; diferenças em transferências inferidas e assistidas são informadas |
check_availability_cal, book_appointment_cal | Informadas como ferramentas do Cal.com para reconectar em Integrações; as credenciais do Retell nunca são transferidas |
send_sms, MCP | Informados com instruções de configuração de SMS ou MCP |
voice_id (11labs-, openai-, cartesia-, …) | Voz de catálogo mais próxima |
language (uma localidade, modo multilíngue ou uma lista de localidades) | Idiomas principal e adicionais |
model / s2s_model | Não mapeado: os agentes importados começam com inteligência Pro e audição Standard |
knowledge_base_ids (fontes de URL, documento e texto) | Base de conhecimento com documentos |
default_dynamic_variables, variáveis de sistema compatíveis | Valores padrão de variáveis do ThunderPhone e instruções simples de contexto da chamada |
voicemail_option, end_call_after_silence_ms, max_call_duration_ms, ring_duration_ms, gravação desativada, boosted_keywords | Comportamento da caixa postal; limites de chamada; configuração de gravação; termos do prompt |
webhook_url, mecanismos de LLM personalizados, nós de fluxo não compatíveis e configurações exclusivas do fornecedor | Informados para revisão manual, sem serem descartados silenciosamente |
Obtendo uma chave
- Abra elevenlabs.io/app/settings/api-keys e escolha Criar chave de API.
- Em permissões, conceda Plataforma de agentes: Leitura (e Base de conhecimento: Leitura, se exibido); o importador não precisa de mais nada.
- Copie a chave para a caixa de diálogo.
| Campo do ElevenLabs | ThunderPhone |
|---|---|
conversation_config.agent.prompt.prompt, nós do Fluxo de trabalho do agente e condições ordenadas de ramificação | Instruções compartilhadas e uma etapa por nó do fluxo de trabalho; nós de ferramenta executam sua ferramenta quando a etapa começa; ramificações de expressão são identificadas para revisão |
first_message, language, language_presets | Mensagem de abertura; idiomas principal e adicionais; aberturas traduzidas |
prompt.llm | Não mapeado: os agentes importados começam com inteligência Pro e audição Standard |
tts.voice_id | Voz de catálogo mais próxima |
tool_ids do webhook, incluindo ferramentas vinculadas a etapas do fluxo de trabalho | Conexões de API com parâmetros portáveis de corpo/consulta; parâmetros e credenciais fixos do fornecedor são removidos e informados |
built_in_tools para encerrar chamada, transferência telefônica, teclado e caixa postal | Recursos integrados, regras de transferência e comportamento da caixa postal; destinos SIP e dinâmicos são informados para recriação |
Transferências para outro agente (transfer_to_agent, nós de fluxo de trabalho do agente) | Transferências para os agentes do ElevenLabs importados na mesma execução |
Entradas de URL/texto/arquivo/pasta de knowledge_base, incluindo conhecimento de etapas do fluxo de trabalho | Documentos da base de conhecimento; pastas são expandidas e o conteúdo de texto/arquivo é buscado por ID |
turn.silence_end_call_timeout, conversation.max_duration_seconds, asr.keywords, privacy.record_voice | Limites de silêncio e duração máxima; termos de pronúncia; gravação desativada é informada na página de revisão |
| LLMs personalizados, servidores MCP, procedimentos, webhooks do espaço de trabalho, substituições de modelo/voz/idioma por etapa, ferramentas de agendamento do ElevenLabs | Informados com a ação necessária após a importação |
Obtendo uma chave
- Abra app.bland.ai/dashboard/settings.
- Copie a chave de API exibida ali (a Bland tem uma chave por conta; ela não tem escopo, então alterne-a depois se preferir).
- Cole-a na caixa de diálogo.
Os rótulos exibidos pelo Bland não são tratados como a identidade do agente. O importador determina como o agente se apresenta a partir da saudação e do prompt; para um fluxo, usa o prompt global e o nó inicial. Se essa verificação não estiver disponível ou não encontrar um nome, o prompt importado permanece neutro.
| Campo do Bland | ThunderPhone |
|---|---|
Agente web prompt, first_sentence, language, model, voice, pathway_id | Prompt; frase de abertura; idioma; nível; voz mais próxima; fluxo de pathway publicado anexado |
| Versão de produção da persona | Prompts de personalidade e orquestração; voz; idioma; configuração para quem liga falar primeiro; gravação; duração máxima; ferramentas e conhecimento padrão. Um único pathway anexado é incluído; o roteamento por múltiplos pathways é informado para configuração manual |
| Ferramentas personalizadas e de pathway (URL, método, esquema, cabeçalhos, variáveis de corpo) | Conexões de API. Referências a Bland Secret são informadas e devem ser adicionadas novamente |
| Ferramentas do Cal.com, HubSpot, Salesforce, Google Calendar e Google Sheets | A integração correspondente do ThunderPhone é indicada para você conectar e ativar |
| Ferramentas do Slack | Informadas como não importadas: o ThunderPhone ainda não consegue se conectar ao Slack |
Detalhes do número de entrada (prompt, pathway_id / versão, ferramentas, transferências, palavras-chave, dados da solicitação) | Um agente por número de entrada, com padrões de variáveis da chamada e regras de transferência |
| Cada pathway, anexado a um número ou não | Versão publicada quando disponível; um rascunho não publicado é claramente sinalizado |
| Prompt global; nós Default, Knowledge Base, Transfer Call, End Call, Webhook e Wait for Response; arestas, condições de loop, nós globais, variáveis extraídas, fala estática | Instruções compartilhadas e uma etapa por nó, incluindo etapas que podem ocorrer a qualquer momento, valores a coletar, fala exata, etapas de webhook, transferências e encerramentos de chamada. Caminhos de resposta de webhook em um campo de resposta ou variável extraída são verificados exatamente |
| Texto de conhecimento embutido e IDs de conhecimento resolvíveis | Documentos de conhecimento. Itens cujo texto ou arquivo não pode ser lido são informados para envio manual |
max_duration, wait_for_greeting, configuração de gravação | Limite de chamada, ordem de fala, configuração de gravação |
webhook, consultas de dados dinâmicos, roteamento de persona por múltiplos caminhos, configurações de nó não compatíveis, agentes v2 | Informados com o acompanhamento manual necessário |
| Números de entrada | Listados com ambas as opções, pois o Bland não informa se ele ou sua conta Twilio é proprietário deles |
O que exige uma etapa no ThunderPhone
O relatório no fim da página de revisão lista números, webhooks e ferramentas que não foram transferidos; as observações de cada agente cobrem o restante. Juntos, eles mostram tudo o que não foi transferido e o motivo:
- Números de telefone. Após a importação, cada número de origem mostra onde ele
está e o que você pode fazer com ele:
- Na sua própria conta Twilio ou Telnyx (por exemplo, um número Twilio que você conectou ao Vapi ou ElevenLabs): um administrador pode movê-lo para um agente importado. Se nenhuma conexão VoIP estiver vinculada a essa conta ainda, conecte-a primeiro. Antes de qualquer alteração, uma etapa de confirmação informa que as chamadas para o número deixarão de ser direcionadas à plataforma antiga. Em seguida, o ThunderPhone aponta o número para si mesmo na sua conta da operadora (um número Twilio entra no tronco SIP do ThunderPhone; um número Telnyx é movido para a conexão SIP do ThunderPhone) e faz uma breve chamada de teste para ativá-lo. Para desfazer, exclua o número em Telefone e web, mantendo-o na sua conta da operadora, e depois reimporte-o na plataforma antiga.
- No seu tronco SIP: conecte o tronco como uma conexão SIP e importe o número em Telefone e web.
- Vendidos pela plataforma (números Vapi, Retell e Bland comprados nela): o ThunderPhone não pode movê-los. Faça a portabilidade para uma operadora e importe-o, ou obtenha um número ThunderPhone e associe-o ao agente importado.
- A Bland não informa se um número é dela ou da sua conta Twilio, portanto os números Bland mostram ambas as opções.
- Webhooks por agente. O ThunderPhone entrega webhooks assinados por organização; configure um em Webhooks.
- Credenciais armazenadas pelo fornecedor. Os cabeçalhos de ferramentas que estavam visíveis são copiados. As credenciais que a plataforma antiga armazenava por ID são sinalizadas; adicione-as aos cabeçalhos da conexão de API.
- Integrações integradas. Ferramentas de calendário, CRM e mensagens que a plataforma antiga hospedava (por exemplo, agendamento do Cal.com) são indicadas com a integração do ThunderPhone que você deve conectar; as credenciais delas não são transferidas. A revisão também sinaliza um prompt que ainda instrui o agente a usar uma ferramenta que não foi importada.
- Mensagens de texto. Os agentes do ThunderPhone enviam mensagens de texto pelo seu próprio número Twilio ou Telnyx; configure o SMS nas configurações do agente.
- Ferramentas sem equivalente (automações específicas da plataforma) são listadas para que nada seja omitido silenciosamente.
- Variáveis de chamada. Os placeholders
{{name}}são mantidos, com os valores padrão da sua plataforma. O ThunderPhone os preenche a partir das variáveis transmitidas quando uma chamada começa e os deixa em branco caso contrário; a revisão lista as que você precisa transmitir. - Limites de chamada e gravação. A duração máxima da chamada é importada. Quando o agente de origem nunca a alterou, o padrão da própria plataforma é definido: 10 minutos para Vapi e ElevenLabs, 1 hora para Retell, 30 minutos para Bland. Um valor de origem que não seja um número positivo é importado sem máximo, e a revisão informa isso. Os limites de silêncio e duração máxima fora dos intervalos do ThunderPhone são ajustados, e a observação da revisão informa o valor de origem e o importado. Quando o agente de origem tinha a gravação de chamadas desativada, a observação da revisão do agente informa se ele é importado com a gravação desativada ou, quando ainda não é possível desativar a gravação, com a gravação ativada.
O que muda quando você importa
Algumas configurações que sua plataforma anterior deixou no próprio padrão passam a usar o padrão do ThunderPhone. A revisão as lista em uma observação por agente, nos detalhes dele, somente onde as duas plataformas diferem. Os valores do ThunderPhone abaixo são seus padrões, que você pode alterar por agente:
| Configuração | Padrão da plataforma antiga | Padrão do ThunderPhone |
|---|---|---|
| Tempo de toque em chamadas de saída | Retell: 30 segundos | 60 segundos |
| Encerramento de uma chamada silenciosa | Retell: desligar após 10 minutos; ElevenLabs: nunca | Verificar a cada 15 segundos (após cerca de 6 segundos se ninguém tiver falado ainda, após pelo menos um minuto se quem liga tiver pedido para o agente esperar), desligar após 1 minuto de silêncio |
| Gravação de chamadas | Números de entrada e personas do Bland: desativada | Ativada. Entre em contato com o suporte ou altere nas configurações do agente, quando disponível |
| Ao chegar à caixa postal | Personas do Bland: desligar | O agente decide com base no prompt |
Uma configuração que você alterou na plataforma anterior é importada conforme definida, não listada aqui. A única exceção é uma configuração de chamada silenciosa de "nunca desligar": ela é listada como padrão, e o agente mantém as verificações do ThunderPhone. Altere qualquer uma delas nas configurações do agente após a importação.
Importar sem uma chave
Escolha Colar JSON exportado e cole o(s) objeto(s) que a API ou o painel da sua plataforma exporta, como um objeto ou uma lista JSON:
- Vapi — um objeto de assistente (
GET /assistant/{id}), um objeto Squad (GET /squad/{id}) ou uma lista de ambos. Ferramentas vinculadas apenas por id e arquivos de conhecimento exigem uma chave para serem resolvidos. A Vapi descontinuou os Workflows, portanto, converta um Workflow em um Squad antes de colá-lo. - Retell — o objeto do agente (
GET /get-agent/{id}?version=...) junto com o Retell LLM da mesma versão (GET /get-retell-llm/{id}?version=...) ou o objeto de fluxo de conversa na mesma lista. O importador vincula por id e versão, prioriza um agente publicado colado quando o status de publicação está presente e importa um LLM ou fluxo independente com um nome gerado. - ElevenLabs — o objeto do agente (
GET /v1/convai/agents/{id}). As exportações atuais normalmente fazem referência a ferramentas de webhook e documentos de conhecimento apenas por id. Uma colagem informa esses itens como não resolvidos; use uma chave de API para uma importação completa. - Bland — um agente web, a resposta de
/v1/agentsou um objeto de caminho. Cada objeto colado é importado como seu próprio agente, mesmo quando dois compartilham um id; ids de ferramentas e conhecimentos que exigem acesso à API são listados para configuração manual em vez de serem descartados.
Tudo que for referenciado apenas por ID e não estiver presente na colagem será listado nas observações.
Após a importação
- Abra cada agente e leia suas notas.
- Clique em Testar chamada na página do agente ou peça ao Zeus para testá-lo.
- Transfira seus números ou associe um novo (consulte Números de telefone acima).
- Teste cada conexão de API com o testador de solicitações.
- Verifique se os documentos de conhecimento terminaram de ser indexados.
- Configure um webhook da organização caso os agentes antigos usassem um.
O importador também está disponível pela API REST.
A importação não prende você à plataforma. Qualquer agente pode ser exportado como arquivos abertos, gratuitamente, a qualquer momento: consulte Saindo do ThunderPhone.