Podstawowe pojęcia

Mapa wszystkich elementów platformy — do czego służy każdy obiekt, gdzie znajduje się w panelu i które API go obsługuje.

ThunderPhone to kompletna platforma do tworzenia, uruchamiania i ulepszania agentów głosowych AI. Ta strona jest mapą: każde pojęcie, które napotkasz, opisano w osobnej krótkiej sekcji wraz z powierzchnią w panelu i obsługującym je API. Przejrzyj ją raz, a potem wracaj, gdy potrzebujesz wyjaśnienia terminu.

Pasek boczny panelu odzwierciedla tę strukturę:

Organizacje#

Organizacja jest jednostką dzierżawy. Każdy inny zasób — agenci, numery telefonów, połączenia, klucze — należy do dokładnie jednej organizacji. Twoje konto może należeć do wielu organizacji; każda ma własne saldo, własne klucze i własną listę członków.

Klucz API sk_live_, który tworzysz w Organizacja → Klucze, jest powiązany z jedną organizacją. To powiązanie sprawia, że REST API jest tak proste: nigdy nie umieszczasz identyfikatora organizacji w ścieżkach URL, ponieważ klucz już ją identyfikuje.

W panelu: przełącznik organizacji (w stopce paska bocznego) oraz ustawienia Organizacja — karty Moje konto, Ogólne, Klucze, Alerty, Ustawienia rozliczeń i Historia rozliczeń. Zobacz opis ustawień organizacji.

W API: /v1/orgs, /v1/developer/api-keys.

Agenci#

Agent to konfiguracja AI obsługująca połączenie. Obejmuje:

• Prompt, który określa, co agent mówi i jak się zachowuje — w tym działania podczas połączenia, takie jak przekazywanie połączeń, naciskanie klawiszy i rozłączanie, które są zwykłymi liniami promptu, a nie osobną konfiguracją.
• Poziom silnika (spark, bolt, storm-*): Spark jest zoptymalizowany pod kątem kosztów, Bolt pod kątem szybkości, a Storm pod kątem inteligencji przy złożonych promptach.
• Głos wraz z językiem podstawowym i opcjonalnymi dodatkowymi językami — agent automatycznie przełącza się, gdy rozmówca zmienia język. Zobacz Obsługiwane języki.
• Dołączone możliwości: połączone aplikacje, połączenia API, bazy wiedzy, serwery MCP i wbudowane narzędzia funkcji.
• Ustawienia zachowania: kolejność wypowiedzi, tryb potwierdzania, ścieżka w tle, limit czasu oczekiwania.

Edycje w kreatorze zapisują się automatycznie jako wersja robocza; nic nie zostaje opublikowane, dopóki nie klikniesz Wdróż. Każde wdrożenie jest zapisywane jako migawka na karcie Historia kreatora, dzięki czemu możesz sprawdzić i przywrócić dowolną poprzednią wersję.

W panelu: Agenci głosowi → kreator agenta (/dashboard/agents). Zobacz Utwórz pierwszego agenta głosowego.

W API: /v1/agents — CRUD, duplikowanie, przekazywanie, historia wersji i narzędzia pomocnicze promptów.

Głosy#

Biblioteka głosów zawiera głosy, których może używać agent, ich próbki do odsłuchania, obsługiwane języki, grupy według płci i akcentu oraz wszelkie dopłaty za głos lub język premium. Płatny próbnik może wygenerować własną frazę o długości od 1 do 500 znaków przed dokonaniem wyboru.

Uprawnione organizacje mogą także tworzyć głosy niestandardowe na podstawie krótkiej próbki WAV lub MP3. Głosy niestandardowe mają limit i asynchroniczny status tworzenia; gdy są gotowe, pojawiają się w tym samym selektorze agenta co głosy z biblioteki.

W panelu: Głosy (/dashboard/voices). Zobacz Biblioteka głosów i głosy niestandardowe.

W API: /v1/voices, próbki głosów i głosy niestandardowe.

Numery telefonów#

Numer telefonu należy do organizacji i kieruje połączenia przychodzące do agenta (oraz może obsługiwać połączenia wychodzące). Dwa źródła:

• Numery ThunderPhone — rzeczywiste numery amerykańskie udostępniane z puli ThunderPhone, aktywne w kilka sekund, $1/miesiąc plus 1¢/minutę dopłaty. Początkowo obsługują tylko połączenia przychodzące. Administrator organizacji może zażądać połączeń wychodzących na stronie Numery telefonów; ThunderPhone ręcznie rozpatruje każde zgłoszenie, a zatwierdzone numery mogą wykonywać połączenia i prowadzić kampanie. Organizacja może domyślnie posiadać 25 numerów.
• Numery VoIP — dodawane od własnego dostawcy przez połączenie VoIP. Twilio i Telnyx łączą się bezpośrednio za pomocą klucza API (Telnyx oferuje również przewodnik konfiguracji nowego konta); SignalWire, Vonage, Plivo oraz każdy inny trunk SIP łączą się przez konfigurację SIP, ręczną konfigurację SIP. Po zaimportowaniu i zweryfikowaniu numery VoIP obsługują połączenia przychodzące i wychodzące.

W każdym wierszu numeru możesz ustawić tryb kierowania, wybrać agenta dla połączeń przychodzących i nadać numerowi etykietę.

W panelu: Numery telefonów (/dashboard/phone-numbers). Zobacz Uzyskaj numer telefonu.

W API: /v1/phone-numbers, /v1/voip-connections, /v1/phone-number-labels.

Połączenia#

Każde połączenie przychodzące, połączenie wychodzące, symulacja i sesja widżetu stają się dziennikiem połączenia. Połączenie zawiera pełną transkrypcję z oznaczeniami ról, uporządkowaną historię tur (w tym wywołania narzędzi), nagranie, łączny koszt rozliczenia oraz opcjonalną ocenę AI i raporty problemów.

Gdy połączenie jest na żywo, możesz je otworzyć i nasłuchiwać — dołączasz po cichu i nikt uczestniczący w połączeniu Cię nie słyszy. Po rozpoczęciu nasłuchiwania możesz szeptać: wpisz instrukcję, która trafia bezpośrednio do agenta w trakcie połączenia; rozmówca nigdy jej nie słyszy, a agent stosuje ją na żywo.

W panelu: Historia połączeń (/dashboard/call-history) dla archiwum i szczegółów poszczególnych połączeń; Na żywo dla połączeń w toku. Zobacz Przeglądaj, odsłuchuj i wspieraj swoje połączenia.

W API: /v1/calls — lista, transkrypcja, historia, dźwięk, ocena, eksport; /v1/issue-reports.

Portale klientów#

Portal klienta to oznaczony marką widok historii połączeń tylko do odczytu dla klienta zewnętrznego. Administratorzy organizacji wybierają agentów, których połączenia mają być wyświetlane, dodają zatwierdzone adresy e-mail widzów, przesyłają logo i kolor akcentu oraz opcjonalnie weryfikują domenę niestandardową. Widzowie portalu mogą sprawdzać szczegóły połączeń, transkrypcje i dostępne nagrania bez otrzymywania dostępu do panelu.

W panelu: Portale klientów (/dashboard/client-portals). Zobacz Portale klientów.

W API: /v1/client-portals dla powierzchni zarządzania administratora.

Widżety internetowe#

Widżet internetowy umożliwia odwiedzającym Twoją witrynę rozmowę z agentem za pomocą mikrofonu — bez potrzeby podawania numeru telefonu. Uwierzytelnia się za pomocą klucza publicznego (pk_live_...), którego przeglądarki mogą używać wyłącznie z dozwolonych domen, dzięki czemu jest bezpieczny w kodzie po stronie klienta. Lista domen nie służy do uwierzytelniania, a ustawienia sesji, które może wysłać strona, są wyłączone, dopóki nie zezwolisz na nie dla klucza.

Klucze działają w jednym z dwóch trybów: agent (statycznie przypisany do jednego agenta) lub webhook (Twój serwer wybiera konfigurację dla każdego odwiedzającego — zobacz Dynamiczna konfiguracja dla każdego połączenia). Sesje widżetu korzystają z tej samej infrastruktury połączeń co rozmowy telefoniczne.

W panelu: Widżety internetowe (/dashboard/web-widgets) — twórz widżety, ustawiaj tryb i agenta, zarządzaj dozwolonymi domenami oraz kopiuj fragment kodu do osadzenia. Zobacz Utwórz widżet internetowy.

W API: /v1/publishable-key, /v1/mic-session oraz dokumentacja SDK widżetu.

Bazy wiedzy#

Baza wiedzy to zbiór dokumentów, które agent może przeszukiwać w trakcie rozmowy, aby oprzeć na nich swoje odpowiedzi — przesyłaj pliki, wklejaj tekst lub importuj strony internetowe według adresu URL, a następnie przypisz bazę wiedzy do agenta w kreatorze. Agent wyszukuje w niej informacje za pomocą wbudowanego narzędzia wyszukiwania, gdy wymaga tego rozmowa.

W panelu: Wiedza (/dashboard/knowledge) dla biblioteki dokumentów; sekcja Wiedza w kreatorze, aby przypisać bazę do agenta. Zobacz Dodaj bazę wiedzy do agenta.

Połączenia#

Połączenia umożliwiają agentom dostęp do świata zewnętrznego. Cztery rodzaje, jedna grupa na pasku bocznym:

• Aplikacje (/dashboard/app-connections) — połączenia OAuth ze Slack, HubSpot, Salesforce, Google Calendar, Google Sheets i Cal.com. Połącz raz, a następnie włączaj dla każdego agenta narzędzia dla poszczególnych operacji (wyślij wiadomość Slack, utwórz lub zaktualizuj kontakt HubSpot, zarezerwuj termin Cal.com…). Zobacz Połącz aplikacje.
• API (/dashboard/api-connections) — przekształć dowolne API HTTP w działanie agenta. Wklej polecenie cURL, a kreator AI przygotuje definicję narzędzia, lub utwórz ją ręcznie; przycisk Żądanie testowe wykonuje połączenie w piaskownicy przed wdrożeniem. Zobacz Połączenia API — panelową wersję /v1/integrations.
• MCP (/dashboard/mcp-connections) — dodaj serwer Model Context Protocol według adresu URL i pozwól agentowi używać udostępnianych przez niego narzędzi. Zobacz Dodaj serwer MCP.
• VoIP (/dashboard/voip-connections) — dane uwierzytelniające dostawcy do korzystania z własnych numerów telefonów. Zobacz Połącz dostawcę VoIP.

ThunderPhone udostępnia również własny punkt końcowy MCP, dzięki któremu zewnętrzny klient MCP może wyświetlać listę agentów, sprawdzać połączenia i transkrypcje oraz inicjować połączenia. Zobacz Użyj ThunderPhone jako serwera MCP.

W API: /v1/integrations, /v1/mcp-servers oraz /v1/voip-connections; zobacz także Utwórz integrację narzędzia.

Kampanie#

Kampania wykonuje połączenia wychodzące na dużą skalę: prześlij plik CSV z kontaktami, wybierz agenta i numer, z którego będą wykonywane połączenia, a następnie ustaw okno wykonywania połączeń (dni i godziny z uwzględnieniem strefy czasowej), współbieżność oraz zasady ponawiania prób (maksymalną liczbę prób i wyniki — brak odpowiedzi, poczta głosowa, niepowodzenie — dla których próba ma zostać ponowiona). Kampania przetwarza listę i rejestruje każde połączenie w Historii połączeń.

W panelu: Kampanie (/dashboard/campaigns). Zobacz Uruchom kampanię połączeń wychodzących.

Dla jednorazowych połączeń programistycznych: API połączeń wychodzących.

Monitorowanie na żywo#

Widok Na żywo pokazuje wszystkie połączenia w toku w organizacji i umożliwia otwarcie dowolnego z nich, aby nasłuchiwać i szeptać w czasie rzeczywistym. To obszar nadzoru: obserwuj, jak nowy prompt obsługuje pierwszy rzeczywisty ruch, lub monitoruj trwającą kampanię.

W panelu: Na żywo (/dashboard/live). Zobacz Obserwowanie i nadzorowanie połączeń na żywo.

Symulacje#

Symulacja to rozmówca AI prowadzący rzeczywistą rozmowę z Twoim agentem — ta sama ścieżka telefoniczna, rzeczywisty transkrypt, rzeczywista ocena — dzięki czemu możesz testować przed wdrożeniem (i po nim). Wskaż agenta lub numer telefonu, samodzielnie opisz scenariusz rozmówcy albo wygeneruj scenariusze za pomocą AI na podstawie promptu agenta (w tym przypadki brzegowe, jeśli o nie poprosisz), a następnie obserwuj połączenie na żywo.

Scenariusze są grupowane w zestawy, które ustalają minimalny współczynnik zaliczeń i mogą blokować wydania w CI; regresje względem zaakceptowanej wartości bazowej są raportowane dla każdego scenariusza.

W panelu: Symulacje (/dashboard/simulations) oraz przycisk Symulacja w kreatorze agenta. Zobacz Symulowanie połączenia.

W API: /v1/test-calls oraz uruchamianie zestawów — zobacz Kompleksowe testowanie agenta.

Zestawy walidacyjne#

Zestaw walidacyjny przekształca rzeczywiste momenty rozmów w powtarzalne, jednokrotne testy regresji. Każdy przykład utrwala kontekst rozmowy, istotne nagranie audio rozmówcy, pierwotną odpowiedź i oczekiwane zachowanie. Odtworzenia są uruchamiane względem bieżącej wersji roboczej agenta bez wykonywania kolejnego połączenia, a okno wdrażania może pokazać, czy najnowsze uruchomienie nadal odpowiada tej wersji roboczej.

W panelu: Zestawy walidacyjne (/dashboard/validation) dla zbioru danych organizacji oraz karta Walidacja w kreatorze agenta dla uruchomień. Zobacz Zestawy walidacyjne.

W API: /v1/validation-sets oraz punkty końcowe odtwarzania agenta/przykładu na tej samej stronie referencyjnej.

Eksperymenty#

Eksperyment przeprowadza testy A/B konfiguracji agentów na rzeczywistym ruchu: zdefiniuj warianty (różne prompty, silniki lub ustawienia), podziel między nie ruch i porównaj wyniki dla każdego wariantu. Użyj go zamiast ręcznie tworzyć logikę segmentów w webhooku.

W panelu: Eksperymenty (/dashboard/experiments) oraz karta A/B w kreatorze agenta. Zobacz Eksperymenty (testy A/B).

Problemy#

Problem to oznaczony problem w określonym połączeniu — zgłoszony przez osobę dokonującą przeglądu lub wykryty przez ocenę AI. Problemy zawierają poziom ważności, źródło i status, a strona Problemy jest kolejką do segregacji: filtruj, analizuj problematyczne połączenie i śledź poprawki.

W panelu: Problemy (/dashboard/issues) oraz oznaczanie dla poszczególnych połączeń w Historii połączeń. Zobacz Segregacja problemów.

W API: /v1/issue-reports.

Raporty#

Raport odpowiada na pytanie zadane w języku naturalnym dotyczące danych o połączeniach ("Jakie były trzy najczęstsze powody, dla których rozmówcy prosili w zeszłym tygodniu o rozmowę z człowiekiem?") za pomocą analizy napisanej przez AI, ograniczonej do wybranych przez Ciebie agentów i zakresu dat.

W panelu: Raporty (/dashboard/reports). Zobacz Raporty.

Obserwowalność#

Obserwowalność to obszar metryk: liczba połączeń, wyniki i jakość w czasie, z możliwością filtrowania według agenta i przedziału czasowego oraz eksportu do dalszej analizy.

W panelu: Obserwowalność (/dashboard/observability). Zobacz Obserwowalność.

Alerty#

Reguła alertu monitoruje metrykę (współczynnik powodzeń, współczynnik niepowodzeń, średni wynik, liczbę połączeń, regresje zestawów) w przedziale czasowym i uruchamia się, gdy przekroczy określony próg. Powiadomienia są wysyłane e-mailem i do Slacka oraz wywołują zdarzenie alert.triggered dla Twoich punktów końcowych webhooków.

W panelu: Organizacja → Alerty. Zobacz Alerty.

Webhooki#

ThunderPhone wysyła na Twój serwer webhooki HTTP POST, gdy podczas połączenia i po jego zakończeniu wystąpią określone zdarzenia. Dwa modele dostarczania:

• Punkty końcowe webhooków (zalecane): zarządzaj wieloma adresami URL w /v1/developer/webhook-endpoints, korzystając z sekretów dla poszczególnych punktów końcowych i subskrypcji zdarzeń dla poszczególnych punktów końcowych.
• Starszy webhook z jednym adresem URL: jeden adres URL na organizację. Zarządzany w /v1/webhook lub w Organizacja → Ogólne. Zachowany dla zgodności wstecznej.

Zdarzenia dzielą się na dwie klasy:

• Zdarzenia blokujące wymagają, aby serwer odpowiedział konfiguracją, która kształtuje trwające połączenie — są to zdarzenia połączeń przychodzących (telephony.incoming / web.incoming). Połączenie telefoniczne czeka do 13 sekund, wliczając jedną ponowną próbę, a sesja widżetu 10 sekund. Nie ma agenta zastępczego: bez użytecznej konfiguracji połączenie telefoniczne zostaje zakończone, a sesja widżetu kończy się niepowodzeniem.
• Zdarzenia nieblokujące to powiadomienia typu „wyślij i zapomnij”, ponawiane z wykładniczo rosnącym odstępem — zobacz semantykę dostarczania.

Każde żądanie zawiera podpis HMAC-SHA256 z sygnaturą czasową w nagłówku X-ThunderPhone-Signature-V2, a także starszy podpis X-ThunderPhone-Signature obejmujący wyłącznie treść. Zobacz weryfikację podpisu.

Narzędzia funkcji#

Narzędzie funkcji to punkt końcowy HTTP, który Twój agent może wywołać w trakcie rozmowy. Przekazujesz ThunderPhone schemat funkcji w stylu OpenAI wraz z adresem URL punktu końcowego; agent decyduje, kiedy go wywołać, a ThunderPhone wykonuje podpisane żądanie HTTP ze swoich serwerów i przekazuje wynik z powrotem agentowi.

Agenci mają również wbudowane możliwości połączeń — przekazywanie połączenia, wysyłanie danych z klawiatury (DTMF), kończenie połączenia, oczekiwanie na linii — które włączasz zwykłymi liniami w promptach zamiast definicjami narzędzi.

W panelu: sekcja Połączenia API w kreatorze (zobacz Połączenia).

W API: /v1/integrations oraz specyfikacja narzędzi funkcji.

Zespół i role#

Każda organizacja ma listę członków z dwiema rolami: Członkowie tworzą i obsługują agentów; Administratorzy zarządzają również zespołem i rozliczeniami. Zaproś przez e-mail — zaproszenia wygasają po 7 dniach i można je cofnąć; menu ⋯ w wierszu członka zmienia role lub usuwa daną osobę. Logowanie jednokrotne można skonfigurować dla całej organizacji — zobacz SSO.

W panelu: Organizacja → Ogólne. Zobacz Zaproś swój zespół.

W API: /v1/members, /v1/invites.

Rozliczenia#

ThunderPhone działa w modelu przedpłaconym. Każda organizacja ma saldo w USD; połączenia obciążają je według stawki minutowej agenta (poziom silnika oraz dopłaty — kreator pokazuje na bieżąco całkowitą stawkę podczas zmiany ustawień, a wybrane dodatkowe języki dodają 3¢/min). Gdy saldo osiągnie zero, połączenia przychodzące są odrzucane, a połączenia wychodzące zwracają 402 Payment Required.

Doładuj saldo ręcznie lub włącz automatyczne doładowanie z progiem salda, kwotą doładowania i opcjonalnym miesięcznym limitem wydatków — aby połączenie nigdy nie zakończyło się w środku zdania.

W panelu: Organizacja → Ustawienia rozliczeń oraz Historia rozliczeń. Zobacz Dodaj środki i włącz automatyczne doładowanie oraz pełne informacje o cenach.

W API: /v1/billing.

Copilot w aplikacji#

Panel zawiera wbudowanego copilota — zapytaj go „jak zrobić X”, a odpowie na podstawie tej dokumentacji, zaproponuje instrukcje krok po kroku, które podświetlają rzeczywiste elementy sterujące, i może ponownie odtworzyć dowolny z przewodników. To najszybszy sposób na znalezienie elementu sterującego wspomnianego na tej stronie. Zobacz Zapytaj copilota w aplikacji.

Łączenie wszystkiego w całość#