ThunderPhone v3 jau veikia.Viską atlikite savarankiškai – nuo 2 ct/min.Skaityti pranešimą

Getting Started

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ą.

Senojo skydelio rodinio šoninė juosta atspindi š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šą.

sk_live_ API raktas, kurį sukuriate skiltyje Integracijos → API raktai (organizacijos meniu; senajame rodinyje 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 ją jau 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:

  • Raginimas, kuris nustato, ką agentas sako ir kaip jis elgiasi, įskaitant skambučių veiksmus, pvz., peradresavimą, klaviatūros paspaudimus ir skambučio nutraukimą, kurie yra paprastos raginimo eilutės, o ne atskira konfigūracija.
  • Jo nustatymai: intelektas (Core arba Pro), klausymas (Lite, Standard, Plus arba Max) ir atsakymo greitis, kurie suderina kainą, greitį ir tikslumą.
  • 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 įterptieji funkcijų įrankiai.
  • Elgsenos nustatymai: kalbėjimo tvarka, patvirtinimo režimas, foninis garso takelis, laukimo laiko limitas.

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

Balso bibliotekoje pateikiami balsai, kuriuos gali naudoti agentas, jų atkuriami pavyzdžiai, suderinamos kalbos, lyties ir akcentų grupės bei informacija, kurie balsai yra aukščiausios kokybės. Mokamas pavyzdžių kūrimo įrankis gali sintezuoti jūsų pasirinktą 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 aktyvūs per kelias sekundes, $1 per mėnesį; jų pokalbių minutės apmokestinamos kaip telefono linija. Iš pradžių jie skirti tik įeinantiems skambučiams. Organizacijos administratorius gali paprašyti galimybės skambinti iš numerio puslapyje Telefono numeriai; ThunderPhone kiekvieną prašymą peržiūri rankiniu būdu, o patvirtinti numeriai gali skambinti ir vykdyti kampanijas. Pagal numatytuosius nustatymus organizacija gali turėti 25 numerius.
  • VoIP numeriai — prijungiami iš jūsų teikėjo naudojant VoIP ryšį. Twilio ir Telnyx prijungiami tiesiogiai naudojant API raktą (Telnyx taip pat siūlo interaktyvią naujos paskyros sąranką); SignalWire, Vonage, Plivo ir bet kuris kitas SIP magistralinis ryšys prijungiami per 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.

Jei dokumento importavimas nepavyksta, galite bandyti dar kartą. Tinklalapių dokumentams taip pat galite atnaujinti puslapį, kad jis būtų nuskaitytas iš naujo. Jei ištrinate žinių bazę, jos dokumentai išsaugomi ir atjungiami nuo tos bazės. Agentai, kurie naudojo šią bazę, nebemato tų dokumentų, nebent juos prijungiate tiesiogiai.

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) — ryšiai su HubSpot, Salesforce, Google Calendar, Google Sheets ir Cal.com. Prisijunkite vieną kartą, tada įjunkite konkrečioms operacijoms skirtus įrankius (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 vediklis parengs įrankio apibrėžtį, arba sukurkite ją rankiniu būdu; mygtukas Bandomoji užklausa prieš diegiant paleidžia bandomosios aplinkos iškvietimą. Žr. API ryšiai — tai /v1/integrations valdymo skydelio sąsaja.
  • 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) — teikėjo prisijungimo duomenys, skirti naudoti savo telefono numerius. Žr. Prijungti VoIP teikė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 yra iš anksto apmokamas. Kiekviena organizacija turi USD likutį; už kiekvieną skambutį nurašoma jo sudedamųjų dalių kaina pagal mūsų tiekėjų sąrašines kainas, infrastruktūros mokestis ir 17–25 % marža (žr. kainodarą). 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