---
title: "Importe agentes de outra plataforma"
description: "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."
ui: zeus
---

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.

<Note>
  Sua chave de API é usada apenas para a importação. Ela é criptografada enquanto
  o inventário é buscado e excluída assim que a busca é concluída — e em caso
  de falha ou descarte. É necessário ter a função de administrador para iniciar
  ou confirmar uma importação.
</Note>

## Inicie uma importação

1. Abra **Agentes** e escolha **Importar agentes** ou peça ao Zeus para trazer seus agentes.
2. Selecione a plataforma.
3. 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.
4. 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](/pt/guides/prompting), 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](/pt/guides/agent-steps)
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

<Tabs>
  <Tab title="Vapi">
    **Como obter uma chave**

    1. Abra [dashboard.vapi.ai/org/api-keys](https://dashboard.vapi.ai/org/api-keys)
       (Configurações da organização → Chaves de API).
    2. Crie uma chave e escolha **Privada** — chaves públicas não podem listar
       assistentes.
    3. 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 |
  </Tab>
  <Tab title="Retell">
    **Como obter uma chave**

    1. Abra [dashboard.retellai.com/apiKeys](https://dashboard.retellai.com/apiKeys)
       (Configurações do sistema → Chaves de API) e escolha **Criar chave**.
    2. 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.
    3. 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 |
  </Tab>
  <Tab title="Agentes do ElevenLabs">
    **Obtendo uma chave**

    1. Abra [elevenlabs.io/app/settings/api-keys](https://elevenlabs.io/app/settings/api-keys)
       e escolha **Criar chave de API**.
    2. Em permissões, conceda **Plataforma de agentes: Leitura**
       (e **Base de conhecimento: Leitura**, se exibido); o importador não precisa
       de mais nada.
    3. 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 |
  </Tab>
  <Tab title="Bland">
    **Obtendo uma chave**

    1. Abra [app.bland.ai/dashboard/settings](https://app.bland.ai/dashboard/settings).
    2. 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).
    3. 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 |
  </Tab>
</Tabs>

## 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](/pt/guides/bring-your-own-numbers) 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](/pt/guides/voip-providers) 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](/pt/webhooks/overview).
- **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](/pt/guides/call-variables) 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/agents` ou 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

1. Abra cada agente e leia suas notas.
2. Clique em **Testar chamada** na página do agente ou peça ao Zeus para testá-lo.
3. Transfira seus números ou associe um novo (consulte **Números de telefone** acima).
4. Teste cada conexão de API com o testador de solicitações.
5. Verifique se os documentos de conhecimento terminaram de ser indexados.
6. Configure um webhook da organização caso os agentes antigos usassem um.

O importador também está disponível pela [API REST](/api-reference/agent-imports).

A importação não prende você à plataforma. Qualquer agente pode ser exportado como arquivos abertos, gratuitamente, a qualquer momento: consulte [Saindo do ThunderPhone](/pt/guides/leaving-thunderphone).
