---
title: "Quitter ThunderPhone"
description: "Exportez un agent sous forme de fichiers ouverts, recréez-le sur LiveKit Agents, Pipecat, Vapi ou Retell avec une compétence d’agent de codage, puis téléchargez votre historique d’appels et vos enregistrements."
ui: zeus
---

Vous pouvez quitter ThunderPhone à tout moment. Chaque agent peut être exporté gratuitement sous forme de zip de fichiers ouverts, et une skill aide votre agent de codage à le reconstruire sur LiveKit Agents, Pipecat, Vapi ou Retell. Cette page explique ce que vous pouvez emporter, comment l’exporter et ce que vous devrez refaire de l’autre côté.

## Ce que vous pouvez emporter

| Éléments | Méthode |
|---|---|
| Un agent : instructions, outils, numéros de transfert, étapes, paramètres, routage des numéros et webhooks | L’[export de l’agent](#export-an-agent), un zip par agent |
| Les fichiers de connaissances de l’agent | Dans l’export de l’agent |
| L’historique des appels et les transcriptions | L’[export des appels](#call-history-and-recordings), jusqu’à 1 000 appels par requête |
| Les enregistrements | Un enregistrement par requête, par appel |
| Les numéros de téléphone chez votre propre opérateur | Ils n’ont jamais quitté votre opérateur. Consultez [Numéros de téléphone](#phone-numbers) |

## Exporter un agent

### Dans Zeus

Ouvrez l’agent et accédez à ses paramètres (**Gestion des appels** dans
l’éditeur de l’agent). En bas, sous **Exporter, copier ou supprimer**, choisissez **Exporter**.
Le fichier ZIP est téléchargé sur votre ordinateur.

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

Le fichier ZIP est créé lorsque vous le demandez. Toute personne pouvant lire l’agent peut
l’exporter. Les connaissances, les numéros et les webhooks sont inclus uniquement lorsque
l’identifiant peut les lire : un jeton OAuth nécessite `knowledge:read`,
`numbers:read` et `integrations:read`, et les webhooks nécessitent également un rôle d’administrateur ou
de propriétaire. Tout élément exclu est répertorié sous `omitted` dans `manifest.json`.
L’API renvoie `429` au-delà de 30 exports par minute.

| Paramètre de requête | Description |
|---|---|
| `include_url_paths` | `true` conserve le chemin de chaque URL dans l’export, comme le point de terminaison d’un outil. Par défaut, chaque URL est réduite à son hôte. Les noms d’utilisateur, mots de passe et chaînes de requête sont supprimés des URL dans les deux cas |

Utilisez `include_url_paths=true` lorsque vous allez reconstruire l’agent
ailleurs, car les points de terminaison des outils y sont nécessaires. Ne l’activez pas pour
une copie que vous prévoyez de partager.

### Contenu du fichier ZIP

| Fichier | Contenu |
|---|---|
| `manifest.json` | Le format (`thunderphone.agent-export/v1`), les éléments inclus et une liste `omitted` indiquant tout élément exclu et la raison |
| `agent.json` | L’agent tel que le renvoie [`GET /v1/agents/{agent_id}`](/api-reference/agents#agent-object), sans les identifiants |
| `prompt.md` | Les instructions actives |
| `knowledge/index.json` et les fichiers à côté | Les connaissances de l’agent. Chaque document correspond au fichier d’origine lorsqu’il est stocké, sinon à son texte extrait |
| `numbers.json` | Les numéros acheminés vers cet agent, entrants et sortants, avec toute version ou variante épinglée |
| `webhooks.json` | Les [points de terminaison de webhook](/fr/webhooks/endpoints) associés à cet agent, sans leurs secrets |
| `README.md` | Le rôle de chaque fichier |

Un fichier de connaissances de plus de 25 Mo est exclu, tout comme tout ce qui dépasse
100 Mo pour l’export complet. Chacun est répertorié dans `manifest.json` avec le
point de terminaison permettant de le télécharger,
[`GET /v1/knowledge/documents/{document_id}/original`](/api-reference/knowledge-bases#download-the-original-file).

### Éléments jamais inclus

- **Valeurs des identifiants.** Les en-têtes d’un outil sont répertoriés uniquement par leur nom. Les
  valeurs d’en-tête sont en écriture seule dans ThunderPhone : aucune réponse de l’API ne les renvoie, donc aucun
  export ne le peut. Vous les saisissez à nouveau de l’autre côté. Cela couvre les identifiants
  que ThunderPhone stocke comme identifiants. Vos instructions et fichiers de connaissances sont
  copiés exactement tels que vous les avez rédigés ou importés ; si une clé a déjà été collée
  dans un prompt ou un document, elle se trouve dans le fichier ZIP. Vérifiez avant de le partager.
- **Historique des appels et enregistrements.** Ils disposent de leurs propres exports ; consultez
  [Historique des appels et enregistrements](#call-history-and-recordings).
- **Historique des versions.** L’export contient l’agent tel qu’il est actuellement actif. Les versions
  antérieures restent répertoriées dans
  [`GET /v1/agents/{agent_id}/versions`](/api-reference/agents#version-history).
- **Autres agents auxquels celui-ci transfère les appels.** Exportez chacun d’eux de la même manière.

## Passer à une autre plateforme

La skill `migrate-off-thunderphone` guide votre agent de code tout au long de
la migration. Installez les [skills ThunderPhone](/fr/guides/coding-agents) :

```bash
npx skills add thunderphone/skills
```

Demandez ensuite à votre agent de code de migrer un agent depuis ThunderPhone et indiquez
la destination : **LiveKit Agents**, **Pipecat**, **Vapi** ou **Retell**. La
skill télécharge l’export, vous demande chaque identifiant, reconstruit l’agent
à partir d’un mappage pour cette destination et le teste sur celle-ci avant tout
transfert de numéro. La conversion s’exécute dans votre agent de code, avec vos
propres clés. ThunderPhone n’écrit jamais dans votre compte sur une autre
plateforme.

Ce qui est transféré, sous forme de fichiers que la skill mappe pour vous :

- Les instructions, y compris les instructions partagées et les étapes.
- Les outils : le même endpoint, la même méthode et le même schéma de paramètres. Le
  `request_format` de chaque outil enregistre la structure du corps attendue par votre endpoint.
- Les numéros de transfert ainsi que les paramètres de fin d’appel et de pavé numérique.
- Les fichiers de connaissances.
- Les paramètres de messagerie vocale, de silence et de durée d’appel.
- Les numéros auxquels l’agent répond et depuis lesquels il émet des appels.

Ce que vous devez refaire de l’autre côté :

- **Fournisseurs de services vocaux, de modèles de langage et de voix.** Vous les choisissez sur la
  destination. Rien ne garantit qu’une voix, ou le son d’un appel, sera
  identique.
- **Identifiants.** Les valeurs d’en-tête des outils et les secrets de webhook.
- **Téléphonie.** La façon dont les numéros atteignent l’agent est configurée différemment sur chaque
  plateforme.
- **Étapes et transferts.** Une destination proposant une fonctionnalité de flux ou de transfert les
  reconstruit sur place. Ailleurs, la skill intègre les étapes dans les
  instructions et vous l’indique.
- **Paramètres ThunderPhone sans équivalent.** L’intelligence, les paramètres d’écoute et de
  vitesse de réponse, les outils intégrés d’e-mail et de SMS, ainsi que
  l’évaluation des appels, les résumés et les libellés de résultat ne sont pas
  transférés, sauf si vous les reconstruisez.
- **Signatures de requête.** ThunderPhone signe les requêtes d’outil et les webhooks
  qu’il envoie. Une autre plateforme signe à sa manière ; un endpoint qui
  [vérifie la signature ThunderPhone](/fr/guides/verify-webhook-signatures)
  nécessite donc une nouvelle vérification.
- **Tests.** Testez l’agent reconstruit sur la destination avant de transférer un
  numéro.

Laissez l’agent ThunderPhone en place jusqu’à ce que le nouveau ait réussi vos
tests. C’est votre solution de repli.

## Numéros de téléphone

Transférez les numéros en dernier, une fois que le nouvel agent a réussi ses tests.

- **Un numéro auprès de votre propre opérateur** (une [connexion VoIP](/fr/guides/bring-your-own-numbers))
  reste auprès de cet opérateur. Dirigez-le vers la nouvelle plateforme dans la
  console de votre opérateur. Choisissez ensuite **Libérer** sur le numéro dans
  ThunderPhone et laissez **Annuler également ce numéro dans mon compte …** décoché : le numéro est
  déconnecté de ThunderPhone et reste dans votre compte opérateur. Via
  l’API, [libérez](/api-reference/phone-numbers#release-a-phone-number)-le
  avec `DELETE /v1/phone-numbers/{phone_number_id}?confirm=true` et n’envoyez pas
  `release_at_provider`.
- **Un numéro fourni par ThunderPhone.** Contactez
  le [support](mailto:support@thunderphone.com) avant de libérer un numéro que vous
  souhaitez conserver. La libération d’un numéro ThunderPhone est définitive : il retourne
  dans le pool et peut être attribué à un autre client.

## Historique des appels et enregistrements

Ils sont distincts de l’export de l’agent.

- **Appels.** [`GET /v1/calls/export`](/api-reference/calls#export-calls)
  renvoie jusqu’à 1 000 appels par requête au format CSV (métadonnées) ou JSON (avec
  transcriptions). Filtrez par `agent_id` et parcourez votre historique avec
  `start_date` et `end_date`. L’en-tête de réponse `X-Truncated` vaut `true`
  lorsque davantage d’appels correspondent que ceux renvoyés.
- **Enregistrements.** [`GET /v1/calls/{call_id}/audio`](/api-reference/calls#get-recording-audio)
  renvoie une URL à durée de vie limitée pour l’enregistrement d’un appel. Aucun téléchargement
  groupé des enregistrements n’est disponible.

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

## Ce que cela coûte

Rien. L’export des agents, l’export des appels et les téléchargements d’enregistrements sont
gratuits. ThunderPhone est [à l’usage](/fr/guides/pricing), sans abonnement
ni frais par utilisateur. Un numéro ThunderPhone cesse d’être facturé lorsque vous le libérez.

## Après votre départ

Il n’y a pas de durée d’engagement fixe. Vous pouvez mettre fin au contrat par notification écrite à
legal@thunderphone.com, envoyée depuis l’adresse e-mail administrative du compte ou
un autre canal vérifiable. Un défaut de paiement peut suspendre le service ; à lui seul,
il ne met jamais fin au contrat et ne déclenche pas la suppression des Données client. Concernant les données,
les Conditions indiquent : « Après résiliation formelle, le Fournisseur renverra ou supprimera les Données client
dans les soixante (60) jours, sous réserve des droits d’exportation du Client, des cycles de sauvegarde,
des obligations de conservation, de la conservation légalement requise, du DPA et de tout BAA signé. »

Le texte intégral figure dans les
[Conditions d’utilisation](https://thunderphone.com/terms#term-termination), sous
**Durée du service ; suspension ; résiliation**. Les Conditions prévalent ; ceci est un résumé.

## Ressources associées

- [Importer des agents depuis une autre plateforme](/fr/guides/import-agents)
- [Compétences pour les agents de codage](/fr/guides/coding-agents)
- [API des agents](/api-reference/agents)
- [API des appels](/api-reference/calls)
