Open in
Opuszczanie ThunderPhone
Eksportuj agenta jako otwarte pliki, odtwórz go w LiveKit Agents, Pipecat, Vapi lub Retell za pomocą umiejętności agenta programującego oraz pobierz historię połączeń i nagrania.
Możesz opuścić ThunderPhone, kiedy zechcesz. Każdego agenta można bezpłatnie wyeksportować jako archiwum zip z otwartymi plikami, a umiejętność pomaga agentowi programistycznemu odtworzyć go w LiveKit Agents, Pipecat, Vapi lub Retell. Ta strona opisuje, co możesz ze sobą zabrać, jak to wyeksportować oraz co trzeba odtworzyć po drugiej stronie.
Co możesz ze sobą zabrać
| Co | Jak |
|---|---|
| Agent: instrukcje, narzędzia, numery przekierowań, kroki, ustawienia, routing numerów i webhooki | Eksport agenta, jedno archiwum zip na agenta |
| Pliki wiedzy agenta | W eksporcie agenta |
| Historia połączeń i transkrypcje | Eksport połączeń, do 1000 połączeń na żądanie |
| Nagrania | Jedno nagranie na żądanie, dla każdego połączenia |
| Numery telefonów u własnego operatora | Nigdy nie opuściły twojego operatora. Zobacz Numery telefonów |
Eksportowanie agenta
W Zeus
Otwórz agenta i przejdź do jego ustawień (Obsługa połączeń w edytorze agenta). Na dole, w sekcji Eksportuj, kopiuj lub usuń, wybierz Eksportuj. Plik ZIP zostanie pobrany na komputer.
Za pomocą API
curl 'https://api.thunderphone.com/v1/agents/12/export' \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-o agent-12.zipPlik ZIP jest tworzony, gdy o niego poprosisz. Każdy, kto może odczytać agenta,
może go wyeksportować. Wiedza, numery i webhooki są uwzględniane tylko wtedy,
gdy poświadczenie może je odczytać: token OAuth potrzebuje uprawnień
knowledge:read, numbers:read i integrations:read, a webhooki wymagają
również roli administratora lub właściciela. Pominięta część jest wymieniona
w sekcji omitted w pliku manifest.json. API zwraca 429 po przekroczeniu
30 eksportów na minutę.
| Parametr zapytania | Opis |
|---|---|
include_url_paths | Wartość true zachowuje ścieżkę każdego adresu URL w eksporcie, na przykład punkt końcowy narzędzia. Domyślnie każdy adres URL jest skracany do hosta. Nazwy użytkowników, hasła i ciągi zapytań są usuwane z adresów URL w obu przypadkach |
Użyj include_url_paths=true, gdy zamierzasz odtworzyć agenta w innym miejscu,
ponieważ potrzebne są tam punkty końcowe narzędzi. Pozostaw tę opcję wyłączoną
w przypadku kopii, którą planujesz udostępnić.
Co zawiera plik ZIP
| Plik | Zawartość |
|---|---|
manifest.json | Format (thunderphone.agent-export/v1), uwzględnione elementy oraz lista omitted, która wskazuje wszystko, co pominięto, i dlaczego |
agent.json | Agent w formie zwracanej przez GET /v1/agents/{agent_id}, bez poświadczeń |
prompt.md | Aktywne instrukcje |
knowledge/index.json i pliki obok niego | Wiedza agenta. Każdy dokument jest oryginalnym plikiem, jeśli jest przechowywany, w przeciwnym razie zawiera wyodrębniony tekst |
numbers.json | Numery kierowane do tego agenta, przychodzące i wychodzące, wraz z przypiętą wersją lub wariantem, jeśli istnieje |
webhooks.json | Punkty końcowe webhooków przypisane do tego agenta, bez ich sekretów |
README.md | Opis każdego pliku |
Plik wiedzy większy niż 25 MB jest pomijany, podobnie jak wszystko powyżej
100 MB dla całego eksportu. Każdy taki plik jest wymieniony w manifest.json
wraz z punktem końcowym, który go pobiera,
GET /v1/knowledge/documents/{document_id}/original.
Co nigdy nie jest uwzględniane
- Wartości poświadczeń. Nagłówki narzędzia są wymienione tylko według nazwy. Wartości nagłówków są w ThunderPhone dostępne tylko do zapisu: żadna odpowiedź API ich nie zwraca, więc nie może ich zawierać żaden eksport. Wprowadzasz je ponownie po drugiej stronie. Dotyczy to poświadczeń, które ThunderPhone przechowuje jako poświadczenia. Twoje instrukcje i pliki wiedzy są kopiowane dokładnie tak, jak je napisano lub przesłano, więc jeśli klucz został kiedykolwiek wklejony do promptu lub dokumentu, znajduje się w pliku ZIP. Sprawdź go przed udostępnieniem.
- Historia połączeń i nagrania. Mają własne eksporty; zobacz Historia połączeń i nagrania.
- Historia wersji. Eksport zawiera agenta w jego aktualnej wersji aktywnej.
Wcześniejsze wersje pozostają wymienione pod adresem
GET /v1/agents/{agent_id}/versions. - Inni agenci, do których ten agent przekazuje połączenia. Wyeksportuj każdego z nich w ten sam sposób.
Przejście na inną platformę
Umiejętność migrate-off-thunderphone przeprowadza agenta programistycznego przez
migrację. Zainstaluj umiejętności ThunderPhone:
npx skills add thunderphone/skillsNastępnie poproś agenta programistycznego o przeniesienie agenta z ThunderPhone i podaj platformę docelową: LiveKit Agents, Pipecat, Vapi lub Retell. Umiejętność pobiera eksport, pyta o każde poświadczenie, odtwarza agenta na podstawie mapowania dla tej platformy docelowej i testuje go tam przed przeniesieniem numerów. Konwersja działa w agencie programistycznym przy użyciu własnych kluczy. ThunderPhone nigdy nie zapisuje danych na Twoim koncie na innej platformie.
Co zostaje przeniesione jako pliki mapowane przez umiejętność:
- Instrukcje, w tym współdzielone instrukcje i kroki.
- Narzędzia: ten sam punkt końcowy, metoda i schemat parametrów. Pole
request_formatkażdego narzędzia określa strukturę treści oczekiwaną przez punkt końcowy. - Numery przekierowania oraz ustawienia zakończenia połączenia i klawiatury numerycznej.
- Pliki wiedzy.
- Ustawienia poczty głosowej, ciszy i długości połączenia.
- Numery, na które agent odbiera połączenia i z których je wykonuje.
Co należy odtworzyć po drugiej stronie:
- Dostawcy mowy, modeli językowych i głosu. Wybierasz ich na platformie docelowej. Nic nie gwarantuje, że głos lub brzmienie połączenia będą takie same.
- Poświadczenia. Wartości nagłówków narzędzi i sekrety webhooków.
- Telefonia. Sposób kierowania numerów do agenta jest konfigurowany inaczej na każdej platformie.
- Kroki i przekazania. Na platformie docelowej z funkcją przepływów lub przekazań są one tam odtwarzane. W innych przypadkach umiejętność włącza kroki do instrukcji i informuje o tym.
- Ustawienia ThunderPhone bez odpowiednika. Ustawienia inteligencji, słyszenia i szybkości odpowiedzi, wbudowane narzędzia do e-maili i wiadomości tekstowych oraz ocena połączeń, podsumowania i etykiety wyników nie zostaną przeniesione, chyba że odtworzysz je samodzielnie.
- Podpisy żądań. ThunderPhone podpisuje wysyłane żądania narzędzi i webhooki. Inna platforma podpisuje je na własny sposób, więc punkt końcowy, który weryfikuje podpis ThunderPhone, wymaga nowej kontroli.
- Testowanie. Przetestuj odtworzonego agenta na platformie docelowej przed przeniesieniem numeru.
Pozostaw agenta ThunderPhone na miejscu, dopóki nowy nie przejdzie Twoich testów. To Twoja droga powrotna.
Numery telefonów
Przenoś numery na końcu, po tym jak nowy agent przejdzie testy.
- Numer u własnego operatora (połączenie VoIP)
pozostaje u tego operatora. Skieruj go na nową platformę w konsoli operatora.
Następnie wybierz Zwolnij przy numerze w ThunderPhone i pozostaw opcję
Anuluj również ten numer na moim koncie … niezaznaczoną: numer zostanie
odłączony od ThunderPhone i pozostanie na koncie operatora. Przez API
zwolnij go za pomocą
DELETE /v1/phone-numbers/{phone_number_id}?confirm=truei nie wysyłajrelease_at_provider. - Numer udostępniony przez ThunderPhone. Skontaktuj się z pomocą techniczną, zanim zwolnisz numer, który chcesz zachować. Zwolnienie numeru ThunderPhone jest trwałe: wraca on do puli i może zostać przydzielony innemu klientowi.
Historia połączeń i nagrania
Są one oddzielne od eksportu agenta.
- Połączenia.
GET /v1/calls/exportzwraca do 1 000 połączeń na żądanie jako CSV (metadane) lub JSON (z transkrypcjami). Filtruj wedługagent_idi przechodź przez historię stronami za pomocąstart_dateiend_date. Nagłówek odpowiedziX-Truncatedma wartośćtrue, gdy pasuje więcej połączeń niż zostało zwróconych. - Nagrania.
GET /v1/calls/{call_id}/audiozwraca krótkotrwały adres URL do nagrania jednego połączenia. Nie ma zbiorczego pobierania nagrań.
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.jsonIle to kosztuje
Nic. Eksport agentów, eksport połączeń i pobieranie nagrań są bezpłatne. ThunderPhone działa w modelu płatności za użycie, bez subskrypcji i opłaty za stanowisko. Numer ThunderPhone przestaje generować opłaty po jego zwolnieniu.
Po odejściu
Nie ma określonego czasu trwania umowy. Możesz zakończyć umowę, wysyłając pisemne powiadomienie na adres legal@thunderphone.com z administracyjnego adresu e-mail konta lub innym weryfikowalnym kanałem. Brak płatności może zawiesić usługę; sam w sobie nigdy nie kończy umowy ani nie powoduje usunięcia Danych Klienta. W kwestii danych Regulamin stanowi: „Po formalnym rozwiązaniu umowy Dostawca zwróci lub usunie Dane Klienta w ciągu sześćdziesięciu (60) dni, z zastrzeżeniem praw Klienta do eksportu, cykli tworzenia kopii zapasowych, blokad prawnych, okresów przechowywania wymaganych prawem, DPA oraz wszelkich zawartych umów BAA”.
Pełny tekst znajduje się w Regulaminie, w sekcji Okres świadczenia usług; zawieszenie; rozwiązanie umowy. Regulamin ma charakter nadrzędny; to jest podsumowanie.