Importa agenti da un
Importa agenti, strumenti e basi di conoscenza da Vapi, Retell, ElevenLabs Agents o Bland con una chiave API o un
Se i tuoi agenti sono su Vapi, Retell, ElevenLabs Agents o Bland, l'importatore li recupera, associa ogni campo a ThunderPhone e ti mostra il risultato prima che venga creato alcunché.
Avvia un'importazione
- Apri Agenti e scegli Importa (oppure Importa da Vapi, Retell, ElevenLabs o Bland in una pagina Agenti vuota).
- Seleziona la piattaforma.
- Segui i passaggi numerati nella finestra di dialogo per creare una chiave su quella piattaforma (aprono per te la pagina delle impostazioni corretta), incollala oppure passa a Incolla JSON esportato e incolla uno o più oggetti agente dalla dashboard o dall'API di quella piattaforma.
- Scegli Recupera i miei agenti. Il recupero e l'associazione richiedono solitamente meno di un minuto; puoi lasciare la pagina e tornare dal pannello delle attività.
Esamina il piano
Per ogni agente sono mostrati il nome, la voce corrispondente (con il livello di affidabilità della corrispondenza), il livello di intelligenza, gli strumenti e le basi di Knowledge incluse, oltre a note sugli elementi modificati durante la conversione. Espandi una riga per leggere il prompt:
- Riscritto — un prompt coerente nello stile della guida ai prompt, con ogni numero di telefono, URL, nome dello strumento e segnaposto della sorgente preservato.
- Strutturato — la configurazione della sorgente organizzata sotto intestazioni, esattamente come estratta. Viene utilizzata automaticamente quando la riscrittura non può essere verificata.
Deseleziona gli agenti che non desideri (le copie di test sono deselezionate per impostazione predefinita), modifica nomi, voci, livelli o la scelta del prompt, quindi Importa. Gli agenti creati si aprono nell'editor con le connessioni API e Knowledge collegati.
Cosa viene importato
Ottenere una chiave
- Apri dashboard.vapi.ai/org/api-keys (Impostazioni dell'organizzazione → Chiavi API).
- Crea una chiave e scegli Privata: le chiavi pubbliche non possono elencare gli assistenti.
- Copiala nella finestra di dialogo. Le chiavi Vapi non hanno ambiti; elimina la chiave in Vapi dopo l'importazione se l'hai creata solo per questo scopo.
| Campo Vapi | ThunderPhone |
|---|---|
model.messages[system] | Prompt |
firstMessage, firstMessageMode | Frase di apertura nel prompt; chi parla per primo |
voice.provider + voiceId | Voce del catalogo più simile (viene mostrata la confidenza della corrispondenza) |
transcriber.language | Lingua principale |
model.model | Livello di intelligenza |
model.tools / toolIds (function, apiRequest) | Connessioni API |
Destinazioni transferCall | Sezione di trasferimento del prompt (trasferimento integrato) |
endCall, dtmf | Funzioni integrate |
Strumenti query (knowledgeBases[].fileIds) e knowledgeBaseId legacy | Base di Knowledge con i file caricati come documenti |
endCallMessage, endCallPhrases, voicemailMessage, messagePlan.idleMessages | Sezioni del prompt; impostazione del messaggio di segreteria |
silenceTimeoutSeconds | Riaggancio per silenzio |
maxDurationSeconds, server.url, squadre, flussi di lavoro, strumenti sms/ghl/make/code/mcp | Segnalati, non importati |
Ottenere una chiave
- Apri dashboard.retellai.com/apiKeys (Impostazioni di sistema → Chiavi API) e scegli Crea chiave.
- Attiva Limita autorizzazioni e imposta Agente, Base di Knowledge e Telefono su Lettura. Lascia deselezionati tutti gli altri gruppi; l'importatore non scrive mai su Retell.
- Copia la chiave nella finestra di dialogo.
| Campo Retell | ThunderPhone |
|---|---|
Retell LLM general_prompt, begin_message, start_speaker | Prompt; frase di apertura; chi parla per primo |
states + starting_state | Procedura di chiamata ordinata nel prompt |
Flusso di conversazione global_prompt + nodi | Procedura di chiamata ordinata; i nodi di trasferimento diventano anche regole di passaggio |
general_tools personalizzati | Connessioni API |
transfer_call, end_call, press_digit | Trasferimento nel prompt + funzioni integrate |
voice_id (11labs-, openai-, cartesia-, …) | Voce del catalogo più simile |
language | Lingue principali e aggiuntive |
model / s2s_model | Livello di intelligenza |
knowledge_base_ids (fonti URL, documento, testo) | Base di Knowledge con documenti |
voicemail_option, end_call_after_silence_ms, boosted_keywords | Impostazione della segreteria; riaggancio per silenzio; termini del prompt |
webhook_url, max_call_duration_ms (quando inferiore al valore predefinito di 60 minuti), motori LLM personalizzati, send_sms, MCP | Segnalati, non importati |
Ottenere una chiave
- Apri elevenlabs.io/app/settings/api-keys e scegli Crea chiave API.
- Nelle autorizzazioni, assegna Piattaforma Agents: Lettura (e Base di Knowledge: Lettura se visualizzato); l'importatore non richiede altro.
- Copia la chiave nella finestra di dialogo.
| Campo ElevenLabs | ThunderPhone |
|---|---|
conversation_config.agent.prompt.prompt | Prompt |
first_message, language | Frase di apertura; lingua principale |
prompt.llm | Livello di intelligenza |
tts.voice_id | Voce del catalogo più simile |
tools / tool_ids di tipo webhook | Connessioni API (schema di query o corpo) |
Strumenti di sistema end_call, transfer_to_number, tastierino | Funzioni integrate + trasferimento nel prompt |
Voci URL/testo/file di knowledge_base | Base di Knowledge: le voci URL diventano documenti URL; le voci di testo e file vengono recuperate tramite ID e importate come testo estratto |
turn.silence_end_call_timeout | Riaggancio per silenzio |
conversation.max_duration_seconds, strumenti client, MCP | Segnalati, non importati |
Ottenere una chiave
- Apri app.bland.ai/dashboard/settings.
- Copia la chiave API mostrata qui (Bland ha una chiave per account; non ha ambiti, quindi ruotala in seguito se preferisci).
- Incollala nella finestra di dialogo.
Gli agenti web non hanno un nome su Bland, quindi l'importatore li denomina in base al saluto ("Ciao, sono Nova…") o al prompt ("Sei Nova…").
| Campo Bland | ThunderPhone |
|---|---|
Agente web prompt, first_sentence, language, model, voice | Prompt; frase di apertura; lingua; livello; voce più simile |
tools personalizzati (name, url, method, input_schema, headers) | Connessioni API |
prompt o pathway_id del numero in entrata | Un agente per numero in entrata |
| Ogni percorso, collegato o meno a un numero | Un agente per percorso |
| Nodi e collegamenti del percorso (Default, Knowledge Base, Transfer Call, End Call, Webhook) | Procedura di chiamata ordinata; il testo del nodo della base di Knowledge diventa un documento; trasferimenti e webhook diventano funzioni integrate e connessioni API |
transfer_phone_number | Sezione di trasferimento |
max_duration, webhook | Segnalati, non importati |
| Numeri di proprietà di Bland | Segnalati come non trasferibili |
Cosa richiede un intervento su ThunderPhone
Il report in fondo alla pagina di revisione elenca tutto ciò che non è stato trasferito e il motivo:
- Numeri di telefono. I numeri di tua proprietà presso un operatore possono essere collegati come numeri VoIP. I numeri di proprietà della piattaforma non possono essere trasferiti; ottieni un nuovo numero e collegalo all'agente importato.
- Webhook per agente. ThunderPhone invia webhook firmati per organizzazione; configurane uno in Webhook.
- Credenziali archiviate dal fornitore. Le intestazioni degli strumenti visibili vengono copiate. Le credenziali archiviate dalla vecchia piattaforma tramite ID vengono segnalate; aggiungile alle intestazioni della connessione API.
- Strumenti senza un equivalente (invio di SMS, automazioni specifiche della piattaforma) sono elencati affinché nulla venga omesso silenziosamente.
- Limiti di durata delle chiamate. ThunderPhone non ha una durata massima delle chiamate per agente; usa invece l'impostazione di riaggancio per silenzio e le regole di chiusura del tuo prompt.
Importazione senza chiave
Scegli Incolla JSON esportato e incolla gli oggetti esportati dall'API o dalla dashboard della tua piattaforma, come un oggetto o un elenco JSON:
- Vapi — l'oggetto assistente (
GET /assistant/{id}). Gli strumenti collegati tramitetoolIdse i file Knowledge richiedono una chiave per essere risolti. - Retell — l'oggetto agente (
GET /get-agent/{id}) insieme a il suo Retell LLM (GET /get-retell-llm/{id}) o l'oggetto flusso di conversazione nello stesso elenco; l'importatore li collega tramite ID. Un LLM o un flusso incollato da solo viene importato con un nome generato. - ElevenLabs — l'oggetto agente (
GET /v1/convai/agents/{id}); i suoi strumenti webhook sono inclusi inline, quindi nulla rimane irrisolto. - Bland — un agente web, la risposta di
/v1/agentso un oggetto percorso.
Qualsiasi elemento referenziato solo tramite ID e non presente nell'incolla viene elencato nelle note.
Dopo l'importazione
- Apri ogni agente e leggi le relative note.
- Effettua una chiamata di prova dal builder.
- Collega un numero di telefono.
- Testa ogni connessione API con il tester delle richieste.
- Verifica che i documenti Knowledge abbiano completato l'indicizzazione.
- Configura un webhook dell'organizzazione se i vecchi agenti ne usavano uno.
L'importatore è disponibile anche tramite l'API REST.