ThunderPhone v3 è online.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 agenti, oppure chiedi a Zeus di trasferire i tuoi agenti.
  2. Seleziona la piattaforma.
  3. 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.
  4. 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

  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 iniziale nel prompt; chi parla per primo
voice.provider + voiceIdVoce di catalogo più vicina, con ricerca nella libreria Vapi al meglio delle possibilità (viene mostrata l'affidabilità della corrispondenza)
transcriber.language, languages, keywords/keytermsLingue e vocabolario per il riconoscimento vocale
model.modelNon 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 transferCallTrasferimenti telefonici nel prompt; le destinazioni SIP, assistente e dinamiche vengono segnalate per la verifica
Strumenti handoffPassaggi agli assistenti denominati importati nella stessa esecuzione
endCall, dtmfFunzionalità integrate
Google Calendar, Google Sheets, smsSegnalati con l'integrazione ThunderPhone o la configurazione SMS necessaria
SlackSegnalato come non importato: ThunderPhone non può ancora connettersi a Slack
Strumenti query e knowledgeBase, oltre al legacy knowledgeBaseIdBase Knowledge con file caricati accessibili come documenti
endCallMessage, endCallPhrases, voicemailMessage, piani per messaggi di inattività e hook di timeoutSezioni del prompt; impostazioni della segreteria telefonica e del silenzio
maxDurationSeconds, esclusioni della registrazioneDurata massima della chiamata (viene mantenuto il valore predefinito Vapi di 600 secondi); un'esclusione della registrazione viene segnalata nella pagina di verifica
SquadreUn 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 supportatiSegnalati con un'azione specifica di verifica o ricreazione; piani e credenziali grezzi 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 + relativa 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 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 collegamentiIstruzioni 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_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 una modifica della firma e qualsiasi impostazione non predefinita di parlato, tentativi, variabili di risposta o codifica modulo
transfer_call, end_call, press_digitTrasferimenti condizionali, incluse le estensioni, + funzioni integrate; vengono segnalate le differenze tra trasferimenti dedotti e con operatore
check_availability_cal, book_appointment_calSegnalati come strumenti Cal.com da riconnettere in Integrations; le credenziali Retell non vengono mai trasferite
send_sms, MCPSegnalati 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_modelNon 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 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 di chiamata; impostazione di registrazione; termini del prompt
webhook_url, motori LLM personalizzati, nodi di flusso non supportati e impostazioni specifiche 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 Agent Workflow e condizioni di diramazione ordinateIstruzioni 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_presetsFrase di apertura; lingue principali e aggiuntive; frasi di apertura tradotte
prompt.llmNon mappato: gli agenti importati iniziano con intelligenza Pro e ascolto Standard
tts.voice_idVoce del catalogo più simile
tool_ids webhook, inclusi gli strumenti collegati ai passaggi del workflowConnessioni 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 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 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 workflowDocumenti 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_voiceLimiti 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 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 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 SheetsViene indicata l'integrazione ThunderPhone corrispondente da connettere e abilitare
Strumenti SlackSegnalati 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 numeroVersione 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 fissoIstruzioni 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 parola, impostazione di registrazione
webhook, ricerche di dati dinamici, routing della persona con più percorsi, impostazioni di nodo non supportate, agenti v2Segnalati con l'azione manuale necessaria
Numeri in entrataElencati 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:

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 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/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 sue note.
  2. Fai clic su Testa chiamata nella pagina dell'agente oppure chiedi a Zeus di testarlo.
  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.

L'importazione non ti vincola. Puoi esportare qualsiasi agente come file aperti, gratuitamente, in qualsiasi momento: consulta Lasciare ThunderPhone.