Pagrindinės sąvokos

Visų platformos elementų apžvalga — ką daro kiekvienas objektas, kur jis yra valdymo skydelyje ir kuri API su juo sąveikauja.

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

Valdymo skydelio šoninė juosta atkartoja šią struktūrą:

Organizacijos#

Organizacija yra nuomos modelio 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ą, savo raktus ir savo 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: URL keliuose niekada nenurodote organizacijos ID, nes jūsų raktas jau ją identifikuoja.

Valdymo 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ų nuorodą.

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

Agentai#

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

• Komanda, nustatanti, ką agentas sako ir kaip jis elgiasi — įskaitant skambučio veiksmus, pvz., peradresavimus, klaviatūros paspaudimus ir skambučio nutraukimą, kurie yra paprastos komandos eilutės, o ne atskira konfigūracija.
• Variklio pakopa (spark, bolt, storm-*): Spark optimizuotas kainai, Bolt — greičiui, Storm — sudėtingų komandų supratimui.
• Balsas, pagrindinė kalba ir pasirinktinės papildomos kalbos — agentas automatiškai persijungia, kai skambinantysis pakeičia kalbą. Žr. Palaikomos kalbos.
• Prijungtos galimybės: prijungtos programos, API jungtys, žinių bazės, MCP serveriai ir įterptiniai funkcijų įrankiai.
• Elgsenos nustatymai: kalbėjimo tvarka, patvirtinimo režimas, foninis garso takelis, laukimo skirtasis laikas.

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

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

API: /v1/agents — CRUD, dubliavimas, peradresavimas, versijų istorija ir komandų pagalbinės priemonės.

Balsai#

Balsų bibliotekoje pateikiami balsai, kuriuos gali naudoti agentas, jų leidžiami pavyzdžiai, suderinamos kalbos, lyties ir akcentų grupės bei visos papildomos priemokos už aukščiausios kokybės balsus ar kalbas. Mokamas pavyzdžių generatorius gali sintezuoti jūsų 1–500 simbolių frazę prieš jums pasirenkant.

Reikalavimus atitinkančios organizacijos taip pat gali kurti pasirinktinius balsus iš trumpo WAV arba MP3 pavyzdžio. Pasirinktiniai balsai turi kvotą ir asinchroninę kūrimo būseną; kai jie paruošiami, rodomi tame pačiame agentų parinkiklyje kaip ir bibliotekos balsai.

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

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

Telefonų numeriai#

Telefono numeris priklauso organizacijai ir nukreipia įeinančius skambučius agentui (ir gali būti naudojamas išeinantiems skambučiams). Du šaltiniai:

• ThunderPhone numeriai — tikri JAV numeriai, suteikiami iš ThunderPhone numerių fondo ir aktyvuojami per kelias sekundes, $1 per mėnesį ir papildomas 1 ¢ už minutę mokestis. Iš pradžių jie skirti tik įeinantiems skambučiams. Organizacijos administratorius gali prašyti įjungti skambinimą į išorę puslapyje „Telefono numeriai“; ThunderPhone kiekvieną prašymą peržiūri rankiniu būdu, o patvirtinti numeriai gali skambinti ir vykdyti kampanijas. Organizacija pagal numatytuosius nustatymus gali turėti 25 numerius.
• VoIP numeriai — perkeliami iš jūsų paslaugų teikėjo naudojant VoIP ryšį. Twilio ir Telnyx prijungiami tiesiogiai naudojant API raktą (Telnyx taip pat siūlo vedamą naujos paskyros sąranką); SignalWire, Vonage, Plivo ir bet kuris kitas SIP magistralinis ryšys prijungiami naudojant SIP sąranką – rankinę SIP konfigūraciją. Importuoti ir patvirtinti VoIP numeriai palaiko įeinančius ir išeinančius skambučius.

Kiekvienam numerio įrašui galite nustatyti nukreipimo režimą, pasirinkti įeinančių skambučių agentą ir pažymėti numerį etikete.

Valdymo skydelyje: Telefonų 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 sesija tampa skambučio žurnalu. Skambutyje pateikiama visa vaidmenimis pažymėta transkripcija, struktūruota pokalbio eiga (įskaitant įrankių iškvietimus), įrašas, bendra atsiskaitymo suma ir pasirinktiniai DI vertinimai bei problemų ataskaitos.

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

Valdymo skydelyje: Skambučių istorija (/dashboard/call-history) skirta archyvui ir atskiro skambučio informacijai; Tiesiogiai — vykstantiems skambučiams. Žr. Peržiūrėkite, klausykitės ir mokykite savo skambučius.

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

Klientų portalai#

Kliento portalas yra firminis, tik skaitomas skambučių istorijos rodinys išoriniam klientui. Organizacijos administratoriai pasirenka agentus, kurių skambučiai rodomi, prideda patvirtintų žiūrinčiųjų el. pašto adresus, įkelia logotipą ir akcentinę spalvą bei pasirinktinai patvirtina pasirinktinį domeną. Portalo žiūrintieji gali peržiūrėti skambučio informaciją, transkripcijas ir pasiekiamus į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 sąsajai.

Žiniatinklio valdikliai#

Žiniatinklio valdiklis suteikia jūsų svetainės lankytojams galimybę kalbėtis su agentu naudojant mikrofoną — telefono numerio nereikia. Jis autentifikuojamas naudojant viešąjį raktą (pk_live_...), kurį naršyklės gali naudoti tik iš jūsų leidžiamų domenų, todėl jį saugu naudoti kliento pusės kode. Domenų sąrašas nėra autentifikavimas, o seanso nustatymai, kuriuos puslapis gali siųsti, yra išjungti, kol neleidžiate jų naudoti su raktu.

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ė konfigūracija kiekvienam skambučiui). 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 dokumentacija.

Žinių bazės#

Žinių bazė yra dokumentų rinkinys, kuriame jūsų agentas gali ieškoti vykstant skambučiui, 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) skirtos dokumentų bibliotekai; kūrimo priemonės Žinios skiltis skirta prijungti bazę prie agento. Žr. Suteikti 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 bet kuriam agentui kiekvienos operacijos įrankius (siųsti Slack pranešimą, sukurti arba atnaujinti HubSpot kontaktą, rezervuoti Cal.com laiką…). Žr. Prijungti programas.
• API (/dashboard/api-connections) — paverskite bet kurią HTTP API agento veiksmu. Įklijuokite cURL komandą, ir DI vedlys parengs įrankio apibrėžimą, arba sukurkite jį rankiniu būdu; mygtukas Bandomoji užklausa atlieka smėlio dėžės skambutį prieš diegiant. Žr. API jungtys — tai valdymo skydelio sąsaja, skirta /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) — tiekėjo prisijungimo duomenys, skirti naudoti savo telefono numerius. Žr. Prijungti VoIP tiekėją.

ThunderPhone taip pat teikia savo MCP galinį tašką, todėl išorinis MCP klientas gali išvardyti agentus, peržiūrėti skambučius ir nuorašus bei atlikti 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 išeinančius skambučius dideliu mastu: įkelkite kontaktų CSV failą, pasirinkite agentą ir skambintojo numerį, nustatykite skambučių laiką (dienas ir valandas, atsižvelgiant į laiko juostą), vienalaikiškumą ir pakartotinių bandymų politiką (didžiausią bandymų skaičių ir kurių rezultatų — neatsiliepė, balso paštas, nepavyko — skambučiai bus kartojami). Kampanija pereina per sąrašą ir įrašo kiekvieną skambutį į 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.

Tiesioginė stebėsena#

Tiesiogiai rodo visus organizacijoje vykstančius skambučius ir leidžia atidaryti bet kurį iš jų, kad galėtumėte klausytis ir kuždėti realiuoju laiku. Tai priežiūros sritis: stebėkite, kaip nauja užklausa sulaukia pirmojo tikro srauto, arba prižiūrėkite vykdomą kampaniją.

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

Simuliacijos#

Simuliacija – tai AI skambinantysis, 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 skambinančiojo scenarijų arba generuokite scenarijus su AI pagal agento užklausą (įskaitant ribinius atvejus, jei jų paprašysite), ir stebėkite skambutį tiesiogiai.

Scenarijai grupuojami į rinkinius, kuriuose nustatomas minimalus išlaikymo rodiklis ir kurie gali valdyti leidimus CI aplinkoje; regresijos, palyginti su priimta bazine versija, pateikiamos kiekvienam scenarijui.

Valdymo skydelyje: Simuliacijos (/dashboard/simulations), taip pat mygtukas Simuliacija agento kūrimo priemonėje. Žr. Simuliuoti skambutį.

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

Validavimo rinkiniai#

Validavimo rinkinys paverčia tikrus skambučio momentus pakartotiniais vieno pokalbio ėjimo regresijos patikrinimais. Kiekviename pavyzdyje užfiksuojamas pokalbio kontekstas, susijęs skambinančiojo garsas, pirminis atsakymas ir tikėtinas elgesys. Pakartojimai vykdomi su dabartiniu agento juodraščiu neatliekant kito skambučio, o diegimo dialogo lange gali būti rodoma, ar naujausias vykdymas vis dar atitinka tą juodraštį.

Valdymo skydelyje: Validavimo rinkiniai (/dashboard/validation) skirti organizacijos duomenų rinkiniui, o agento kūrimo priemonės skirtukas Validavimas – vykdymams. Žr. Validavimo rinkiniai.

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

Eksperimentai#

Eksperimentas atlieka agento konfigūracijų A/B testavimą su tiesioginiu srautu: apibrėžkite variantus (skirtingas užklausas, variklius ar nustatymus), padalykite srautą tarp jų ir palyginkite kiekvieno varianto rezultatus. Naudokite jį vietoj rankinio segmentų logikos kūrimo žiniatinklio kabliuke.

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

Problemos#

Problema – tai pažymėta konkretaus skambučio problema, kurią pateikė žmogus peržiūrėtojas arba aptiko AI 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 pataisymus.

Valdymo skydelyje: Problemos (/dashboard/issues), taip pat atskirų skambučių žymėjimas skambučių istorijoje. Žr. Problemų rūšiavimas.

API: /v1/issue-reports.

Ataskaitos#

Ataskaita atsako į natūralia kalba užduotą klausimą apie jūsų skambučių duomenis ("Kokios buvo trys pagrindinės priežastys, dėl kurių skambinantieji praėjusią savaitę prašė žmogaus?") pateikdama AI parengtą analizę, apribotą jūsų pasirinktais agentais ir datų intervalu.

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

Stebimumas#

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

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

Įspėjimai#

Įspėjimo taisyklė stebi metriką (sėkmės rodiklį, nesėkmės rodiklį, vidutinį balą, skambučių apimtį, rinkinio regresijas) per laiko intervalą ir suveikia, kai ji peržengia 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.

Webhook#

ThunderPhone siunčia HTTP POST webhook į jūsų serverį, kai skambučio metu ir po jo įvyksta tam tikri veiksmai. Yra du pristatymo modeliai:

• Webhook galiniai taškai (rekomenduojama): valdykite daug URL adresų /v1/developer/webhook-endpoints, naudodami kiekvieno galinio taško paslaptis ir kiekvieno galinio taško įvykių prenumeratas.
• Senas vieno URL webhook: vienas URL adresas vienai organizacijai. Valdomas per /v1/webhook arba skiltyje Organizacija → Bendrieji. Paliktas dėl atgalinio suderinamumo.

Įvykiai skirstomi į dvi klases:

• Blokuojantys įvykiai tikisi, kad jūsų serveris atsakys su konfigūracija, kuri formuoja vykstantį skambutį — tai įeinančio skambučio įvykiai (telephony.incoming / web.incoming). Telefono skambutis laukia iki 13 sekundžių, įskaitant vieną pakartotinį bandymą, o valdiklio sesija – 10 sekundžių. Atsarginio agento nėra: be tinkamos konfigūracijos telefono skambutis nutraukiamas, o valdiklio sesija nepavyksta.
• Neblokuojantys įvykiai yra išsiųsti ir pamiršti pranešimai, pakartotinai siunčiami taikant eksponentinį laukimo intervalą — žr. pristatymo semantiką.

Kiekvienoje užklausoje pateikiamas laiko žyma pažymėtas HMAC-SHA256 parašas X-ThunderPhone-Signature-V2, taip pat senasis tik užklausos turiniui skirtas X-ThunderPhone-Signature. Žr. parašo patvirtinimą.

Funkcijų įrankiai#

Funkcijos įrankis yra HTTP galinis taškas, kurį jūsų agentas gali iškviesti pokalbio metu. 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 grąžina rezultatą agentui.

Agentai taip pat turi integruotas skambučių funkcijas — 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 ryšiai (žr. Ryšiai).

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ą. Pakvieskite el. paštu — kvietimų galiojimas baigiasi po 7 dienų ir juos galima atšaukti; nario eilutės meniu ⋯ leidžia keisti vaidmenis arba pašalinti žmogų. 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 su išankstiniu mokėjimu. Kiekviena organizacija turi USD likutį; už skambučius iš jo nurašoma pagal agento minutės tarifą (variklio pakopa ir papildomi mokesčiai — kūrimo priemonė realiuoju laiku rodo bendrą tarifą keičiant nustatymus, o pasirinktos papildomos kalbos prideda 3 ct./min.). Kai likutis pasiekia nulį, įeinantys skambučiai atmetami, o išeinantys skambučiai grąžina 402 Payment Required.

Papildykite likutį rankiniu būdu arba įjunkite automatinį papildymą su likučio riba, papildymo suma ir pasirinktiniu mėnesio išlaidų limitu — 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šsamią kainodaros informaciją.

API: /v1/billing.

Programėlėje esantis pagalbininkas#

Valdymo skydelyje yra integruotas pagalbininkas — paklauskite jo „kaip man atlikti X“, ir jis atsakys remdamasis šia dokumentacija, pasiūlys žingsnis po žingsnio instrukcijas, išryškinančias tikruosius valdiklius, bei gali pakartoti bet kurią iš interaktyvių apžvalgų. Tai greičiausias būdas rasti šiame puslapyje minimą valdiklį. Žr. Klauskite programėlėje esančio pagalbininko.

Viską sujungiant#