ThunderPhone v3 już działa.Uruchom samodzielnie, od 2¢/min.Przeczytaj komunikat

Using the dashboard

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ć

CoJak
Agent: instrukcje, narzędzia, numery przekierowań, kroki, ustawienia, routing numerów i webhookiEksport agenta, jedno archiwum zip na agenta
Pliki wiedzy agentaW eksporcie agenta
Historia połączeń i transkrypcjeEksport połączeń, do 1000 połączeń na żądanie
NagraniaJedno nagranie na żądanie, dla każdego połączenia
Numery telefonów u własnego operatoraNigdy 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
curl 'https://api.thunderphone.com/v1/agents/12/export' \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -o agent-12.zip

Plik 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 zapytaniaOpis
include_url_pathsWartość 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

PlikZawartość
manifest.jsonFormat (thunderphone.agent-export/v1), uwzględnione elementy oraz lista omitted, która wskazuje wszystko, co pominięto, i dlaczego
agent.jsonAgent w formie zwracanej przez GET /v1/agents/{agent_id}, bez poświadczeń
prompt.mdAktywne instrukcje
knowledge/index.json i pliki obok niegoWiedza agenta. Każdy dokument jest oryginalnym plikiem, jeśli jest przechowywany, w przeciwnym razie zawiera wyodrębniony tekst
numbers.jsonNumery kierowane do tego agenta, przychodzące i wychodzące, wraz z przypiętą wersją lub wariantem, jeśli istnieje
webhooks.jsonPunkty końcowe webhooków przypisane do tego agenta, bez ich sekretów
README.mdOpis 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/skills

Nastę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_format każ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=true i nie wysyłaj release_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/export zwraca do 1 000 połączeń na żądanie jako CSV (metadane) lub JSON (z transkrypcjami). Filtruj według agent_id i przechodź przez historię stronami za pomocą start_date i end_date. Nagłówek odpowiedzi X-Truncated ma wartość true, gdy pasuje więcej połączeń niż zostało zwróconych.
  • Nagrania. GET /v1/calls/{call_id}/audio zwraca krótkotrwały adres URL do nagrania jednego połączenia. Nie ma zbiorczego pobierania nagrań.
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

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

Powiązane