Alapok
Kapcsolattartás
Élő monitorozás és kimenő
kampányok.
Kapcsolatok
Alkalmazások, API-k, MCP-szerverek és VoIP-szolgáltatók, amelyeket az
ügynökei használhatnak.
Minőség és tesztelés
Szervezet
Eseménykezelés
Webhookok és függvényeszközök a
saját kódjához.
Szervezetek
A szervezet a bérlői egység. Minden más erőforrás — ügynökök, telefonszámok, hívások, kulcsok — pontosan egy szervezethez tartozik. Az Ön fiókja több szervezethez is tartozhat; mindegyik saját egyenleggel, saját kulcsokkal és saját taglistával rendelkezik. A Szervezet → Kulcsok alatt létrehozottsk_live_ API-kulcs
egy szervezethez van kötve. Ez a kötés teszi a REST API-t ennyire
egyszerűvé: soha nem kell szervezeti azonosítót megadnia az URL-útvonalakban, mert a kulcsa
már azonosítja azt.
A vezérlőpulton: a szervezetváltó (az oldalsáv láblécében) és a
Szervezet beállításai — Általános, Kulcsok, Riasztások, Számlázási
beállítások és Számlázási előzmények lapok.
Az API-ban: /v1/orgs,
/v1/developer/api-keys.
Ügynökök
Az ügynök az a mesterségesintelligencia-konfiguráció, amely egy hívást kezel. Tartalma:- Egy prompt, amely meghatározza, mit mond az ügynök és hogyan viselkedik — beleértve az olyan hívásműveleteket, mint az átirányítások, a billentyűzetnyomások és a hívásbontások, amelyek külön konfiguráció helyett egyszerű prompthivatkozások.
- Egy motorcsomag (
spark,bolt,storm-*): a Spark költséghatékonyságra, a Bolt sebességre, a Storm pedig összetett promptok esetén intelligenciára van optimalizálva. - Egy hang, valamint egy elsődleges nyelv és opcionális további nyelvek — az ügynök automatikusan vált, amikor a hívó nyelvet vált. Lásd: Támogatott nyelvek.
- Csatolt képességek: csatlakoztatott alkalmazások, API-kapcsolatok, tudásbázisok, MCP-szerverek és beágyazott függvényeszközök.
- Viselkedési beállítások: beszédsorrend, visszaigazolási mód, háttérhang, várakoztatási időkorlát.
/dashboard/agents). Lásd:
Az első hangalapú AI-ügynök létrehozása.
Az API-ban: /v1/agents — CRUD,
duplikálás, átirányítás, verzióelőzmények és promptsegédletek.
Telefonszámok
Egy telefonszám egy szervezethez tartozik, és a bejövő hívásokat egy ügynökhöz irányítja (valamint kimenő hívásokat is kezelhet). Két forrás áll rendelkezésre:- Demószámok — valódi amerikai számok, amelyeket a ThunderPhone készletéből biztosítunk, és másodpercek alatt aktiválódnak. Csak bejövő hívásokhoz használhatók, rövid szóbeli tájékoztatóval fogadják a hívásokat, és a vezérlőpult szervezetenként legfeljebb 10-et engedélyez belőlük. Első teszteléshez ideálisak; éles használatra nem.
- VoIP-számok — saját szolgáltatótól hozhatók be egy VoIP-kapcsolaton keresztül. A Twilio és a Telnyx közvetlenül csatlakozik (a Telnyx irányított beállítást kínál); a SignalWire és a Vonage hamarosan érkezik — jelenleg manuális SIP-konfiguráción keresztül érheti el őket, amely bármilyen SIP-trunköt elfogad. Az importálás és ellenőrzés után a VoIP-számok támogatják a bejövő és kimenő hívásokat is.
/dashboard/phone-numbers).
Lásd: Telefonszám beszerzése.
Az API-ban: /v1/phone-numbers,
/v1/voip-connections,
/v1/phone-number-labels.
Hívások
Minden bejövő hívás, kimenő hívás, szimuláció és widgetmunkamenet hívásnaplóvá válik. Egy hívás tartalmazza a teljes, szerepkörjelölésekkel ellátott leiratot, a strukturált fordulóelőzményeket (beleértve az eszközhívásokat), a felvételt, a számlázási végösszeget, valamint az opcionális AI-alapú értékelési és problémariportokat. Amíg egy hívás élő, megnyithatja és belehallgathat — Ön némán csatlakozik, és a hívásban részt vevők nem hallják Önt. Belehallgatás közben súghat is: írjon be egy utasítást, amely hívás közben közvetlenül az ügynökéhez kerül; a hívó fél ezt soha nem hallja, az ügynök pedig valós időben követi. A vezérlőpulton: Híváselőzmények (/dashboard/call-history) az
archívumhoz és a hívásonkénti részletekhez; Élő a folyamatban lévő
hívásokhoz. Lásd:
Hívások áttekintése, belehallgatás és iránymutatás.
Az API-ban: /v1/calls — lista, leirat,
előzmények, hanganyag, értékelés, exportálás;
/v1/issue-reports.
Webes widgetek
A webes widget mikrofonalapú beszélgetést biztosít webhelye látogatóinak egy ügynökkel — nincs szükség telefonszámra. Egy publikálható kulccsal (pk_live_...) hitelesít, amely kizárólag az engedélyezett domainekről
használható, ezért biztonságosan alkalmazható kliensoldali kódban.
A kulcsok két mód egyikében működnek: agent (statikusan egy ügynökhöz kötve)
vagy webhook (a szervere látogatónként választja ki a konfigurációt — lásd:
Dinamikus hívásonkénti konfiguráció). A widget-
munkamenetek ugyanazon a hívásinfrastruktúrán keresztül működnek, mint a
telefonhívások.
A vezérlőpulton: Webes widgetek (/dashboard/web-widgets) —
hozzon létre widgeteket, állítsa be a módot és az ügynököt, kezelje az
engedélyezett domaineket, és másolja ki a beágyazási kódrészletet. Lásd:
Webes widget létrehozása.
Az API-ban: /v1/publishable-key,
/v1/mic-session, valamint a
Widget SDK dokumentációja.
Tudásbázisok
A tudásbázis olyan dokumentumok gyűjteménye, amelyekben ügynöke hívás közben kereshet, hogy megalapozza válaszait — töltsön fel fájlokat közvetlenül, vagy importáljon a Google Drive-ból, majd kapcsolja a tudásbázist egy ügynökhöz a szerkesztőben. Az ügynök a beépített keresőeszközzel kérdezi le, amikor a beszélgetés ezt igényli. A vezérlőpulton: Tudás (/dashboard/knowledge) a dokumentumtárhoz;
a szerkesztő Tudás szakasza egy tudásbázis ügynökhöz kapcsolásához. Lásd:
Adjon tudásbázist az ügynökének.
Kapcsolatok
A kapcsolatok révén érik el az ügynökök a külvilágot. Négy típus, egy oldalsáv-csoport:- Alkalmazások (
/dashboard/app-connections) — OAuth-kapcsolatok a Slackhez, HubSpothoz, Salesforce-hoz, Google Calendarhoz, Google Sheetshoz és Cal.comhoz. Csatlakoztassa őket egyszer, majd kapcsolja be műveletenként az eszközöket (Slack-üzenet küldése, HubSpot-kapcsolat létrehozása vagy frissítése, Cal.com-időpont foglalása…) bármely ügynökhöz. Lásd: Alkalmazások csatlakoztatása. - API-k (
/dashboard/api-connections) — alakítson bármely HTTP API-t ügynökműveletté. Illesszen be egy cURL-parancsot, és az AI-varázsló elkészíti az eszköz definíciójának vázlatát, vagy hozza létre kézzel; a Tesztkérés gomb élesítés előtt tesztkörnyezetbeli hívást indít. Lásd: API-kapcsolatok — a/v1/integrationsirányítópulti felülete. - MCP (
/dashboard/mcp-connections) — adjon hozzá URL alapján egy Model Context Protocol-szervert, és engedje, hogy az ügynök használja az általa biztosított eszközöket. Lásd: MCP-szerver hozzáadása. - VoIP (
/dashboard/voip-connections) — szolgáltatói hitelesítő adatok a saját telefonszámok használatához. Lásd: VoIP-szolgáltató csatlakoztatása.
/v1/integrations és
/v1/voip-connections; lásd még:
Eszközintegráció létrehozása.
Kampányok
Egy kampány nagy léptékben indít kimenő hívásokat: töltsön fel egy névjegyeket tartalmazó CSV-fájlt, válassza ki az ügynököt és a hívószámot, majd állítsa be a hívási időablakot (napok és órák, időzónakezeléssel), a párhuzamosságot és az újrapróbálkozási szabályzatot (a próbálkozások maximális száma és az újrapróbálkozást kiváltó kimenetek — nincs válasz, hangposta, sikertelen). A kampány végighalad a listán, és minden hívást rögzít a Híváselőzményekben. Az irányítópulton: Kampányok (/dashboard/campaigns). Lásd:
Kimenő hívási kampány futtatása.
Egyszeri, programozott hívásokhoz: a
kimenő hívások API-ja.
Élő monitorozás
Az Élő nézet a szervezeten belüli összes folyamatban lévő hívást mutatja, és lehetővé teszi bármelyik megnyitását, hogy valós időben belehallgathasson és súghasson. Ez a felügyeleti felület: figyelje, ahogy egy új prompt megkapja az első valós forgalmát, vagy tartsa szemmel a futó kampányt. Az irányítópulton: Élő (/dashboard/live). Lásd:
Élő hívások figyelése és felügyelete.
Szimulációk
Egy szimuláció során egy AI-hívó valós beszélgetést folytat az Ön ügynökével — ugyanazon a telefonos útvonalon, valós leirattal és valós értékeléssel —, így élesítés előtt (és után) is tesztelhet. Irányítsa egy ügynökre vagy telefonszámra, írja meg saját maga a hívói forgatókönyvet, vagy generáljon forgatókönyveket AI-val az ügynök promptja alapján (kérésre a szélsőséges eseteket is beleértve), majd kövesse élőben a hívást. A forgatókönyvek csomagokba rendezhetők, amelyek minimális sikerességi arányt rögzítenek, és a CI-ben korlátozhatják a kiadásokat; az elfogadott alapállapothoz viszonyított regressziók forgatókönyvenként jelennek meg. Az irányítópulton: Szimulációk (/dashboard/simulations), valamint az
ügynökszerkesztőben található Szimuláció gomb. Lásd:
Hívás szimulálása.
Az API-ban: /v1/test-calls és a
csomagfuttató — lásd: Ügynök teljes körű tesztelése.
Kísérletek
Egy kísérlet A/B-teszteli az ügynökkonfigurációkat élő forgalomban: határozzon meg változatokat (eltérő promptokat, motorokat vagy beállításokat), ossza fel közöttük a forgalmat, és hasonlítsa össze a változatonkénti eredményeket. Használja ezt a webhookban kézzel kialakított bucketlogika helyett. Az irányítópulton: Kísérletek (/dashboard/experiments) és az
ügynökszerkesztő A/B lapja. Lásd:
Kísérletek (A/B-tesztelés).
Hibák
A hiba egy adott híváson megjelölt probléma — emberi ellenőr rögzítheti, vagy az AI-alapú értékelés észlelheti. A hibákhoz súlyosság, forrás és állapot tartozik, a Hibák oldal pedig a triázs várólista: szűrje, vizsgálja meg az érintett hívást, és kövesse nyomon a javításokat. A vezérlőpulton: Hibák (/dashboard/issues), valamint hívásonkénti
jelölés a Híváselőzményekben. Lásd: Hibák triázsa.
Az API-ban: /v1/issue-reports.
Jelentések
Egy jelentés az Ön hívásadataira vonatkozó, természetes nyelven feltett kérdésre („Mi volt a három leggyakoribb ok, amiért a hívók emberi ügyintézőt kértek a múlt héten?”) AI által készített elemzéssel válaszol, az Ön által kiválasztott ügynökökre és dátumtartományra szűkítve. A vezérlőpulton: Jelentések (/dashboard/reports). Lásd:
Jelentések.
Megfigyelhetőség
A megfigyelhetőség a metrikák felülete: hívásmennyiség, kimenetelek és minőség időbeli alakulása, ügynök és időablak szerint szűrhető, valamint exportálható további elemzéshez. A vezérlőpulton: Megfigyelhetőség (/dashboard/observability).
Lásd: Megfigyelhetőség.
Riasztások
Egy riasztási szabály egy metrikát (sikerességi arány, hibaarány, átlagos pontszám, hívásmennyiség, tesztcsomag-regressziók) figyel egy időablakban, és akkor aktiválódik, amikor az átlépi az Ön küszöbértékét. Az értesítések e-mailben és Slackben érkeznek, és kiváltanak egyalert.triggered eseményt az Ön
webhookvégpontjain.
A vezérlőpulton: Szervezet → Riasztások. Lásd:
Riasztások.
Webhookok
A ThunderPhone HTTP POST webhookokat küld az Ön szerverére, amikor események történnek egy hívás közben vagy után. Két kézbesítési modell érhető el:- Webhookvégpontok (ajánlott): több URL kezelése a
/v1/developer/webhook-endpointsalatt, végpontonkénti titkos kulcsokkal és végpontonkénti eseményfeliratkozásokkal. - Régi, egyetlen URL-es webhook: szervezetenként egy URL. Kezelése a
/v1/webhookalatt vagy a Szervezet → Általános menüben történik. A visszafelé kompatibilitás érdekében megmaradt.
- A blokkoló események esetén a szerverének olyan konfigurációval
kell válaszolnia, amely alakítja a folyamatban lévő hívást — ezek a
bejövő hívási események
(
telephony.incoming/web.incoming). Legfeljebb 10 másodperce van a válaszadásra; időtúllépés esetén a statikusan hozzárendelt ügynök kezeli a hívást. - A nem blokkoló események elküldési és elfelejtési értesítések, amelyeket exponenciális visszalépéssel próbálunk újra kézbesíteni — lásd a kézbesítési szemantikát.
X-ThunderPhone-Signature fejlécben. Lásd:
Aláírás-ellenőrzés.
Függvényeszközök
Egy függvényeszköz egy HTTP-végpont, amelyet az ügynöke a beszélgetés közben hívhat meg. Ön egy OpenAI-stílusú függvénysémát és egy végpont-URL-t ad meg a ThunderPhone számára; az ügynök eldönti, mikor hívja meg, a ThunderPhone pedig aláírt HTTP-kérést indít a szervereiről, és visszaadja az eredményt az ügynöknek. Az ügynökök beépített hívási képességekkel is rendelkeznek — a hívás átadása, billentyűzeti (DTMF) bevitel küldése, a hívás befejezése, várakoztatás —, amelyeket egyszerű prompt-sorokkal engedélyezhet eszközdefiníciók helyett. A vezérlőpulton: a szerkesztő API-kapcsolatok szakasza (lásd: Kapcsolatok). Az API-ban:/v1/integrations és a
Függvényeszközök specifikációja.
Csapat és szerepkörök
Minden szervezet rendelkezik taglistával, amely két szerepkört tartalmaz: a Tagok ügynököket hoznak létre és üzemeltetnek; az Adminisztrátorok emellett a csapatot és a számlázást is kezelik. E-mailben hívhat meg tagokat — a meghívók 7 nap után lejárnak és visszavonhatók; egy tag sorában található ⋯ menüvel módosíthatja a szerepkört vagy eltávolíthat valakit. Az egyszeri bejelentkezés szervezetszinten konfigurálható — lásd: SSO. A vezérlőpulton: Szervezet → Általános. Lásd: Csapat meghívása. Az API-ban:/v1/members,
/v1/invites.
Számlázás
A ThunderPhone előre fizetett. Minden szervezethez USD-egyenleg tartozik; a hívások az ügynök percenkénti díjával terhelik azt (a motorcsomag és a felárak alapján — a szerkesztő a beállítások módosításakor élőben mutatja a teljes díjat, és a prémium nyelvek további 2¢/perc díjat jelentenek). Amikor az egyenleg eléri a nullát, a bejövő hívásokat a rendszer elutasítja, a kimenő hívások pedig402 Payment Required választ adnak vissza.
Töltse fel manuálisan az egyenleget, vagy engedélyezze az automatikus feltöltést egy egyenlegküszöbértékkel, egy
feltöltési összeggel és opcionális havi költési limittel — így egy hívás
soha nem szakad meg mondat közben.
A vezérlőpulton: Szervezet → Számlázási beállítások és
Számlázási előzmények. Lásd:
Egyenleg feltöltése és az automatikus feltöltés bekapcsolása.
Az API-ban: /v1/billing.
Az alkalmazáson belüli kopilóta
A vezérlőpult beépített kopilótával rendelkezik — kérdezze meg tőle: „hogyan csináljam az X-et”, és a dokumentáció alapján válaszol, kattintásról kattintásra bemutató útmutatókat kínál, amelyek kiemelik a tényleges vezérlőelemeket, valamint bármelyik vezetett bemutatót újra le tudja játszani. Ez a leggyorsabb módja annak, hogy megtaláljon egy ezen az oldalon említett vezérlőelemet. Lásd: Kérdezze meg az alkalmazáson belüli kopilótát.Mindez együtt
Vezérlőpult gyorsindítás
Az ötlépéses varázsló: ügynök → számlázás → szám → szimuláció → ellenőrzés.
API gyorsindítás
Ugyanaz az első hívás négy REST-hívással.
A vezérlőpult használata
Hozzon létre egy ügynököt, töltse fel az egyenlegét, szerezzen egy számot, szimuláljon, és ellenőrizze a hívásokat.
Eszközök és adatok csatlakoztatása
OAuth-alkalmazások, egyéni API-k, MCP-szerverek és VoIP-szolgáltatók.
Elemzés és fejlesztés
Jelentések, megfigyelhetőség, kísérletek, problémák és riasztások.
Csapat és fiók
Meghívók és szerepkörök, API-kulcsok, biztonság és SSO.
Fejlesztői receptgyűjtemény
API-receptek: bejövő, kimenő, dinamikus konfiguráció, eszközök, tesztelés.
Webhook-aláírások ellenőrzése
Állítsa be helyesen egyszer a HMAC-ellenőrzést, majd használja újra mindenhol.