Open in
Odchod z ThunderPhone
Exportujte agenta ako otvorené súbory, znovu ho vytvorte v LiveKit Agents, Pipecat, Vapi alebo Retell s použitím zručnosti kódovacieho agenta a stiahnite si históriu hovorov a nahrávky.
ThunderPhone môžete opustiť kedykoľvek. Každého agenta môžete bezplatne exportovať ako zip s otvorenými súbormi a zručnosť pomôže vášmu programovaciemu agentovi znovu ho vytvoriť v LiveKit Agents, Pipecat, Vapi alebo Retell. Táto stránka popisuje, čo si môžete vziať, ako to exportovať a čo budete musieť znovu vytvoriť na druhej strane.
Čo si môžete vziať so sebou
| Čo | Ako |
|---|---|
| Agent: pokyny, nástroje, čísla na presmerovanie, kroky, nastavenia, smerovanie čísel a webhooky | Export agenta, jeden zip na agenta |
| Súbory znalostí agenta | V exporte agenta |
| História hovorov a prepisy | Export hovorov, až 1 000 hovorov na požiadavku |
| Nahrávky | Jedna nahrávka na požiadavku podľa hovoru |
| Telefónne čísla u vášho vlastného operátora | Nikdy neopustili vášho operátora. Pozrite si Telefónne čísla |
Exportovanie agenta
V Zeus
Otvorte agenta a prejdite do jeho nastavení (Spracovanie hovorov v editore agenta). Dole v časti Exportovať, kopírovať alebo odstrániť vyberte Exportovať. Súbor ZIP sa stiahne do vášho počítača.
Pomocou API
curl 'https://api.thunderphone.com/v1/agents/12/export' \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-o agent-12.zipSúbor ZIP sa vytvorí, keď oň požiadate. Exportovať ho môže každý, kto má
prístup na čítanie agenta. Znalosti, čísla a webhooky sú zahrnuté len vtedy,
keď ich poverenie môže čítať: token OAuth potrebuje knowledge:read,
numbers:read a integrations:read, webhooky navyše vyžadujú rolu správcu
alebo vlastníka. Vynechaná časť je uvedená v poli omitted v súbore manifest.json.
API odpovie 429 pri viac než 30 exportoch za minútu.
| Parameter dotazu | Popis |
|---|---|
include_url_paths | Hodnota true zachová v exporte cestu každej adresy URL, napríklad koncový bod nástroja. Predvolene sa každá adresa URL skráti len na hostiteľa. Používateľské mená, heslá a reťazce dotazu sa z adries URL odstránia v oboch prípadoch |
Použite include_url_paths=true, keď sa chystáte agenta znovu vytvoriť
inde, pretože tam budete potrebovať koncové body nástrojov. Pri kópii, ktorú
plánujete zdieľať, ho nechajte vypnutý.
Čo obsahuje súbor ZIP
| Súbor | Obsah |
|---|---|
manifest.json | Formát (thunderphone.agent-export/v1), zahrnutý obsah a zoznam omitted, ktorý uvádza všetko vynechané a dôvod vynechania |
agent.json | Agent vo forme, v akej ho vracia GET /v1/agents/{agent_id}, bez poverení |
prompt.md | Aktuálne pokyny |
knowledge/index.json a súbory vedľa neho | Znalosti agenta. Každý dokument je pôvodný súbor, ak je uložený, inak jeho extrahovaný text |
numbers.json | Čísla smerované na tohto agenta, prichádzajúce aj odchádzajúce, vrátane pripnutej verzie alebo variantu |
webhooks.json | Koncové body webhookov priradené tomuto agentovi bez ich tajných údajov |
README.md | Obsah jednotlivých súborov |
Súbor znalostí väčší než 25 MB sa vynechá, rovnako ako čokoľvek nad
100 MB pre celý export. Každý z nich je uvedený v súbore manifest.json s
koncovým bodom, ktorý ho stiahne,
GET /v1/knowledge/documents/{document_id}/original.
Čo nikdy nie je zahrnuté
- Hodnoty poverení. Hlavičky nástroja sú uvedené iba podľa názvu. Hodnoty hlavičiek sú v ThunderPhone iba na zápis: nevracia ich žiadna odpoveď API, preto ich nemôže obsahovať ani export. Na druhej strane ich zadáte znova. Týka sa to poverení, ktoré ThunderPhone ukladá ako poverenia. Vaše pokyny a súbory znalostí sa skopírujú presne v podobe, v akej ste ich napísali alebo nahrali, takže ak ste niekedy vložili kľúč do výzvy alebo dokumentu, bude v súbore ZIP. Pred zdieľaním ho skontrolujte.
- História hovorov a nahrávky. Majú vlastné exporty; pozrite si Históriu hovorov a nahrávky.
- História verzií. Export obsahuje agenta v jeho aktuálne nasadenej podobe.
Staršie verzie zostávajú uvedené v
GET /v1/agents/{agent_id}/versions. - Ďalší agenti, na ktorých tento agent presmerúva hovory. Každého z nich exportujte rovnakým spôsobom.
Prechod na inú platformu
Zručnosť migrate-off-thunderphone prevedie vášho programovacieho agenta
presunom. Nainštalujte si zručnosti ThunderPhone:
npx skills add thunderphone/skillsPotom požiadajte svojho programovacieho agenta, aby presunul hlasového agenta z ThunderPhone, a pomenujte cieľovú platformu: LiveKit Agents, Pipecat, Vapi alebo Retell. Zručnosť stiahne export, vyžiada si od vás jednotlivé prihlasovacie údaje, znova vytvorí agenta podľa mapovania pre daný cieľ a pred presunom akéhokoľvek čísla ho tam otestuje. Konverzia prebieha vo vašom programovacom agentovi s vašimi vlastnými kľúčmi. ThunderPhone nikdy nezapisuje do vášho účtu na inej platforme.
Čo sa prenesie ako súbory, ktoré za vás zručnosť namapuje:
- Pokyny vrátane zdieľaných pokynov a krokov.
- Nástroje: rovnaký koncový bod, metóda a schéma parametrov.
request_formatkaždého nástroja zaznamenáva tvar tela požiadavky, ktorý váš koncový bod očakáva. - Čísla na presmerovanie a nastavenia ukončenia hovoru a klávesnice.
- Súbory znalostí.
- Nastavenia hlasovej schránky, ticha a dĺžky hovoru.
- Z ktorých čísel agent prijíma hovory a z ktorých ich uskutočňuje.
Čo musíte na druhej strane vykonať znova:
- Poskytovatelia reči, jazykového modelu a hlasu. Vyberáte ich v cieľovej platforme. Nič nezaručuje, že sa hlas alebo zvuk hovoru zhodnú.
- Prihlasovacie údaje. Hodnoty hlavičiek nástrojov a tajné kľúče webhookov.
- Telefónia. Spôsob, akým sa čísla pripájajú k agentovi, je na každej platforme nastavený inak.
- Kroky a odovzdania. V cieľovej platforme s funkciou toku alebo odovzdania sa znova vytvoria tam. Inde zručnosť zahrnie kroky do pokynov a oznámi vám to.
- Nastavenia ThunderPhone bez ekvivalentu. Inteligencia, nastavenia počúvania a rýchlosti odpovede, vstavané nástroje na e-mail a textové správy a hodnotenie hovorov, súhrny a štítky výsledkov sa neprenesú, ak ich znova nevytvoríte.
- Podpisy požiadaviek. ThunderPhone podpisuje požiadavky nástrojov a webhooky, ktoré odosiela. Iná platforma ich podpisuje vlastným spôsobom, takže koncový bod, ktorý overuje podpis ThunderPhone, potrebuje novú kontrolu.
- Testovanie. Pred presunom čísla otestujte znova vytvoreného agenta v cieľovej platforme.
Nechajte agenta ThunderPhone na mieste, kým nový agent neprejde vašimi testami. Je to vaša cesta späť.
Telefónne čísla
Čísla presuňte ako posledné, až keď nový agent prejde testami.
- Číslo u vášho vlastného operátora (pripojenie VoIP)
zostáva u tohto operátora. Nasmerujte ho na novú platformu v konzole vášho
operátora. Potom pri čísle v ThunderPhone vyberte Uvoľniť a nechajte
možnosť Zrušiť toto číslo aj v mojom účte … nezaškrtnutú: číslo sa odpojí
od ThunderPhone a zostane vo vašom účte u operátora. Prostredníctvom API ho
uvoľnite pomocou
DELETE /v1/phone-numbers/{phone_number_id}?confirm=truea neposielajterelease_at_provider. - Číslo poskytnuté službou ThunderPhone. Pred uvoľnením čísla, ktoré si chcete ponechať, kontaktujte podporu. Uvoľnenie čísla ThunderPhone je trvalé: vráti sa do fondu a môže ho získať iný zákazník.
História hovorov a nahrávky
Tieto údaje sú oddelené od exportu agenta.
- Hovory.
GET /v1/calls/exportvráti až 1 000 hovorov na požiadavku vo formáte CSV (metadáta) alebo JSON (s prepismi). Filtrujte podľaagent_ida prechádzajte históriu po stránkach pomocoustart_dateaend_date. Hlavička odpovedeX-Truncatedmá hodnotutrue, keď sa zhodovalo viac hovorov, než bolo vrátených. - Nahrávky.
GET /v1/calls/{call_id}/audiovráti krátkodobo platnú adresu URL pre nahrávku jedného hovoru. Hromadné sťahovanie nahrávok nie je k dispozícii.
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Čo to stojí
Nič. Export agenta, export hovorov a sťahovanie nahrávok sú bezplatné. ThunderPhone funguje na princípe platby podľa používania bez predplatného a bez poplatku za používateľa. Keď číslo ThunderPhone uvoľníte, prestane sa účtovať.
Po odchode
Neexistuje žiadne pevne stanovené obdobie. Zmluvu môžete ukončiť písomným oznámením na adresu legal@thunderphone.com, odoslaným z administratívneho e-mailu účtu alebo iným overiteľným kanálom. Omeškanie platby môže pozastaviť službu; samo osebe nikdy neukončí zmluvu ani nespustí vymazanie údajov zákazníka. Podmienky o údajoch uvádzajú: „Po formálnom ukončení poskytovateľ vráti alebo vymaže údaje zákazníka do šesťdesiatich (60) dní, s výhradou práv zákazníka na export, cyklov zálohovania, právnych blokácií, zákonom vyžadovaného uchovávania, DPA a akejkoľvek uzatvorenej BAA.“
Úplné znenie nájdete v Podmienkach používania v časti Trvanie služby; pozastavenie; ukončenie. Rozhodujúce sú Podmienky; toto je zhrnutie.