ThunderPhone 2.0 è arrivato.Attivazione self-service, da 2¢/min.Leggi l’annuncio

Using the dashboard

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

  1. Apri Agenti e scegli Importa (oppure Importa da Vapi, Retell, ElevenLabs o Bland in una pagina Agenti vuota).
  2. Seleziona la piattaforma.
  3. 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.
  4. 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

  1. Apri dashboard.vapi.ai/org/api-keys (Impostazioni dell'organizzazione → Chiavi API).
  2. Crea una chiave e scegli Privata: le chiavi pubbliche non possono elencare gli assistenti.
  3. 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 VapiThunderPhone
model.messages[system]Prompt
firstMessage, firstMessageModeFrase di apertura nel prompt; chi parla per primo
voice.provider + voiceIdVoce 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 chiaveLingue e vocabolario per il riconoscimento vocale
model.modelLivello 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 transferCallTrasferimenti telefonici nel prompt; le destinazioni SIP, assistente e dinamiche vengono segnalate per la revisione
Strumenti handoffPassaggi agli assistenti nominati importati nella stessa esecuzione
endCall, dtmfFunzionalità integrate
Google Calendar, Google Sheets, Slack, smsSegnalati con l'integrazione ThunderPhone o la configurazione SMS necessaria
Strumenti query e knowledgeBase, oltre al precedente knowledgeBaseIdBase Knowledge con file caricati accessibili come documenti
endCallMessage, endCallPhrases, voicemailMessage, piani di messaggi di inattività e hook di timeoutSezioni del prompt; impostazioni della segreteria telefonica e del silenzio
maxDurationSeconds, esclusioni dalla registrazioneDurata massima della chiamata (viene mantenuto il valore predefinito Vapi di 600 secondi); un'esclusione dalla registrazione viene segnalata nella pagina di revisione
SquadreUn 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 supportatiSegnalati con un'azione specifica di revisione o ricostruzione; i piani e le credenziali non elaborati non vengono archiviati

Ottenere una chiave

  1. Apri dashboard.retellai.com/apiKeys (Impostazioni di sistema → Chiavi API) e scegli Crea chiave.
  2. 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.
  3. Copia la chiave nella finestra di dialogo.
Campo RetellThunderPhone
Agente pubblicato più recente + versione esatta di Retell LLM / flussoPrompt e comportamento pubblicati; le bozze più recenti vengono segnalate per la revisione
Retell LLM general_prompt, begin_message, start_speaker, statiIstruzioni 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 collegamentiIstruzioni e passaggi condivisi; le condizioni delle equazioni sui valori raccolti vengono verificate esattamente; testo iniziale e passaggi di trasferimento esatti
Strumenti e nodi agent_swapPassaggi agli agenti Retell importati nella stessa esecuzione
Strumenti personalizzatiConnessioni 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_digitTrasferimenti condizionali, incluse le estensioni, e funzioni integrate; vengono segnalate le differenze tra trasferimenti dedotti e assistiti
check_availability_cal, book_appointment_calSegnalati come strumenti Cal.com da riconnettere in Integrazioni; le credenziali Retell non vengono mai trasferite
send_sms, MCPSegnalati 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_modelLivello di intelligenza
knowledge_base_ids (URL, documenti, fonti di testo)Knowledge con documenti
default_dynamic_variables, variabili di sistema supportateValori 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_keywordsComportamento 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 fornitoreSegnalati per la revisione manuale, non eliminati silenziosamente

Ottenere una chiave

  1. Apri elevenlabs.io/app/settings/api-keys e scegli Crea chiave API.
  2. Nelle autorizzazioni, assegna Piattaforma Agents: Lettura (e Base di Knowledge: Lettura se visualizzato); l'importatore non richiede altro.
  3. Copia la chiave nella finestra di dialogo.
Campo ElevenLabsThunderPhone
conversation_config.agent.prompt.prompt, nodi del flusso di lavoro dell'agente e condizioni dei rami ordinateIstruzioni 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_presetsMessaggio iniziale; lingue principali e aggiuntive; messaggi iniziali tradotti
prompt.llmLivello di intelligenza
tts.voice_idVoce di catalogo più simile
webhook tool_ids, inclusi gli strumenti associati ai passaggi del flusso di lavoroConnessioni 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 telefonicaFunzioni 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 lavoroDocumenti 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_voiceLimiti 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 ElevenLabsSegnalati con l'azione necessaria dopo l'importazione

Ottenere una chiave

  1. Apri app.bland.ai/dashboard/settings.
  2. Copia la chiave API mostrata qui (Bland ha una chiave per account; non ha ambiti, quindi ruotala in seguito se preferisci).
  3. 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 BlandThunderPhone
Agente web prompt, first_sentence, language, model, voice, pathway_idPrompt; frase di apertura; lingua; livello; voce più simile; flusso del percorso pubblicato collegato
Versione di produzione della personaPrompt 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 SheetsViene 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 numeroVersione 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 staticoIstruzioni 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 risolvibiliDocumenti 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 registrazioneLimite 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 v2Segnalati con il follow-up manuale necessario
Numeri in entrataElencati 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:

ImpostazionePredefinito della vecchia piattaformaPredefinito di ThunderPhone
Tempo di squillo nelle chiamate in uscitaRetell: 30 secondi60 secondi
Termine di una chiamata silenziosaRetell: riaggancia dopo 10 minuti; ElevenLabs: maiVerifica 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 chiamateNumeri in entrata e personaggi Bland: disattivataAttivata. Contatta l'assistenza oppure modificala nelle impostazioni dell'agente, dove disponibile
Alla segreteria telefonicaPersonaggi Bland: riagganciaL'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/agents o 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

  1. Apri ogni agente e leggi le relative note.
  2. Effettua una chiamata di prova dal builder.
  3. Trasferisci i tuoi numeri oppure collegane uno nuovo (vedi Numeri di telefono sopra).
  4. Testa ogni connessione API con il tester delle richieste.
  5. Verifica che i documenti Knowledge abbiano completato l'indicizzazione.
  6. Configura un webhook dell'organizzazione se i vecchi agenti ne utilizzavano uno.

L'importatore è disponibile anche tramite l'API REST.