Open in
Dhana za msingi
Ramani ya kila kitu kwenye mfumo — kile ambacho kila kipengee hufanya, mahali kilipo kwenye dashibodi, na API ipi hukitumia.
ThunderPhone ni jukwaa kamili la kujenga, kuendesha, na kuboresha ejenti za sauti za AI. Ukurasa huu ni ramani: kila dhana utakayokutana nayo, kila moja katika sehemu fupi, pamoja na kiolesura cha dashibodi na API inayoisaidia. Ipitie kwa haraka mara moja, kisha urudi wakati wowote neno linapohitaji ufafanuzi.
Upau wa pembeni wa mwonekano wa zamani wa dashibodi unaakisi muundo huu:
Ufuatiliaji wa moja kwa moja na kampeni za kutoka.
Programu, API, seva za MCP, na watoa huduma wa VoIP ambazo ejenti zako zinaweza kutumia.
Webhooks na zana za utendaji kwa msimbo wako mwenyewe.
Mashirika
Shirika ni kitengo cha upangaji wa rasilimali. Kila rasilimali nyingine — ejenti, namba za simu, simu, funguo — ni 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 Miunganisho → Vifunguo vya API
(menyu ya shirika; Shirika → Vifunguo katika mwonekano wa zamani) unahusishwa
na shirika moja. Uhusiano huo ndio unaofanya REST API iwe rahisi sana:
huweki kamwe kitambulisho cha shirika katika njia za URL, kwa sababu ufunguo wako
tayari unalitambua.
Kwenye dashibodi: kibadilishaji cha shirika (chini ya upau wa kando) na mipangilio ya Shirika — vichupo vya Akaunti yangu, Jumla, Funguo, Arifa, Mipangilio ya Utozaji, na Historia ya Utozaji. Angalia Marejeleo ya mipangilio ya shirika.
Katika API: /v1/orgs,
/v1/developer/api-keys.
Ejenti
Ejenti ni usanidi wa AI unaoendesha simu. Unajumuisha:
- prompt inayodhibiti kile ejenti husema na jinsi inavyotenda — ikijumuisha vitendo vya simu kama uhamishaji, mibonyezo ya vitufe, na kukata simu, ambavyo ni mistari ya kawaida ya prompt badala ya usanidi tofauti.
- Mipangilio yake: akili (Core au Pro), uwezo wa kusikia (Lite, Standard, Plus au Max) na kasi ya kujibu, ambayo hubadilishana gharama, kasi na usahihi.
- Sauti pamoja na lugha ya msingi na lugha za ziada za hiari — ejenti hubadilika kiotomatiki mpigaji simu anapobadilisha lugha. Tazama 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 usuli, muda wa kusubiri.
Mabadiliko katika kijenzi huhifadhiwa kiotomatiki kwenye rasimu; hakuna kinachoanza kutumika hadi ubofye Tekeleza. Kila utekelezaji huhifadhiwa kama nakala katika kichupo cha Historia cha kijenzi, hivyo unaweza kukagua na kurejesha toleo lolote la awali.
Kwenye dashibodi: Ejenti za Sauti → kijenzi cha ejenti
(/dashboard/agents). Angalia
Jenga 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 inaweza kutumia, sampuli zake zinazoweza kuchezwa, lugha zinazooana, makundi ya jinsia na lafudhi, pamoja na sauti zipi ni za malipo. Kitoaji sampuli cha kulipia kinaweza kutengeneza kifungu chako mwenyewe cha herufi 1–500 kabla ya kuchagua.
Mashirika yanayostahiki yanaweza pia kuunda sauti maalum kutoka kwenye sampuli fupi ya WAV au MP3. Sauti maalum zina kikomo na hali ya uundaji ya asinkronasi; zikishakuwa tayari, zinaonekana kwenye kiteua ejenti kilekile kinachotumika kwa 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.
Namba za simu
Namba ya simu ni ya shirika na huelekeza simu zinazoingia kwa ejenti (na inaweza kubeba simu za kutoka). Vyanzo viwili:
- Namba za ThunderPhone — namba halisi za Marekani zinazotolewa kutoka kwenye dimbwi la ThunderPhone, huwashwa ndani ya sekunde, $1/mwezi; dakika zao za simu hutozwa kama laini ya simu. Huanzia kwa simu zinazoingia pekee. Msimamizi wa shirika anaweza kuomba upigaji simu unaotoka kutoka ukurasa wa Namba za simu; ThunderPhone hukagua kila ombi mwenyewe, na namba zilizoidhinishwa zinaweza kupiga simu na kuendesha kampeni. Shirika linaweza kuwa na 25 kwa chaguo-msingi.
- Namba za VoIP — zinazoletwa kutoka kwa mtoa huduma wako kupitia muunganisho wa VoIP. Twilio na Telnyx huunganishwa moja kwa moja kwa ufunguo wa API (Telnyx pia ina usanidi elekezi wa akaunti mpya); SignalWire, Vonage, Plivo na mkonga mwingine wowote wa SIP huunganishwa kupitia usanidi wa SIP, usanidi wa SIP wa mikono. Baada ya kuingizwa na kuthibitishwa, namba za VoIP zinaweza kutumia simu zinazoingia na zinazotoka.
Kila safu ya namba hukuruhusu kuweka hali ya uelekezaji, kuchagua ejenti wa simu zinazoingia, na kuweka lebo kwenye namba.
Kwenye dashibodi: Namba za simu (/dashboard/phone-numbers).
Tazama Pata namba ya simu.
Kwenye API: /v1/phone-numbers,
/v1/voip-connections,
/v1/phone-number-labels.
Simu
Kila simu inayoingia, simu inayotoka, uigaji, na kikao cha wijeti hukuwa kumbukumbu ya simu. Simu ina transkripti kamili yenye lebo za majukumu, historia iliyopangiliwa ya zamu (ikiwemo miito ya zana), rekodi, jumla ya malipo, pamoja na ukadiriaji wa hiari wa AI na ripoti za matatizo.
Wakati simu iko moja kwa moja, unaweza kuifungua na kusikiliza kwa siri — unaunganishwa kimya, na hakuna mtu kwenye simu anayekusikia. Baada ya kuanza kusikiliza, unaweza kunong'ona: andika maelekezo yanayoenda moja kwa moja kwa ejenti yako katikati ya simu; mpigaji hawayasikii kamwe, na ejenti huyafuata moja kwa moja.
Kwenye dashibodi: Historia ya simu (/dashboard/call-history) kwa
kumbukumbu na maelezo ya kila simu; Moja kwa moja kwa simu zinazoendelea. Tazama
Kagua, sikiliza, na elekeza simu zako.
Kwenye API: /v1/calls — orodhesha, transkripti,
historia, sauti, ukadiriaji, hamisha;
/v1/issue-reports.
Portali za wateja
Portali ya mteja ni mwonekano wa kumbukumbu za simu wa kusoma pekee wenye chapa kwa ajili ya mteja wa nje. Wasimamizi wa shirika huchagua ejenti ambao simu zao zinaonekana, huongeza barua pepe za watazamaji walioidhinishwa, hupakia nembo na rangi ya mkazo, na kwa hiari huthibitisha domeni maalum. Watazamaji wa portali wanaweza kukagua maelezo ya simu, transkripti, na rekodi zinazopatikana bila kupewa ufikiaji wa dashibodi.
Kwenye dashibodi: Portali za wateja (/dashboard/client-portals). Tazama
Portali za wateja.
Kwenye API: /v1/client-portals kwa
kiolesura cha usimamizi wa msimamizi.
Wijeti za wavuti
Wijeti ya wavuti huwapa wanaotembelea tovuti yako mazungumzo yanayotumia maikrofoni
na ejenti — hakuna nambari ya simu inayohitajika. Inathibitisha kwa kutumia
ufunguo unaoweza kuchapishwa (pk_live_...) ambao vivinjari vinaweza kutumia tu kutoka
kwenye domeni zako zinazoruhusiwa, hivyo ni salama katika msimbo wa upande wa mteja. Orodha ya domeni
si uthibitishaji, na mipangilio ya kipindi ambayo ukurasa unaweza kutuma
imezimwa hadi uiruhusu kwenye ufunguo.
Funguo huendesha katika mojawapo ya modi mbili: agent (imefungwa moja kwa moja kwa ejenti mmoja)
au webhook (seva yako huchagua usanidi kwa kila mgeni — tazama
Usanidi unaobadilika kwa kila simu). Vipindi vya wijeti
hupitia miundombinu ileile ya simu kama simu za kawaida.
Katika dashibodi: Wijeti za wavuti (/dashboard/web-widgets) —
unda wijeti, weka modi 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 nyaraka ambao ejenti wako anaweza kutafuta katikati ya 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 builder. Ejenti huiuliza kwa zana ya utafutaji iliyojengwa ndani kila wakati mazungumzo yanapohitaji hivyo.
Ikiwa uagizaji wa hati utashindwa, unaweza kujaribu tena. Kwa hati za kurasa za wavuti, unaweza pia kuonyesha upya ukurasa ili kuichukua tena. Ukifuta msingi wa maarifa, hati zake huhifadhiwa na kutenganishwa na msingi huo. Ejenti zilizotumia msingi huo hazitaendelea kuona hati hizo isipokuwa uziziambatishe moja kwa moja.
Katika dashibodi: Maarifa (/dashboard/knowledge) kwa ajili ya
maktaba ya nyaraka; sehemu ya Maarifa ya builder ili kuambatisha moja kwa
ejenti. Tazama
Pea ejenti wako msingi wa maarifa.
Miunganisho
Miunganisho ndiyo namna ejenti zinavyofikia ulimwengu wa nje. Aina nne, kundi moja la utepe:
- Apps (
/dashboard/app-connections) — miunganisho ya HubSpot, Salesforce, Google Calendar, Google Sheets na Cal.com. Unganisha mara moja, kisha washa au zima zana za kila operesheni (sasisha au unda anwani ya HubSpot, weka nafasi ya Cal.com…) kwa ejenti yoyote. Tazama Unganisha programu. - APIs (
/dashboard/api-connections) — geuza HTTP API yoyote kuwa kitendo cha ejenti. Bandika amri ya cURL, na kijakazi cha AI kitatayarisha rasimu ya ufafanuzi wa zana, au iunde mwenyewe; kitufe cha Jaribu Ombi hutuma mwito wa sandbox 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 uruhusu ejenti kutumia zana inazotoa. Tazama Ongeza seva ya MCP. - VoIP (
/dashboard/voip-connections) — vitambulisho vya mtoa huduma kwa kuleta nambari zako mwenyewe za simu. Tazama Unganisha mtoa huduma wa VoIP.
ThunderPhone pia hutoa endpoint yake ya 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
Jenga ujumuishaji wa zana.
Kampeni
Kampeni hupiga simu za kutoka kwa kiwango kikubwa: pakia CSV ya anwani, chagua ejenti na nambari ya kupigia, 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 gani — hakuna jibu, ujumbe wa sauti, imeshindwa — yanajaribiwa tena). Kampeni hupitia orodha na kurekodi kila simu katika Historia ya Simu.
Katika dashibodi: Kampeni (/dashboard/campaigns). Tazama
Endesha kampeni ya simu za kutoka.
Kwa simu za programu za mara moja: 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: tazama prompt mpya inapopokea trafiki yake ya kwanza halisi, au fuatilia kampeni inayoendelea.
Kwenye dashibodi: Moja kwa moja (/dashboard/live). Tazama
Fuatilia na simamia simu za moja kwa moja.
Uigaji
Uigaji ni mpigaji simu wa AI anayefanya mazungumzo halisi na ejenti wako — njia sawa ya simu, nakala halisi ya mazungumzo, upangaji alama halisi — ili uweze kujaribu kabla (na baada) ya kuzindua. 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 zisizo za kawaida, ukiomba), na utazame simu moja kwa moja.
Hali hupangwa katika seti ambazo huweka kiwango cha chini cha ufaulu na zinaweza kudhibiti uzinduzi katika CI; mabadiliko ya kurudi nyuma dhidi ya msingi uliokubaliwa huripotiwa kwa kila hali.
Kwenye dashibodi: Uigaji (/dashboard/simulations), pamoja na
kitufe cha Uigaji ndani ya kiunda ejenti. Tazama
Igiza simu.
Kwenye API: /v1/test-calls na
kiendeshaji seti — tazama Jaribu ejenti kutoka mwanzo hadi mwisho.
Seti za uthibitishaji
Seti ya uthibitishaji hubadilisha matukio halisi ya simu kuwa ukaguzi wa kurudiarudia wa mzunguko mmoja. 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 kidokezo cha kuzindua kinaweza kuonyesha iwapo utekelezaji wa hivi karibuni bado unalenga rasimu hiyo.
Kwenye dashibodi: Seti za uthibitishaji (/dashboard/validation) kwa
mkusanyiko wa data wa shirika na kichupo cha Uthibitishaji cha kiunda ejenti
kwa ajili ya utekelezaji. Tazama
Seti za uthibitishaji.
Kwenye API: /v1/validation-sets na
vituo vya mwisho vya uchezaji upya wa 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 matoleo (prompt, injini, au mipangilio tofauti), gawanya trafiki kati yake, na ulinganishe matokeo kwa kila toleo. Litumie badala ya kutengeneza mwenyewe mantiki ya bucket katika webhook.
Kwenye dashibodi: Majaribio (/dashboard/experiments) na
kichupo cha A/B katika kiunda ejenti. Tazama
Majaribio (upimaji wa A/B).
Masuala
Suala ni tatizo lililoalamishwa kwenye simu mahususi — lililoripotiwa na mkaguzi wa kibinadamu au kutambuliwa na upangaji alama wa AI. Masuala yana kiwango cha uzito, chanzo, na hali, na ukurasa wa Masuala ni foleni ya uchunguzi: chujia, kagua simu yenye tatizo, na fuatilia marekebisho.
Kwenye dashibodi: Masuala (/dashboard/issues), pamoja na
kualamisha kwa kila simu katika Historia ya simu. Tazama
Uchunguzi wa masuala.
Kwenye API: /v1/issue-reports.
Ripoti
Ripoti hujibu swali la lugha asilia kuhusu data yako ya simu ("Ni sababu zipi tatu kuu zilizowafanya wapigaji simu waombe mtu wa kibinadamu wiki iliyopita?") kwa uchanganuzi ulioandikwa na AI, unaolenga ejenti na kipindi cha tarehe unachochagua.
Kwenye dashibodi: Ripoti (/dashboard/reports). Tazama
Ripoti.
Uangalizi
Uangalizi ni sehemu ya vipimo: idadi ya simu, matokeo, na ubora kadiri muda unavyopita, vinavyochujwa kwa ejenti na kipindi cha muda, pamoja na usafirishaji wa data kwa uchanganuzi wa baadaye.
Kwenye dashibodi: Uangalizi (/dashboard/observability).
Tazama Uangalizi.
Tahadhari
Sheria ya tahadhari hufuatilia kipimo (kiwango cha mafanikio, kiwango cha hitilafu,
alama ya wastani, idadi ya simu, mabadiliko ya kurudi nyuma ya seti) katika kipindi cha muda na
huwashwa kinapovuka kizingiti chako. Arifa hutumwa kwa barua pepe na
Slack, na huwashwa tukio la alert.triggered kwa
vituo vyako vya mwisho vya 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. Miundo miwili ya uwasilishaji:
- Vituo vya webhook (vinavyopendekezwa): simamia URL nyingi katika
/v1/developer/webhook-endpointskwa siri za kila kituo na usajili wa matukio wa kila kituo. - Webhook ya zamani ya URL moja: URL moja kwa kila shirika. Inasimamiwa katika
/v1/webhookau chini ya Shirika → Jumla. Imehifadhiwa kwa uoanifu wa nyuma.
Matukio yamegawanyika katika aina mbili:
- Matukio ya kuzuia yanatarajia seva yako ijibu kwa usanidi
unaounda simu inayoendelea — yaani
matukio ya simu zinazoingia
(
telephony.incoming/web.incoming). Simu ya kawaida husubiri hadi sekunde 13, ikijumuisha jaribio moja la kurudia, na kipindi cha wijeti sekunde 10. Hakuna ejenti mbadala: bila usanidi unaoweza kutumika, simu hukatishwa na kipindi cha wijeti hushindwa. - Matukio yasiyozuia ni arifa zinazotumwa bila kusubiri majibu, na hurudiwa kwa muda wa kusubiri unaoongezeka kwa kielelezo — tazama mantiki ya uwasilishaji.
Kila ombi hubeba sahihi ya HMAC-SHA256 yenye muhuri wa muda katika
X-ThunderPhone-Signature-V2, pamoja na sahihi ya zamani ya mwili pekee
X-ThunderPhone-Signature. Tazama
uthibitishaji wa sahihi.
Zana za function
Zana ya function ni kituo cha HTTP ambacho ejenti wako anaweza kuita katikati ya mazungumzo. Unaipa ThunderPhone schema ya function ya mtindo wa OpenAI pamoja na URL ya kituo; ejenti huamua lini kuiita, na ThunderPhone hutuma ombi la HTTP lililosainiwa kutoka kwenye seva zake na kumrudishia ejenti matokeo.
Ejenti pia huja na uwezo wa simu uliojengewa ndani — kuhamisha simu, kutuma ingizo la keypad (DTMF), kumaliza simu, kusubiri kwenye hold — ambao unawezesha kwa mistari rahisi ya prompt badala ya fasili za zana.
Kwenye dashibodi: sehemu ya Miunganisho ya API ya kijenzi (tazama Miunganisho).
Kwenye API: /v1/integrations na
spec ya Zana za Function.
Timu na majukumu
Kila shirika lina orodha ya wanachama yenye majukumu mawili: Wanachama hujenga na kuendesha ejenti; Wasimamizi pia husimamia timu na malipo. Alika kwa barua pepe — mialiko huisha baada ya siku 7 na inaweza kubatilishwa; menyu ya ⋯ kwenye mstari wa mwanachama hubadilisha majukumu au huondoa mtu. Kuingia mara moja kunaweza kusanidiwa kwa shirika zima — tazama SSO.
Kwenye dashibodi: Shirika → Jumla. Tazama Alika timu yako.
Kwenye API: /v1/members,
/v1/invites.
Malipo
ThunderPhone ni ya kulipia mapema. Kila org ina salio la USD; kila simu
hukata gharama za vipengele vyake kwa bei za orodha za watoa huduma wetu, pamoja na
ada ya miundombinu na faida ya 17–25% (tazama bei). Salio
linapofikia sifuri, simu zinazoingia hukataliwa na simu zinazotoka
hurejesha 402 Payment Required.
Ongeza salio mwenyewe, au wezesha kujaza salio kiotomatiki kwa kizingiti cha salio, kiasi cha kujaza, 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. Tazama Ongeza fedha na uwashe kujaza salio kiotomatiki, pamoja na marejeleo kamili ya bei.
Kwenye API: /v1/billing.
Copilot ya ndani ya programu
Dashibodi inakuja na copilot iliyojengewa ndani — iulize "ninafanyaje X" nayo hujibu kwa kutumia nyaraka hizi, hutoa mwongozo wa kubofya hatua kwa hatua unaoangazia vidhibiti halisi, na inaweza kurudia ziara elekezi yoyote. Hii ndiyo njia ya haraka zaidi ya kupata kidhibiti kinachotajwa na ukurasa huu. Tazama Uliza copilot ya ndani ya programu.
Kuunganisha yote
Kisanidi cha hatua tano: ejenti → malipo → namba → uigaji → ukaguzi.
Simu ya kwanza sawa katika miito minne ya REST.
Unda ejenti, weka fedha, pata namba, iga, na ukague simu.
Programu za OAuth, API maalum, seva za MCP, na watoa huduma wa VoIP.
Ripoti, uangalizi, majaribio, matatizo, na arifa.
Mialiko na majukumu, funguo za API, usalama, na SSO.
Mapishi ya API: zinazoingia, zinazotoka, usanidi unaobadilika, zana, upimaji.
Fanya ukaguzi wa HMAC kwa usahihi mara moja na utumie tena kila mahali.