---
title: "Lasciare ThunderPhone"
description: "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."
ui: zeus
---

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](#export-an-agent), uno zip per agente |
| I file Knowledge dell'agente | All'interno dell'esportazione dell'agente |
| Cronologia delle chiamate e trascrizioni | L'[esportazione delle chiamate](#call-history-and-recordings), 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](#phone-numbers) |

## 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

<CodeGroup>
```bash cURL
curl 'https://api.thunderphone.com/v1/agents/12/export' \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -o agent-12.zip
```
</CodeGroup>

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 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}`](/api-reference/agents#agent-object), 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](/it/webhooks/endpoints) 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`](/api-reference/knowledge-bases#download-the-original-file).

### 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](#call-history-and-recordings).
- **Cronologia delle versioni.** L'esportazione contiene l'agente così com'è
  attualmente attivo. Le versioni precedenti restano elencate in
  [`GET /v1/agents/{agent_id}/versions`](/api-reference/agents#version-history).
- **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](/it/guides/coding-agents):

```bash
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](/it/guides/verify-webhook-signatures)
  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](/it/guides/bring-your-own-numbers))
  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](/api-reference/phone-numbers#release-a-phone-number)
  con `DELETE /v1/phone-numbers/{phone_number_id}?confirm=true` e non
  inviare `release_at_provider`.
- **Un numero fornito da ThunderPhone.** Contatta
  [l'assistenza](mailto:support@thunderphone.com) 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`](/api-reference/calls#export-calls)
  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`](/api-reference/calls#get-recording-audio)
  restituisce un URL di breve durata per la registrazione di una chiamata. Non è disponibile
  alcun download in blocco delle registrazioni.

<CodeGroup>
```bash 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
```
</CodeGroup>

## Costi

Nulla. L'esportazione degli agenti, l'esportazione delle chiamate e il download delle registrazioni sono
gratuiti. ThunderPhone è [a consumo](/it/guides/pricing), 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](https://thunderphone.com/terms#term-termination), nella sezione
**Durata del servizio; sospensione; risoluzione**. I Termini prevalgono; questa è una sintesi.

## Correlati

- [Importa agenti da un'altra piattaforma](/it/guides/import-agents)
- [Skill per agenti di programmazione](/it/guides/coding-agents)
- [API degli agenti](/api-reference/agents)
- [API delle chiamate](/api-reference/calls)
