Alapfogalmak

A platform minden elemének áttekintése — az egyes objektumok funkciója, helye az irányítópulton, valamint az őket érintő API-k.

ThunderPhone egy teljes körű platform hangalapú AI-ügynökök létrehozásához, működtetéséhez és fejlesztéséhez. Ez az oldal a térkép: minden olyan fogalom rövid összefoglalója, amellyel találkozni fog, a hozzá tartozó irányítópultfelülettel és az azt támogató API-val. Fusson át rajta egyszer, majd térjen vissza, amikor egy kifejezés magyarázatra szorul.

Az irányítópult oldalsávja ezt a struktúrát követi:

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. Fiókja több szervezethez is tartozhat; mindegyiknek saját egyenlege, saját kulcsai és saját taglistája van.

A Szervezet → Kulcsok alatt létrehozott sk_live_ API-kulcs egyetlen szervezethez van kötve. Ez teszi ilyen egyszerűvé a REST API-t: soha nem kell szervezetazonosítót megadnia az URL-útvonalakban, mert a kulcsa már azonosítja azt.

Az irányítópulton: a szervezetváltó (az oldalsáv alján) és a Szervezet beállításai — a Saját fiók, Általános, Kulcsok, Riasztások, Számlázási beállítások és Számlázási előzmények lapok. Lásd: Szervezeti beállítások referenciája.

Az API-ban: /v1/orgs, /v1/developer/api-keys.

Ügynökök#

Az ügynök az a hívást kezelő AI-konfiguráció, amely a következőket foglalja magában:

• Egy promptot, amely meghatározza, mit mond az ügynök és hogyan viselkedik — beleértve az olyan hívásműveleteket is, mint az átirányítások, billentyűzetgomb-megnyomások és bontások, amelyek külön konfiguráció helyett egyszerű promptsorok.
• Egy motorszintet (spark, bolt, storm-*): a Spark költségre, a Bolt sebességre, a Storm pedig összetett promptok esetén intelligenciára van optimalizálva.
• Egy hangot, valamint egy elsődleges nyelvet és opcionális további nyelveket — az ügynök automatikusan vált, amikor a hívó nyelvet vált. Lásd: Támogatott nyelvek.
• Csatolt képességeket: csatlakoztatott alkalmazások, API-kapcsolatok, tudásbázisok, MCP-szerverek és beágyazott függvényeszközök.
• Viselkedési beállításokat: megszólalási sorrend, visszaigazolási mód, háttérhang, várakoztatási időkorlát.

A szerkesztőben végzett módosítások automatikusan piszkozatként mentődnek; semmi sem élesedik, amíg nem kattint a Telepítés gombra. Minden telepítés pillanatfelvételként rögzül a szerkesztő Előzmények lapján, így bármely korábbi verziót megvizsgálhat és visszaállíthat.

Az irányítópulton: Hangalapú AI-ügynökök → az ügynökszerkesztő (/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édek.

Hangok#

A hangkönyvtár tartalmazza azokat a hangokat, amelyeket egy ügynök használhat, azok lejátszható mintáit, a kompatibilis nyelveket, a nem és akcentus szerinti csoportosításokat, valamint az esetleges prémium hang- vagy nyelvi felárat. Egy fizetős mintagenerátorral saját, 1–500 karakteres kifejezést szintetizálhat, mielőtt választana.

A jogosult szervezetek rövid WAV- vagy MP3-minta alapján egyéni hangokat is létrehozhatnak. Az egyéni hangokhoz kvóta és aszinkron létrehozási állapot tartozik; amikor elkészülnek, a könyvtári hangokkal azonos ügynökválasztóban jelennek meg.

A vezérlőpulton: Hangok (/dashboard/voices). Lásd: Hangkönyvtár és egyéni hangok.

Az API-ban: /v1/voices, hangminták és egyéni hangok.

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ásokhoz is használható). Két forrás áll rendelkezésre:

• ThunderPhone-számok — valódi amerikai számok, amelyeket a ThunderPhone készletéből biztosítunk, másodpercek alatt élesednek, $1/hónap plusz 1¢/perc felárért. Kezdetben csak bejövő hívásokra használhatók. A szervezet rendszergazdája a Telefonszámok oldalon kérhet kimenő hívási lehetőséget; a ThunderPhone minden kérést manuálisan felülvizsgál, és a jóváhagyott számok hívásokat indíthatnak és kampányokat futtathatnak. Egy szervezet alapértelmezés szerint 25 számot tarthat.
• VoIP-számok — saját szolgáltatójától hozhatók be egy VoIP-kapcsolaton keresztül. A Twilio és a Telnyx közvetlenül API-kulccsal csatlakozik (a Telnyx irányított újfiók-beállítást is kínál); a SignalWire, a Vonage, a Plivo és bármely más SIP-trönk SIP- beállításon, manuális SIP-konfiguráción keresztül csatlakozik. Importálás és ellenőrzés után a VoIP-számok támogatják a bejövő és kimenő hívásokat.

Minden szám sorában beállíthat útválasztási módot, kiválaszthatja a bejövő hívások ügynökét, és címkét adhat a számnak.

A vezérlőpulton: Telefonszámok (/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 widget-munkamenet hívásnaplóvá válik. Egy hívás tartalmazza a teljes, szerepkörrel címkézett átiratot, a strukturált fordulótörténetet (beleértve az eszközhívásokat), a felvételt, a számlázási végösszeget, valamint opcionális AI-értékelési és hibajelentéseket.

Amíg egy hívás élő, megnyithatja és belehallgathat — csendben 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 közvetlenül az ügynökéhez jut a hívás közben; a hívó fél ezt soha nem hallja, az ügynök pedig azonnal követi.

A vezérlőpulton: Híváselőzmények (/dashboard/call-history) az archívumhoz és hívásonkénti részletekhez; Élő a folyamatban lévő hívásokhoz. Lásd: Hívások áttekintése, meghallgatása és irányítása.

Az API-ban: /v1/calls — lista, átirat, előzmények, hanganyag, értékelés, export; /v1/issue-reports.

Ügyfélportálok#

Az ügyfélportál egy márkázott, csak olvasható híváselőzmény-nézet egy külső ügyfél számára. A szervezet rendszergazdái kiválasztják azokat az ügynököket, amelyek hívásai megjelennek, hozzáadják a jóváhagyott megtekintői e-mail-címeket, feltöltenek egy logót és beállítanak egy kiemelőszínt, valamint opcionálisan ellenőriznek egy egyéni domaint. A portál megtekintői a vezérlőpulthoz való hozzáférés nélkül vizsgálhatják meg a hívás részleteit, az átiratokat és az elérhető felvételeket.

A vezérlőpulton: Ügyfélportálok (/dashboard/client-portals). Lásd: Ügyfélportálok.

Az API-ban: /v1/client-portals a rendszergazdai kezelőfelülethez.

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, amelyet a böngészők csak az Ön által engedélyezett domainekről használhatnak, így kliensoldali kódban is biztonságos. A domainlista nem hitelesítés, és az oldalak által küldhető munkamenet-beállítások mindaddig ki vannak kapcsolva, amíg Ön nem engedélyezi őket a kulcson.

A kulcsok két mód egyikében működnek: agent (statikusan egy ügynökhöz kötve) vagy webhook (az Ön szervere választja ki a konfigurációt látogatónként — lásd: Dinamikus hívásonkénti konfiguráció). A widgetmunkamenetek ugyanazon a hívási infrastruktúrán keresztül zajlanak, mint a telefonhívások.

Az irányító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 és a Widget SDK dokumentációja.

Tudásbázisok#

A tudásbázis olyan dokumentumok gyűjteménye, amelyekben az ügynöke hívás közben kereshet, hogy megalapozza a válaszait — töltsön fel fájlokat, illesszen be szöveget, vagy importáljon weboldalakat URL alapján, majd csatolja 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.

Az irányítópulton: Tudás (/dashboard/knowledge) a dokumentumtárhoz; a szerkesztő Tudás szakasza tudásbázis ügynökhöz csatolásához. Lásd: Adjon tudásbázist az ügynökének.

Kapcsolatok#

A kapcsolatokon keresztül érik el az ügynökök a külvilágot. Négy típus, egy oldalsávbeli csoport:

• Alkalmazások (/dashboard/app-connections) — OAuth-kapcsolatok a Slackhez, HubSpothoz, Salesforce-hoz, Google Calendarhoz, Google Sheetshöz és Cal.comhoz. Csatlakoztassa őket egyszer, majd kapcsolja be műveletenként az eszközöket (Slack-üzenet küldése, HubSpot-kapcsolat beszúrá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ármilyen 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 teszthívást indít, mielőtt élesítené. Lásd: API-kapcsolatok — a /v1/integrations irányítópultos felülete.
• MCP (/dashboard/mcp-connections) — adjon hozzá URL alapján egy Model Context Protocol-kiszolgálót, és engedje, hogy az ügynök használja az általa elérhetővé tett eszközöket. Lásd: MCP-kiszolgáló hozzáadása.
• VoIP (/dashboard/voip-connections) — szolgáltatói hitelesítő adatok saját telefonszámok használatához. Lásd: VoIP-szolgáltató csatlakoztatása.

A ThunderPhone saját MCP-végpontot is biztosít, így egy külső MCP-kliens listázhatja az ügynököket, megvizsgálhatja a hívásokat és az átiratokat, valamint hívásokat indíthat. Lásd: A ThunderPhone használata MCP-kiszolgálóként.

Az API-ban: /v1/integrations, /v1/mcp-servers é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 kapcsolatokat tartalmazó CSV-fájlt, válassza ki az ügynököt és a hívó telefonszámot, majd állítsa be a hívási időablakot (napok és órák, időzónát figyelembe véve), a párhuzamosságot és az újrapróbálási szabályzatot (a próbálkozások maximális száma, valamint az újrapróbált eredmények — 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 megjeleníti a szervezet összes folyamatban lévő hívását, és lehetővé teszi, hogy bármelyiket megnyissa, és valós időben belehallgasson vagy súghasson. Ez a felügyeleti felület: figyelje, ahogy egy új prompt megkapja az első éles forgalmát, vagy kövessen nyomon egy 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#

A szimuláció során egy AI-hívó valódi beszélgetést folytat az Ön ügynökével — ugyanazon a telefonos útvonalon, valós átirattal és valós értékeléssel —, így a kiadás előtt (és után) is tesztelhet. Irányítsa egy ügynökhöz vagy telefonszámhoz, írja meg saját maga a hívó forgatókönyvét, vagy generáljon forgatókönyveket AI-val az ügynök promptja alapján (kérésre szélső esetekkel együtt), majd kövesse élőben a hívást.

A forgatókönyvek csomagokba rendezhetők, amelyek rögzítik a minimális megfelelési arányt, és a CI-ben kapuzhatják a kiadásokat; az elfogadott alapvonalhoz képesti regressziókat forgatókönyvenként jelentjük.

Az irányítópulton: Szimulációk (/dashboard/simulations), valamint az ügynökszerkesztő Szimuláció gombja. 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.

Validációs készletek#

Egy validációs készlet a valós hívások pillanatait ismételhető, egyfordulós regressziós ellenőrzésekké alakítja. Minden példa rögzíti a beszélgetés kontextusát, a releváns hívóhangot, az eredeti választ és az elvárt viselkedést. Az újrajátszások újabb hívás indítása nélkül futnak az aktuális ügynökvázlaton, és a telepítési párbeszédablak megjelenítheti, hogy a legutóbbi futtatás továbbra is megfelel-e annak a vázlatnak.

Az irányítópulton: Validációs készletek (/dashboard/validation) a szervezeti adatkészlethez, valamint az ügynökszerkesztő Validáció lapja a futtatásokhoz. Lásd: Validációs készletek.

Az API-ban: /v1/validation-sets, valamint az ügynök- és példa-újrajátszási végpontok ugyanazon a referenciaoldalon.

Kísérletek#

Egy kísérlet A/B-teszteli az ügynökkonfigurációkat éles forgalmon: határozzon meg változatokat (eltérő promptokkal, motorokkal vagy beállításokkal), ossza el közöttük a forgalmat, és hasonlítsa össze változatonként az eredményeket. Használja ezt a webhookban saját kezűleg kialakított csoportlogika 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).

Problémák#

Egy probléma egy adott hívásnál jelzett gond — amelyet emberi ellenőrző rögzített, vagy az AI-értékelés észlelt. A problémák súlyosságot, forrást és állapotot tartalmaznak, a Problémák oldal pedig a triázssor: szűrjön, vizsgálja meg az érintett hívást, és kövesse nyomon a javításokat.

Az irányítópulton: Problémák (/dashboard/issues), valamint hívásonkénti jelölés a Híváselőzményekben. Lásd: Problémák triázsa.

Az API-ban: /v1/issue-reports.

Jelentések#

Egy jelentés természetes nyelvű kérdésre válaszol az Ön hívásadataival kapcsolatban („Mi volt a három leggyakoribb ok, amiért a hívók emberi segítséget kértek múlt héten?”) egy AI által írt elemzéssel, amely az Ön által kiválasztott ügynökökre és dátumtartományra van szűkítve.

Az irányító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, eredmények és minőség időbeli alakulása, ügynök és időablak szerint szűrhetően, exportálási lehetőséggel a további elemzéshez.

Az irányító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, átlagpontszám, hívásmennyiség, csomagregressziók) figyel egy időablakban, és aktiválódik, amikor az átlépi az Ön küszöbértékét. Az értesítések e-mailben és Slackben érkeznek, valamint alert.triggered eseményt indítanak az Ön webhook-végpontjain.

Az irányító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:

• Webhook-végpontok (ajánlott): több URL kezelése a /v1/developer/webhook-endpoints alatt, 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/webhook alatt vagy a Szervezet → Általános résznél történik. A visszamenőleges kompatibilitás érdekében maradt meg.

Az események két osztályba sorolhatók:

• Blokkoló események esetén a szerverének olyan konfigurációval kell válaszolnia, amely befolyásolja a folyamatban lévő hívást — ezek a bejövő hívási események (telephony.incoming / web.incoming). Egy telefonhívás legfeljebb 13 másodpercet vár, egy újrapróbálkozást is beleértve, a widgetmunkamenet pedig 10 másodpercet. Nincs tartalék ügynök: használható konfiguráció nélkül a telefonhívás megszakad, a widgetmunkamenet pedig sikertelen lesz.
• Nem blokkoló események elküldés utáni értesítések, amelyeket exponenciális visszalépéssel próbálunk újra kézbesíteni — lásd: kézbesítési szemantika.

Minden kérés időbélyeggel ellátott HMAC-SHA256 aláírást tartalmaz az X-ThunderPhone-Signature-V2 fejlécben, valamint a kizárólag törzset használó örökölt X-ThunderPhone-Signature aláírást. Lásd: Aláírás ellenőrzése.

Függvényeszközök#

A függvényeszköz egy HTTP-végpont, amelyet az ügynöke a beszélgetés közben meghívhat. A ThunderPhone számára megad egy OpenAI-stílusú függvénysémát és egy végpont URL-jét; az ügynök dönti el, mikor hívja meg, a ThunderPhone pedig a szervereiről indítja az aláírt HTTP-kérést, majd 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 átirányítása, billentyűzetes (DTMF) bevitel küldése, a hívás befejezése, várakoztatás — amelyeket eszközdefiníciók helyett egyszerű prompt-sorokkal engedélyezhet.

Az irányító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, két szerepkörrel: a Tagok ügynököket építenek és üzemeltetnek; a Rendszergazdák emellett a csapatot és a számlázást is kezelik. Meghívás e-mailben történik — a meghívások 7 nap után lejárnak és visszavonhatók; egy tag sorában lévő ⋯ menüvel szerepkört módosíthat vagy eltávolíthat valakit. Az egyszeri bejelentkezés szervezetszinten konfigurálható — lásd az SSO-t.

Az irányítópulton: Szervezet → Általános. Lásd: Csapata meghívása.

Az API-ban: /v1/members, /v1/invites.

Számlázás#

A ThunderPhone előre fizetős. Minden szervezet USD-egyenleggel rendelkezik; a hívások az ügynök percenkénti díjával terhelik ezt (motorszint és felárak — a szerkesztő a beállítások módosításakor élőben megjeleníti a teljes díjat, és a kiválasztott további nyelvek további 3¢/perc díjat jelentenek). Amikor az egyenleg eléri a nullát, a bejövő hívásokat elutasítják, a kimenő hívások pedig 402 Payment Required választ adnak vissza.

Töltsön fel egyenleget manuálisan, vagy engedélyezze az automatikus feltöltést egyenlegküszöbértékkel, feltöltési összeggel és opcionális havi költési korláttal — így egy hívás sem szakad meg félmondat közben.

Az irányító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, valamint a teljes árlista.

Az API-ban: /v1/billing.

Az alkalmazáson belüli kopilóta#

Az irányítópult beépített kopilótát tartalmaz — kérdezze meg tőle, hogy „hogyan tudok X-et végrehajtani”, és ezekből a dokumentumokból válaszol, lépésről lépésre bemutatókat kínál, amelyek kiemelik a valódi vezérlőelemeket, valamint bármely irányított bemutatót újra le tud játszani. Ez a leggyorsabb módja annak, hogy megtalálja az ezen az oldalon említett vezérlőelemeket. Lásd: Az alkalmazáson belüli kopilóta használata.

Összefoglalás#