Open in
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 agenti, oppure chiedi a Zeus di trasferire i tuoi agenti.
- Seleziona la piattaforma.
- Segui i passaggi per creare una chiave su quella piattaforma (aprono per te la pagina delle impostazioni corretta) e incollala, oppure scegli Incolla invece JSON esportato e incolla uno o più oggetti agente dalla dashboard o dall'API di quella piattaforma.
- Scegli Recupera i miei agenti (indica il nome della tua piattaforma). Il recupero e la mappatura richiedono in genere meno di un minuto; puoi lasciare la pagina e tornare in seguito. Un'importazione ancora aperta e le importazioni precedenti sono elencate nella pagina Importa agenti.
Nella vecchia vista, Importa si trova in Agenti vocali e apre gli stessi passaggi in una finestra di dialogo.
Esamina il piano
Ogni agente mostra il nome, la voce corrispondente (con il livello di affidabilità della corrispondenza), gli strumenti e le basi di conoscenza che include, nonché note su tutto ciò che è cambiato nella traduzione. Espandi una riga per leggere il prompt:
- Ripulito (Riscritto nella vecchia visualizzazione) — un unico prompt coerente nello stile della guida ai prompt, con ogni numero di telefono, URL, strumento nome e segnaposto della fonte preservati.
- Come su Vapi, o il nome della tua piattaforma (Strutturato nella vecchia visualizzazione) — la configurazione di origine organizzata in sezioni, esattamente come estratta. Utilizzata automaticamente quando la riscrittura non può essere verificata o quando risulta molto più breve della fonte.
Un agente importato da un flusso mostra Istruzioni condivise al posto del prompt e il numero di passaggi che conserva dal flusso. La revisione della vecchia visualizzazione elenca il nome di ogni passaggio, cosa indica all'agente di fare e dove prosegue, mentre Mostra come unico prompt mostra lo stesso agente come un singolo prompt, ovvero ciò che esegue quando i passaggi non sono disponibili. Gli agenti con trasferimenti elencano gli agenti a cui trasferiscono il chiamante; se deselezioni uno di questi, la revisione indica che il trasferimento non verrà configurato.
Ogni agente è inizialmente selezionato, tranne quelli vuoti e gli agenti iniziali predefiniti creati dalla piattaforma per te. Deseleziona gli agenti che non vuoi, modifica nomi, voci, impostazioni o la scelta del prompt, quindi Importa. Gli agenti vengono salvati con le connessioni API e le Knowledge associate; aprine uno per controllarlo e prova una chiamata prima di assegnarlo a un numero.
Flussi, squadre e trasferimenti tra agenti
Gli agenti multi-passaggio mantengono la loro struttura. Consulta Passaggi dell'agente per sapere come vengono eseguiti passaggi e trasferimenti durante una chiamata.
- I flussi diventano passaggi. Gli stati multi-prompt e i flussi di conversazione di Retell,
i percorsi di Bland e i flussi di lavoro di ElevenLabs vengono importati come passaggi dell'agente.
Il prompt globale dell'origine diventa le istruzioni condivise.
- Le istruzioni di ogni nodo, la frase fissa, i valori da raccogliere e gli strumenti vengono mantenuti.
- Le condizioni dei collegamenti scritte a parole diventano transizioni che l'agente decide.
Un singolo confronto su un valore raccolto o su una risposta webhook
(
age >= 18) diventa una transizione verificata esattamente. - I nodi webhook e funzione eseguono il proprio strumento all'avvio del passaggio. I nodi globali possono essere raggiunti da qualsiasi passaggio; un nodo senza proprie uscite restituisce la chiamata al passaggio che ha interrotto.
- I nodi di trasferimento e fine diventano passaggi finali che trasferiscono o terminano la chiamata. Un nodo di trasferimento Retell mantiene la propria uscita per quando il trasferimento non va a buon fine.
- Un nodo di diramazione che si limita a scegliere il passaggio successivo viene unito al passaggio precedente quando possibile. Altrimenti rimane un passaggio separato, con una nota.
- Un flusso troppo grande per i passaggi, o che ThunderPhone non può rappresentare come passaggi, viene importato come un unico prompt che elenca ogni passaggio, con una nota.
- Le squadre, i trasferimenti tra agenti e le sostituzioni di agenti diventano passaggi di consegna. Ogni membro
di una Squad Vapi viene importato come agente separato, denominato in base al membro e alla
Squad. Il primo membro risponde alle chiamate della Squad e gli altri vengono raggiunti
tramite passaggio di consegna. Anche i trasferimenti ElevenLabs a un altro agente e le sostituzioni
di agente Retell diventano passaggi di consegna. Il chiamante rimane in linea e la conversazione
avvenuta fino a quel momento viene mantenuta.
- Una chiamata ricevuta tramite passaggio di consegna mantiene le impostazioni di chiamata dell'agente che ha risposto: segreteria telefonica, limiti di chiamata, lingue e registrazione. L'agente a cui passa la chiamata porta con sé il proprio prompt, passaggi, strumenti e voce.
- Un passaggio di consegna può puntare solo a un agente importato nella stessa esecuzione. Se l'altro agente non è nell'importazione, o lo deselezioni, la nota lo indica e puoi aggiungere il passaggio di consegna in seguito nelle impostazioni dell'agente.
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 iniziale nel prompt; chi parla per primo |
voice.provider + voiceId | Voce di catalogo più vicina, con ricerca nella libreria Vapi al meglio delle possibilità (viene mostrata l'affidabilità della corrispondenza) |
transcriber.language, languages, keywords/keyterms | Lingue e vocabolario per il riconoscimento vocale |
model.model | Non mappato: gli agenti importati iniziano con intelligenza Pro e ascolto Standard |
model.tools, toolIds, toolRefs (function, apiRequest) | Connessioni API; vengono mantenute le strutture delle richieste Vapi e i fallback del server a livello di assistente |
Destinazioni transferCall | Trasferimenti telefonici nel prompt; le destinazioni SIP, assistente e dinamiche vengono segnalate per la verifica |
Strumenti handoff | Passaggi agli assistenti denominati importati nella stessa esecuzione |
endCall, dtmf | Funzionalità integrate |
Google Calendar, Google Sheets, sms | Segnalati con l'integrazione ThunderPhone o la configurazione SMS necessaria |
| Slack | Segnalato come non importato: ThunderPhone non può ancora connettersi a Slack |
Strumenti query e knowledgeBase, oltre al legacy knowledgeBaseId | Base Knowledge con file caricati accessibili come documenti |
endCallMessage, endCallPhrases, voicemailMessage, piani per messaggi di inattività e hook di timeout | Sezioni del prompt; impostazioni della segreteria telefonica e del silenzio |
maxDurationSeconds, esclusioni della registrazione | Durata massima della chiamata (viene mantenuto il valore predefinito Vapi di 600 secondi); un'esclusione della registrazione viene segnalata nella pagina di verifica |
| Squadre | Un agente per membro, con prompt, override, voce, strumenti e Knowledge propri. Le assistantDestinations diventano passaggi tra loro; il primo membro mantiene i numeri della Squadra |
| Server personalizzati per Knowledge/modelli, piani di conformità, altri hook, workflow e strumenti ospitati non supportati | Segnalati con un'azione specifica di verifica o ricreazione; piani e credenziali grezzi non vengono archiviati |
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 |
|---|---|
| Agente pubblicato più recente + relativa versione esatta di Retell LLM / flusso | Prompt e comportamento pubblicati; le bozze più recenti vengono segnalate per la revisione |
Retell LLM general_prompt, begin_message, start_speaker, stati | Istruzioni condivise; comportamento di apertura; un passaggio per stato, con i relativi strumenti e transizioni e i valori raccolti da ciascuna transizione |
Flusso di conversazione global_prompt, nodi, componenti, nodi globali e collegamenti | Istruzioni e passaggi condivisi; le condizioni delle equazioni sui valori raccolti vengono verificate esattamente; testo di apertura esatto e passaggi di trasferimento |
Strumenti e nodi agent_swap | Passaggi agli agenti Retell importati nella stessa esecuzione |
| Strumenti personalizzati | Connessioni API con parametri di query, timeout e struttura della richiesta solo Retell/args; vengono segnalate una modifica della firma e qualsiasi impostazione non predefinita di parlato, tentativi, variabili di risposta o codifica modulo |
transfer_call, end_call, press_digit | Trasferimenti condizionali, incluse le estensioni, + funzioni integrate; vengono segnalate le differenze tra trasferimenti dedotti e con operatore |
check_availability_cal, book_appointment_cal | Segnalati come strumenti Cal.com da riconnettere in Integrations; le credenziali Retell non vengono mai trasferite |
send_sms, MCP | Segnalati con istruzioni per la configurazione di SMS o MCP |
voice_id (11labs-, openai-, cartesia-, …) | Voce del catalogo più simile |
language (un'impostazione locale, modalità multilingue o un elenco di impostazioni locali) | Lingue principali e aggiuntive |
model / s2s_model | Non mappato: gli agenti importati iniziano con intelligenza Pro e ascolto Standard |
knowledge_base_ids (fonti url, documenti, testo) | Knowledge base con documenti |
default_dynamic_variables, variabili di sistema supportate | Valori predefiniti delle variabili ThunderPhone e semplici istruzioni sul contesto della chiamata |
voicemail_option, end_call_after_silence_ms, max_call_duration_ms, ring_duration_ms, registrazione disattivata, boosted_keywords | Comportamento della segreteria telefonica; limiti di chiamata; impostazione di registrazione; termini del prompt |
webhook_url, motori LLM personalizzati, nodi di flusso non supportati e impostazioni specifiche del fornitore | Segnalati per la revisione manuale, non eliminati silenziosamente |
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, nodi Agent Workflow e condizioni di diramazione ordinate | Istruzioni condivise e un passaggio per nodo del workflow; i nodi strumento eseguono il proprio strumento all'avvio del passaggio; le diramazioni delle espressioni vengono etichettate per la revisione |
first_message, language, language_presets | Frase di apertura; lingue principali e aggiuntive; frasi di apertura tradotte |
prompt.llm | Non mappato: gli agenti importati iniziano con intelligenza Pro e ascolto Standard |
tts.voice_id | Voce del catalogo più simile |
tool_ids webhook, inclusi gli strumenti collegati ai passaggi del workflow | Connessioni API con parametri body/query portabili; i parametri fissi del fornitore e le credenziali vengono rimossi e segnalati |
built_in_tools per terminare la chiamata, trasferimento telefonico, tastierino e segreteria telefonica | Funzioni integrate, regole di trasferimento e comportamento della segreteria telefonica; le destinazioni SIP e dinamiche vengono segnalate per la ricostruzione |
Trasferimenti a un altro agente (transfer_to_agent, nodi del workflow dell'agente) | Passaggi agli agenti ElevenLabs importati nella stessa esecuzione |
Voci url/testo/file/cartella di knowledge_base, incluso il Knowledge dei passaggi del workflow | Documenti della Knowledge base; le cartelle vengono espanse e il contenuto di testo/file viene recuperato per id |
turn.silence_end_call_timeout, conversation.max_duration_seconds, asr.keywords, privacy.record_voice | Limiti di silenzio e durata massima; termini di pronuncia; la registrazione disattivata viene segnalata nella pagina di revisione |
| LLM personalizzati, server MCP, procedure, webhook dello spazio di lavoro, override di modello/voce/lingua per passaggio, strumenti di prenotazione ElevenLabs | Segnalati con l'azione necessaria dopo l'importazione |
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.
Le etichette visualizzate di Bland non vengono considerate l'identità dell'agente. L'importatore ricava l'identità con cui l'agente si presenta dal saluto e dal prompt; per un percorso usa il prompt globale e il nodo iniziale. Se questo controllo non è disponibile o non trova alcun nome, il prompt importato resta neutro.
| Campo Bland | ThunderPhone |
|---|---|
Agente web prompt, first_sentence, language, model, voice, pathway_id | Prompt; frase di apertura; lingua; livello; voce più simile; flusso del percorso pubblicato collegato |
| Versione di produzione della persona | Prompt di personalità e orchestrazione; voce; lingua; impostazione in cui parla prima il chiamante; registrazione; durata massima; strumenti e Knowledge predefiniti. Viene incluso un singolo percorso collegato; il routing con più percorsi viene segnalato per la configurazione manuale |
| Strumenti personalizzati e del percorso (url, metodo, schema, intestazioni, variabili del corpo) | Connessioni API. I riferimenti a Bland Secret vengono segnalati e devono essere aggiunti di nuovo |
| Strumenti Cal.com, HubSpot, Salesforce, Google Calendar e Google Sheets | Viene indicata l'integrazione ThunderPhone corrispondente da connettere e abilitare |
| Strumenti Slack | Segnalati come non importati: ThunderPhone non può ancora connettersi a Slack |
Dettagli del numero in entrata (prompt, pathway_id / versione, strumenti, trasferimenti, parole chiave, dati della richiesta) | Un agente per ogni numero in entrata, con valori predefiniti delle variabili di chiamata e regole di trasferimento |
| Ogni percorso, collegato o meno a un numero | Versione pubblicata quando disponibile; una bozza non pubblicata viene chiaramente segnalata |
| Prompt globale; nodi Default, Knowledge Base, Transfer Call, End Call, Webhook e Wait for Response; collegamenti, condizioni di ciclo, nodi globali, variabili estratte, testo fisso | Istruzioni condivise e un passaggio per nodo, inclusi passaggi eseguibili in qualsiasi momento, valori da raccogliere, testo esatto, passaggi webhook, trasferimenti e chiusure di chiamata. I percorsi di risposta webhook basati su un campo di risposta o una variabile estratta vengono verificati esattamente |
| Testo Knowledge inline e ID Knowledge risolvibili | Documenti Knowledge. Gli elementi il cui testo o file non può essere letto vengono segnalati per il caricamento manuale |
max_duration, wait_for_greeting, impostazione di registrazione | Limite di chiamata, ordine di parola, impostazione di registrazione |
webhook, ricerche di dati dinamici, routing della persona con più percorsi, impostazioni di nodo non supportate, agenti v2 | Segnalati con l'azione manuale necessaria |
| Numeri in entrata | Elencati con entrambe le opzioni, poiché Bland non indica se ne è proprietario Bland o il tuo account Twilio |
Cosa richiede un intervento su ThunderPhone
Il report in fondo alla pagina di revisione elenca numeri, webhook e strumenti che non sono stati trasferiti; le note di ciascun agente coprono il resto. Insieme mostrano tutto ciò che non è stato trasferito e il motivo:
- Numeri di telefono. Dopo l'importazione, ogni numero di origine mostra dove
si trova e cosa puoi farci:
- Nel tuo account Twilio o Telnyx (ad esempio un numero Twilio che hai collegato a Vapi o ElevenLabs): un amministratore può spostarlo a un agente importato. Se nessuna connessione VoIP gestisce già quell'account, collegala prima. Prima di qualsiasi modifica, un passaggio di conferma avvisa che le chiamate al numero non verranno più inoltrate alla vecchia piattaforma. ThunderPhone configura quindi il numero affinché punti a sé stesso nel tuo account del gestore telefonico (un numero Twilio si unisce al trunk SIP di ThunderPhone; un numero Telnyx passa alla connessione SIP di ThunderPhone) ed effettua una breve chiamata di prova per attivarlo. Per annullare l'operazione, elimina il numero da Telefono e web, mantenendolo nel tuo account del gestore telefonico, quindi importalo di nuovo sulla vecchia piattaforma.
- Sul tuo trunk SIP: collega il trunk come connessione SIP e importa il numero in Telefono e web.
- Venduto dalla piattaforma (numeri Vapi, Retell e Bland acquistati lì): ThunderPhone non può spostarlo. Trasferiscilo a un gestore telefonico e importalo, oppure ottieni un numero ThunderPhone e collegalo all'agente importato.
- Bland non indica se un numero è proprio o proviene dal tuo account Twilio, quindi i numeri Bland mostrano entrambe le opzioni.
- Webhook per agente. ThunderPhone invia webhook firmati per organizzazione; configurane uno in Webhook.
- Credenziali archiviate dal fornitore. Le intestazioni degli strumenti che erano visibili vengono copiate. Le credenziali archiviate dalla vecchia piattaforma tramite ID vengono segnalate; aggiungile alle intestazioni della connessione API.
- Integrazioni integrate. Gli strumenti di calendario, CRM e messaggistica ospitati dalla vecchia piattaforma (ad esempio le prenotazioni Cal.com) vengono indicati con l'integrazione ThunderPhone da collegare; le relative credenziali non vengono trasferite. La revisione segnala anche un prompt che continua a indicare all'agente di usare uno strumento non importato.
- Messaggi di testo. Gli agenti ThunderPhone inviano messaggi di testo tramite il tuo numero Twilio o Telnyx; configura gli SMS nelle impostazioni dell'agente.
- Strumenti senza equivalente (automazioni specifiche della piattaforma) sono elencati affinché nulla venga omesso senza avviso.
- Variabili di chiamata. I segnaposto
{{name}}vengono mantenuti, con i valori predefiniti della tua piattaforma. ThunderPhone li compila dalle variabili passate all'avvio di una chiamata e altrimenti li lascia vuoti; la revisione elenca quelle che devi passare. - Limiti di chiamata e registrazione. Viene importata la durata massima della chiamata. Quando l'agente di origine non l'ha mai modificata, viene impostato il valore predefinito della piattaforma: 10 minuti per Vapi ed ElevenLabs, 1 ora per Retell, 30 minuti per Bland. Un valore di origine che non è un numero positivo viene importato senza massimo e la revisione lo indica. I limiti di silenzio e durata massima esterni agli intervalli di ThunderPhone vengono adattati e la nota di revisione indica il valore di origine e quello importato. Quando l'agente di origine aveva la registrazione delle chiamate disattivata, la nota di revisione dell'agente indica se viene importato con la registrazione disattivata o, dove non è ancora possibile disattivare la registrazione, con la registrazione attivata.
Cosa cambia durante l'importazione
Alcune impostazioni che la tua vecchia piattaforma ha lasciato ai propri valori predefiniti adottano invece i valori predefiniti di ThunderPhone. La revisione le elenca in una nota per agente, nei relativi dettagli, solo dove le due piattaforme differiscono. I valori di ThunderPhone riportati di seguito sono quelli predefiniti, che puoi modificare per singolo agente:
| Impostazione | Predefinito della vecchia piattaforma | Predefinito di ThunderPhone |
|---|---|---|
| Tempo di squillo nelle chiamate in uscita | Retell: 30 secondi | 60 secondi |
| Termine di una chiamata silenziosa | Retell: riaggancia dopo 10 minuti; ElevenLabs: mai | Verifica ogni 15 secondi (dopo circa 6 secondi se nessuno ha ancora parlato, dopo almeno un minuto se il chiamante ha chiesto all'agente di attendere), riaggancia dopo 1 minuto di silenzio |
| Registrazione delle chiamate | Numeri in entrata e personaggi Bland: disattivata | Attivata. Contatta l'assistenza oppure modificala nelle impostazioni dell'agente, dove disponibile |
| Alla segreteria telefonica | Personaggi Bland: riaggancia | L'agente decide in base al suo prompt |
Un'impostazione modificata sulla piattaforma precedente viene importata come l'hai configurata, non elencata qui. L'unica eccezione è un'impostazione per chiamate silenziose con "non riagganciare mai": viene elencata come valore predefinito e l'agente mantiene i controlli periodici di ThunderPhone. Modifica una qualsiasi di queste impostazioni dell'agente dopo l'importazione.
Importazione senza chiave
Scegli Incolla invece il JSON esportato e incolla gli oggetti esportati dall'API o dalla dashboard della tua piattaforma, come singolo oggetto o elenco JSON:
- Vapi — un oggetto assistente (
GET /assistant/{id}), un oggetto Squad (GET /squad/{id}) o un elenco di entrambi. Gli strumenti collegati solo tramite ID e i file Knowledge richiedono una chiave per essere risolti. Vapi ha ritirato i Workflows, quindi converti un Workflow in uno Squad prima di incollarlo. - Retell — l'oggetto agente (
GET /get-agent/{id}?version=...) insieme a al relativo Retell LLM della stessa versione (GET /get-retell-llm/{id}?version=...) oppure a un oggetto flusso di conversazione nello stesso elenco. L'importatore collega per ID e versione, preferisce un agente pubblicato incollato quando è presente lo stato di pubblicazione e importa un LLM o flusso autonomo con un nome generato. - ElevenLabs — l'oggetto agente (
GET /v1/convai/agents/{id}). Le esportazioni correnti di solito fanno riferimento agli strumenti webhook e ai documenti Knowledge solo tramite ID. Un incollaggio segnala questi elementi come non risolti; usa una chiave API per un'importazione completa. - Bland — un agente web, la risposta
/v1/agentso un oggetto percorso. Ogni oggetto incollato viene importato come agente separato, anche quando due condividono un ID; gli ID di strumenti e Knowledge che richiedono l'accesso API vengono elencati per la configurazione manuale invece di essere eliminati.
Qualsiasi elemento referenziato solo tramite ID e non presente nell'incolla viene elencato nelle note.
Dopo l'importazione
- Apri ogni agente e leggi le sue note.
- Fai clic su Testa chiamata nella pagina dell'agente oppure chiedi a Zeus di testarlo.
- Trasferisci i tuoi numeri oppure collegane uno nuovo (vedi Numeri di telefono sopra).
- 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 utilizzavano uno.
L'importatore è disponibile anche tramite l'API REST.
L'importazione non ti vincola. Puoi esportare qualsiasi agente come file aperti, gratuitamente, in qualsiasi momento: consulta Lasciare ThunderPhone.