Dhana za msingi

Ramani ya kila kitu kwenye jukwaa — kila kipengee hufanya nini, kinapatikana wapi 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, sehemu moja fupi kwa kila dhana, pamoja na sehemu yake kwenye dashibodi na API inayoiunga mkono. Ipitie kwa haraka mara moja, kisha urudi wakati wowote istilahi inapohitaji ufafanuzi.

Upau wa pembeni wa dashibodi unaakisi muundo huu:

Mashirika#

Shirika ni kitengo cha upangaji wa huduma. Kila rasilimali nyingine — ejenti, nambari 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 Shirika → Funguo unafungamanishwa na shirika moja. Ufungamanishaji huo ndio unaofanya REST API iwe tambarare sana: huweki kamwe kitambulisho cha shirika kwenye njia za URL, kwa sababu ufunguo wako tayari unalitambulisha.

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

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

Ejenti#

Ejenti ni usanidi wa AI unaoendesha simu. Unajumuisha:

• Prompt inayosimamia ejenti inasema nini na jinsi inavyojiendesha — ikijumuisha vitendo vya simu kama kuhamisha, 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 hubadilika kiotomatiki mpigaji anapobadilisha lugha. Tazama Lugha zinazotumika.
• Uwezo ulioambatishwa: programu zilizounganishwa, miunganisho ya API, hifadhidata za maarifa, seva za MCP, na zana za utendaji za ndani.
• Vidhibiti vya tabia: mpangilio wa kuzungumza, hali ya kuthibitisha, wimbo wa usuli, muda wa kuisha wa kusubiri.

Marekebisho kwenye kiunda huhifadhiwa kiotomatiki kwenye rasimu; hakuna kinachoenda hewani hadi ubofye Tekeleza. Kila utekelezaji huhifadhiwa kama nakala kwenye kichupo cha Historia cha kiunda, hivyo unaweza kukagua na kurejesha toleo lolote la awali.

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

Kwenye 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 ya malipo. Kijaribio cha kulipia kinaweza kutengeneza kwa usanisi kifungu chako cha herufi 1–500 kabla hujachagua.

Mashirika yanayostahiki yanaweza pia kuunda sauti maalum kutoka kwenye sampuli fupi ya WAV au MP3. Sauti maalum zina kikomo na hali ya uundaji ya asinchronasi; zikisha kuwa tayari, zinaonekana kwenye 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 kubeba simu zinazotoka). Vyanzo viwili:

• Nambari za ThunderPhone — nambari halisi za Marekani zinazotolewa kutoka kwenye dimbwi la ThunderPhone, tayari kutumika ndani ya sekunde, $1 kwa mwezi pamoja na malipo ya ziada ya 1¢/dakika . Ni za simu zinazoingia pekee; simu zinazotoka zinahitaji mtoa huduma wako mwenyewe. Shirika linaweza kuwa na 25 kwa chaguo-msingi.
• 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 mikono, unaokubali trunk yoyote ya SIP. Baada ya kuingizwa na kuthibitishwa, nambari za VoIP zinaauni 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 kumbukumbu ya simu. Simu hubeba nakala kamili ya mazungumzo yenye lebo za majukumu, historia ya zamu iliyopangwa (ikiwemo miito ya zana), rekodi, jumla ya malipo, na hiari utathmini wa AI na ripoti za matatizo.

Wakati simu iko moja kwa moja, unaweza kuifungua na kusikiliza — unaungana kimya, na hakuna aliye kwenye simu anayekusikia. Baada ya kuanza kusikiliza, unaweza kunong'ona: andika maagizo yanayoenda moja kwa moja kwa ejenti wako katikati ya simu; mpigaji simu hayasikii 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 Pitia, sikiliza, na elekeza simu zako.

Kwenye API: /v1/calls — orodha, nakala ya mazungumzo, historia, sauti, utathmini, uhamishaji; /v1/issue-reports.

Portal za wateja#

Portal ya mteja ni mwonekano wenye chapa wa historia ya simu wa kusoma pekee 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 kuthibitisha kikoa maalum. Watazamaji wa portal wanaweza kukagua maelezo ya simu, nakala za mazungumzo, na rekodi zinazopatikana bila kupokea ufikiaji wa dashibodi.

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

Kwenye API: /v1/client-portals kwa kiolesura cha usimamizi wa msimamizi.

Wijeti za wavuti#

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

Funguo huendeshwa katika mojawapo ya hali 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 sawa ya simu kama simu za kawaida.

Kwenye dashibodi: Wijeti za Wavuti (/dashboard/web-widgets) — unda wijeti, weka hali na ejenti, dhibiti 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 yako inaweza kutafuta wakati wa simu ili kutegemeza majibu yake — pakia faili, bandika maandishi, au ingiza kurasa za wavuti kwa URL, kisha ambatisha msingi wa maarifa kwa ejenti katika kijenzi. Ejenti hutumia zana ya utafutaji iliyojengeka kuutafuta wakati wowote mazungumzo yanapouhitaji.

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

Miunganisho#

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

• Programu (/dashboard/app-connections) — miunganisho ya OAuth na Slack, HubSpot, Salesforce, Google Calendar, Google Sheets, na Cal.com. Unganisha mara moja, kisha washa au zima zana za kila operesheni (tuma ujumbe wa Slack, sasisha au unda anwani ya HubSpot, weka nafasi ya Cal.com…) kwenye ejenti yoyote. 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 katika mazingira ya majaribio kabla ya kuzindua. Tazama Miunganisho ya API — kiolesura cha dashibodi cha /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) — vitambulisho vya mtoa huduma kwa kuleta 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 Jenga muunganisho wa zana.

Kampeni#

Kampeni hupiga simu za kutoka kwa kiwango kikubwa: pakia CSV ya anwani, chagua ejenti na nambari ya mpigaji, kisha weka muda wa kupiga simu (siku na saa, kwa kuzingatia eneo la saa), idadi ya simu kwa wakati mmoja, na sera ya kujaribu tena (idadi ya juu ya majaribio na matokeo gani — hakuna jibu, barua ya sauti, imeshindwa — 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 za mara moja kwa programu: API ya simu za kutoka.

Ufuatiliaji wa moja kwa moja#

Moja kwa moja huonyesha kila simu inayoendelea katika shirika lote, na hukuruhusu kufungua yoyote kati ya hizo 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 ileile ya simu, transkripti halisi, upimaji halisi — ili uweze kujaribu kabla ya (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 matukio ya pembezoni ukiomba), kisha tazama simu moja kwa moja.

Hali hukusanywa katika seti zinazoweka kiwango cha chini cha ufaulu na zinaweza kudhibiti uzinduzi katika CI; mabadiliko hasi dhidi ya msingi uliokubaliwa huripotiwa kwa kila hali.

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

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

Seti za uthibitishaji#

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

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

Kwenye API: /v1/validation-sets na vifikio vya uchezaji upya vya ejenti/mfano kwenye ukurasa huohuo wa marejeleo.

Majaribio#

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

Kwenye dashibodi: Majaribio (/dashboard/experiments) na kichupo cha A/B katika kijenga ejenti. Tazama Majaribio (upimaji wa A/B).

Masuala#

Suala ni tatizo lililoalamishwa kwenye simu mahususi — lililoripotiwa na mkaguzi wa kibinadamu au kugunduliwa na upimaji wa AI. Masuala yana kiwango cha uzito, chanzo, na hali, na ukurasa wa Masuala ni foleni ya uchambuzi: chuja, kagua simu yenye tatizo, na fuatilia marekebisho.

Kwenye dashibodi: Masuala (/dashboard/issues), pamoja na kualamisha kwa kila simu katika Historia ya Simu. Tazama Uchambuzi wa masuala.

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 waombe mtu wa kibinadamu wiki iliyopita?") kwa uchanganuzi ulioandikwa na AI, unaolengwa kwa 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 kwa muda, unaoweza kuchujwa kwa ejenti na kipindi cha muda, pamoja na uhamishaji kwa uchanganuzi wa baadaye.

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

Arifa#

Sheria ya arifa hufuatilia kipimo (kiwango cha mafanikio, kiwango cha kushindwa, wastani wa alama, idadi ya simu, mabadiliko hasi ya seti) katika kipindi cha muda na huwashwa kinapovuka kizingiti chako. Arifa hutumwa kwa barua pepe na Slack, na hutuma tukio la alert.triggered kwa vifikio vyako vya webhook.

Kwenye dashibodi: Shirika → Arifa. Tazama Arifa.

Webhook#

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

• Vituo vya webhook (vinavyopendekezwa): simamia URL nyingi katika /v1/developer/webhook-endpoints zenye 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/webhook au chini ya Shirika → Jumla. Imehifadhiwa kwa ajili ya utangamanifu wa nyuma.

Matukio yamegawanywa katika madaraja mawili:

• 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 iliyoteuliwa kwa njia tuli hushughulikia simu.
• Matukio yasiyozuia ni arifa zinazotumwa bila kusubiri, na hujaribiwa tena kwa ucheleweshaji wa ongezeko la eksponenshali — tazama semantiki za utumaji.

Kila ombi hubeba sahihi ya HMAC-SHA256 katika X-ThunderPhone-Signature. Tazama uthibitishaji wa sahihi.

Zana za function#

Zana ya function ni kituo cha HTTP ambacho ejenti wako anaweza kupiga katikati ya mazungumzo. Unaipa ThunderPhone schema ya function ya mtindo wa OpenAI pamoja na URL ya kituo; ejenti huamua wakati wa kukipiga, na ThunderPhone hutuma ombi la HTTP lililotiwa sahihi kutoka kwenye seva zake na kumrudishia ejenti matokeo.

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

Kwenye dashibodi: sehemu ya Miunganisho ya API ya kijenzi (tazama Miunganisho).

Kwenye API: /v1/integrations na maelezo 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 kubatilishwa; menyu ya ⋯ kwenye safu ya mwanachama hubadilisha majukumu au humwondoa 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 shirika lina salio la USD; simu hulitoza kwa kiwango cha ejenti kwa dakika (kiwango cha injini pamoja na ada za ziada — kijenzi 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 hurudisha 402 Payment Required.

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

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

Kwenye API: /v1/billing.

Copilot ya ndani ya programu#

Dashibodi huja na copilot iliyojengewa ndani — iulize "ninawezaje kufanya X" nayo hujibu kutoka kwenye nyaraka hizi, hutoa maelekezo ya hatua kwa hatua yanayoangazia vidhibiti halisi, na inaweza kurudia ziara elekezi yoyote. Ndiyo njia ya haraka zaidi ya kupata kidhibiti kinachotajwa kwenye ukurasa huu. Tazama Uliza copilot ya ndani ya programu.

Kuunganisha yote#