Dhana za msingi

ThunderPhone ni jukwaa kamili la kuunda, kuendesha, na kuboresha ejenti za sauti za AI. Ukurasa huu ni ramani: kila dhana utakayokutana nayo, kila moja katika sehemu fupi, pamoja na sehemu yake kwenye dashibodi na API inayoisimamia. Uipitie mara moja, kisha urudi wakati wowote istilahi inapohitaji ufafanuzi.

Upau wa kando wa dashibodi unaakisi muundo huu:

Mashirika

Shirika ni kitengo cha upangaji. Kila rasilimali nyingine — ejenti, namba za simu, simu, funguo — ni mali ya shirika moja pekee. Akaunti yako inaweza kuwa ya mashirika mengi; kila moja lina salio lake, funguo zake, na orodha yake ya wanachama.

Ufunguo wa API wa sk_live_ unaounda chini ya Shirika → Funguo unafungamanishwa na shirika moja. Ufungamanishaji huo ndio unaofanya REST API iwe rahisi sana: huweki kamwe id ya shirika katika njia za URL, kwa sababu ufunguo wako tayari unalitambulisha.

Kwenye dashibodi: kiteuzi cha shirika (chini ya upau wa kando) na mipangilio ya Shirika — vichupo vya Akaunti yangu, Jumla, Funguo, Arifa, Mipangilio ya Malipo, na Historia ya Malipo. Angalia marejeleo ya mipangilio ya Shirika.

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

Ejenti

Ejenti ni usanidi wa AI unaoendesha simu. Unajumuisha:

• Prompt inayosimamia ejenti inachosema na jinsi inavyojiendesha — ikijumuisha vitendo vya simu kama kuhamisha simu, kubonyeza vitufe vya keypad, na kukata simu, ambavyo ni mistari ya kawaida ya prompt badala ya usanidi tofauti.
• Kiwango cha injini (spark, bolt, storm-*): Spark imeboreshwa kwa gharama, Bolt kwa kasi, Storm kwa akili katika prompt changamani.
• Sauti pamoja na lugha ya msingi na lugha za ziada zisizo za lazima — ejenti hubadilisha lugha kiotomatiki mpigaji anapobadilisha lugha. Angalia Lugha zinazotumika.
• Uwezo ulioambatishwa: programu zilizounganishwa, miunganisho ya API, misingi ya maarifa, seva za MCP, na zana za function za ndani.
• Vidhibiti vya tabia: mpangilio wa kuzungumza, hali ya uthibitisho, sauti ya nyuma, muda wa kusubiri.

Marekebisho katika kiunda huhifadhiwa kiotomatiki kama rasimu; hakuna kinachoanza kutumika hadi ubofye Tuma. Kila utumaji huhifadhiwa kama nakala katika kichupo cha Historia cha kiunda, hivyo unaweza kukagua na kurejesha toleo lolote la awali.

Kwenye dashibodi: Ejenti za Sauti → kiunda ejenti (/dashboard/agents). Angalia Unda ejenti yako ya kwanza ya sauti.

Katika API: /v1/agents — CRUD, kunakili, kuhamisha, historia ya matoleo, na visaidizi vya prompt.

Sauti

Maktaba ya sauti ina sauti ambazo ejenti anaweza kutumia, sampuli zake zinazoweza kuchezwa, lugha zinazooana, makundi ya jinsia na lafudhi, pamoja na malipo yoyote ya ziada kwa sauti/lugha za malipo. Kijaribio cha sampuli cha kulipia kinaweza kutengeneza kifungu chako mwenyewe cha herufi 1–500 kabla ya kuchagua.

Mashirika yanayostahili yanaweza pia kuunda sauti maalum kutoka kwenye sampuli fupi ya WAV au MP3. Sauti maalum zina kikomo cha idadi na hali ya uundaji wa usawazishaji; zikishakuwa tayari, zinaonekana katika kichaguzi kilekile cha ejenti kama sauti za maktaba.

Kwenye dashibodi: Sauti (/dashboard/voices). Tazama Maktaba ya sauti na sauti maalum.

Kwenye API: /v1/voices, sampuli za sauti, na sauti maalum.

Nambari za simu

Nambari ya simu ni ya shirika na huelekeza simu zinazoingia kwa ejenti (na inaweza kutumika kwa simu zinazotoka). Vyanzo viwili:

• Nambari za onyesho — nambari halisi za Marekani zilizotolewa kutoka kwenye bwawa la ThunderPhone, zinazofanya kazi ndani ya sekunde chache. Ni za simu zinazoingia pekee, hujibu kwa taarifa fupi inayosemwa, na dashibodi huweka kikomo cha 10 kwa shirika. Ni bora kwa jaribio la kwanza; si kwa uzalishaji.
• Nambari za VoIP — zinazoletwa kutoka kwa mtoa huduma wako kupitia muunganisho wa VoIP. Twilio na Telnyx huunganishwa moja kwa moja (Telnyx ina usanidi elekezi); SignalWire na Vonage zinakuja hivi karibuni — kwa sasa unazifikia kupitia usanidi wa SIP wa mkono, unaokubali trunk yoyote ya SIP. Baada ya kuingizwa na kuthibitishwa, nambari za VoIP zinatumia simu zinazoingia na zinazotoka.

Kila safu ya nambari hukuruhusu kuweka hali ya uelekezaji, kuchagua ejenti wa simu zinazoingia, na kuweka lebo kwenye nambari.

Kwenye dashibodi: Nambari za Simu (/dashboard/phone-numbers). Tazama Pata nambari ya simu.

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

Simu

Kila simu inayoingia, simu inayotoka, uigaji, na kipindi cha wijeti huwa rekodi ya simu. Simu ina transkripti kamili yenye lebo za majukumu, historia iliyopangiliwa ya zamu (ikiwemo miito ya zana), rekodi ya sauti, jumla ya malipo, pamoja na upangaji wa alama wa AI na ripoti za matatizo za hiari.

Simu inapokuwa mubashara, unaweza kuifungua na kusikiliza kwa siri — unaunganishwa kimya, na hakuna aliye kwenye simu anayekusikia. Baada ya kuanza kusikiliza, unaweza kunong'ona: andika maelekezo yanayoenda moja kwa moja kwa ejenti wako katikati ya simu; mpigaji simu hayasikii kamwe, na ejenti huyafuata mubashara.

Kwenye dashibodi: Historia ya Simu (/dashboard/call-history) kwa kumbukumbu na maelezo ya kila simu; Mubashara kwa simu zinazoendelea. Tazama Kagua, sikiliza, na elekeza simu zako.

Kwenye API: /v1/calls — orodha, transkripti, historia, sauti, upangaji wa alama, uhamishaji; /v1/issue-reports.

Portal za wateja

Portal ya mteja ni mwonekano wa historia ya simu wa kusoma pekee, wenye chapa, kwa mteja wa nje. Wasimamizi wa shirika huchagua ejenti ambao simu zao zinaonekana, huongeza barua pepe za watazamaji walioidhinishwa, hupakia nembo na rangi ya msisitizo, na kwa hiari huthibitisha kikoa maalum. Watazamaji wa portal wanaweza kuchunguza maelezo ya simu, transkripti, na rekodi za sauti zinazopatikana bila kupewa ufikiaji wa dashibodi.

Kwenye dashibodi: Portal za wateja (/dashboard/client-portals). Tazama Portal za wateja.

Kwenye API: /v1/client-portals kwa sehemu ya usimamizi wa wasimamizi.

Wijeti za wavuti

Wijeti ya wavuti huwapa wanaotembelea tovuti yako mazungumzo yanayotumia maikrofoni na ejenti — hakuna nambari ya simu inayohitajika. Huthibitisha utambulisho kwa ufunguo unaoweza kuchapishwa (pk_live_...) ambao umefungwa kwa vyanzo vya vikoa vyako vinavyoruhusiwa, hivyo ni salama katika msimbo wa upande wa mteja.

Funguo huendeshwa katika hali moja kati ya mbili: agent (imefungwa moja kwa moja kwa ejenti mmoja) au webhook (seva yako huchagua usanidi kwa kila mtembeleaji — tazama Usanidi badilifu kwa kila simu). Vipindi vya wijeti hupitia miundombinu ileile ya simu kama simu za kawaida.

Kwenye dashibodi: Wijeti za wavuti (/dashboard/web-widgets) — unda wijeti, weka hali na ejenti, simamia vikoa vinavyoruhusiwa, na nakili kijisehemu cha kupachika. Tazama Unda wijeti ya wavuti.

Katika API: /v1/publishable-key, /v1/mic-session, na nyaraka za SDK ya wijeti.

Misingi ya maarifa

Msingi wa maarifa ni mkusanyiko wa hati ambazo ejenti wako anaweza kutafuta wakati wa simu ili kutoa majibu yenye msingi — pakia faili, bandika maandishi, au leta kurasa za wavuti kwa URL, kisha ambatisha msingi wa maarifa kwa ejenti katika kijenzi. Ejenti huutafuta kwa zana ya utafutaji iliyojengewa ndani kila mazungumzo yanapouhitaji.

Kwenye dashibodi: Maarifa (/dashboard/knowledge) kwa ajili ya maktaba ya hati; sehemu ya Maarifa ya kijenzi ili kuambatisha msingi kwa ejenti. Tazama Weka msingi wa maarifa kwa ejenti wako.

Miunganisho

Miunganisho ndiyo njia ambayo ejenti hufikia ulimwengu wa nje. Aina nne, kikundi kimoja cha upau wa pembeni:

• Programu (/dashboard/app-connections) — miunganisho ya OAuth kwa Slack, HubSpot, Salesforce, Google Calendar, Google Sheets, na Cal.com. Unganisha mara moja, kisha washa zana za kila operesheni (tuma ujumbe wa Slack, sasisha au unda anwani ya HubSpot, weka nafasi ya Cal.com…) kwa ejenti yeyote. Tazama Unganisha programu.
• API (/dashboard/api-connections) — geuza API yoyote ya HTTP kuwa kitendo cha ejenti. Bandika amri ya cURL na kisaidizi cha AI huandaa rasimu ya ufafanuzi wa zana, au iunde mwenyewe; kitufe cha Ombi la majaribio hutuma simu ya mazingira ya majaribio kabla ya kuzindua. Tazama Miunganisho ya API — sehemu ya dashibodi ya /v1/integrations.
• MCP (/dashboard/mcp-connections) — ongeza seva ya Model Context Protocol kwa URL na uache ejenti itumie zana inazotoa. Tazama Ongeza seva ya MCP.
• VoIP (/dashboard/voip-connections) — stakabadhi za mtoa huduma kwa kutumia nambari zako za simu. Tazama Unganisha mtoa huduma wa VoIP.

ThunderPhone pia hutoa kituo chake cha MCP ili mteja wa nje wa MCP aweze kuorodhesha ejenti, kukagua simu na nakala za mazungumzo, na kupiga simu. Tazama Tumia ThunderPhone kama seva ya MCP.

Katika API: /v1/integrations, /v1/mcp-servers, na /v1/voip-connections; tazama pia Unda muunganisho wa zana.

Kampeni

Kampeni hupiga simu za kutoka kwa kiwango kikubwa: pakia CSV ya anwani, chagua ejenti na nambari ya kutuma simu, kisha weka muda wa kupiga simu (siku na saa, kwa kuzingatia saa za eneo), idadi ya simu zinazofanyika kwa wakati mmoja, na sera ya kujaribu tena (idadi ya juu ya majaribio na matokeo yapi — hakuna jibu, ujumbe wa sauti, haikufaulu — yatajaribiwa tena). Kampeni hupitia orodha na kurekodi kila simu katika Historia ya simu.

Kwenye dashibodi: Kampeni (/dashboard/campaigns). Tazama Endesha kampeni ya simu za kutoka.

Kwa simu binafsi za kiprogramu: API ya simu za kutoka.

Ufuatiliaji wa moja kwa moja

Moja kwa moja huonyesha kila simu inayoendelea katika shirika, na hukuruhusu kufungua yoyote kati yake ili kusikiliza na kunong'ona kwa wakati halisi. Hii ni sehemu ya usimamizi: angalia prompt mpya inapopokea trafiki yake ya kwanza halisi, au fuatilia kampeni inayoendelea.

Kwenye dashibodi: Moja kwa moja (/dashboard/live). Tazama Angalia na simamia simu za moja kwa moja.

Uigaji

Uigaji ni mpigaji simu wa AI anayefanya mazungumzo halisi na ejenti wako — njia ileile ya simu, transkripti halisi, tathmini halisi — ili uweze kufanya majaribio kabla (na baada) ya kutuma. Uelekeze kwa ejenti au nambari ya simu, andika mwenyewe hali ya mpigaji simu au tengeneza hali kwa AI kutoka kwenye prompt ya ejenti (ikijumuisha hali za kipekee, ukiomba), na utazame simu moja kwa moja.

Hali hupangwa katika seti zinazoweka kiwango cha chini cha ufaulu na zinaweza kuzuia matoleo katika CI; kasoro dhidi ya msingi uliokubaliwa huripotiwa kwa kila hali.

Kwenye dashibodi: Uigaji (/dashboard/simulations), pamoja na kitufe cha Uigaji ndani ya kitengenezi cha ejenti. Tazama Igiza simu.

Kwenye API: /v1/test-calls na kiendeshaji cha seti — tazama Jaribu ejenti kutoka mwanzo hadi mwisho.

Seti za uthibitishaji

Seti ya uthibitishaji hubadilisha matukio halisi ya simu kuwa ukaguzi wa kasoro unaorudiwa wa zamu moja. Kila mfano huhifadhi muktadha wa mazungumzo, sauti husika ya mpigaji simu, jibu la awali, na tabia inayotarajiwa. Uchezaji upya huendeshwa dhidi ya rasimu ya sasa ya ejenti bila kupiga simu nyingine, na kidirisha cha kutuma kinaweza kuonyesha kama utekelezaji wa hivi karibuni bado unalingana na rasimu hiyo.

Kwenye dashibodi: Seti za uthibitishaji (/dashboard/validation) kwa seti ya data ya shirika na kichupo cha Uthibitishaji cha kitengenezi cha ejenti kwa utekelezaji. Tazama Seti za uthibitishaji.

Kwenye API: /v1/validation-sets na sehemu za mwisho za kucheza upya ejenti/mfano kwenye ukurasa huo huo wa marejeleo.

Majaribio

Jaribio hufanya majaribio ya A/B ya usanidi wa ejenti kwenye trafiki ya moja kwa moja: fafanua vibadala (prompt, injini, au mipangilio tofauti), gawanya trafiki kati yavyo, na ulinganishe matokeo kwa kila kibadala. Litumie badala ya kuunda mwenyewe mantiki ya bucket katika webhook.

Kwenye dashibodi: Majaribio (/dashboard/experiments) na kichupo cha A/B katika kitengenezi cha ejenti. Tazama Majaribio (majaribio ya A/B).

Matatizo

Tatizo ni hitilafu iliyowekwa alama kwenye simu mahususi — iliyowasilishwa na mkaguzi wa kibinadamu au kugunduliwa na tathmini ya AI. Matatizo yana kiwango cha ukali, chanzo, na hali, na ukurasa wa Matatizo ni foleni ya uchambuzi: chuja, kagua simu yenye tatizo, na fuatilia marekebisho.

Kwenye dashibodi: Matatizo (/dashboard/issues), pamoja na kuweka alama kwa kila simu katika Historia ya Simu. Tazama Uchambuzi wa matatizo.

Kwenye API: /v1/issue-reports.

Ripoti

Ripoti hujibu swali la lugha ya kawaida kuhusu data yako ya simu ("Ni sababu zipi tatu kuu zilizowafanya wapigaji simu kuomba mtu wa kibinadamu wiki iliyopita?") kwa uchanganuzi ulioandikwa na AI, unaolenga ejenti na kipindi cha tarehe unachochagua.

Kwenye dashibodi: Ripoti (/dashboard/reports). Tazama Ripoti.

Ufuatiliaji

Ufuatiliaji ni sehemu ya vipimo: idadi ya simu, matokeo, na ubora kadiri muda unavyopita, unaoweza kuchujwa kwa ejenti na dirisha la muda, ukiwa na uwezo wa kuhamisha kwa uchanganuzi wa hatua zinazofuata.

Kwenye dashibodi: Ufuatiliaji (/dashboard/observability). Tazama Ufuatiliaji.

Tahadhari

Sheria ya tahadhari hufuatilia kipimo (kiwango cha mafanikio, kiwango cha kushindwa, wastani wa alama, idadi ya simu, kasoro za seti) katika dirisha la muda na huwashwa kinapovuka kizingiti chako. Arifa hutumwa kwa barua pepe na Slack, na hutuma tukio la alert.triggered kwa sehemu zako za mwisho za webhook.

Kwenye dashibodi: Shirika → Tahadhari. Tazama Tahadhari.

Webhook

ThunderPhone hutuma webhook za HTTP POST kwenye seva yako mambo yanapotokea wakati wa simu na baada ya simu. Kuna miundo miwili ya uwasilishaji:

• Endpoint za webhook (zinazopendekezwa): dhibiti URL nyingi kwenye /v1/developer/webhook-endpoints kwa siri za kila endpoint na usajili wa matukio wa kila endpoint.
• Webhook ya urithi ya URL moja: URL moja kwa kila shirika. Inadhibitiwa kwenye /v1/webhook au chini ya Shirika → Jumla. Imehifadhiwa kwa uoanifu wa nyuma.

Matukio yamegawanywa katika aina mbili:

• Matukio ya kuzuia yanatarajia seva yako ijibu kwa usanidi unaounda simu inayoendelea — yaani matukio ya simu zinazoingia (telephony.incoming / web.incoming). Una hadi sekunde 10 kujibu; muda ukiisha, ejenti aliyepewa mapema hushughulikia simu.
• Matukio yasiyozuia ni arifa za kutuma bila kusubiri, zinazojaribiwa tena kwa backoff ya eksponensheli — angalia semantiki za uwasilishaji.

Kila ombi hubeba sahihi ya HMAC-SHA256 katika X-ThunderPhone-Signature. Angalia Uthibitishaji wa sahihi.

Zana za function

Zana ya function ni endpoint ya HTTP ambayo ejenti wako anaweza kuitumia katikati ya mazungumzo. Unaipa ThunderPhone schema ya function ya mtindo wa OpenAI pamoja na URL ya endpoint; ejenti huamua wakati wa kuiita, na ThunderPhone hutuma ombi la HTTP lililotiwa sahihi kutoka kwenye seva zake na kurudisha matokeo kwa ejenti.

Ejenti pia huja na uwezo wa simu uliojengewa ndani — kuhamisha simu, kutuma ingizo la vitufe (DTMF), kumaliza simu, kusubiri kwenye hold — unaowasha kwa mistari rahisi ya prompt badala ya ufafanuzi wa zana.

Kwenye dashibodi: sehemu ya Miunganisho ya API ya builder (angalia Miunganisho).

Katika API: /v1/integrations na spec ya Zana za Function.

Timu na majukumu

Kila shirika lina orodha ya wanachama yenye majukumu mawili: Wanachama huunda na kuendesha ejenti; Wasimamizi pia husimamia timu na malipo. Alika kwa barua pepe — mialiko huisha baada ya siku 7 na inaweza kufutwa; menyu ya ⋯ kwenye safu ya mwanachama hubadilisha majukumu au kumwondoa mtu. Kuingia mara moja kunaweza kusanidiwa kwa shirika zima — angalia SSO.

Kwenye dashibodi: Shirika → Jumla. Angalia Alika timu yako.

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

Malipo

ThunderPhone ni ya malipo ya awali. Kila shirika lina salio la USD; simu hukata salio hilo kwa kiwango cha ejenti kwa dakika (kiwango cha engine pamoja na ada za ziada — builder huonyesha kiwango kamili moja kwa moja unapobadilisha mipangilio, na lugha za ziada zilizochaguliwa huongeza 3¢/dakika). Salio linapofikia sifuri, simu zinazoingia hukataliwa na simu zinazotoka hurejesha 402 Payment Required.

Ongeza salio mwenyewe, au washa uongezaji salio kiotomatiki kwa kizingiti cha salio, kiasi cha kujaza tena, na kikomo cha hiari cha matumizi ya kila mwezi — ili simu isikatike katikati ya sentensi.

Kwenye dashibodi: Shirika → Mipangilio ya Malipo na Historia ya Malipo. Angalia Ongeza fedha na washa uongezaji salio kiotomatiki, pamoja na marejeleo kamili ya bei.

Katika API: /v1/billing.

Copilot ya ndani ya programu

Dashibodi huja na copilot iliyojengewa ndani — iulize "ninafanyaje X" na itajibu kwa kutumia nyaraka hizi, itatoa maelekezo ya hatua kwa hatua yanayoangazia vidhibiti halisi, na inaweza kurudia ziara elekezi zozote. Hii ndiyo njia ya haraka zaidi ya kupata kidhibiti kinachotajwa kwenye ukurasa huu. Angalia Uliza copilot ya ndani ya programu.

Kuunganisha yote