Open in
Lasciare ThunderPhone
Esporta un agente come file aperti, ricrealo su LiveKit Agents, Pipecat, Vapi o Retell con una competenza da agente di programmazione e scarica la cronologia delle chiamate e le registrazioni.
Puoi lasciare ThunderPhone quando vuoi. Puoi esportare qualsiasi agente gratuitamente come zip di file aperti e una skill aiuta il tuo agente di programmazione a ricrearlo su LiveKit Agents, Pipecat, Vapi o Retell. Questa pagina spiega cosa puoi portare con te, come esportarlo e cosa devi rifare dall'altra parte.
Cosa puoi portare con te
| Cosa | Come |
|---|---|
| Un agente: istruzioni, strumenti, numeri di trasferimento, passaggi, impostazioni, instradamento dei numeri e webhook | L'esportazione dell'agente, uno zip per agente |
| I file Knowledge dell'agente | All'interno dell'esportazione dell'agente |
| Cronologia delle chiamate e trascrizioni | L'esportazione delle chiamate, fino a 1.000 chiamate per richiesta |
| Registrazioni | Una registrazione per richiesta, per chiamata |
| Numeri di telefono sul tuo operatore | Non hanno mai lasciato il tuo operatore. Vedi Numeri di telefono |
Esportare un agente
In Zeus
Apri l'agente e vai alle sue impostazioni (Gestione chiamate nell'editor dell'agente). In fondo, in Esporta, copia o elimina, scegli Esporta. Il file ZIP viene scaricato sul tuo computer.
Con l'API
curl 'https://api.thunderphone.com/v1/agents/12/export' \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-o agent-12.zipIl file ZIP viene creato quando lo richiedi. Chiunque possa leggere l'agente
può esportarlo. Knowledge, numeri e webhook sono inclusi solo quando la
credenziale può leggerli: un token OAuth richiede knowledge:read,
numbers:read e integrations:read, mentre i webhook richiedono anche un
amministratore o un proprietario. Una parte omessa è elencata in omitted in
manifest.json. L'API risponde con 429 oltre 30 esportazioni al minuto.
| Parametro di query | Descrizione |
|---|---|
include_url_paths | true mantiene il percorso di ogni URL nell'esportazione, ad esempio l'endpoint di uno strumento. Per impostazione predefinita, ogni URL viene ridotto al suo host. Nomi utente, password e stringhe di query vengono rimossi dagli URL in entrambi i casi |
Usa include_url_paths=true quando stai per ricreare l'agente altrove,
perché lì sono necessari gli endpoint degli strumenti. Lascialo disattivato
per una copia che intendi condividere.
Contenuto del file ZIP
| File | Contenuto |
|---|---|
manifest.json | Il formato (thunderphone.agent-export/v1), ciò che è incluso e un elenco omitted che indica tutto ciò che è stato omesso e il motivo |
agent.json | L'agente come restituito da GET /v1/agents/{agent_id}, senza credenziali |
prompt.md | Le istruzioni attive |
knowledge/index.json e i file accanto | La Knowledge dell'agente. Ogni documento è il file originale quando disponibile, altrimenti il relativo testo estratto |
numbers.json | I numeri instradati a questo agente, in entrata e in uscita, con eventuale versione o variante fissata |
webhooks.json | Gli endpoint webhook associati a questo agente, senza i relativi segreti |
README.md | Il contenuto di ogni file |
Un file Knowledge più grande di 25 MB viene omesso, così come tutto ciò che
supera 100 MB per l'intera esportazione. Ognuno è elencato in manifest.json
con l'endpoint che lo scarica,
GET /v1/knowledge/documents/{document_id}/original.
Cosa non viene mai incluso
- Valori delle credenziali. Le intestazioni di uno strumento sono elencate solo per nome. I valori delle intestazioni sono di sola scrittura in ThunderPhone: nessuna risposta API li restituisce, quindi nessuna esportazione può farlo. Li inserisci nuovamente dall'altra parte. Questo riguarda le credenziali che ThunderPhone archivia come credenziali. Le tue istruzioni e i file Knowledge vengono copiati esattamente come li hai scritto o caricati, quindi se una chiave è stata incollata in un prompt o in un documento, sarà nel file ZIP. Controlla prima di condividerlo.
- Cronologia delle chiamate e registrazioni. Hanno esportazioni dedicate; consulta Cronologia delle chiamate e registrazioni.
- Cronologia delle versioni. L'esportazione contiene l'agente così com'è
attualmente attivo. Le versioni precedenti restano elencate in
GET /v1/agents/{agent_id}/versions. - Altri agenti a cui questo passa le chiamate. Esporta ciascuno nello stesso modo.
Passa a un'altra piattaforma
La skill migrate-off-thunderphone guida il tuo agente di programmazione
nella migrazione. Installa le skill di ThunderPhone:
npx skills add thunderphone/skillsPoi chiedi al tuo agente di programmazione di spostare un agente da ThunderPhone e indica la destinazione: LiveKit Agents, Pipecat, Vapi o Retell. La skill scarica l'esportazione, ti chiede ogni credenziale, ricostruisce l'agente da una mappatura per quella destinazione e lo testa lì prima di spostare qualsiasi numero. La conversione viene eseguita nel tuo agente di programmazione, con le tue chiavi. ThunderPhone non scrive mai sul tuo account in un'altra piattaforma.
Cosa viene trasferito, come file che la skill mappa per te:
- Istruzioni, incluse le istruzioni e i passaggi condivisi.
- Strumenti: lo stesso endpoint, metodo e schema dei parametri. Il
request_formatdi ogni strumento registra la struttura del corpo prevista dal tuo endpoint. - Numeri di trasferimento e impostazioni per terminare la chiamata e il tastierino.
- File Knowledge.
- Impostazioni di segreteria telefonica, silenzio e durata della chiamata.
- I numeri a cui l'agente risponde e da cui effettua chiamate.
Cosa devi rifare dall'altra parte:
- Provider di sintesi vocale, modello linguistico e voce. Li scegli nella destinazione. Nulla garantisce che una voce, o il suono di una chiamata, corrisponderà.
- Credenziali. Valori delle intestazioni degli strumenti e segreti webhook.
- Telefonia. Il modo in cui i numeri raggiungono l'agente è configurato in modo diverso su ogni piattaforma.
- Passaggi e passaggi di consegna. Una destinazione con una funzionalità di flusso o passaggio di consegna li ricostruisce lì. Altrove la skill integra i passaggi nelle istruzioni e te lo comunica.
- Impostazioni ThunderPhone senza equivalente. Intelligence, impostazioni di ascolto e velocità di risposta, strumenti integrati per email e messaggi di testo, e valutazione delle chiamate, riepiloghi ed etichette dell'esito non vengono trasferiti a meno che tu non li ricostruisca.
- Firme delle richieste. ThunderPhone firma le richieste degli strumenti e i webhook che invia. Un'altra piattaforma firma a modo suo, quindi un endpoint che verifica la firma ThunderPhone necessita di un nuovo controllo.
- Test. Testa l'agente ricostruito nella destinazione prima di spostare un numero.
Lascia l'agente ThunderPhone attivo finché quello nuovo non ha superato i tuoi test. È la tua via per tornare indietro.
Numeri di telefono
Sposta i numeri per ultimi, dopo che il nuovo agente ha superato i test.
- Un numero presso il tuo operatore (una connessione VoIP)
resta presso quell'operatore. Indirizzalo alla nuova piattaforma nella console del tuo operatore.
Poi seleziona Rilascia sul numero in ThunderPhone e lascia
Annulla anche questo numero nel mio account … deselezionato: il numero viene
disconnesso da ThunderPhone e resta nel tuo account presso l'operatore. Tramite
l'API, rilascialo
con
DELETE /v1/phone-numbers/{phone_number_id}?confirm=truee non inviarerelease_at_provider. - Un numero fornito da ThunderPhone. Contatta l'assistenza prima di rilasciare un numero che vuoi mantenere. Il rilascio di un numero ThunderPhone è permanente: torna al pool e può essere assegnato a un altro cliente.
Cronologia delle chiamate e registrazioni
Questi elementi sono separati dall'esportazione dell'agente.
- Chiamate.
GET /v1/calls/exportrestituisce fino a 1.000 chiamate per richiesta come CSV (metadati) o JSON (con trascrizioni). Filtra peragent_ide scorri la cronologia constart_dateeend_date. L'intestazione di rispostaX-Truncatedètruequando corrispondono più chiamate di quelle restituite. - Registrazioni.
GET /v1/calls/{call_id}/audiorestituisce un URL di breve durata per la registrazione di una chiamata. Non è disponibile alcun download in blocco delle registrazioni.
curl 'https://api.thunderphone.com/v1/calls/export?export_format=json&agent_id=12&start_date=2026-10-01T00:00:00Z&end_date=2026-11-01T00:00:00Z' \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-o calls-2026-10.jsonCosti
Nulla. L'esportazione degli agenti, l'esportazione delle chiamate e il download delle registrazioni sono gratuiti. ThunderPhone è a consumo, senza abbonamento né costo per postazione. Un numero ThunderPhone smette di essere fatturato quando lo rilasci.
Dopo l'uscita
Non esiste una durata fissa. Puoi risolvere il contratto tramite comunicazione scritta a legal@thunderphone.com, inviata dall'email amministrativa dell'account o tramite un altro canale verificabile. Un mancato pagamento può sospendere il servizio; da solo non risolve mai il contratto né comporta l'eliminazione dei Dati del Cliente. Per quanto riguarda i dati, i Termini stabiliscono: "Dopo la risoluzione formale, il Fornitore restituirà o eliminerà i Dati del Cliente entro sessanta (60) giorni, fatti salvi i diritti di esportazione del Cliente, i cicli di backup, gli obblighi di conservazione legale, la conservazione richiesta dalla legge, il DPA e qualsiasi BAA sottoscritto."
Il testo completo è disponibile nei Termini di servizio, nella sezione Durata del servizio; sospensione; risoluzione. I Termini prevalgono; questa è una sintesi.