ThunderPhone v3 est disponible.En libre-service, à partir de 2 ¢/min.Découvrir l’annonce

Using the dashboard

Quitter ThunderPhone

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.

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émentsMéthode
Un agent : instructions, outils, numéros de transfert, étapes, paramètres, routage des numéros et webhooksL’export de l’agent, un zip par agent
Les fichiers de connaissances de l’agentDans l’export de l’agent
L’historique des appels et les transcriptionsL’export des appels, jusqu’à 1 000 appels par requête
Les enregistrementsUn enregistrement par requête, par appel
Les numéros de téléphone chez votre propre opérateurIls n’ont jamais quitté votre opérateur. Consultez Numéros de téléphone

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

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

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êteDescription
include_url_pathstrue 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

FichierContenu
manifest.jsonLe format (thunderphone.agent-export/v1), les éléments inclus et une liste omitted indiquant tout élément exclu et la raison
agent.jsonL’agent tel que le renvoie GET /v1/agents/{agent_id}, sans les identifiants
prompt.mdLes 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.jsonLes numéros acheminés vers cet agent, entrants et sortants, avec toute version ou variante épinglée
webhooks.jsonLes points de terminaison de webhook associés à cet agent, sans leurs secrets
README.mdLe 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.

É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.
  • 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.
  • 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 :

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

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, 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, sous Durée du service ; suspension ; résiliation. Les Conditions prévalent ; ceci est un résumé.

Ressources associées