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 (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 unico prompt coerente nello stile della guida ai prompt, con ogni numero di telefono, URL, nome dello strumento e segnaposto della fonte preservati.
- Strutturato — la configurazione di origine organizzata sotto intestazioni, esattamente come estratta. Viene usata automaticamente quando la riscrittura non può essere verificata o quando risulta molto più breve della fonte.
Un agente importato da un flusso mostra le Istruzioni condivise al posto del prompt, seguite dai relativi passaggi: il nome di ogni passaggio, ciò che indica all'agente di fare e dove prosegue. Mostra come un unico prompt mostra lo stesso agente come un solo prompt, che è quello che esegue ovunque i passaggi non siano disponibili. Gli agenti con trasferimenti elencano gli agenti a cui trasferiscono il chiamante; se ne deselezioni uno, la revisione indica che quel trasferimento non verrà configurato.
Tutti gli agenti iniziano selezionati, tranne quelli vuoti e gli agenti iniziali predefiniti creati dalla piattaforma per te. Deseleziona gli agenti che non desideri, modifica nomi, voci, livelli o la scelta del prompt, quindi Importa. Gli agenti creati si aprono nel builder con le connessioni API e Knowledge collegati.
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 di apertura nel prompt; chi parla per primo |
voice.provider + voiceId | Voce di catalogo più vicina, con ricerca nella libreria Vapi effettuata al meglio delle possibilità (viene mostrata l'affidabilità della corrispondenza) |
transcriber.language, languages, parole chiave/termini chiave | Lingue e vocabolario per il riconoscimento vocale |
model.model | Livello di intelligenza |
model.tools, toolIds, toolRefs (function, apiRequest) | Connessioni API; vengono mantenuti gli envelope 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 revisione |
Strumenti handoff | Passaggi agli assistenti nominati importati nella stessa esecuzione |
endCall, dtmf | Funzionalità integrate |
Google Calendar, Google Sheets, Slack, sms | Segnalati con l'integrazione ThunderPhone o la configurazione SMS necessaria |
Strumenti query e knowledgeBase, oltre al precedente knowledgeBaseId | Base Knowledge con file caricati accessibili come documenti |
endCallMessage, endCallPhrases, voicemailMessage, piani di messaggi di inattività e hook di timeout | Sezioni del prompt; impostazioni della segreteria telefonica e del silenzio |
maxDurationSeconds, esclusioni dalla registrazione | Durata massima della chiamata (viene mantenuto il valore predefinito Vapi di 600 secondi); un'esclusione dalla registrazione viene segnalata nella pagina di revisione |
| Squadre | Un agente per membro, con prompt, override, voce, strumenti e Knowledge propri. Le assistantDestinations diventano passaggi tra di 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 revisione o ricostruzione; i piani e le credenziali non elaborati 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 + 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 iniziale; un passaggio per stato, con i relativi strumenti e transizioni e i valori raccolti da ogni 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 iniziale e passaggi di trasferimento esatti |
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 le modifiche alla firma e qualsiasi impostazione non predefinita per parlato, tentativi, variabili di risposta o codifica dei moduli |
transfer_call, end_call, press_digit | Trasferimenti condizionali, incluse le estensioni, e funzioni integrate; vengono segnalate le differenze tra trasferimenti dedotti e assistiti |
check_availability_cal, book_appointment_cal | Segnalati come strumenti Cal.com da riconnettere in Integrazioni; le credenziali Retell non vengono mai trasferite |
send_sms, MCP | Segnalati con istruzioni per configurare SMS o MCP |
voice_id (11labs-, openai-, cartesia-, …) | Voce di catalogo più simile |
language (un'impostazione locale, modalità multilingue o un elenco di impostazioni locali) | Lingue principali e aggiuntive |
model / s2s_model | Livello di intelligenza |
knowledge_base_ids (URL, documenti, fonti di testo) | Knowledge 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 delle chiamate; impostazione di registrazione; termini del prompt |
webhook_url, motori LLM personalizzati, nodi di flusso non supportati e impostazioni solo 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 del flusso di lavoro dell'agente e condizioni dei rami ordinate | Istruzioni condivise e un passaggio per ogni nodo del flusso di lavoro; i nodi degli strumenti eseguono il proprio strumento all'avvio del passaggio; i rami delle espressioni vengono contrassegnati per la revisione |
first_message, language, language_presets | Messaggio iniziale; lingue principali e aggiuntive; messaggi iniziali tradotti |
prompt.llm | Livello di intelligenza |
tts.voice_id | Voce di catalogo più simile |
webhook tool_ids, inclusi gli strumenti associati ai passaggi del flusso di lavoro | Connessioni API con parametri del corpo/della 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 flusso di lavoro dell'agente) | Passaggi agli agenti ElevenLabs importati nella stessa esecuzione |
Voci URL/testo/file/cartella di knowledge_base, inclusa la Knowledge dei passaggi del flusso di lavoro | Documenti Knowledge; 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 dell'area di lavoro, sostituzioni 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 del chiamante per primo; registrazione; durata massima; strumenti e Knowledge predefiniti. È incluso un solo percorso collegato; l'instradamento su 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 nuovamente |
| Strumenti Cal.com, Slack, HubSpot, Salesforce, Google Calendar e Google Sheets | Viene indicata l'integrazione ThunderPhone corrispondente da collegare e abilitare |
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 contrassegnata |
| Prompt globale; nodi Predefinito, Knowledge Base, Trasferisci chiamata, Termina chiamata, Webhook e Attendi risposta; archi, condizioni di ciclo, nodi globali, variabili estratte, testo statico | 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 intervento, impostazione di registrazione |
webhook, ricerche di dati dinamici, instradamento della persona su più percorsi, impostazioni dei nodi non supportate, agenti v2 | Segnalati con il follow-up manuale necessario |
| Numeri in entrata | Elencati con entrambe le possibilità, poiché Bland non specifica se appartengono a Bland o al 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 fare con esso:
- Nel tuo account Twilio o Telnyx (ad esempio un numero Twilio che hai collegato a Vapi o ElevenLabs): un amministratore può trasferirlo a un agente importato. Se nessuna connessione VoIP utilizza ancora quell'account, collegala prima. Prima di apportare modifiche, un passaggio di conferma indica che le chiamate al numero smetteranno di essere instradate alla vecchia piattaforma. ThunderPhone quindi configura il numero perché punti a sé stesso nel tuo account del gestore (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 in Numeri di telefono, mantenendolo nel tuo account del gestore, quindi reimportalo nella vecchia piattaforma.
- Sul tuo trunk SIP: collega il trunk come connessione SIP e importa il numero in Numeri di telefono.
- Venduto dalla piattaforma (numeri Vapi, Retell e Bland acquistati lì): ThunderPhone non può trasferirlo. Trasferiscilo a un gestore e importalo, oppure ottieni un numero ThunderPhone e assegnalo 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. Vengono copiate le intestazioni degli strumenti che erano visibili. Le credenziali che la vecchia piattaforma archiviava per 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 invece indicati con l'integrazione ThunderPhone da collegare; le relative credenziali non vengono trasferite. La revisione segnala inoltre un prompt che continua a indicare all'agente di usare uno strumento non importato.
- Messaggi di testo. Gli agenti ThunderPhone inviano messaggi tramite la tua connessione al gestore; configura gli SMS nelle impostazioni dell'agente.
- Strumenti senza un equivalente (automazioni specifiche della piattaforma) vengono 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 limite massimo, e la revisione lo indica. I limiti di silenzio e di durata massima al di fuori degli intervalli di ThunderPhone vengono adeguati 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, laddove non sia ancora possibile disattivare la registrazione, con la registrazione attivata.
Cosa cambia durante l'importazione
Alcune impostazioni che la tua piattaforma precedente lasciava ai propri valori predefiniti usano invece il valore predefinito di ThunderPhone. La revisione le elenca in una nota per agente, in Mostra dettagli, solo dove le due piattaforme differiscono. I valori di ThunderPhone riportati di seguito sono quelli predefiniti, che puoi modificare per ogni 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 JSON esportato e incolla gli oggetti esportati dall'API o dalla dashboard della tua piattaforma, come un oggetto o un 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 relative note.
- Effettua una chiamata di prova dal builder.
- 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.