Open in
Părăsirea ThunderPhone
Exportați un agent ca fișiere deschise, reconstruiți-l pe LiveKit Agents, Pipecat, Vapi sau Retell cu o competență de agent de programare și descărcați istoricul apelurilor și înregistrările.
Puteți părăsi ThunderPhone oricând doriți. Orice agent se exportă gratuit ca o arhivă zip cu fișiere deschise, iar un skill vă ajută agentul de programare să îl reconstruiască în LiveKit Agents, Pipecat, Vapi sau Retell. Această pagină prezintă ce puteți lua cu dumneavoastră, cum să exportați și ce trebuie să refaceți de cealaltă parte.
Ce puteți lua cu dumneavoastră
| Ce | Cum |
|---|---|
| Un agent: instrucțiuni, instrumente, numere de transfer, pași, setări, rutarea numerelor și webhook-uri | Exportul agentului, o arhivă zip pentru fiecare agent |
| Fișierele de cunoștințe ale agentului | În exportul agentului |
| Istoricul apelurilor și transcrierile | Exportul apelurilor, până la 1.000 de apeluri per solicitare |
| Înregistrări | Câte o înregistrare per solicitare, pentru fiecare apel |
| Numere de telefon la propriul operator | Nu au părăsit niciodată operatorul dumneavoastră. Consultați Numere de telefon |
Exportați un agent
În Zeus
Deschideți agentul și accesați setările acestuia (Gestionarea apelurilor în editorul agentului). În partea de jos, la Exportați, copiați sau ștergeți, alegeți Exportați. Fișierul zip se descarcă pe computerul dumneavoastră.
Cu API-ul
curl 'https://api.thunderphone.com/v1/agents/12/export' \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-o agent-12.zipFișierul zip este creat atunci când îl solicitați. Oricine poate citi agentul îl
poate exporta. Cunoștințele, numerele și webhookurile sunt incluse numai când
acreditarea le poate citi: un token OAuth are nevoie de knowledge:read,
numbers:read și integrations:read, iar webhookurile necesită și rol de
administrator sau proprietar. O parte omisă este listată la omitted în
manifest.json. API-ul răspunde cu 429 la peste 30 de exporturi pe minut.
| Parametru de interogare | Descriere |
|---|---|
include_url_paths | true păstrează în export calea fiecărui URL, cum ar fi endpointul unui instrument. În mod implicit, fiecare URL este redus la gazda sa. Numele de utilizator, parolele și șirurile de interogare sunt eliminate din URL-uri în ambele cazuri |
Utilizați include_url_paths=true atunci când urmează să reconstruiți agentul
în altă parte, deoarece endpointurile instrumentelor sunt necesare acolo. Lăsați-l dezactivat pentru
o copie pe care intenționați să o distribuiți.
Ce conține fișierul zip
| Fișier | Conținut |
|---|---|
manifest.json | Formatul (thunderphone.agent-export/v1), ce este inclus și o listă omitted care indică orice element omis și motivul |
agent.json | Agentul așa cum îl returnează GET /v1/agents/{agent_id}, cu acreditările eliminate |
prompt.md | Instrucțiunile active |
knowledge/index.json și fișierele de lângă acesta | Cunoștințele agentului. Fiecare document este fișierul original, atunci când unul este stocat, altfel textul extras |
numbers.json | Numerele direcționate către acest agent, pentru apeluri primite și efectuate, cu orice versiune sau variantă fixată |
webhooks.json | Endpointurile webhook asociate acestui agent, fără secretele lor |
README.md | Rolul fiecărui fișier |
Un fișier de cunoștințe mai mare de 25 MB este omis, la fel ca orice depășește
100 MB pentru întregul export. Fiecare este listat în manifest.json cu
endpointul care îl descarcă,
GET /v1/knowledge/documents/{document_id}/original.
Ce nu este inclus niciodată
- Valorile acreditărilor. Antetele unui instrument sunt listate doar după nume. Valorile antetelor sunt numai pentru scriere în ThunderPhone: niciun răspuns API nu le returnează, deci niciun export nu le poate returna. Le introduceți din nou în cealaltă parte. Aceasta acoperă acreditările pe care ThunderPhone le stochează ca acreditări. Instrucțiunile și fișierele dumneavoastră de cunoștințe sunt copiate exact așa cum le-ați scris sau încărcat, deci dacă o cheie a fost vreodată lipită într-un prompt sau într-un document, aceasta se află în fișierul zip. Verificați înainte de a-l distribui.
- Istoricul apelurilor și înregistrările. Acestea au propriile exporturi; consultați Istoricul apelurilor și înregistrările.
- Istoricul versiunilor. Exportul conține agentul așa cum este activ acum. Versiunile
anterioare rămân listate la
GET /v1/agents/{agent_id}/versions. - Alți agenți către care acesta transferă apelurile. Exportați-i pe fiecare în același mod.
Mutați-vă pe altă platformă
Competența migrate-off-thunderphone vă ghidează agentul de programare prin
mutare. Instalați competențele ThunderPhone:
npx skills add thunderphone/skillsApoi cereți agentului dvs. de programare să mute un agent de pe ThunderPhone și indicați destinația: LiveKit Agents, Pipecat, Vapi sau Retell. Competența descarcă exportul, vă solicită fiecare acreditare, reconstruiește agentul dintr-o mapare pentru destinația respectivă și îl testează acolo înainte de mutarea oricărui număr. Conversia rulează în agentul dvs. de programare, cu propriile dvs. chei. ThunderPhone nu scrie niciodată în contul dvs. de pe altă platformă.
Ce se transferă, ca fișiere pe care competența le mapează pentru dvs.:
- Instrucțiuni, inclusiv instrucțiuni și pași partajați.
- Instrumente: același endpoint, metodă și schemă de parametri.
request_formatal fiecărui instrument înregistrează structura corpului așteptată de endpointul dvs. - Numere de transfer și setările pentru încheierea apelului și tastatură.
- Fișiere de cunoștințe.
- Setări pentru mesageria vocală, tăcere și durata apelului.
- Numerele la care agentul răspunde și de la care inițiază apeluri.
Ce refaceți pe cealaltă parte:
- Furnizorii de vorbire, model lingvistic și voce. Îi alegeți la destinație. Nimic nu garantează că o voce sau felul în care sună un apel va corespunde.
- Acreditări. Valorile antetelor instrumentelor și secretele webhook.
- Telefonie. Modul în care numerele ajung la agent este configurat diferit pe fiecare platformă.
- Pași și transferuri. O destinație cu o funcție de flux sau transfer le reconstruiește acolo. În alte situații, competența integrează pașii în instrucțiuni și vă informează.
- Setări ThunderPhone fără echivalent. Setările de inteligență, auz și viteză de răspuns, instrumentele integrate pentru e-mail și mesaje text, precum și evaluarea apelurilor, rezumatele și etichetele de rezultat nu se mută decât dacă le reconstruiți.
- Semnături de solicitare. ThunderPhone semnează solicitările de instrumente și webhookurile pe care le trimite. Altă platformă semnează în propriul mod, astfel încât un endpoint care verifică semnătura ThunderPhone necesită o verificare nouă.
- Testare. Testați agentul reconstruit la destinație înainte de a muta un număr.
Păstrați agentul ThunderPhone activ până când cel nou trece testele dvs. Este modalitatea dvs. de revenire.
Numere de telefon
Mutați numerele la final, după ce noul agent trece testele.
- Un număr la propriul dvs. furnizor (o conexiune VoIP)
rămâne la acel furnizor. Direcționați-l către noua platformă în consola
furnizorului dvs. Apoi alegeți Eliberați pentru număr în ThunderPhone și
lăsați nebifată opțiunea Anulați și acest număr în contul meu de …:
numărul este deconectat de la ThunderPhone și rămâne în contul dvs. la
furnizor. Prin API, eliberați
numărul cu
DELETE /v1/phone-numbers/{phone_number_id}?confirm=trueși nu trimitețirelease_at_provider. - Un număr furnizat de ThunderPhone. Contactați asistența înainte de a elibera un număr pe care doriți să îl păstrați. Eliberarea unui număr ThunderPhone este permanentă: acesta revine în grupul disponibil și poate fi alocat altui client.
Istoricul apelurilor și înregistrările
Acestea sunt separate de exportul agentului.
- Apeluri.
GET /v1/calls/exportreturnează până la 1.000 de apeluri per solicitare ca CSV (metadate) sau JSON (cu transcrieri). Filtrați dupăagent_idși parcurgeți istoricul pe pagini custart_dateșiend_date. Antetul de răspunsX-Truncatedestetrueatunci când au corespuns mai multe apeluri decât au fost returnate. - Înregistrări.
GET /v1/calls/{call_id}/audioreturnează un URL cu durată scurtă de viață pentru înregistrarea unui apel. Nu există descărcare în masă a înregistrărilor.
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.jsonCosturi
Nimic. Exportul agenților, exportul apelurilor și descărcările înregistrărilor sunt gratuite. ThunderPhone funcționează cu sistem plătiți pe măsură ce utilizați, fără abonament și fără taxă per utilizator. Facturarea unui număr ThunderPhone se oprește când îl eliberați.
După plecare
Nu există o durată fixă. Puteți rezilia acordul printr-o notificare scrisă la legal@thunderphone.com, trimisă de la e-mailul administrativ al contului sau printr-un alt canal verificabil. O întrerupere a plății poate suspenda serviciul; singură, aceasta nu reziliază niciodată acordul și nu declanșează ștergerea Datelor clientului. Referitor la date, Termenii prevăd: „După rezilierea formală, Furnizorul va returna sau șterge Datele clientului în termen de șaizeci (60) de zile, sub rezerva drepturilor de export ale Clientului, a ciclurilor de backup, a obligațiilor legale de păstrare, a păstrării impuse de lege, a DPA și a oricărui BAA executat.”
Textul integral se găsește în Termenii serviciului, la secțiunea Durata serviciului; suspendare; reziliere. Termenii prevalează; acesta este un rezumat.