Open in
Importer des agents depuis une autre plateforme
Importez des agents, des outils et des bases de connaissances depuis Vapi, Retell, ElevenLabs Agents ou Bland à l’aide d’une clé API ou d’une exportation JSON, vérifiez le mapping, puis importez-les.
Si vos agents se trouvent sur Vapi, Retell, ElevenLabs Agents ou Bland, l’importateur les récupère, associe chaque champ à ThunderPhone et vous affiche le résultat avant toute création.
Démarrer une importation
- Ouvrez Agents et choisissez Importer des agents, ou demandez à Zeus de transférer vos agents.
- Sélectionnez la plateforme.
- Suivez les étapes pour créer une clé sur cette plateforme (elles ouvrent la bonne page de paramètres pour vous) et collez-la, ou choisissez Coller le JSON exporté à la place et collez un ou plusieurs objets d’agent depuis le tableau de bord ou l’API de cette plateforme.
- Choisissez Récupérer mes agents (le bouton indique le nom de votre plateforme). La récupération et le mappage prennent généralement moins d’une minute ; vous pouvez quitter la page et y revenir. Une importation encore ouverte, ainsi que vos importations précédentes, sont répertoriées sur la page Importer des agents.
Dans l’ancienne vue, Importer se trouve dans Agents vocaux et ouvre les mêmes étapes dans une boîte de dialogue.
Examiner le plan
Chaque agent affiche son nom, la voix associée (avec le niveau de confiance de l’association), les outils et bases de connaissances qu’il contient, ainsi que des notes sur les éventuelles modifications apportées lors de la traduction. Développez une ligne pour lire le prompt :
- Nettoyé (Réécrit dans l’ancienne vue) — un prompt cohérent dans le style du guide de prompting, avec chaque numéro de téléphone, URL, nom d’outil et espace réservé de la source conservés.
- Tel que sur Vapi, ou le nom de votre plateforme (Structuré dans l’ancienne vue) — la configuration source présentée sous des titres, exactement telle qu’elle a été extraite. Utilisée automatiquement lorsque la réécriture ne peut pas être vérifiée, ou lorsque la réécriture est beaucoup plus courte que la source.
Un agent importé depuis un flux affiche Instructions partagées au lieu du prompt, ainsi que le nombre d’étapes qu’il conserve du flux. La révision de l’ancienne vue répertorie le nom de chaque étape, ce qu’elle indique à l’agent de faire et où elle mène ensuite, et Afficher sous forme d’un seul prompt affiche le même agent sous la forme d’un seul prompt, qui est celui qu’il exécute partout où les étapes ne sont pas disponibles. Les agents avec transferts répertorient les agents auxquels ils transfèrent l’appelant ; si vous en décochez un, la révision indique que ce transfert ne sera pas configuré.
Chaque agent est sélectionné au départ, à l’exception des agents vides et des agents de démarrage par défaut créés par la plateforme pour vous. Décochez les agents que vous ne voulez pas, modifiez les noms, les voix, les paramètres ou le choix du prompt, puis cliquez sur Importer. Les agents sont enregistrés avec leurs connexions API et leurs connaissances associées ; ouvrez-en un pour le vérifier et essayez un appel avant de l’attribuer à un numéro.
Flux, Squads et transferts entre agents
Les agents à plusieurs étapes conservent leur structure. Consultez Étapes de l'agent pour savoir comment les étapes et les transferts s'effectuent lors d'un appel.
- Les flux deviennent des étapes. Les états à plusieurs prompts et les flux conversationnels Retell,
les parcours Bland et les workflows ElevenLabs sont importés comme étapes de l'agent. Le
prompt global de la source devient les instructions partagées.
- Les instructions, la ligne fixe, les valeurs à recueillir et les outils de chaque nœud sont conservés.
- Les conditions de branchement rédigées en toutes lettres deviennent des transitions que l'agent décide.
Une comparaison unique sur une valeur recueillie ou une réponse de webhook
(
age >= 18) devient une transition vérifiée exactement. - Les nœuds de webhook et de fonction exécutent leur outil au démarrage de l'étape. Les nœuds globaux sont accessibles depuis n'importe quelle étape ; un nœud sans issue propre redonne l'appel à l'étape qu'il a interrompue.
- Les nœuds de transfert et de fin deviennent des dernières étapes qui transfèrent ou terminent l'appel. Un nœud de transfert Retell conserve son issue au cas où le transfert n'aboutit pas.
- Un nœud de branchement qui choisit uniquement l'étape suivante est fusionné avec l'étape précédente lorsque cela est possible. Sinon, il reste une étape distincte, avec une note.
- Un flux trop volumineux pour les étapes, ou que ThunderPhone ne peut pas représenter sous forme d'étapes, est importé comme un seul prompt qui liste chaque étape, avec une note.
- Les Squads, transferts entre agents et changements d'agents deviennent des transferts. Chaque membre
d'une Squad Vapi est importé comme son propre agent, nommé d'après le membre et la
Squad. Le premier membre répond aux appels de la Squad et les autres sont joints
par transfert. Les transferts ElevenLabs vers un autre agent et les changements d'agents Retell
deviennent également des transferts. L'appelant reste en ligne et la conversation en cours
est conservée.
- Un appel transféré conserve les paramètres d'appel de l'agent qui y a répondu : messagerie vocale, limites d'appel, langues et enregistrement. L'agent vers lequel l'appel est transféré apporte son propre prompt, ses étapes, ses outils et sa voix.
- Un transfert peut pointer uniquement vers un agent importé lors de la même exécution. Si l'autre agent ne fait pas partie de l'importation, ou si vous le décochez, la note l'indique et vous pouvez ajouter le transfert plus tard dans les paramètres de l'agent.
Ce qui est importé
Obtenir une clé
- Ouvrez dashboard.vapi.ai/org/api-keys (Paramètres de l’organisation → Clés API).
- Créez une clé et choisissez Privée — les clés publiques ne peuvent pas lister les assistants.
- Copiez-la dans la boîte de dialogue. Les clés Vapi ne sont pas limitées par périmètre ; supprimez la clé dans Vapi après l’importation si vous l’avez créée uniquement pour cela.
| Champ Vapi | ThunderPhone |
|---|---|
model.messages[system] | Prompt |
firstMessage, firstMessageMode | Phrase d’ouverture dans le prompt ; qui parle en premier |
voice.provider + voiceId | Voix de catalogue la plus proche, avec recherche optimale dans la bibliothèque Vapi (niveau de correspondance affiché) |
transcriber.language, languages, mots-clés/termes-clés | Langues et vocabulaire de reconnaissance vocale |
model.model | Non mappé : les agents importés démarrent avec l’intelligence Pro et l’écoute Standard |
model.tools, toolIds, toolRefs (function, apiRequest) | Connexions API ; les enveloppes de requête Vapi et les solutions de repli serveur au niveau de l’assistant sont conservées |
Destinations transferCall | Transferts téléphoniques dans le prompt ; les destinations SIP, d’assistant et dynamiques sont signalées pour vérification |
Outils handoff | Transferts vers les assistants nommés importés lors de la même opération |
endCall, dtmf | Fonctionnalités intégrées |
Google Calendar, Google Sheets, sms | Signalés avec l’intégration ThunderPhone ou la configuration SMS requise |
| Slack | Signalé comme non importé : ThunderPhone ne peut pas encore se connecter à Slack |
Outils query et knowledgeBase, ainsi que l’ancien knowledgeBaseId | Base de connaissances avec les fichiers importés accessibles sous forme de documents |
endCallMessage, endCallPhrases, voicemailMessage, plans de messages d’inactivité et hooks de délai d’expiration | Sections du prompt ; paramètres de messagerie vocale et de silence |
maxDurationSeconds, exclusions d’enregistrement | Durée maximale d’appel (la valeur par défaut de 600 secondes de Vapi est conservée) ; une exclusion d’enregistrement est signalée sur la page de vérification |
| Squads | Un agent par membre, avec son propre prompt, ses remplacements, sa voix, ses outils et ses connaissances. Les assistantDestinations deviennent des transferts entre eux ; le premier membre conserve les numéros du Squad |
| Serveurs personnalisés de connaissances/modèles, plans de conformité, autres hooks, workflows et outils hébergés non pris en charge | Signalés avec une action précise de vérification ou de reconstruction ; les plans bruts et les identifiants ne sont pas stockés |
Obtenir une clé
- Ouvrez dashboard.retellai.com/apiKeys (Paramètres système → Clés API) et choisissez Créer une clé.
- Activez Restreindre les autorisations et définissez Agent, Base de connaissances et Téléphone sur Lecture. Laissez tous les autres groupes décochés ; l’importateur n’écrit jamais dans Retell.
- Copiez la clé dans la boîte de dialogue.
| Champ Retell | ThunderPhone |
|---|---|
| Dernier agent publié + sa version exacte du LLM / flux Retell | Prompt et comportement publiés ; les brouillons plus récents sont signalés pour révision |
LLM Retell general_prompt, begin_message, start_speaker, états | Instructions partagées ; comportement d'ouverture ; une étape par état, avec ses outils et transitions, ainsi que les valeurs collectées par chaque transition |
Flux de conversation global_prompt, nœuds, composants, nœuds globaux et arêtes | Instructions et étapes partagées ; les conditions d'équation sur les valeurs collectées sont vérifiées exactement ; texte d'ouverture exact et étapes de transfert |
Outils et nœuds agent_swap | Transferts vers les agents Retell importés lors de la même opération |
| Outils personnalisés | Connexions API avec paramètres de requête, délai d'attente et format de requête Retell/args uniquement ; toute modification de signature et tout paramètre non standard de voix, de nouvelle tentative, de variable de réponse ou d'encodage de formulaire sont signalés |
transfer_call, end_call, press_digit | Transferts conditionnels, y compris les extensions, et fonctions intégrées ; les différences de transfert déduit et de transfert assisté sont signalées |
check_availability_cal, book_appointment_cal | Signalés comme outils Cal.com à reconnecter dans Intégrations ; les identifiants Retell ne sont jamais transférés |
send_sms, MCP | Signalés avec les instructions de configuration SMS ou MCP |
voice_id (11labs-, openai-, cartesia-, …) | Voix de catalogue la plus proche |
language (une locale, le mode multilingue ou une liste de locales) | Langues principale et supplémentaires |
model / s2s_model | Non mappé : les agents importés démarrent avec l'intelligence Pro et l'écoute Standard |
knowledge_base_ids (sources url, document, texte) | Base de connaissances avec documents |
default_dynamic_variables, variables système prises en charge | Valeurs par défaut des variables ThunderPhone et instructions simples de contexte d'appel |
voicemail_option, end_call_after_silence_ms, max_call_duration_ms, ring_duration_ms, enregistrement désactivé, boosted_keywords | Comportement de la messagerie vocale ; limites d'appel ; paramètre d'enregistrement ; termes du prompt |
webhook_url, moteurs LLM personnalisés, nœuds de flux non pris en charge et paramètres propres au fournisseur | Signalés pour révision manuelle, sans être supprimés silencieusement |
Obtenir une clé
- Ouvrez elevenlabs.io/app/settings/api-keys et choisissez Créer une clé API.
- Dans les autorisations, attribuez-lui Plateforme Agents : Lecture (et Base de connaissances : Lecture si cette option est affichée) ; l’importateur n’a besoin de rien d’autre.
- Copiez la clé dans la boîte de dialogue.
| Champ ElevenLabs | ThunderPhone |
|---|---|
conversation_config.agent.prompt.prompt, nœuds Agent Workflow et conditions de branchement ordonnées | Instructions partagées et une étape par nœud de flux de travail ; les nœuds d'outil exécutent leur outil au démarrage de l'étape ; les branches d'expression sont étiquetées pour révision |
first_message, language, language_presets | Phrase d'ouverture ; langues principale et supplémentaires ; ouvertures traduites |
prompt.llm | Non mappé : les agents importés démarrent avec l'intelligence Pro et l'écoute Standard |
tts.voice_id | Voix de catalogue la plus proche |
tool_ids de webhook, y compris les outils associés aux étapes du flux de travail | Connexions API avec paramètres de corps et de requête portables ; les paramètres fixes du fournisseur et les identifiants sont supprimés et signalés |
built_in_tools pour la fin d'appel, le transfert téléphonique, le clavier et la messagerie vocale | Fonctions intégrées, règles de transfert et comportement de la messagerie vocale ; les destinations SIP et dynamiques sont signalées pour reconstruction |
Transferts vers un autre agent (transfer_to_agent, nœuds de flux de travail d'agent) | Transferts vers les agents ElevenLabs importés lors de la même opération |
Entrées url/texte/fichier/dossier de knowledge_base, y compris les connaissances d'étape de flux de travail | Documents de la base de connaissances ; les dossiers sont développés et le contenu texte/fichier est récupéré par identifiant |
turn.silence_end_call_timeout, conversation.max_duration_seconds, asr.keywords, privacy.record_voice | Limites de silence et de durée maximale ; termes de prononciation ; l'enregistrement désactivé est signalé sur la page de révision |
| LLM personnalisés, serveurs MCP, procédures, webhooks d'espace de travail, remplacements de modèle/voix/langue par étape, outils de prise de rendez-vous ElevenLabs | Signalés avec l'action nécessaire après l'importation |
Obtenir une clé
- Ouvrez app.bland.ai/dashboard/settings.
- Copiez la clé API affichée (Bland dispose d’une clé par compte ; elle n’est pas limitée par périmètre, effectuez donc une rotation ensuite si vous le souhaitez).
- Collez-la dans la boîte de dialogue.
Les libellés affichés par Bland ne sont pas considérés comme l'identité de l'agent. L'importateur détermine comment l'agent se présente à partir du message d'accueil et du prompt ; pour un parcours, il utilise le prompt global et le nœud de départ. Si cette vérification est indisponible ou ne trouve aucun nom, le prompt importé reste neutre.
| Champ Bland | ThunderPhone |
|---|---|
Agent web prompt, first_sentence, language, model, voice, pathway_id | Prompt ; phrase d'ouverture ; langue ; niveau ; voix la plus proche ; flux de parcours publié associé |
| Version de production de Persona | Prompts de personnalité et d'orchestration ; voix ; langue ; paramètre indiquant que l'appelant parle en premier ; enregistrement ; durée maximale ; outils et connaissances par défaut. Un seul parcours associé est inclus ; le routage entre plusieurs parcours est signalé pour une configuration manuelle |
| Outils personnalisés et de parcours (url, méthode, schéma, en-têtes, variables de corps) | Connexions API. Les références Bland Secret sont signalées et doivent être ajoutées à nouveau |
| Outils Cal.com, HubSpot, Salesforce, Google Calendar et Google Sheets | L'intégration ThunderPhone correspondante est indiquée afin que vous puissiez la connecter et l'activer |
| Outils Slack | Signalés comme non importés : ThunderPhone ne peut pas encore se connecter à Slack |
Détails du numéro entrant (prompt, pathway_id / version, outils, transferts, mots-clés, données de requête) | Un agent par numéro entrant, avec des valeurs par défaut de variables d'appel et des règles de transfert |
| Chaque parcours, associé à un numéro ou non | Version publiée lorsqu'elle est disponible ; un brouillon non publié est clairement signalé |
| Prompt global ; nœuds Default, Knowledge Base, Transfer Call, End Call, Webhook et Wait for Response ; arêtes, conditions de boucle, nœuds globaux, variables extraites, texte statique | Instructions partagées et une étape par nœud, y compris les étapes disponibles à tout moment, les valeurs à collecter, le texte exact, les étapes de webhook, les transferts et les raccrochages. Les parcours de réponse webhook basés sur un champ de réponse ou une variable extraite sont vérifiés exactement |
| Texte de connaissances intégré et identifiants de connaissances résolubles | Documents de connaissances. Les éléments dont le texte ou le fichier ne peut pas être lu sont signalés pour un chargement manuel |
max_duration, wait_for_greeting, paramètre d'enregistrement | Limite d'appel, ordre de prise de parole, paramètre d'enregistrement |
webhook, recherches de données dynamiques, routage de persona à plusieurs parcours, paramètres de nœud non pris en charge, agents v2 | Signalés avec le suivi manuel requis |
| Numéros entrants | Répertoriés avec les deux options, car Bland n'indique pas s'il en est propriétaire ou si votre compte Twilio l'est |
Ce qui nécessite une étape sur ThunderPhone
Le rapport situé en bas de la page de révision liste les numéros, webhooks et outils qui n'ont pas été transférés ; les notes de chaque agent couvrent le reste. Ensemble, ils indiquent tout ce qui n'a pas été transféré et pourquoi :
- Numéros de téléphone. Après l’importation, chaque numéro source indique où il
se trouve et ce que vous pouvez en faire :
- Dans votre propre compte Twilio ou Telnyx (par exemple, un numéro Twilio que vous avez connecté à Vapi ou ElevenLabs) : un administrateur peut le transférer vers un agent importé. Si aucune connexion VoIP ne détient encore ce compte, connectez-la d’abord. Avant toute modification, une étape de confirmation indique que les appels vers ce numéro ne seront plus acheminés vers l’ancienne plateforme. ThunderPhone associe ensuite le numéro à son service dans votre compte opérateur (un numéro Twilio rejoint le trunk SIP de ThunderPhone ; un numéro Telnyx passe vers la connexion SIP de ThunderPhone) et effectue un bref appel de test pour l’activer. Pour annuler l’opération, supprimez le numéro dans Téléphone et web, tout en le conservant dans votre compte opérateur, puis réimportez-le sur l’ancienne plateforme.
- Sur votre trunk SIP : connectez le trunk en tant que connexion SIP, puis importez le numéro dans Téléphone et web.
- Vendu par la plateforme (numéros Vapi, Retell et Bland achetés sur celle-ci) : ThunderPhone ne peut pas le transférer. Portez-le vers un opérateur et importez-le, ou obtenez un numéro ThunderPhone et associez-le à l’agent importé.
- Bland n’indique pas si un numéro lui appartient ou provient de votre compte Twilio ; les numéros Bland affichent donc les deux options.
- Webhooks par agent. ThunderPhone envoie des webhooks signés par organisation ; configurez-en un dans Webhooks.
- Identifiants stockés par le fournisseur. Les en-têtes d’outils qui étaient visibles sont copiés. Les identifiants que l’ancienne plateforme stockait par ID sont signalés ; ajoutez-les aux en-têtes de la connexion API.
- Intégrations intégrées. Les outils de calendrier, CRM et messagerie hébergés par l’ancienne plateforme (par exemple, la réservation Cal.com) sont associés à l’intégration ThunderPhone à connecter à la place ; leurs identifiants ne sont pas transférés. La vérification signale également un prompt qui indique encore à l’agent d’utiliser un outil qui n’a pas été importé.
- Messages texte. Les agents ThunderPhone envoient des SMS via votre propre numéro Twilio ou Telnyx ; configurez les SMS dans les paramètres de l’agent.
- Outils sans équivalent (automatisations propres à la plateforme) sont répertoriés afin que rien ne soit ignoré silencieusement.
- Variables d’appel. Les espaces réservés
{{name}}sont conservés, avec les valeurs par défaut de votre plateforme. ThunderPhone les renseigne à partir des variables transmises au début d’un appel et les laisse vides dans les autres cas ; la vérification répertorie celles que vous devez transmettre. - Limites d’appel et enregistrement. La durée maximale d’appel est importée. Lorsque l’agent source ne l’a jamais modifiée, la valeur par défaut de la plateforme est définie : 10 minutes pour Vapi et ElevenLabs, 1 heure pour Retell, 30 minutes pour Bland. Une valeur source qui n’est pas un nombre positif est importée sans maximum, et la vérification l’indique. Les limites de silence et de durée maximale situées hors des plages prises en charge par ThunderPhone sont ajustées, et la note de vérification indique la valeur source ainsi que la valeur importée. Lorsque l’agent source avait désactivé l’enregistrement des appels, la note de vérification de l’agent indique s’il est importé avec l’enregistrement désactivé ou, lorsque la désactivation de l’enregistrement n’est pas encore disponible, avec l’enregistrement activé.
Ce qui change lors de l'importation
Quelques paramètres que votre ancienne plateforme a laissés sur ses propres valeurs par défaut adoptent à la place les valeurs par défaut de ThunderPhone. La vérification les répertorie dans une note par agent vocal, dans ses détails, uniquement lorsque les deux plateformes diffèrent. Les valeurs ThunderPhone ci-dessous sont ses valeurs par défaut, que vous pouvez modifier pour chaque agent vocal :
| Paramètre | Valeur par défaut de l’ancienne plateforme | Valeur par défaut de ThunderPhone |
|---|---|---|
| Durée de sonnerie des appels sortants | Retell : 30 secondes | 60 secondes |
| Fin d’un appel silencieux | Retell : raccrocher après 10 minutes ; ElevenLabs : jamais | Relance toutes les 15 secondes (après environ 6 secondes si personne n’a encore parlé, après au moins une minute si l’appelant a demandé à l’agent d’attendre), raccrochage après 1 minute de silence |
| Enregistrement des appels | Numéros entrants et personas Bland : désactivé | Activé. Contactez le support ou modifiez ce paramètre dans les réglages de l’agent, lorsqu’ils sont disponibles |
| Sur une messagerie vocale | Personas Bland : raccrocher | L’agent décide selon son prompt |
Un paramètre que vous avez modifié sur l'ancienne plateforme est importé tel que vous l'avez défini et n'est pas répertorié ici. La seule exception concerne un paramètre d'appel silencieux défini sur « ne jamais raccrocher » : il est répertorié comme une valeur par défaut, et l'agent conserve les vérifications de ThunderPhone. Modifiez l'un de ces paramètres dans les paramètres de l'agent après l'importation.
Importer sans clé
Choisissez Coller le JSON exporté à la place et collez le ou les objets exportés par l’API ou le tableau de bord de votre plateforme, sous la forme d’un objet unique ou d’une liste JSON :
- Vapi — un objet assistant (
GET /assistant/{id}), un objet Squad (GET /squad/{id}), ou une liste de l’un ou l’autre. Les outils associés uniquement par id et les fichiers de connaissances nécessitent une clé pour être résolus. Vapi a supprimé les Workflows ; convertissez donc un Workflow en Squad avant de le coller. - Retell — l’objet agent (
GET /get-agent/{id}?version=...) avec son Retell LLM de même version (GET /get-retell-llm/{id}?version=...) ou son objet de flux conversationnel dans la même liste. L’importateur établit les liens par id et version, privilégie un agent publié collé lorsque le statut de publication est présent, et importe un LLM ou un flux autonome sous un nom généré. - ElevenLabs — l’objet agent (
GET /v1/convai/agents/{id}). Les exportations actuelles référencent généralement les outils webhook et les documents de connaissances uniquement par id. Un collage signale ces éléments comme non résolus ; utilisez une clé API pour une importation complète. - Bland — un agent web, la réponse
/v1/agentsou un objet pathway. Chaque objet collé est importé comme son propre agent, même lorsque deux objets partagent un id ; les id d’outils et de connaissances nécessitant un accès API sont répertoriés pour une configuration manuelle au lieu d’être ignorés.
Tout élément référencé uniquement par identifiant et absent du contenu collé est listé dans les notes.
Après l’importation
- Ouvrez chaque agent et lisez ses notes.
- Cliquez sur Tester l’appel sur la page de l’agent, ou demandez à Zeus de le tester.
- Transférez vos numéros ou associez-en un nouveau (voir Numéros de téléphone ci-dessus).
- Testez chaque connexion API avec le testeur de requêtes.
- Vérifiez que les documents de connaissances ont terminé leur indexation.
- Configurez un webhook d’organisation si les anciens agents en utilisaient un.
L’importateur est également disponible via l’API REST.
L’importation ne vous enferme pas. Vous pouvez exporter n’importe quel agent sous forme de fichiers ouverts, gratuitement, à tout moment : consultez Quitter ThunderPhone.