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 (ou Importar do Vapi, Retell, ElevenLabs ou Bland em uma página de agentes vazia).
- Escolha a plataforma.
- Siga as etapas numeradas na caixa de diálogo para criar uma chave nessa plataforma (elas abrem a página de configurações correta para você), cole-a ou mude para Colar JSON exportado e cole um ou mais objetos de agente do painel ou da API dessa plataforma.
- Escolha Buscar meus agentes. A busca e o mapeamento geralmente levam menos de um minuto; você pode sair da página e voltar pela bandeja de tarefas.
Revise o plano
Cada agente mostra o nome, a voz correspondente (com o nível de confiança da correspondência), o nível de inteligência, as ferramentas e bases de conhecimento incluídas e observações sobre qualquer alteração feita na tradução. Expanda uma linha para ler o prompt:
- Reescrito — um prompt coeso no estilo do guia de prompting, com todos os números de telefone, URLs, nomes de ferramentas e placeholders da fonte preservados.
- Estruturado — a configuração de origem organizada em títulos, exatamente como extraída. Usado automaticamente quando a reescrita não pode ser verificada.
Desmarque os agentes que não quiser (cópias de teste vêm desmarcadas por padrão), edite nomes, vozes, níveis ou a escolha do prompt e selecione Importar. Os agentes criados são abertos no construtor com suas conexões de API e conhecimentos anexados.
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 da Vapi | ThunderPhone |
|---|---|
model.messages[system] | Prompt |
firstMessage, firstMessageMode | Linha de abertura no prompt; quem fala primeiro |
voice.provider + voiceId | Voz mais próxima do catálogo (confiança da correspondência exibida) |
transcriber.language | Idioma principal |
model.model | Nível de inteligência |
model.tools / toolIds (function, apiRequest) | Conexões de API |
Destinos de transferCall | Seção de transferência do prompt (transferência integrada) |
endCall, dtmf | Recursos integrados |
Ferramentas query (knowledgeBases[].fileIds) e knowledgeBaseId legado | Base de conhecimento com os arquivos enviados como documentos |
endCallMessage, endCallPhrases, voicemailMessage, messagePlan.idleMessages | Seções do prompt; configuração de mensagem de correio de voz |
silenceTimeoutSeconds | Encerramento por silêncio |
maxDurationSeconds, server.url, squads, workflows, ferramentas sms/ghl/make/code/mcp | Relatado, não importado |
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 |
|---|---|
Retell LLM general_prompt, begin_message, start_speaker | Prompt; linha de abertura; quem fala primeiro |
states + starting_state | Procedimento ordenado de chamada no prompt |
Fluxo de conversa global_prompt + nós | Procedimento ordenado de chamada; nós de transferência também se tornam regras de transferência |
general_tools personalizados | Conexões de API |
transfer_call, end_call, press_digit | Transferência no prompt + recursos integrados |
voice_id (11labs-, openai-, cartesia-, …) | Voz mais próxima do catálogo |
language | Idiomas principal e adicionais |
model / s2s_model | Nível de inteligência |
knowledge_base_ids (fontes de URL, documento, texto) | Base de conhecimento com documentos |
voicemail_option, end_call_after_silence_ms, boosted_keywords | Configuração de correio de voz; encerramento por silêncio; termos do prompt |
webhook_url, max_call_duration_ms (quando abaixo do padrão de 60 minutos), mecanismos LLM personalizados, send_sms, MCP | Relatado, não importado |
Como obter 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 | Prompt |
first_message, language | Linha de abertura; idioma principal |
prompt.llm | Nível de inteligência |
tts.voice_id | Voz mais próxima do catálogo |
tools / tool_ids do tipo webhook | Conexões de API (esquema de consulta ou corpo) |
Ferramentas do sistema end_call, transfer_to_number, teclado numérico | Recursos integrados + transferência no prompt |
Entradas de URL/texto/arquivo de knowledge_base | Base de conhecimento: entradas de URL tornam-se documentos de URL; entradas de texto e arquivo são buscadas por ID e importadas como texto extraído |
turn.silence_end_call_timeout | Encerramento por silêncio |
conversation.max_duration_seconds, ferramentas de cliente, MCP | Relatado, não importado |
Como obter 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 agentes web não têm nome na Bland, então o importador os nomeia com base na saudação ("Olá, aqui é a Nova…") ou no prompt ("Você é a Nova…").
| Campo da Bland | ThunderPhone |
|---|---|
Agente web prompt, first_sentence, language, model, voice | Prompt; linha de abertura; idioma; nível; voz mais próxima |
tools personalizados (name, url, method, input_schema, headers) | Conexões de API |
prompt ou pathway_id do número de entrada | Um agente por número de entrada |
| Cada pathway, vinculado ou não a um número | Um agente por pathway |
| Nós e arestas do pathway (Default, Knowledge Base, Transfer Call, End Call, Webhook) | Procedimento ordenado de chamada; o texto do nó de base de conhecimento torna-se um documento; transferências e webhooks tornam-se recursos integrados e conexões de API |
transfer_phone_number | Seção de transferência |
max_duration, webhook | Relatado, não importado |
| Números pertencentes à Bland | Relatados como não portáveis |
O que exige uma etapa no ThunderPhone
O relatório na parte inferior da página de revisão lista tudo o que não foi migrado e o motivo:
- Números de telefone. Números que você possui em uma operadora podem ser conectados como números VoIP. Números pertencentes à plataforma não podem ser migrados; obtenha um novo número e vincule-o ao agente importado.
- Webhooks por agente. O ThunderPhone envia webhooks assinados por organização; configure um em Webhooks.
- Credenciais armazenadas pelo fornecedor. Cabeçalhos de ferramentas que estavam visíveis são copiados. Credenciais que a plataforma anterior armazenava por ID são sinalizadas; adicione-as aos cabeçalhos da conexão de API.
- Ferramentas sem equivalente (envio de SMS, automações específicas da plataforma) são listadas para que nada seja descartado silenciosamente.
- Limites de duração da chamada. O ThunderPhone não tem duração máxima de chamada por agente; use a configuração de desligamento por silêncio e as regras de encerramento do seu prompt.
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 — o objeto do assistente (
GET /assistant/{id}). Ferramentas vinculadas portoolIdse arquivos de conhecimento precisam de uma chave para serem resolvidos. - Retell — o objeto do agente (
GET /get-agent/{id}) junto com seu Retell LLM (GET /get-retell-llm/{id}) ou objeto de fluxo de conversa na mesma lista; o importador os vincula por ID. Um LLM ou fluxo colado sozinho é importado com um nome gerado. - ElevenLabs — o objeto do agente (
GET /v1/convai/agents/{id}); suas ferramentas de webhook são incluídas inline, portanto nada fica sem resolução. - Bland — um agente web, a resposta de
/v1/agentsou um objeto de caminho.
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 observações.
- Faça uma chamada de teste pelo construtor.
- Vincule um número de telefone.
- Teste cada conexão de API com o testador de solicitações.
- Verifique se os documentos de conhecimento concluíram a indexação.
- Configure um webhook da organização se os agentes anteriores usavam um.
O importador também está disponível pela API REST.