Pagrindinės sąvokos

ThunderPhone yra išsami platforma, skirta kurti, vykdyti ir tobulinti DI balso agentus. Šis puslapis yra žemėlapis: kiekviena sąvoka, su kuria susidursite, pateikiama atskirame trumpame skyriuje kartu su atitinkama skydelio sąsaja ir ją palaikančia API. Greitai perskaitykite jį vieną kartą, tada grįžkite, kai reikės išsiaiškinti terminą.

Skydelio šoninė juosta atkartoja šią struktūrą:

Organizacijos

Organizacija yra atskiros aplinkos vienetas. Kiekvienas kitas išteklius — agentai, telefono numeriai, skambučiai, raktai — priklauso tik vienai organizacijai. Jūsų paskyra gali priklausyti daugeliui organizacijų; kiekviena turi savo balansą, raktus ir narių sąrašą.

API raktas sk_live_, kurį sukuriate skiltyje Organizacija → Raktai, yra susietas su viena organizacija. Dėl šio susiejimo REST API yra tokia paprasta: niekada nenurodote organizacijos ID URL keliuose, nes jūsų raktas jau ją identifikuoja.

Skydelyje: organizacijos perjungiklis (šoninės juostos apačioje) ir Organizacijos nustatymai — skirtukai Mano paskyra, Bendrieji, Raktai, Įspėjimai, Atsiskaitymo nustatymai ir Atsiskaitymo istorija. Žr. organizacijos nustatymų informaciją.

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

Agentai

Agentas yra DI konfigūracija, kuri vykdo skambutį. Ją sudaro:

• Instrukcija, kuri nustato, ką agentas sako ir kaip elgiasi — įskaitant skambučio veiksmus, pvz., peradresavimą, klaviatūros mygtukų paspaudimus ir skambučio nutraukimą; tai yra paprastos instrukcijos eilutės, o ne atskira konfigūracija.
• Variklio pakopa (spark, bolt, storm-*): Spark optimizuotas kainai, Bolt — greičiui, Storm — sudėtingų instrukcijų išmanumui.
• Balsas, pagrindinė kalba ir pasirenkamos papildomos kalbos — agentas automatiškai persijungia, kai skambinantysis pakeičia kalbą. Žr. Palaikomos kalbos.
• Prijungtos galimybės: prijungtos programos, API integracijos, žinių bazės, MCP serveriai ir įterptiniai funkcijų įrankiai.
• Elgsenos nustatymai: kalbėjimo tvarka, patvirtinimo režimas, fono takelis, laukimo laiko limitas.

Pakeitimai kūrimo priemonėje automatiškai įrašomi kaip juodraštis; niekas nepublikuojama, kol nepaspaudžiate Diegti. Kiekvienas diegimas išsaugomas kūrimo priemonės skirtuke Istorija, todėl galite peržiūrėti ir atkurti bet kurią ankstesnę versiją.

Skydelyje: Balso agentai → agento kūrimo priemonė (/dashboard/agents). Žr. Sukurkite pirmąjį balso agentą.

API: /v1/agents — CRUD, kopijavimas, perdavimas, versijų istorija ir instrukcijų pagalbinės priemonės.

Balsai

Balsų bibliotekoje pateikiami balsai, kuriuos gali naudoti agentas, jų perklausomi pavyzdžiai, suderinamos kalbos, lyties ir akcentų grupės bei visi papildomi mokesčiai už aukščiausios kokybės balsus ar kalbas. Prieš pasirinkdami galite naudoti mokamą pavyzdžių generatorių, kad susintetintumėte savo 1–500 simbolių frazę.

Tinkamos organizacijos taip pat gali sukurti pasirinktinius balsus iš trumpo WAV arba MP3 pavyzdžio. Pasirinktiniams balsams taikoma kvota ir asinchroninė kūrimo būsena; kai jie paruošiami, jie rodomi tame pačiame agentų pasirinkimo sąraše kaip ir bibliotekos balsai.

Valdymo skydelyje: Balsai (/dashboard/voices). Žr. Balsų biblioteka ir pasirinktiniai balsai.

API: /v1/voices, balso pavyzdžiai ir pasirinktiniai balsai.

Telefono numeriai

Telefono numeris priklauso organizacijai ir nukreipia įeinančius skambučius į agentą (taip pat gali vykdyti išeinančius skambučius). Yra du šaltiniai:

• Demonstraciniai numeriai — tikri JAV numeriai, suteikiami iš ThunderPhone numerių fondo ir aktyvuojami per kelias sekundes. Jie skirti tik įeinantiems skambučiams, atsiliepia trumpu žodiniu pranešimu, o valdymo skydelyje vienai organizacijai leidžiama turėti ne daugiau kaip 10 tokių numerių. Puikiai tinka pirmam bandymui, bet ne produkcijai.
• VoIP numeriai — gaunami iš jūsų paslaugų teikėjo per VoIP ryšį. Twilio ir Telnyx jungiami tiesiogiai (Telnyx turi vedamąją sąranką); SignalWire ir Vonage bus prieinami netrukus — šiuo metu juos galite pasiekti naudodami rankinę SIP konfigūraciją, kuri priima bet kokį SIP magistralinį ryšį. Importuoti ir patvirtinti VoIP numeriai palaiko įeinančius ir išeinančius skambučius.

Kiekvienoje numerio eilutėje galite nustatyti nukreipimo režimą, pasirinkti įeinančių skambučių agentą ir priskirti numeriui etiketę.

Valdymo skydelyje: Telefono numeriai (/dashboard/phone-numbers). Žr. Gaukite telefono numerį.

API: /v1/phone-numbers, /v1/voip-connections, /v1/phone-number-labels.

Skambučiai

Kiekvienas įeinantis skambutis, išeinantis skambutis, simuliacija ir valdiklio seansas registruojamas kaip skambučio įrašas. Skambučio įraše pateikiama visa vaidmenimis pažymėta transkripcija, struktūrizuota pokalbio eigų istorija (įskaitant įrankių iškvietimus), įrašas, bendra atsiskaitymo suma ir pasirinktinai AI vertinimai bei problemų ataskaitos.

Kol skambutis yra aktyvus, galite jį atidaryti ir klausytis — prisijungiate tyliai, todėl niekas skambučio metu jūsų negirdi. Pradėję klausytis galite pašnibždėti: įveskite nurodymą, kuris skambučio metu tiesiogiai perduodamas jūsų agentui; skambinantysis jo niekada negirdi, o agentas jį vykdo nedelsdamas.

Valdymo skydelyje: Skambučių istorija (/dashboard/call-history) skirta archyvui ir išsamiai kiekvieno skambučio informacijai; Aktyvūs skirta vykstantiems skambučiams. Žr. Peržiūrėkite, klausykitės ir padėkite valdyti savo skambučius.

API: /v1/calls — sąrašas, transkripcija, istorija, garsas, vertinimas, eksportavimas; /v1/issue-reports.

Klientų portalai

Kliento portalas yra su prekės ženklu pritaikytas, tik skaitomas skambučių istorijos rodinys išoriniam klientui. Organizacijos administratoriai pasirenka agentus, kurių skambučiai rodomi, prideda patvirtintų peržiūros naudotojų el. pašto adresus, įkelia logotipą ir akcento spalvą bei pasirinktinai patvirtina pasirinktinį domeną. Portalo peržiūros naudotojai gali peržiūrėti skambučių išsamią informaciją, transkripcijas ir prieinamus įrašus, nesuteikiant jiems prieigos prie valdymo skydelio.

Valdymo skydelyje: Klientų portalai (/dashboard/client-portals). Žr. Klientų portalai.

API: /v1/client-portals skirta administravimo valdymo funkcijoms.

Žiniatinklio valdikliai

Žiniatinklio valdiklis suteikia jūsų svetainės lankytojams galimybę kalbėtis su agentu naudojant mikrofoną — telefono numeris nereikalingas. Jis autentifikuojamas naudojant viešinamą raktą (pk_live_...), kuris susietas su jūsų leidžiamų domenų kilme, todėl jį saugu naudoti kliento pusės kode.

Raktai veikia vienu iš dviejų režimų: agent (statiškai susietas su vienu agentu) arba webhook (jūsų serveris parenka konfigūraciją kiekvienam lankytojui — žr. Dinaminė kiekvieno skambučio konfigūracija). Valdiklio sesijos naudoja tą pačią skambučių infrastruktūrą kaip ir telefono skambučiai.

Valdymo skydelyje: Žiniatinklio valdikliai (/dashboard/web-widgets) — kurkite valdiklius, nustatykite režimą ir agentą, tvarkykite leidžiamus domenus ir nukopijuokite įterpimo fragmentą. Žr. Sukurti žiniatinklio valdiklį.

API: /v1/publishable-key, /v1/mic-session ir Valdiklio SDK dokumentaciją.

Žinių bazės

Žinių bazė yra dokumentų rinkinys, kuriame jūsų agentas gali ieškoti skambučio metu, kad pagrįstų savo atsakymus — įkelkite failus, įklijuokite tekstą arba importuokite tinklalapius pagal URL, tada kūrimo priemonėje prijunkite žinių bazę prie agento. Agentas užklausia ją naudodamas integruotą paieškos įrankį, kai to reikia pokalbio metu.

Valdymo skydelyje: Žinios (/dashboard/knowledge) skirta dokumentų bibliotekai; kūrimo priemonės skiltis Žinios skirta prijungti ją prie agento. Žr. Suteikite agentui žinių bazę.

Jungtys

Jungtys leidžia agentams pasiekti išorinį pasaulį. Keturi tipai, viena šoninės juostos grupė:

• Programos (/dashboard/app-connections) — OAuth jungtys su Slack, HubSpot, Salesforce, Google Calendar, Google Sheets ir Cal.com. Prisijunkite vieną kartą, tada įjunkite konkrečių operacijų įrankius (siųsti Slack žinutę, atnaujinti arba sukurti HubSpot kontaktą, rezervuoti Cal.com laiką...) bet kuriam agentui. Žr. Prijungti programas.
• API (/dashboard/api-connections) — paverskite bet kurią HTTP API agento veiksmu. Įklijuokite cURL komandą, o DI vedlys parengs įrankio apibrėžimą, arba sukurkite jį rankiniu būdu; mygtukas Bandomoji užklausa vykdo smėlio dėžės skambutį prieš diegiant. Žr. API jungtys — valdymo skydelio sąsają, skirtą /v1/integrations.
• MCP (/dashboard/mcp-connections) — pridėkite Model Context Protocol serverį pagal URL ir leiskite agentui naudoti jo teikiamus įrankius. Žr. Pridėti MCP serverį.
• VoIP (/dashboard/voip-connections) — paslaugų teikėjo prisijungimo duomenys, skirti naudoti savo telefono numerius. Žr. Prijungti VoIP paslaugų teikėją.

ThunderPhone taip pat teikia savo MCP galinį tašką, kad išorinis MCP klientas galėtų išvardyti agentus, peržiūrėti skambučius ir nuorašus bei vykdyti skambučius. Žr. Naudoti ThunderPhone kaip MCP serverį.

API: /v1/integrations, /v1/mcp-servers ir /v1/voip-connections; taip pat žr. Sukurti įrankio integraciją.

Kampanijos

Kampanija vykdo daug išeinančių skambučių: įkelkite kontaktų CSV failą, pasirinkite agentą ir numerį, iš kurio skambinama, bei nustatykite skambinimo langą (dienas ir valandas, atsižvelgiant į laiko juostą), vienu metu vykdomų skambučių skaičių ir pakartojimų politiką (didžiausią bandymų skaičių ir kuriems rezultatams — neatsakyta, balso paštas, nepavyko — bus bandoma dar kartą). Kampanija vykdoma pagal sąrašą ir kiekvieną skambutį įrašo į skambučių istoriją.

Valdymo skydelyje: Kampanijos (/dashboard/campaigns). Žr. Vykdyti išeinančių skambučių kampaniją.

Vienkartiniams programiniams skambučiams: naudokite išeinančių skambučių API.

Tiesiogiai

Tiesiogiai rodo kiekvieną vykstantį skambutį visoje organizacijoje ir leidžia atidaryti bet kurį iš jų, kad galėtumėte klausytis ir kuždėti realiuoju laiku. Tai priežiūros erdvė: stebėkite, kaip nauja instrukcija sulaukia pirmojo realaus srauto, arba sekite vykdomą kampaniją.

Valdymo skydelyje: Tiesiogiai (/dashboard/live). Žr. Stebėti ir prižiūrėti tiesioginius skambučius.

Simuliacijos

Simuliacija – tai DI skambintojas, vedantis tikrą pokalbį su jūsų agentu – tas pats telefonijos kelias, tikra transkripcija, tikras vertinimas – todėl galite testuoti prieš diegdami (ir po diegimo). Nukreipkite ją į agentą arba telefono numerį, patys parašykite skambintojo scenarijų arba generuokite scenarijus su DI pagal agento instrukciją (įskaitant ribinius atvejus, jei jų paprašysite) ir stebėkite skambutį tiesiogiai.

Scenarijai grupuojami į rinkinius, kuriuose nustatomas minimalus sėkmės rodiklis ir kurie gali blokuoti leidimus CI aplinkoje; regresijos, palyginti su priimtu baziniu lygiu, pateikiamos kiekvienam scenarijui.

Valdymo skydelyje: Simuliacijos (/dashboard/simulations) ir mygtukas Simuliacija agento kūrimo įrankyje. Žr. Simuliuoti skambutį.

API: /v1/test-calls ir rinkinio vykdyklė – žr. Ištestuoti agentą nuo pradžios iki pabaigos.

Validavimo rinkiniai

Validavimo rinkinys tikrus skambučio momentus paverčia pakartojamais vieno pokalbio ėjimo regresijos patikrinimais. Kiekvienas pavyzdys užfiksuoja pokalbio kontekstą, susijusį skambintojo garsą, pirminį atsakymą ir numatomą elgseną. Pakartotiniai paleidimai vykdomi naudojant dabartinį agento juodraštį, neatliekant kito skambučio, o diegimo dialogas gali parodyti, ar naujausias paleidimas vis dar atitinka tą juodraštį.

Valdymo skydelyje: Validavimo rinkiniai (/dashboard/validation) organizacijos duomenų rinkiniui ir agento kūrimo įrankio skirtukas Validavimas paleidimams. Žr. Validavimo rinkiniai.

API: /v1/validation-sets ir agento bei pavyzdžio pakartotinio paleidimo galiniai taškai tame pačiame nuorodų puslapyje.

Eksperimentai

Eksperimentas vykdo agento konfigūracijų A/B testavimą realiame sraute: apibrėžkite variantus (skirtingas instrukcijas, variklius ar nustatymus), padalykite srautą tarp jų ir palyginkite kiekvieno varianto rezultatus. Naudokite tai, užuot patys kūrę segmentavimo logiką žiniatinklio kabliuke.

Valdymo skydelyje: Eksperimentai (/dashboard/experiments) ir skirtukas A/B agento kūrimo įrankyje. Žr. Eksperimentai (A/B testavimas).

Problemos

Problema – tai pažymėtas nesklandumas konkrečiame skambutyje, kurį užregistravo žmogus peržiūrėtojas arba aptiko DI vertinimas. Problemos turi svarbumo lygį, šaltinį ir būseną, o puslapis Problemos yra rūšiavimo eilė: filtruokite, peržiūrėkite probleminį skambutį ir stebėkite taisymus.

Valdymo skydelyje: Problemos (/dashboard/issues) ir kiekvieno skambučio žymėjimas Skambučių istorijoje. Žr. Problemų rūšiavimas.

API: /v1/issue-reports.

Ataskaitos

Ataskaita atsako į natūralios kalbos klausimą apie jūsų skambučių duomenis ("Dėl kokių trijų pagrindinių priežasčių skambintojai praėjusią savaitę prašė žmogaus?") naudodama DI parengtą analizę, apribotą jūsų pasirinktais agentais ir datų intervalu.

Valdymo skydelyje: Ataskaitos (/dashboard/reports). Žr. Ataskaitos.

Stebimumas

Stebimumas yra metrikų erdvė: skambučių apimtis, rezultatai ir kokybė laikui bėgant, filtruojama pagal agentą ir laiko intervalą, su eksportu tolesnei analizei.

Valdymo skydelyje: Stebimumas (/dashboard/observability). Žr. Stebimumas.

Įspėjimai

Įspėjimo taisyklė stebi metriką (sėkmės rodiklį, nesėkmių rodiklį, vidutinį balą, skambučių apimtį, rinkinių regresijas) per laiko intervalą ir suveikia, kai ji viršija jūsų ribą. Pranešimai siunčiami el. paštu ir į Slack, taip pat suaktyvinamas alert.triggered įvykis jūsų žiniatinklio kabliukų galiniams taškams.

Valdymo skydelyje: Organizacija → Įspėjimai. Žr. Įspėjimai.

Žiniatinklio kabliukai

ThunderPhone siunčia HTTP POST žiniatinklio kabliukus į jūsų serverį, kai skambučio metu ar po jo įvyksta tam tikri veiksmai. Du pristatymo modeliai:

• Žiniatinklio kabliukų galiniai taškai (rekomenduojama): valdykite daug URL adresų /v1/developer/webhook-endpoints, naudodami kiekvienam galiniam taškui skirtas paslaptis ir įvykių prenumeratas.
• Senstelėjęs vieno URL žiniatinklio kabliukas: vienas URL adresas vienai organizacijai. Valdomas per /v1/webhook arba skiltyje Organizacija → Bendrieji. Paliktas siekiant užtikrinti atgalinį suderinamumą.

Įvykiai skirstomi į dvi klases:

• Blokuojantys įvykiai tikisi, kad jūsų serveris atsakys konfigūracija, kuri formuoja vykstantį skambutį — tai įeinančio skambučio įvykiai (telephony.incoming / web.incoming). Atsakyti galite per ne daugiau kaip 10 sekundžių; pasibaigus skirtajam laikui, skambutį apdoroja statiškai priskirtas agentas.
• Neblokuojantys įvykiai yra pranešimai, siunčiami be atsakymo laukimo, pakartotinai siunčiami eksponentiškai didinant intervalus — žr. pristatymo semantiką.

Kiekvienoje užklausoje pateikiamas HMAC-SHA256 parašas X-ThunderPhone-Signature. Žr. parašo tikrinimą.

Funkcijų įrankiai

Funkcijos įrankis yra HTTP galinis taškas, kurį jūsų agentas gali iškviesti pokalbio viduryje. ThunderPhone pateikiate „OpenAI“ stiliaus funkcijos schemą ir galinio taško URL; agentas nusprendžia, kada ją iškviesti, o ThunderPhone iš savo serverių siunčia pasirašytą HTTP užklausą ir perduoda rezultatą agentui.

Agentai taip pat turi integruotas skambučio galimybes — skambučio perdavimą, klaviatūros (DTMF) įvesties siuntimą, skambučio užbaigimą, laukimo režimą — kurias įjungiate paprastomis raginimo eilutėmis, o ne įrankių apibrėžimais.

Valdymo skydelyje: kūrimo priemonės skiltis API jungtys (žr. Jungtys).

API: /v1/integrations ir Funkcijų įrankių specifikacija.

Komanda ir vaidmenys

Kiekviena organizacija turi narių sąrašą su dviem vaidmenimis: Nariai kuria ir valdo agentus; Administratoriai taip pat valdo komandą ir atsiskaitymą. Kviesti galite el. paštu — kvietimų galiojimas baigiasi po 7 dienų ir juos galima atšaukti; ⋯ meniu nario eilutėje leidžia keisti vaidmenis arba pašalinti asmenį. Vienkartinį prisijungimą galima sukonfigūruoti visai organizacijai — žr. SSO.

Valdymo skydelyje: Organizacija → Bendrieji. Žr. Pakvieskite savo komandą.

API: /v1/members, /v1/invites.

Atsiskaitymas

ThunderPhone veikia pagal išankstinio mokėjimo principą. Kiekviena organizacija turi USD balansą; už skambučius iš jo nurašoma pagal agento minutės tarifą (variklio pakopa ir papildomi mokesčiai — kūrimo priemonė tiesiogiai rodo bendrą tarifą, kai keičiate nustatymus, o pasirinktos papildomos kalbos kainuoja papildomus 3 ct./min.). Kai balansas pasiekia nulį, įeinantys skambučiai atmetami, o siunčiant skambučius grąžinamas 402 Payment Required.

Papildykite balansą rankiniu būdu arba įjunkite automatinį papildymą, nustatydami balanso ribą, papildymo sumą ir pasirinktinį mėnesio išlaidų limitą — kad skambutis niekada nenutrūktų sakinio viduryje.

Valdymo skydelyje: Organizacija → Atsiskaitymo nustatymai ir Atsiskaitymo istorija. Žr. Pridėkite lėšų ir įjunkite automatinį papildymą, taip pat išsamų kainodaros aprašą.

API: /v1/billing.

Programoje integruotas kopilotas

Valdymo skydelyje yra integruotas kopilotas — paklauskite jo „kaip atlikti X“, ir jis atsakys remdamasis šia dokumentacija, pasiūlys nuoseklias instrukcijas, kuriose išryškinami tikrieji valdikliai, ir gali pakartotinai paleisti bet kurią interaktyvią apžvalgą. Tai greičiausias būdas rasti šio puslapio minimą valdiklį. Žr. Klauskite programoje integruoto kopiloto.

Viską sujungus