Wprowadzenie
Dokumentacja dotycząca uruchamiania produkcyjnych agentów głosowych w rzeczywistych rozmowach telefonicznych i osadzalnych widżetach internetowych: przewodniki szybkiego startu, poradniki oraz pełna dokumentacja API ThunderPhone.
ThunderPhone umożliwia tworzenie głosowych agentów AI, którzy wykonują i odbierają prawdziwe połączenia telefoniczne oraz obsługują rozmowy inicjowane mikrofonem na Twojej stronie. Dokumentacja jest podzielona na cztery karty:
Szybkie starty, pojęcia i instrukcje dotyczące panelu oraz API. Zacznij tutaj, jeśli dopiero zaczynasz.
Każdy endpoint, pole żądania i format odpowiedzi.
Osadzany widżet internetowy — komponent React, hook headless i tag skryptu CDN.
Zdarzenia w czasie rzeczywistym, podpisywanie i semantyka dostarczania.
Co możesz zbudować
Odbieraj połączenia na należący do Ciebie numer za pomocą agenta AI, który realizuje Twój prompt, korzysta z Twoich narzędzi i w razie potrzeby przekazuje rozmowę ludziom.
Wykonuj programowo połączenia z poziomu kodu — ankiety, działania następcze lub procesy potwierdzania.
Dodaj nasz osadzany widżet internetowy do swojej strony, aby klienci mogli kliknąć i rozmawiać. Numer telefonu nie jest wymagany.
Uruchamiaj przygotowane scenariusze przez swojego agenta w partiach, aby wykrywać regresje, zanim usłyszą je klienci.
Dwa sposoby rozpoczęcia
W panelu (zalecane dla pierwszego agenta) — zarejestruj się, a panel przeprowadzi Cię przez pięcioetapowy kreator konfiguracji: utworzenie agenta, konfigurację rozliczeń, dodanie numeru telefonu, uruchomienie symulacji i sprawdzenie połączenia. Szybki start w panelu odzwierciedla ten kreator krok po kroku.
Z terminala — szybki start API wykonuje to samo pierwsze połączenie za pomocą czterech wywołań REST.
- Przejrzyj pojęcia
Pojęcia — mapa każdego obiektu, z którym będziesz pracować, oraz informacja, gdzie znajduje się on w panelu.
- Uruchom szybki start
Szybki start w panelu lub szybki start API — wykonaj pierwsze połączenie z agentem AI.
- Wybierz przewodnik
Skorzystaj z przewodnika instruktażowego dla swojego scenariusza lub przejdź do dokumentacji API.
Przeglądaj przewodniki
Utwórz agenta, zasil konto, uzyskaj numer, symuluj i sprawdzaj połączenia.
Aplikacje OAuth, niestandardowe API, serwery MCP i dostawcy VoIP.
Raporty, obserwowalność, eksperymenty, problemy i alerty.
Zaproszenia i role, klucze API, bezpieczeństwo i SSO.
Bazowy adres URL
https://api.thunderphone.com/v1
Uwierzytelnianie używa standardowego schematu OAuth 2.0 Bearer z kluczem API organizacji
sk_live_. Twój klucz automatycznie identyfikuje docelową
organizację — ścieżki URL nie zawierają identyfikatora organizacji. Szczegóły znajdziesz w sekcji
Uwierzytelnianie.