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

Using the dashboard

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

CosaCome
Un agente: istruzioni, strumenti, numeri di trasferimento, passaggi, impostazioni, instradamento dei numeri e webhookL'esportazione dell'agente, uno zip per agente
I file Knowledge dell'agenteAll'interno dell'esportazione dell'agente
Cronologia delle chiamate e trascrizioniL'esportazione delle chiamate, fino a 1.000 chiamate per richiesta
RegistrazioniUna registrazione per richiesta, per chiamata
Numeri di telefono sul tuo operatoreNon 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
curl 'https://api.thunderphone.com/v1/agents/12/export' \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -o agent-12.zip

Il 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 queryDescrizione
include_url_pathstrue 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

FileContenuto
manifest.jsonIl formato (thunderphone.agent-export/v1), ciò che è incluso e un elenco omitted che indica tutto ciò che è stato omesso e il motivo
agent.jsonL'agente come restituito da GET /v1/agents/{agent_id}, senza credenziali
prompt.mdLe istruzioni attive
knowledge/index.json e i file accantoLa Knowledge dell'agente. Ogni documento è il file originale quando disponibile, altrimenti il relativo testo estratto
numbers.jsonI numeri instradati a questo agente, in entrata e in uscita, con eventuale versione o variante fissata
webhooks.jsonGli endpoint webhook associati a questo agente, senza i relativi segreti
README.mdIl 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/skills

Poi 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_format di 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=true e non inviare release_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/export restituisce fino a 1.000 chiamate per richiesta come CSV (metadati) o JSON (con trascrizioni). Filtra per agent_id e scorri la cronologia con start_date e end_date. L'intestazione di risposta X-Truncated è true quando corrispondono più chiamate di quelle restituite.
  • Registrazioni. GET /v1/calls/{call_id}/audio restituisce un URL di breve durata per la registrazione di una chiamata. Non è disponibile alcun download in blocco delle registrazioni.
cURL
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.json

Costi

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.

Correlati