Getting Started

Alapfogalmak

A platform összes elemének áttekintése — mit tesznek az egyes objektumok, hol találhatók a vezérlőpulton, és melyik API kezeli őket.

ThunderPhone egy teljes körű platform hangalapú AI-ügynökök létrehozásához, futtatásához és fejlesztéséhez. Ez az oldal a térkép: minden itt előforduló fogalomhoz tartozik egy rövid szakasz, a hozzá tartozó dashboardfelülettel és az azt támogató API-val. Először futsa át, majd térjen vissza, amikor egy fogalom részletesebb magyarázatára van szüksége.

A dashboard oldalsávja ezt a struktúrát tükrözi:

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. A fiókja több szervezethez is tartozhat; mindegyik saját egyenleggel, saját kulcsokkal és saját taglistával rendelkezik.

Az Szervezet → Kulcsok alatt létrehozott sk_live_ API-kulcs egy szervezethez van kötve. Ez a kötés teszi olyan egysíkúvá a REST API-t: soha nem kell szervezeti azonosítót megadnia az URL-útvonalakban, mert a kulcsa már azonosítja azt.

A dashboardon: a szervezetváltó (az oldalsáv alján) és a Szervezet beállításai — 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 mesterségesintelligencia-konfiguráció, amely egy hívást kezel. 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, mint az átirányítás, a billentyűzetlenyomás és a hívásbontás, amelyek külön konfiguráció helyett egyszerű promptsorok.
• Egy motorszintet (spark, bolt, storm-*): a Spark a költséghatékonyságra, a Bolt a sebességre, a Storm pedig az összetett promptok intelligens kezelésére 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: kapcsolt alkalmazások, API-kapcsolatok, tudásbázisok, MCP-szerverek és beágyazott függvényeszközök.
• Viselkedési beállításokat: beszédsorrend, visszaigazolási mód, háttérhang, várakoztatási időkorlát.

A szerkesztőben végzett módosítások automatikusan piszkozatba mentődnek; semmi sem kerül élesbe, amíg nem kattint a Közzététel gombra. Minden közzétételről pillanatfelvétel készül a szerkesztő Előzmények lapján, így bármely korábbi verziót megvizsgálhat és visszaállíthat.

A dashboardon: Hangalapú AI-ügynökök → az ügynökszerkesztő (/dashboard/agents). Lásd: Első hangalapú AI-ügynöke létrehozása.

Az API-ban: /v1/agents — CRUD, duplikálás, átirányítás, verzióelőzmények és promptsegédletek.

Hangok#

A hangkönyvtár tartalmazza azokat a hangokat, amelyeket egy ügynök használhat, azok lejátszható mintáit, kompatibilis nyelveit, nemi és akcentuscsoportjait, valamint az esetleges prémium hang-/nyelvi felárakat. Fizetős mintagenerátorral a választás előtt saját, 1–500 karakteres kifejezést is szintetizálhat.

A jogosult szervezetek rövid WAV- vagy MP3-mintából egyéni hangokat is létrehozhatnak. Az egyéni hangokra kvóta és aszinkron létrehozási állapot vonatkozik; amikor elkészülnek, ugyanabban az ügynökválasztóban jelennek meg, mint a könyvtári hangok.

Az irányító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 (és kimenő hívásokat is kezelhet). Két forrás áll rendelkezésre:

• Demó számok — valós amerikai telefonszámok, amelyeket a ThunderPhone készletéből biztosítanak, és másodperceken belül aktiválódnak. Csak bejövő hívásokat fogadnak, rövid szóbeli nyilatkozattal válaszolnak, és az irányítópult szervezetenként legfeljebb 10-et engedélyez. Első teszthez ideálisak, éles használatra nem.
• VoIP-számok — amelyeket saját szolgáltatójától hozhat 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-trunkot fogad. 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.

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

Az irányító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, szerepcímkézett átiratot, a strukturált fordulóelőzményeket (beleértve az eszközhívásokat), a felvételt, a számlázási összeget, valamint az opcionális AI-alapú értékelést é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ó soha nem hallja, az ügynök pedig azonnal követi.

Az irányító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, 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, írásvédett híváselőzmény-nézet egy külső ügyfél számára. A szervezet adminisztrátorai 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 az irányítópulthoz való hozzáférés nélkül vizsgálhatják meg a hívásrészleteket, átiratokat és elérhető felvételeket.

Az irányítópulton: Ügyfélportálok (/dashboard/client-portals). Lásd: Ügyfélportálok.

Az API-ban: /v1/client-portals az adminisztrátori kezelőfelülethez.

Webes widgetek#

A webes widget mikrofonalapú beszélgetést biztosít webhelye látogatóinak egy AI-ügynökkel — nincs szükség telefonszámra. Egy publikálható kulccsal (pk_live_...) hitelesít, amely az Ön engedélyezett domainjeihez van kötve, így biztonságosan használható kliensoldali kódban.

A kulcsok két üzemmó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 widgetmunkamenetek ugyanazon a hívási infrastruktúrán keresztül futnak, mint a telefonhívások.

A vezérlőpulton: Webes widgetek (/dashboard/web-widgets) — hozzon létre widgeteket, állítsa be az üzemmó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 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.

A vezérlőpulton: Tudás (/dashboard/knowledge) a dokumentumtárhoz; a szerkesztő Tudás szakaszában pedig tudásbázist csatolhat egy ügynökhöz. Lásd: Adjon tudásbázist ügynökének.

Kapcsolatok#

A kapcsolatokon keresztül érik el az ügynökök a külső rendszereket. Négy típus, egy oldalsáv-csoport:

• Alkalmazások (/dashboard/app-connections) — OAuth-kapcsolatok a Slackhez, HubSpothoz, Salesforce-hoz, Google Calendarhoz, Google Sheetshöz és Cal.comhoz. Csatlakoztassa egyszer, majd kapcsolja be műveletenként az eszközöket (Slack-üzenet közzététele, HubSpot-kapcsolat létrehozása vagy frissítése, Cal.com-időpont foglalása…) bármelyik ügynökhöz. Lásd: Alkalmazások csatlakoztatása.
• API-k (/dashboard/api-connections) — bármely HTTP API-t ügynökműveletté alakíthat. 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 manuálisan; a Tesztkérés gomb élesítés előtt tesztkörnyezetbeli hívást indít. Lásd: API-kapcsolatok — ez a /v1/integrations vezérlőpultbeli 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, valamint /v1/voip-connections; lásd még: Eszközintegráció készítése.

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ónafigyelembevételével), a párhuzamosságot és az újrapróbálási szabályt (maximális próbálkozásszám és az újrapróbálandó kimenetelek — 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.

A vezérlő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 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ő éles forgalmat, vagy tartson szemmel egy futó kampányt.

A vezérlő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ós 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ökre vagy telefonszámra, í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 (igény esetén szélsőséges esetekkel együtt), majd kövesse élőben a hívást.

A forgatókönyvek csomagokba rendezhetők, amelyek rögzítenek egy minimális sikerességi arányt, és a CI-ben blokkolhatják a kiadásokat; az elfogadott alapértékhez képesti regressziókat forgatókönyvenként jelentjük.

A vezérlő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#

A validációs készlet valós hívások pillanatait alakítja ismételhető, egykörös regressziós ellenőrzésekké. 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. A visszajátszások az aktuális ügynökpiszkozaton futnak újabb hívás indítása nélkül, a telepítési párbeszédpanel pedig megjelenítheti, hogy a legutóbbi futtatás továbbra is megfelel-e annak a piszkozatnak.

A vezérlőpulton: Validációs készletek (/dashboard/validation) a szervezeti adathalmazhoz, 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 ugyanazon referenciaoldalon található ügynök-/példavisszajátszási végpontok.

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 fel közöttük a forgalmat, és hasonlítsa össze az eredményeket változatonként. Használja ezt webhookban kézzel kialakított bucketlogika helyett.

A vezérlő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áshoz kapcsolódó megjelölt gond — emberi ellenőr rögzítette, vagy az AI-értékelés észlelte. A problémák súlyosságot, forrást és állapotot tartalmaznak, a Problémák oldal pedig a triázsvárólista: szűrjön, vizsgálja meg a problémás hívást, és kövesse nyomon a javításokat.

A vezérlőpulton: Problémák (/dashboard/issues), valamint hívásonkénti megjelö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 megválaszol egy természetes nyelvű kérdést az Ön hívásadatairól ("Mi volt az első három leggyakoribb ok, amiért a hívók emberrel akartak beszélni a múlt héten?") egy AI által készített elemzéssel, 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, 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 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 figyel (sikerességi arány, hibaarány, átlagos pontszám, hívásmennyiség, csomagregressziók) egy időablakban, és aktiválódik, amikor az átlépi az Ön küszöbértékét. Az értesítések e-mailbe és Slackbe érkeznek, valamint egy alert.triggered eseményt indítanak az Ön webhook-végpontjain.

A vezérlőpulton: Szervezet → Riasztások. Lásd: Riasztások.

Webhookok#

A ThunderPhone HTTP POST webhookokat küld az Ön szerverének, amikor egy hívás során vagy után események történnek. Két kézbesítési modell:

• Webhookvégpontok (ajánlott): több URL kezelése a /v1/developer/webhook-endpoints útvonalon, végpontonkénti titkos kulcsokkal és végpontonkénti eseményfeliratkozásokkal.
• Örökölt, egy URL-es webhook: szervezetenként egy URL. Kezelése a /v1/webhook útvonalon vagy a Szervezet → Általános menüpontban 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 meghatározza a folyamatban lévő hívást — ezek a bejövő hívási események (telephony.incoming / web.incoming). A válaszadásra legfeljebb 10 másodperce van; időtúllépés esetén a statikusan hozzárendelt ügynök kezeli a hívást.
• Nem blokkoló események elküldési és elfelejtési értesítések, amelyek exponenciális visszalépéssel újrapróbálkozásra kerülnek — lásd: kézbesítési szemantika.

Minden kérés HMAC-SHA256 aláírást tartalmaz az X-ThunderPhone-Signature fejlécben. Lásd: Aláírás ellenőrzése.

Funkcióeszközök#

A funkcióeszkö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 dönti el, mikor hívja meg, a ThunderPhone pedig a saját szervereiről elküldi az aláírt HTTP-kérést, é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 átirányítása, billentyűzeti (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: az építő API-kapcsolatok szakaszában (lásd: Kapcsolatok).

Az API-ban: /v1/integrations és a Funkcióeszközök specifikációja.

Csapat és szerepkörök#

Minden szervezet rendelkezik egy taglistával, két szerepkörrel: Tagok építik és üzemeltetik az ügynököket; az Adminisztrátorok 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 található ⋯ menüvel szerepkört módosíthat vagy eltávolíthat valakit. Az egyszeri bejelentkezés szervezeti szinten konfigurálható — lásd: SSO.

Az irányítópulton: Szervezet → Általános. Lásd: Csapattagok 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ásokból az ügynök percenkénti díja kerül levonásra (motorszint plusz felárak — az építő a beállítások módosításakor valós időben megjeleníti a teljes díjat, és a kiválasztott további nyelvek 3¢/perc díjat jelentenek). Amikor az egyenleg nullára csökken, a bejövő hívások elutasításra kerülnek, 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 egy egyenlegküszöbbel, feltöltési összeggel és opcionális havi költési limittel — így egy hívás sem szakad meg mondat 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 automatikus feltöltés bekapcsolása, valamint a teljes árképzési referencia.

Az API-ban: /v1/billing.

Az alkalmazáson belüli kopilóta#

Az irányítópult beépített kopilótával rendelkezik — kérdezze meg tőle, hogy „hogyan csináljak X-et”, és ezekből a dokumentumokból válaszol, kattintásról kattintásra bemutatókat kínál, amelyek kiemelik a tényleges vezérlőelemeket, valamint bármelyik vezetett bemutatót újra lejátssza. 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#