Základy
Zapojení
Živé monitorování a odchozí
kampaně.
Propojení
Aplikace, rozhraní API, servery MCP a poskytovatelé VoIP, které mohou
vaši agenti používat.
Kvalita a testování
Organizace
Události
Webhooky a funkční nástroje pro
váš vlastní kód.
Organizace
Organizace je základní jednotka pro oddělení prostředí. Každý další prostředek — agenti, telefonní čísla, hovory, klíče — patří právě do jedné organizace. Váš účet může patřit do více organizací; každá má vlastní zůstatek, vlastní klíče a vlastní seznam členů. Klíč APIsk_live_, který vytvoříte v části Organizace → Klíče, je
vázaný na jednu organizaci. Díky tomuto vazbě je rozhraní REST API tak
přímočaré: do cest URL nikdy nevkládáte ID organizace, protože ji váš klíč
už identifikuje.
V dashboardu: přepínač organizace (v zápatí postranního panelu) a
nastavení Organizace — karty Obecné, Klíče, Upozornění, Nastavení
fakturace a Historie fakturace.
V API: /v1/orgs,
/v1/developer/api-keys.
Agenti
Agent je konfigurace AI, která řídí hovor. Zahrnuje:- Prompt, který určuje, co agent říká a jak se chová — včetně akcí hovoru, jako je předání hovoru, stisky klávesnice a ukončení hovoru, které jsou běžnými řádky promptu, nikoli samostatnou konfigurací.
- Úroveň enginu (
spark,bolt,storm-*): Spark je optimalizovaný pro náklady, Bolt pro rychlost a Storm pro inteligenci při složitých promptech. - Hlas spolu s primárním jazykem a volitelnými dalšími jazyky — agent se automaticky přepne, když volající změní jazyk. Viz Podporované jazyky.
- Připojené možnosti: propojené aplikace, připojení API, znalostní báze, servery MCP a vložené funkční nástroje.
- Nastavení chování: pořadí mluvení, režim potvrzování, podkresová stopa, časový limit podržení.
/dashboard/agents). Viz
Vytvořte svého prvního hlasového agenta.
V API: /v1/agents — CRUD,
duplikování, předání, historie verzí a pomocné nástroje pro prompty.
Telefonní čísla
Telefonní číslo patří organizaci a směruje příchozí hovory na agenta (a může uskutečňovat odchozí hovory). Dva zdroje:- Ukázková čísla — skutečná americká čísla zřízená z fondu ThunderPhone, aktivní během několika sekund. Pouze pro příchozí hovory, odpovídají krátkým mluveným upozorněním a řídicí panel omezuje organizaci na 10 těchto čísel. Ideální pro první test, nikoli pro produkci.
- VoIP čísla — přinesená od vlastního poskytovatele prostřednictvím VoIP připojení. Twilio a Telnyx se připojují přímo (Telnyx nabízí provázené nastavení); SignalWire a Vonage budou brzy k dispozici — dnes je můžete připojit pomocí ruční konfigurace SIP, která přijímá jakýkoli SIP trunk. Po importu a ověření podporují VoIP čísla příchozí i odchozí hovory.
/dashboard/phone-numbers).
Viz Získejte telefonní číslo.
V API: /v1/phone-numbers,
/v1/voip-connections,
/v1/phone-number-labels.
Hovory
Každý příchozí hovor, odchozí hovor, simulace a relace widgetu se stává záznamem hovoru. Hovor obsahuje úplný přepis s označenými rolemi, strukturovanou historii tahů (včetně volání nástrojů), nahrávku, celkovou cenu a volitelné hodnocení AI a hlášení problémů. Když hovor probíhá, můžete jej otevřít a odposlouchávat — připojíte se tiše a nikdo v hovoru vás neuslyší. Po připojení můžete našeptávat: zadejte pokyn, který se během hovoru odešle přímo vašemu agentovi; volající jej nikdy neuslyší a agent se jím bude ihned řídit. V řídicím panelu: Historie hovorů (/dashboard/call-history) pro
archiv a podrobnosti jednotlivých hovorů; Živě pro probíhající
hovory. Viz
Kontrola, odposlech a koučování hovorů.
V API: /v1/calls — seznam, přepis,
historie, zvuk, hodnocení, export;
/v1/issue-reports.
Webové widgety
Webový widget poskytuje návštěvníkům vašeho webu konverzaci s agentem přes mikrofon — telefonní číslo není potřeba. Ověřuje se pomocí veřejného klíče (pk_live_...), který je omezen na původy
vašich povolených domén, takže jej lze bezpečně použít v kódu na straně
klienta.
Klíče fungují v jednom ze dvou režimů: agent (staticky vázaný na
jednoho agenta) nebo webhook (váš server vybírá konfiguraci pro
každého návštěvníka — viz
Dynamická konfigurace pro jednotlivé hovory).
Relace widgetu využívají stejnou infrastrukturu hovorů jako telefonní
hovory.
V řídicím panelu: Webové widgety (/dashboard/web-widgets) —
vytvářejte widgety, nastavujte režim a agenta, spravujte povolené domény
a kopírujte kód pro vložení. Viz
Vytvoření webového widgetu.
V API: /v1/publishable-key,
/v1/mic-session a
dokumentace Widget SDK.
Znalostní báze
Znalostní báze je sada dokumentů, ve kterých může váš agent během hovoru vyhledávat, aby své odpovědi opřel o relevantní informace — nahrajte soubory přímo nebo je importujte z Google Drive a poté znalostní bázi připojte k agentovi v nástroji pro tvorbu. Agent ji dotazuje pomocí integrovaného vyhledávacího nástroje, kdykoli to konverzace vyžaduje. V řídicím panelu: Znalosti (/dashboard/knowledge) pro knihovnu
dokumentů; sekce Znalosti v nástroji pro tvorbu pro připojení
znalostní báze k agentovi. Viz
Poskytněte agentovi znalostní bázi.
Propojení
Propojení umožňují agentům komunikovat s okolním světem. Čtyři typy, jedna skupina v postranním panelu:- Aplikace (
/dashboard/app-connections) — připojení OAuth ke Slacku, HubSpotu, Salesforce, Kalendáři Google, Tabulkám Google a Cal.com. Připojte jednou a poté u libovolného agenta zapínejte nástroje pro jednotlivé operace (odeslání zprávy do Slacku, vytvoření nebo aktualizace kontaktu v HubSpotu, rezervace termínu v Cal.com…). Viz Připojení aplikací. - API (
/dashboard/api-connections) — proměňte libovolné HTTP API na akci agenta. Vložte příkaz cURL a průvodce AI navrhne definici nástroje, nebo ji vytvořte ručně; tlačítko Testovat požadavek provede volání v sandboxu před nasazením. Viz Připojení API — rozhraní dashboardu pro/v1/integrations. - MCP (
/dashboard/mcp-connections) — přidejte server Model Context Protocol pomocí adresy URL a nechte agenta používat nástroje, které poskytuje. Viz Přidání serveru MCP. - VoIP (
/dashboard/voip-connections) — přihlašovací údaje poskytovatele pro použití vlastních telefonních čísel. Viz Připojení poskytovatele VoIP.
/v1/integrations a
/v1/voip-connections; viz také
Vytvoření integrace nástroje.
Kampaně
Kampaň uskutečňuje odchozí hovory ve velkém měřítku: nahrajte CSV se kontakty, vyberte agenta a číslo volajícího a nastavte okno pro volání (dny a hodiny se zohledněním časového pásma), souběžnost a zásady opakování (maximální počet pokusů a výsledky — bez odpovědi, hlasová schránka, neúspěch — které se mají opakovat). Kampaň postupuje seznamem a zaznamenává každý hovor do Historie hovorů. V dashboardu: Kampaně (/dashboard/campaigns). Viz
Spuštění kampaně odchozího volání.
Pro jednorázové programové hovory:
API pro odchozí hovory.
Živé sledování
Živě zobrazuje každý probíhající hovor v celé organizaci a umožňuje otevřít kterýkoli z nich a odposlouchávat jej nebo do něj vstupovat šeptem v reálném čase. Jde o rozhraní pro dohled: sledujte, jak nový prompt získává první skutečný provoz, nebo mějte pod dohledem spuštěnou kampaň. V dashboardu: Živě (/dashboard/live). Viz
Sledování a dohled nad živými hovory.
Simulace
Simulace je volající AI, který vede skutečný rozhovor s vaším agentem — stejná telefonní cesta, skutečný přepis, skutečné hodnocení — takže můžete testovat před nasazením i po něm. Nasměrujte ji na agenta nebo telefonní číslo, napište scénář volajícího sami nebo generujte scénáře pomocí AI z promptu agenta (včetně okrajových případů, pokud o ně požádáte), a sledujte hovor živě. Scénáře se sdružují do sad, které stanovují minimální úspěšnost a mohou blokovat vydání v CI; regrese oproti přijatému základu se hlásí pro každý scénář. V dashboardu: Simulace (/dashboard/simulations) a také
tlačítko Simulace v nástroji pro tvorbu agentů. Viz
Simulace hovoru.
V API: /v1/test-calls a spouštěč
sad — viz Komplexní testování agenta.
Experimenty
Experiment provádí A/B testování konfigurací agentů na živém provozu: definujte varianty (různé prompty, enginy nebo nastavení), rozdělte mezi ně provoz a porovnejte výsledky jednotlivých variant. Použijte jej namísto ruční implementace logiky segmentů ve webhooku. V dashboardu: Experimenty (/dashboard/experiments) a
karta A/B v nástroji pro tvorbu agentů. Viz
Experimenty (A/B testování).
Problémy
Problém je označený problém v konkrétním hovoru — nahlášený lidským kontrolorem nebo zjištěný hodnocením AI. Problémy obsahují závažnost, zdroj a stav a stránka Problémy slouží jako fronta pro třídění: filtrujte, prohlédněte problematický hovor a sledujte opravy. V dashboardu: Problémy (/dashboard/issues) a označování
jednotlivých hovorů v Historii hovorů. Viz Třídění problémů.
V API: /v1/issue-reports.
Reporty
Report odpovídá na otázku v přirozeném jazyce o vašich datech hovorů („Jaké byly minulý týden tři hlavní důvody, proč volající požadovali člověka?“) pomocí analýzy vytvořené AI, omezené na agenty a období, které zvolíte. V dashboardu: Reporty (/dashboard/reports). Viz
Reporty.
Observabilita
Observabilita je oblast metrik: objem hovorů, výsledky a kvalita v čase, s možností filtrování podle agenta a časového okna a exportu pro následnou analýzu. V dashboardu: Observabilita (/dashboard/observability).
Viz Observabilita.
Upozornění
Pravidlo upozornění sleduje metriku (míru úspěšnosti, míru selhání, průměrné skóre, objem hovorů, regrese sad) v časovém okně a spustí se, když překročí váš práh. Oznámení se odesílají e-mailem a do Slacku a vyvolají událostalert.triggered pro vaše
koncové body webhooků.
V dashboardu: Organizace → Upozornění. Viz
Upozornění.
Webhooky
ThunderPhone odesílá na váš server HTTP POST webhooky, když během hovoru a po něm nastanou události. Dva modely doručování:- Koncové body webhooků (doporučeno): spravujte více URL na
/v1/developer/webhook-endpointss tajnými klíči pro jednotlivé koncové body a odběry událostí pro jednotlivé koncové body. - Starší webhook s jedinou URL: jedna URL pro organizaci. Spravuje se na
/v1/webhooknebo v části Organizace → Obecné. Je zachován kvůli zpětné kompatibilitě.
- Blokující události očekávají, že váš server odpoví konfigurací,
která ovlivní probíhající hovor — jedná se o
události příchozích hovorů
(
telephony.incoming/web.incoming). Na odpověď máte až 10 sekund; při vypršení časového limitu hovor zpracuje staticky přiřazený agent. - Neblokující události jsou oznámení typu fire-and-forget, která se opakují s exponenciálním odkladem — viz sémantika doručování.
X-ThunderPhone-Signature. Viz
Ověření podpisu.
Funkční nástroje
Funkční nástroj je koncový bod HTTP, který může váš agent volat uprostřed konverzace. ThunderPhone poskytnete schéma funkce ve stylu OpenAI spolu s URL koncového bodu; agent rozhodne, kdy jej zavolat, a ThunderPhone odešle ze svých serverů podepsaný HTTP požadavek a předá výsledek zpět agentovi. Agenti také obsahují vestavěné funkce pro hovory — přepojení hovoru, odesílání vstupu z klávesnice (DTMF), ukončení hovoru, čekání v režimu podržení —, které povolíte pomocí jednoduchých řádků v promptu namísto definic nástrojů. V dashboardu: sekce Připojení API v nástroji pro tvorbu (viz Připojení). V API:/v1/integrations a
specifikace funkčních nástrojů.
Tým a role
Každá organizace má seznam členů se dvěma rolemi: Členové vytvářejí a provozují agenty; Správci také spravují tým a fakturaci. Pozvěte členy e-mailem — pozvánky vyprší po 7 dnech a lze je zrušit; nabídka ⋯ na řádku člena mění role nebo někoho odebere. Jednotné přihlášení lze nakonfigurovat pro celou organizaci — viz SSO. V dashboardu: Organizace → Obecné. Viz Pozvěte svůj tým. V API:/v1/members,
/v1/invites.
Fakturace
ThunderPhone je předplacený. Každá organizace má zůstatek v USD; hovory z něj strhávají sazbu agenta za minutu (úroveň enginu plus příplatky — editor při změně nastavení průběžně zobrazuje celkovou sazbu a prémiové jazyky přidávají 2 ¢/min). Když zůstatek klesne na nulu, příchozí hovory jsou odmítnuty a odchozí hovory vrátí402 Payment Required.
Doplňte kredit ručně nebo zapněte automatické dobíjení s prahem
zůstatku, částkou dobíjení a volitelným měsíčním limitem útrat — aby se
hovor nikdy nepřerušil uprostřed věty.
V ovládacím panelu: Organizace → Nastavení fakturace a
Historie fakturace. Viz
Přidání prostředků a zapnutí automatického dobíjení.
V API: /v1/billing.
Kopilot v aplikaci
Ovládací panel obsahuje vestavěného kopilota — zeptejte se ho „jak mohu X“ a odpoví na základě této dokumentace, nabídne podrobné postupy krok za krokem, které zvýrazní skutečné ovládací prvky, a dokáže přehrát kteroukoli z prohlídek. Je to nejrychlejší způsob, jak najít ovládací prvek uvedený na této stránce. Viz Dotaz na kopilota v aplikaci.Jak to celé spojit
Rychlý start v ovládacím panelu
Průvodce v pěti krocích: agent → fakturace → číslo → simulace → kontrola.
Rychlý start s API
Stejný první hovor ve čtyřech REST voláních.
Používání ovládacího panelu
Vytvořte agenta, dobijte kredit, získejte číslo, simulujte a zkontrolujte hovory.
Připojení nástrojů a dat
Aplikace OAuth, vlastní API, servery MCP a poskytovatelé VoIP.
Analýza a vylepšování
Reporty, sledovatelnost, experimenty, problémy a upozornění.
Tým a účet
Pozvánky a role, klíče API, zabezpečení a SSO.
Kuchařka pro vývojáře
Postupy pro API: příchozí hovory, odchozí hovory, dynamická konfigurace, nástroje, testování.
Ověření podpisů webhooků
Implementujte kontrolu HMAC správně jednou a používejte ji všude.