ThunderPhone v3 sasa inapatikana.Anza mwenyewe, kuanzia 2¢/dakika.Soma tangazo

Connect tools & data

Tumia ThunderPhone kama seva ya MCP

Unda, jaribu, thibitisha na endesha ejenti za sauti za ThunderPhone kutoka Claude, ChatGPT, Claude Code, Codex, Cursor, VS Code au mteja mwingine wa Streamable HTTP MCP.

ThunderPhone hutoa seva ya Streamable HTTP Model Context Protocol katika:

https://api.thunderphone.com/v1/mcp

Hii ni mwelekeo kinyume na kuunganisha seva ya mbali ya MCP kwenye ejenti ya sauti:

MwelekeoMatokeo
Seva ya mbali ya MCP → ejenti ya ThunderPhoneEjenti ya sauti inaweza kuita zana za seva ya mbali.
ThunderPhone → mteja wako wa MCPEjenti yako ya uandishi wa msimbo inaweza kujenga, kujaribu na kuendesha ThunderPhone.

Thibitisha utambulisho

Tumia OAuth kwa chaguomsingi kwa wateja wa saraka: ingia, chagua shirika, na idhinisha ruhusa zilizoombwa. Katisha muunganisho chini ya Mipangilio → Usalama → Programu ulizounganisha. Kubadilisha au kuweka upya nenosiri lako, au kubadilisha barua pepe ya akaunti yako, pia hubatilisha muunganisho, hivyo unganisha tena mteja baadaye.

Kwa wateja waliowekwa na ufunguo wa API, unda ufunguo wa sk_live_ chini ya Miunganisho → Funguo za API na uufichue kwa mteja wako wa MCP kama THUNDERPHONE_API_KEY. Ufunguo umefungwa kwa shirika moja; id inayomilikiwa na shirika lingine hutenda kana kwamba haijapatikana.

Mashirika yanayoshughulikia PHI

Iwapo simu za shirika lako zinaweza kuwa na taarifa za afya zilizolindwa (PHI), kwa sababu una BAA na ThunderPhone au ejenti zako zimeainishwa kuwa zinachakata PHI, URL iliyo hapo juu hairudishi kamwe maudhui ya simu: nakala za maandishi, rekodi, alama, orodha za simu, uhamishaji, matokeo ya kampeni, uchanganuzi na maarifa ya simu, mazungumzo yaliyojengwa kutoka kwa simu halisi na matokeo ya kurudia. Zana hizo hurudisha hitilafu yenye code: "phi_content_unavailable". Kujenga, kujaribu na kusanidi ejenti hufanya kazi kama kawaida.

URL hiyo ndiyo iliyoorodheshwa katika saraka za umma za wasaidizi, ambazo huenda zisiweze kubeba PHI. Ikiwa shirika lako lina BAA yake yenyewe na mtoa huduma wa msaidizi inayoshughulikia eneo la kazi unalotumia:

  1. Msimamizi wa shirika hufungua Shirika → Jumla → Ufikiaji wa msaidizi wa AI katika ThunderPhone na kuthibitisha ufunikaji huo.
  2. Unganisha msaidizi kama kiunganishi maalum ukitumia URL hii badala yake:
https://api.thunderphone.com/v1/mcp/baa

Maudhui ya simu yanapatikana hapo, ikiwemo simu ambazo zinaweza kuwa na PHI. Kuondoa uthibitisho husimamisha hili kwenye ombi linalofuata la msaidizi. Simu ambayo shirika lako liliishughulikia kama isiyo na PHI inapatikana kwenye URL yoyote kati ya hizo.

Njia mbadala za CLI na stdio

ThunderPhone CLI inaweza kuandika usanidi wa mteja huku ikihifadhi seva zisizohusiana:

npx -y @thunderphone/mcp setup --client cursor --api-key-env THUNDERPHONE_API_KEY
npx thunderphone mcp setup --client claude-desktop --scope user

Baada ya usakinishaji wa kimfumo mzima wa @thunderphone/mcp, tumia thunderphone-mcp setup pamoja na chaguo zilezile. Usanidi unasaidia Claude Code, Codex, Cursor, VS Code, Gemini, Claude Desktop na Windsurf. HTTP ya moja kwa moja inapendekezwa; Desktop hutumia stdio.

Kwa mteja yeyote anayeweza kutumia stdio, sanidi command: "npx" pamoja na args: ["-y", "@thunderphone/mcp"]. Kifungashi hutumia THUNDERPHONE_API_KEY kwanza, kisha vitambulisho kutoka thunderphone login, kikihuisha tokeni zilizoisha muda wake, kisha OAuth kupitia mcp-remote. Kuingia kwa kifaa na OAuth kunahitaji uanzishaji husika wa OAuth ya API. Njia ya ufunguo wa API haihitaji. Usanidi wa HTTP wa moja kwa moja hausomi hifadhi ya vitambulisho ya CLI; tumia kifungashi cha stdio kutumia tena kuingia kwa kifaa.

Hizi ni njia mbadala za usanidi wa mikono wa wateja hapa chini.

Usanidi wa mteja

Claude na ChatGPT huingia kwa kutumia OAuth; hakuna API key inayohusika. Ikiwa bado huna akaunti ya ThunderPhone, chagua Fungua akaunti kwenye ukurasa wa kuingia, kisha utarudi kwenye skrini ya kuidhinisha baada ya kuthibitisha barua pepe yako.

Claude (wavuti, kompyuta ya mezani, na simu)

  1. Fungua Geuza kukufaa → Viunganishi (Mipangilio → Viunganishi katika matoleo ya zamani). Ikiwa ThunderPhone inaonekana katika saraka ya viunganishi, ichague. Vinginevyo, chagua Ongeza kiunganishi maalum, ipe jina ThunderPhone, na uweke https://api.thunderphone.com/v1/mcp.
  2. Chagua Unganisha, ingia kwenye ThunderPhone, chagua shirika, na uidhinishe ruhusa.
  3. Kwenye gumzo, wezesha ThunderPhone kutoka kwenye menyu ya zana na uombe unachohitaji, kwa mfano "Orodhesha ejenti zangu".

Claude huomba uthibitisho kabla ya kutumia kila zana kwa mara ya kwanza. Ili kuruka vichocheo vingi hivyo, fungua Geuza kukufaa → Viunganishi → ThunderPhone na uweke Zana za kusoma pekee ziruhusiwe kila wakati. Zana hizo hutafuta taarifa pekee: ejenti, simu, nakala za mazungumzo, salio, na nyaraka. Acha Zana za kuandika/kufuta katika hali ya kuidhinishwa ikiwa unataka kuona kila mabadiliko kabla hayajatokea.

Viunganishi maalum vinahitaji mpango wa Claude unaolipiwa. Kwenye mipango ya Team na Enterprise, mmiliki huongeza kiunganishi kwanza chini ya mipangilio ya viunganishi ya shirika, kisha kila mwanachama huunganisha akaunti yake mwenyewe ya ThunderPhone.

Kinachotofautiana katika Claude

Claude (kiunganishi na programu-jalizi ya Claude Code) hupata seti ndogo zaidi ya zana, kwa kufuata sera ya saraka ya viunganishi vya Claude:

  • Kila simu na ujumbe wa maandishi huthibitishwa mmoja baada ya mwingine. place_call na send_sms kwanza hurejesha mwoneko wa awali (ejenti, namba za kutuma na kupokea, na kwa ujumbe wa maandishi, ujumbe wenyewe) pamoja na confirmation_token; hakuna simu inayopigwa au ujumbe unaotumwa hadi Claude irudie ombi kwa tokeni baada ya kukubali kwako.
  • Hakuna usimamizi wa kampeni. create_campaign, add_campaign_contacts na campaign_action hazipatikani; unda, pakia na anza kampeni katika dashibodi. list_campaigns, get_campaign_stats na check_campaign bado zinafanya kazi.
  • Hakuna test_integration. Jaribu ombi la ujumuishaji kutoka kwenye ukurasa wake katika dashibodi.
  • preview_voice hucheza salamu ya mfano isiyobadilika kwa sauti na lugha unayochagua; haisemi maandishi maalum.
  • list_voices na list_agents hurejesha muhtasari; get_agent ina usanidi kamili wa ejenti.

Taarifa ya AI

Kila simu ambayo ejenti wa ThunderPhone hupiga au kujibu huanza kwa taarifa ya AI inayotolewa kwa sauti. Kwa chaguo-msingi husema "Simu hii inahusisha msaidizi wa AI na itarekodiwa na kunakiliwa kwa maandishi." Kuizima (consent_announcement_enabled false, au ai_live_processing_disclosure_override off) kunakataliwa isipokuwa msimamizi wa shirika awe ameweka kwanza uthibitisho uliotiwa saini katika dashibodi, kutoka kwa mteja wowote, ikiwemo Claude.

ChatGPT

  1. Ikiwa ThunderPhone inaonekana katika saraka ya programu tumizi za ChatGPT, ichague na uiunganishe.
  2. Vinginevyo, fungua Mipangilio → Programu na Viunganishi → Mipangilio ya kina, washa Hali ya msanidi, na uunde kiunganishi chenye URL https://api.thunderphone.com/v1/mcp na uthibitishaji wa OAuth.
  3. Ingia kwenye ThunderPhone, chagua shirika, na uidhinishe ruhusa. Ongeza ThunderPhone kwenye gumzo kutoka kwenye menyu ya zana.

Kufuta ejenti au nambari ya simu, kutupa rasimu, kuzindua kampeni, na kutuma ombi la majaribio linaloweza kuandika kwenye mfumo wa nje kunahitaji uthibitisho wa pili katika programu yoyote; tazama Kuthibitisha vitendo vya uharibifu.

Claude Code

claude mcp add --transport http thunderphone https://api.thunderphone.com/v1/mcp \
  --header "Authorization: Bearer $THUNDERPHONE_API_KEY"

Codex

Ongeza hii kwenye ~/.codex/config.toml:

[mcp_servers.thunderphone]
url = "https://api.thunderphone.com/v1/mcp"
bearer_token_env_var = "THUNDERPHONE_API_KEY"

Cursor

Unda .cursor/mcp.json:

{
  "mcpServers": {
    "thunderphone": {
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
      }
    }
  }
}

Claude Desktop

Ongeza daraja la mcp-remote kwenye usanidi wa Claude Desktop:

{
  "mcpServers": {
    "thunderphone": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.thunderphone.com/v1/mcp",
        "--header",
        "Authorization: Bearer ${THUNDERPHONE_API_KEY}"
      ],
      "env": {
        "THUNDERPHONE_API_KEY": "sk_live_YOUR_API_KEY"
      }
    }
  }
}

VS Code

Unda .vscode/mcp.json na uweke ufunguo kupitia kidokezo cha ingizo cha VS Code:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "thunderphone-api-key",
      "description": "ThunderPhone organization API key",
      "password": true
    }
  ],
  "servers": {
    "thunderphone": {
      "type": "http",
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${input:thunderphone-api-key}"
      }
    }
  }
}

Zana

Kila zana ina ufafanuzi wa MCP. Kwenye majedwali, R inamaanisha kusoma pekee, D ni uharibifu, I ni idempotenti, na O ni mwingiliano wa mtandao/ulimwengu wazi. Kistari kinamaanisha hakuna kidokezo kilichowekwa.

Muunganisho

ZanaHoja kuuUfafanuziInachofanya
get_connection_identity—R, IHuthibitisha kitambulisho na kurudisha shirika lake pamoja na metadata salama ya kitambulisho.

Ejenti

ZanaHoja kuuMaelezoInachofanya
list_agents—R, IHuorodhesha ejenti.
get_agentagent_idR, IHupata ejenti moja.
create_agentusanidi wa ejenti—Huunda ejenti. Huchukua mipangilio sawa na update_agent, ikijumuisha steps, handoffs, intro_clip na intro_ring_count.
update_agentagent_id, sehemu zilizobadilishwa, prompt_edits ya hiari, expected_prompt_sha256DHuweka sehemu kwenye rasimu ya ejenti, ikibadilisha yaliyokuwa kwenye rasimu. Hufanya kazi bila hatua ya uthibitisho: ejenti iliyotumwa haibadiliki hadi deploy_agent itumiwe, na discard_agent_draft hurudisha rasimu katika hali ya awali. Unaweza pia kuweka max_hold_seconds, system_tool_settings, na words. Ili kubadilisha sehemu ya prompt, tuma prompt_edits (tazama Kuhariri prompt mahali pake).
deploy_agentagent_id, if_updated_at ya hiariD, IHupandisha rasimu hadi uzalishaji.
discard_agent_draftagent_id, if_updated_at ya hiari, confirmation_token kwenye ombi la piliD, IHutupa mabadiliko yaliyowekwa. Hatua mbili, tazama Kuthibitisha vitendo vya uharibifu.
duplicate_agentagent_id, name ya hiari—Hunakili ejenti ndani ya shirika.
delete_agentagent_id, confirmation_token kwenye ombi la piliD, IHufuta ejenti kabisa. Hatua mbili.
list_agent_versionsagent_idR, IHuorodhesha matoleo ya usanidi uliotumwa.
list_prompt_revisionsagent_id, source ya hiari, limit, offsetR, IHuorodhesha kila mabadiliko kwenye maandishi ya prompt ya ejenti, yakiwemo rasimu, kila moja likiwa na diff dhidi ya marekebisho iliyobadilisha. Inapatikana wakati seti ya zana ya uboreshaji wa ejenti inapatikana kwenye muunganisho wako (tazama hapa chini).
review_promptagent_id, prompt ya hiari, previous_prompt, quote_id, max_cost_cents—Hukagua prompt ya rasimu (au maandishi unayotuma) kulingana na mwongozo wa mtindo wa prompt. Kila matokeo hunukuu kifungu, hutaja mwongozo na kutoa hariri ya tafuta na ubadilishe; matokeo pia huorodhesha mienendo ambayo prompt inaomba, yenye vitambulisho thabiti, iwapo uundaji upya wa muundo unahitajika na, kwa prompt ya ejenti yenyewe, iwapo mazungumzo yake ya majaribio yanahitaji kusasishwa. Haibadilishi chochote kwenye ejenti; orodha huhifadhiwa pamoja na marekebisho yake ya prompt. Inalipiwa, kwa hivyo haijawekwa alama ya kusoma tu: kwanza ipate bei kwa dry_run, kisha iendeshe tena bila dry_run, kwa quote_id inayorejesha na max_cost_cents. Uendeshaji huu unaolipiwa sasa huhesabiwa dhidi ya posho ileile ya seti ya zana ya shirika kama uendeshaji mwingine wa seti ya zana. Inapatikana wakati seti ya zana ya uboreshaji wa ejenti inapatikana kwenye muunganisho wako (tazama hapa chini).
refactor_promptagent_id, prompt ya hiari, inventory, instructions, quote_id, max_cost_cents—Huandika upya prompt katika muundo wa mwongozo wa mtindo na huainisha kila mwenendo kama uliohifadhiwa, uliounganishwa, ulioandikwa upya au ulioondolewa. Hurejesha maandishi mapya na diff, na kwa chaguo-msingi huyasoma tena ili kuripoti behavior_changes (zilizoongezwa, zilizoondolewa au zilizobadilishwa) na behavior_preserved; yatumie kwa update_agent. Inalipiwa: ipate bei kwa dry_run, kisha iendeshe mara moja kwa quote_id inayorejesha na max_cost_cents. Inapatikana wakati seti ya zana ya uboreshaji wa ejenti inapatikana kwenye muunganisho wako (tazama hapa chini).
list_reusable_instructions—R, IHuorodhesha maagizo yanayoweza kutumika tena: kanuni za prompt zinazoshirikiwa zilizounganishwa na ejenti nyingi kwa reusable_instruction_ids za update_agent.
create_reusable_instructionname, content—Huunda agizo linaloweza kutumika tena ambalo halijaunganishwa. Wasimamizi pekee.

Nambari za simu na waendeshaji

ChomboHoja kuuVifafanuziKazi yake
list_phone_numbers—R, IHuorodhesha nambari za shirika na uelekezaji.
get_phone_number_limits—R, IHupata matumizi na vikomo vya nambari zinazosimamiwa.
provision_phone_numberhiari area_code, city, state, idempotency_keyD, OHunua nambari ya kupokea simu inayosimamiwa na ThunderPhone.
list_voip_connections—R, IHuorodhesha watoa huduma wa mawasiliano wa wateja waliounganishwa.
search_voip_numbersconnection_id, country, type, hiari area_codeR, I, OHutafuta orodha ya nambari za mtoa huduma.
import_voip_numbersconnection_id, numbersD, OHuagiza nambari ambazo tayari zinamilikiwa na mtoa huduma.
update_phone_numberphone_number_id, sehemu za uelekezaji/lebo/webhookDHusasisha uelekezaji wa nambari, ikiwemo uteuzi wa ejenti.
delete_phone_numberphone_number_id, confirm, hiari release_at_provider, confirmation_token kwenye ombi la piliD, I, OHuachilia nambari. Hatua mbili.
get_voip_setup_sessionhiari session_idR, IHusoma usanidi elekezi wa mtoa huduma (hali, orodha hakiki, swali linalosubiriwa), au huorodhesha usanidi ulio wazi. Usanidi huanzishwa kwenye dashibodi kwa sababu unahitaji nenosiri la mtoa huduma. Kwa wasimamizi pekee.
answer_voip_setup_questionsession_id, question_id, answerOHupitisha jibu la mtumiaji kwa usanidi. Nenosiri, idhini ya simu ya majaribio, anwani ya seva, jina la mtumiaji na kuruhusu ThunderPhone iingie kwenye akaunti ya mtoa huduma hujibiwa katika kielekezi cha usanidi pekee; kwa hayo hurejesha kiungo cha kielekezi na haitumi chochote.
save_voip_setupsession_id, hiari name, confirmation_token kwenye ombi la piliD, I, OHuhifadhi muunganisho wa rasimu uliounganishwa ili uweze kutumika. Hatua mbili.
check_phone_numberphone_number au phone_number_idR, I, OHuchunguza mojawapo ya nambari za shirika lenyewe kwa kutumia ushahidi: uelekezaji, muunganisho, uthibitishaji, simu za hivi karibuni za mtoa huduma na za majaribio, na mahali ambapo mtoa huduma huipeleka.

SMS

ZanaHoja kuuVidokezoInachofanya
send_smsfrom_number, to, body, idempotency_keyD, I, OHutuma SMS moja ya maandishi matupu kupitia nambari ya Twilio au Telnyx iliyounganishwa.

Simu

ZanaHoja kuuMaelezoInachofanya
list_callsvichujio vya hiari, limit, offsetR, IHuorodhesha simu kwa vichujio vya historia ya simu vya REST, ikijumuisha exclude_test_calls.
get_callcall_idR, IHupata hali ya simu na metadata.
get_call_transcriptcall_id, live ya hiariR, IHupata nakala ya mazungumzo ya simu.
get_call_audio_urlcall_id, download ya hiariR, I, OHurejesha URL ya sauti iliyotiwa sahihi; kamwe haitiririshi sauti kupitia MCP.
get_call_gradecall_idR, IHupata tathmini ya hivi karibuni zaidi ya simu.
place_callagent_id, from_number, to_numberD, OHupiga simu moja ya kutoka isiyo idempotenti.
export_callsvichujio vya simu, export_formatR, IHusafirisha hadi kikomo cha endpoint ya REST kama JSON au CSV.
get_call_analyticssince_days ya hiari, agent_idR, IHujumlisha simu halisi kwa hali, mwelekeo, matokeo, tathmini na tatizo, huku simu za majaribio zikihesabiwa kivyake.
get_call_insightscall_ids (hadi 10)R, IHupata tathmini, matokeo, muhtasari na matatizo yaliyogunduliwa ya simu kadhaa kwa wakati mmoja.

Upimaji na uthibitishaji

ZanaHoja kuuMaelezoInachofanya
list_test_scenariosagent_idR, IHuorodhesha hali za majaribio.
create_test_scenarioagent_id, title, scenario_prompt, masharti ya hiari—Huunda hali ya majaribio.
generate_test_scenariosagent_id, count ya hiari, include_edge_cases, localeOHuzalisha hali kutoka kwa prompt ya ejenti.
run_agent_testsagent_id, channel, consent_to_charge, uteuzi/matrix ya hiariD, OHutekeleza hali kupitia wavuti au simu.
get_test_runagent_id, batch_idR, IHupata hali ya kundi na matokeo kwa kila hali.
test_my_agentagent_id, consent_to_charge, scenario_ids ya hiari, count, wait_secondsD, OHupima ejenti kwa simu moja: huendesha hali zake zilizohifadhiwa (ikizalisha baadhi ikiwa haina) na kusubiri hadi dakika moja kwa maamuzi, au hurejesha batch_id kwa get_test_run. Hutozwa kama run_agent_tests.
test_in_textagent_id, callers (maelezo 1 hadi 3), version ya hiari, directionOJaribio huru la maandishi: wapigaji simu wa kuigwa huzungumza na rasimu ya ejenti (au toleo la moja kwa moja) kwa maandishi kupitia mchakato halisi, na nakala za mazungumzo hurudi baada ya takriban dakika moja. Matokeo ya zana yameigwa.
run_simulationagent_id, consent_to_charge, scenario_prompt ya hiari, direction, languageD, OHuanzisha simu moja ya kuigwa kati ya mpigaji simu wa AI na rasimu ya ejenti, ili mtu aweze kusikiliza mabadiliko. Hurejesha utekelezaji ukiwa in_progress. Hurekodiwa ejenti inaporekodi simu, na hupimwa baada ya kuisha. Hutozwa kama simu ya majaribio, kwanza kutoka kwenye bajeti ya majaribio ya bila malipo.
get_simulationsimulation_idR, IHupata hali ya simu ya kuigwa na, inapomalizika, ilichozalisha: URL ya muda mfupi ya rekodi na nakala ya mazungumzo ejenti inaporekodi simu, pamoja na alama baada ya upimaji kukamilika (null kabla ya hapo).
list_validation_runsagent_idR, IHuorodhesha utekelezaji wa hivi karibuni wa uthibitishaji wa rasimu.
get_validation_statusagent_idR, IHupata hali ya hivi karibuni ya uthibitishaji na ulinganifu wa rasimu.
list_conversationsagent_id, split ya hiari, sourceR, IHuorodhesha mazungumzo ambayo ejenti hujaribiwa dhidi yake. Inahitaji kifurushi cha zana cha urudiaji wa ejenti.
get_conversationconversation_idR, IHupata mazungumzo moja ya majaribio pamoja na zamu zake za sasa. Inahitaji kifurushi cha zana cha urudiaji wa ejenti.
get_conversation_revisionsconversation_id, limit ya hiari, offsetR, IHuorodhesha kila marekebisho ya mazungumzo ya majaribio: jinsi na sababu yalivyobadilika (yaliyosasishwa kwa mabadiliko ya prompt, yaliyorejeshwa kutoka marekebisho ya awali), tabia zilizoongezwa, kuondolewa na kubadilishwa, mifano iliyohamishwa au kuondolewa, na tofauti za safu. Inahitaji kifurushi cha zana cha urudiaji wa ejenti.
generate_conversationsagent_id, count ya hiari, styleOHuandika mazungumzo ya majaribio yaliyoigwa dhidi ya rasimu ya ejenti na kugeuza nyakati zake ngumu zaidi kuwa mifano ya uthibitishaji yenye majibu sahihi. Tumia dry_run kupata nukuu kwanza; utekelezaji halisi unahitaji quote_id yake na max_cost_cents. Inahitaji kifurushi cha zana cha urudiaji wa ejenti.
import_conversationsagent_id, since_days ya hiari, max_callsOHugeuza simu za hivi karibuni za ejenti kuwa mazungumzo ya majaribio (zisizozidi mbili kwa kila mpigaji simu, simu zisizorekodiwa zikirukwa) na nyakati zake ngumu zaidi kuwa mifano. Tumia dry_run kupata nukuu kwanza; utekelezaji halisi unahitaji quote_id yake na max_cost_cents. Inahitaji kifurushi cha zana cha urudiaji wa ejenti.
refresh_conversationsagent_id, conversation_ids ya hiari, from_prompt_revision_idOHusasisha mazungumzo ya majaribio ya ejenti hadi prompt yake ya sasa baada ya tabia kuongezwa, kuondolewa au kubadilishwa: huelekeza upya, hurejesha marekebisho ya awali (ikiwemo sauti halisi) au huandika upya zamu zilizopitwa na wakati, na huondoa mifano ambayo zamu ya mpigaji simu haipo tena. Tumia dry_run kupata nukuu kwanza; utekelezaji halisi unahitaji quote_id yake na max_cost_cents. Inahitaji kifurushi cha zana cha urudiaji wa ejenti.
get_conversation_jobjob_idR, IHupata kazi ya kuzalisha, kuleta au kusasisha: hali, gharama hadi sasa dhidi ya kikomo chake, na ilichoandika au kusasisha. Inahitaji kifurushi cha zana cha urudiaji wa ejenti.
run_replaysagent_id, overrides ya hiari, split, engine, sample_size, sample_seed, max_cost_cents, quote_id, dry_runD, OHurudia sampuli ya mifano ya ejenti chini ya rasimu yake, au chini ya ubatilishaji kama prompt ya majaribio, sauti au kiwango, na hutathmini kila jibu dhidi ya jibu sahihi la mfano. Marudio kamili huendesha sauti iliyorekodiwa ya zamu kama simu ya moja kwa moja; viwango vya ufaulu huripotiwa kwa kila injini. Marudio ya simu za PHI huendeshwa kama PHI, na usanidi ambao hayawezi kuendesha (sauti ya ElevenLabs, bidhaa ya majaribio) hukataliwa. dry_run hurejesha makadirio, sample_seed iliyotolewa na quote_id; utekelezaji halisi hutuma ombi lilelile pamoja na quote_id na sample_seed hizo, na max_cost_cents, kikomo kisichopitika: kila ombi hutenga kiwango chake cha juu kabla ya kutumwa, na utekelezaji husimama badala ya kutuma ombi lisilotoshea, kwa hivyo acha nafasi ya akiba ya largest_reservation_cents ya makadirio kwa kila mfanyakazi. Marudio kamili hutenga hali yake mbaya zaidi, takriban senti 85 hadi $1.25 kwa kila marudio yanayoendelea kwa zamu ya kawaida (mawili huendeshwa kwa wakati mmoja), dhidi ya gharama halisi ya senti chache; utekelezaji hutozwa gharama halisi ya marudio, kwa hivyo weka max_cost_cents kwa nafasi ya kutosha. Marudio kamili huendeshwa chini ya bajeti inayotosha kwa zamu ya kawaida pamoja na uendeshaji mmoja tena wa aina inayotokea kwenye uzalishaji (mbio ya jibu tena na jaribio tena la uangalizi); zamu inayohitaji zaidi hurekodiwa kama hitilafu, replay_budget_exhausted, huhesabiwa kando kama budget_exhausted, haijumuishwi katika kiwango cha ufaulu na, kwenye mgawanyo wa majaribio, haitumii kundi lolote. Kwenye mgawanyo wa majaribio, kundi lenye sauti ya mpigaji simu iliyorekodiwa chini ya usanidi mwingine isipokuwa Bolt v2 hukataliwa (test_needs_exact_replay) na hubaki halijatumika: pima usanidi huo kwenye mgawanyo wa dev. Inahitaji kifurushi cha zana cha urudiaji wa ejenti.
compare_configsagent_id, configs (2 hadi 4, ya kwanza ni msingi), sample_size ya hiari, sample_seed, max_cost_cents, quote_id, dry_runOHurudia mifano ileile chini ya kila usanidi na huripoti kiwango cha ufaulu, mifano iliyorekebishwa na iliyoharibika dhidi ya msingi, muda wa kusubiri hadi sauti ya kwanza, mara ambazo mpigaji simu alisubiri uthibitisho, milio ya tik au kimya, na gharama kwa kila zamu, kwa kila injini. Pata nukuu kwa dry_run kama run_replays. Kwa mgawanyo wa dev pekee: kwenye mgawanyo wa majaribio hukataliwa (comparison_dev_only); linganisha kwenye dev, kisha pima chaguo kwa run_replays. Inahitaji kifurushi cha zana cha urudiaji wa ejenti.
get_replay_runrun_id, include_trace ya hiariR, IHupata jumla, mabadiliko na matokeo kwa kila mfano ya utekelezaji wa marudio, pamoja na kundi lake la ulinganisho. Marudio kamili yaliyohitaji zaidi ya bajeti yake huhesabiwa kando (budget_exhausted), nje ya kiwango cha ufaulu. Inahitaji kifurushi cha zana cha urudiaji wa ejenti.
create_talk_linkagent_id, variant_id ya hiari, language, expires_in_minutesOHuunda kiungo cha matumizi moja ambacho mtu hufungua kwenye kivinjari ili kuzungumza na rasimu ya sasa ya ejenti, kama kitufe cha Ongea kwenye dashibodi. Kiungo kinaisha muda baada ya dakika 30 kwa chaguo-msingi (kiwango cha juu ni 120); mazungumzo hutozwa kama simu ya majaribio ya Ongea. Tazama Viungo vya Ongea.

Zana zilizoalamishwa kuwa zinahitaji kifurushi cha uboreshaji wa ejenti ni sehemu yake; kifurushi hiki huwashwa kwa kila shirika kikiwa katika beta, na bila kifurushi hicho zinarudisha feature_not_enabled pamoja na hatua inayofuata. Kila mazungumzo ya ejenti yako katika mgawanyo wake wa dev au mgawanyo wake wa majaribio. Mgawanyo wa majaribio ni wa kupima mabadiliko, si wa kuyarekebisha, kwa hivyo zana za mazungumzo hurudisha mazungumzo ya mgawanyo wa majaribio kama kitambulisho chake, mgawanyo, chanzo, hali na hesabu pekee. Uendeshaji wa kurudia kwenye mgawanyo wa majaribio hurudia kundi moja zima la majaribio (sample_size na sample_seed hupuuziwa), kila mfano kwenye injini inayoruhusiwa na data yake, iliyowekwa kabla ya uendeshaji kutoka kwa mfano huo (exact kwa sauti ya mpigaji iliyorekodiwa, text kwa mfano wa maandishi pekee; usanidi usio Bolt v2 hauna njia ya exact, kwa hivyo kundi lenye sauti iliyorekodiwa hukataliwa kwa usanidi huo kwa test_needs_exact_replay na hubaki halijatumika; engine huachwa au huwa auto, kwa kuwa exact au text hukataliwa kwa test_engine_per_example, na hakuna kinachorudi kwenye text), na hurudisha jumla pekee, kwa kila injini: kiwango cha ufaulu, hitilafu kwa uzito na aina, muda wa kusubiri na gharama. Matokeo yake ya kwanza yanayohifadhi urudiaji hutumia kundi hilo, kwa hivyo uendeshaji unaofuata wa majaribio, kwa prompt yoyote, huchukua jingine, na yasipobaki hukataliwa kwa no_test_cohort (kuagiza simu au kutengeneza mazungumzo hujaza makundi mapya); uendeshaji unaoisha kabla ya kuhifadhi moja (Core haiwezi kurudia mifano yake ya sauti kwa exact, exact_replay_unavailable, uwezo wake wa urudiaji bado unashughulika, core_busy, au kila zamu iliishiwa na bajeti yake, replay_budget_exhausted) huacha kundi hilo halijatumika. Kwenye mgawanyo wa dev, urudiaji wa exact ambao Core haiwezi kuendesha hurudi kwenye text na uendeshaji huwekewa alama degraded. Ulinganisho huendeshwa kwenye mgawanyo wa dev pekee. Kila zana inayolipishwa huchukua quote_id ya dry run yake, halali kwa uendeshaji mmoja: hutumika mara moja kwa kudumu uendeshaji unapoanza, na kuanza kunakokataliwa au kushindwa kabla ya hapo huiacha iweze kutumika; uendeshaji unaoshindwa baada ya hapo huripoti hivyo, na hurudiwa kwa dry run mpya ili kupata quote_id mpya. Kwa OAuth, review_prompt na refactor_prompt zinahitaji scope ya agents:write, ikijumuisha dry runs, na zana za mazungumzo na urudiaji zinahitaji testing:write ili kuendeshwa. Watu huona mgawanyo wote wa majaribio kwenye dashibodi. Simu ambayo mpigaji wake yuko katika mgawanyo wa majaribio wa ejenti hutengwa, kwa sababu ni sehemu ya seti ya majaribio. Katika shirika lenye kifurushi hiki, list_calls, get_call, get_call_transcript, get_call_audio_url, get_call_grade na export_calls huirudisha kama {"call_id", "start_time", "held_out": true} hasa (started_at badala ya start_time katika safu za export), bila transkripti, rekodi, historia, daraja au ripoti yake; kila sehemu nyingine ya simu haipo, kwa hivyo soma safu iliyozuiwa kwa held_out yake kabla ya kitu kingine chochote. REST API hufanya vivyo hivyo kwa funguo za API na tokeni za OAuth, na mitazamo yake kwenye simu nyingi (muhtasari wa ripoti, makundi ya matatizo, uchunguzi, ripoti za pipeline) huacha simu zilizotengwa nje ya hesabu, makundi na sampuli zake, na huzuia maandishi yoyote ambayo modeli iliandika kutokana nazo. Uandishi kwenye simu iliyotengwa (kuiwekea daraja, kuipandisha kuwa hali ya majaribio, kutengeneza upya zamu) hukataliwa kwa held_out_call. Hali ya majaribio ambayo mtu alipandisha kutoka simu iliyotengwa hurudi kutoka list_test_scenarios na katika uendeshaji wa majaribio kama {"id", "held_out": true} hasa, na uendeshaji wa uigaji kutoka kwayo, kutoka get_test_run na zana za uigaji, kama {"id", "scenario_id", "held_out": true} hasa; simu zake zilizoigwa pia hutengwa, na uendeshaji wa majaribio bado huiendesha. Mazungumzo ya dev, mfano au matokeo ya urudiaji yaliyonakiliwa kutoka simu ya mpigaji iliyotengwa (migawanyo ni kwa kila ejenti, kwa hivyo mpigaji huyo anaweza kuwa katika mgawanyo wa majaribio wa ejenti mwingine) husomwa kama ya mgawanyo wa majaribio. Watu huona simu zilizotengwa kikamilifu kwenye dashibodi, na msimamizi anaweza kuruhusu ufunguo mmoja wa API kuziona kikamilifu (include_held_out_calls, imezimwa kwa chaguo-msingi, huwekwa kwenye dashibodi pekee), kwa ujumuishaji unaohitaji kila simu; MCP haiitumii kamwe. Webhook hazijabadilika. Mashirika yasiyo na kifurushi hiki hayaoni sehemu ya held_out wala mabadiliko yoyote.

generate_conversations, import_conversations na refresh_conversations hutumia salio la modeli. Vipigie simu kwa dry_run: true kwanza: jibu ni makadirio ya gharama, hatua kwa hatua, yenye quote_id, na hakuna kinachoendeshwa. Makadirio huhesabu kila ombi ambalo uendeshaji unaweza kufanya kwa ukubwa wa kawaida. Uendeshaji halisi unahitaji quote_id hiyo (inaisha baada ya dakika 15, na hufanya kazi tu kwa hoja zilezile) na max_cost_cents, kikomo kisichovukwa: kabla ya kila ombi, kazi hutenga kiasi cha juu ambacho ombi hilo linaweza kugharimu, na husimama badala ya kutuma ombi lisilotoshea, huku ikihifadhi ilichoandika. Kwa sababu ya utengaji huo, uendeshaji unaweza kusimama huku sehemu ya kikomo chake haijatumika; largest_reservation_cents ya makadirio inaonyesha kiasi cha nafasi ya akiba kinachopaswa kuachwa. Wapigaji simu wa kuigwa hubuniwa kutoka kwenye prompt ya ejenti; style: "adversarial" huandika wapigaji simu wagumu wanaosisitiza maeneo dhaifu ya prompt, na mazungumzo hayo daima huenda kwenye mgawanyo wa dev. target: "changed_behaviors" hulenga wapigaji simu kwenye kilichobadilika katika uhariri wa mwisho wa prompt. Kila ejenti huendesha moja ya kazi hizi au uendeshaji mmoja wa replay kwa wakati mmoja, hivyo refresh haibadilishi kamwe mifano ambayo replay inaendesha; kuanzisha moja huku nyingine ikiendelea hurejesha job_active, replay_run_active au conversation_job_active pamoja na cha kusubiri.

Baada ya uhariri wa prompt unaoongeza, kuondoa au kubadilisha tabia, review_prompt kwenye rasimu ya ejenti huripoti ni mazungumzo mangapi ya majaribio yaliyoandikwa kwa prompt yenye tabia nyingine (conversations.refresh_suggested). Kisha refresh_conversations huyaleta hadi kwenye rasimu, ili seti za dev na test zipime prompt mpya kwa historia ambazo ingeweza kuwa imezalisha. Refresh haipotezi chochote: kila mazungumzo huhifadhi kila marekebisho ya awali, na sheria iliyoondolewa inaporudi, marekebisho ya wakati ilipokuwepo hurejeshwa pamoja na sauti halisi ya mpigaji simu. Refresh inayoanzishwa na ejenti ya kuandika msimbo huacha mazungumzo ya mgawanyo wa test, na mazungumzo yaliyonakiliwa kutoka simu zilizozuiwa, nje ya uteuzi, makadirio, maendeleo na gharama zake; kutaja moja katika conversation_ids hurejesha 403 test_conversation. Mtu huyafanya refresh hayo kutoka kwenye dashibodi, na kwa ejenti za kuandika msimbo matokeo ya kazi hiyo huwaonyesha kama ids na hesabu pekee. Mfano wa active ambao refresh huandika upya historia, jibu au ufunguo wa jibu hurudi kwenye pending_review, ukiwa na lebo refreshed_needs_review. Makadirio ya refresh hutoza kila mazungumzo inayoyasoma kana kwamba yangeandikwa upya, kila mwito wa modeli kwa kikomo chake cha matokeo, na hubaki halali kwa prompt na mazungumzo ambayo yalikadiriwa: mojawapo ikibadilika kabla ya uendeshaji, pata makadirio tena; prompt ikibadilika wakati inaendelea, kazi husimama kama failed, huku ikihifadhi ilichofanya refresh.

Maarifa

ZanaHoja kuuUfafanuziInachofanya
list_knowledge_bases—R, IHuorodhesha hifadhidata za maarifa.
create_knowledge_basename, description ya hiari—Huunda hifadhidata ya maarifa.
add_knowledge_documentknowledge_base_id, name, content—Huongeza maandishi au Markdown.
import_knowledge_urlurl, name ya hiariOHuweka ukurasa wa umma kwenye foleni kwa ajili ya uingizaji salama.
search_knowledgeknowledge_base_id, queryR, IHutafuta kupitia urejeshaji wa uzalishaji.

Miunganisho, webhook, na seva za MCP za mbali

ZanaHoja kuuUfafanuziKazi yake
list_integrations—R, IHuorodhesha miunganisho ya kazi za HTTP.
create_integrationdisplay_name, spec ya kazi, sehemu za hiari za anwani lengwa—Huunda zana ya HTTP. Ongeza vichwa vya uthibitishaji kwenye dashibodi.
test_integrationurl, mbinu/mwili/muda wa kusubiri wa hiari, integration_id yenye header_names, confirmation_token kwenye ombi la piliD, OHutuma ombi la majaribio lenye mipaka, lililolindwa dhidi ya SSRF. Thamani za vichwa vilivyohifadhiwa hujazwa kutoka kwenye muunganisho na hutumwa kwa mwenyeji wake pekee. POST (chaguo-msingi), PUT, PATCH na DELETE zina hatua mbili; GET huendeshwa mara moja.
list_webhook_endpoints—R, IHuorodhesha anwani lengwa za webhook zilizosainiwa.
list_webhook_deliveriesagent_id ya hiari, endpoint_id ya hiariR, IHuorodhesha matokeo ya hivi karibuni ya uwasilishaji wa webhook yasiyo na mzigo wa data.
create_webhook_endpointlabel, url, matukio/hali ya hiariOHuunda anwani lengwa ya webhook iliyosainiwa.
copy_webhook_endpointendpoint_id, target_agent_idIHunakili webhook ya ejenti, ikijumuisha siri ya kutia saini, hadi ejenti nyingine kwenye seva. Wasimamizi pekee.
test_webhook_endpointendpoint_idOHutuma tukio bandia kupitia uwasilishaji wa kawaida.
list_mcp_servers—R, IHuorodhesha seva za mbali zinazoweza kuitwa na ejenti za sauti.
create_mcp_serverdisplay_name, urlOHusajili na kusawazisha seva ya mbali. Seva zinazohitaji vichwa vya uthibitishaji huongezwa kwenye dashibodi.
sync_mcp_server_toolsserver_idD, OHusasisha orodha ya zana ya seva ya mbali.

Kampeni

ZanaHoja kuuMaelezoInachofanya
list_campaigns—R, IHuorodhesha kampeni za kupiga simu zinazotoka.
create_campaignsehemu za kampeni—Huunda rasimu ya kampeni.
add_campaign_contactscampaign_id, contacts—Huongeza hadi waasiliani 5,000 wa JSON.
campaign_actioncampaign_id, action, hiari consent_to_charge, confirmation_token kwenye ombi la piliD, OHuendesha start, pause, resume, au stop. start na resume zina hatua mbili; pause na stop huendeshwa mara moja.
get_campaign_statscampaign_idR, IHupata vihesabu na matokeo ya karibuni.
check_campaignhiari campaign_id, contact_phone_number, contact_statusR, IHueleza kwa nini kampeni haipigi simu: dirisha lake la kupiga simu katika saa za eneo lake, waasiliani wanaotarajiwa sasa, na kinachozuia upigaji simu.

Mipangilio ya shirika na wapigaji waliowekwa vizuizi

ZanaHoja kuuMaelezoInachofanya
get_org_settings—R, IHusoma eneo la saa, saa za kazi, nambari za majaribio, lebo za matokeo ya simu, majina ya hali na tahadhari zipi zimezimwa, pamoja na updated_at.
update_org_settingsmipangilio iliyobadilishwa, if_updated_at, confirmation_token inapohitajikaD, IHuzibadilisha (wasimamizi pekee). Orodha na vitu hubadilisha thamani iliyohifadhiwa. Kuzima tahadhari au kuongeza nambari ya majaribio ni hatua mbili. Matokeo yana thamani za zamani za kutendua.
get_account_limits—R, IHupata vikomo vya mfumo kwa thamani mahususi za shirika hili.
list_blocked_callersnumber, search za hiariR, IHuorodhesha nambari za wapigaji waliowekwa vizuizi.
block_callersnumbers, note ya hiari, confirmation_token kwenye ombi la piliD, IHuzuia simu kutoka kwa nambari hizi kabla ejenti yeyote hajajibu. Hatua mbili, wasimamizi pekee.
unblock_callersnumbers, confirmation_token kwenye ombi la piliD, IHuondoa nambari kutoka kwenye orodha ya vizuizi. Hatua mbili, wasimamizi pekee.

get_org_settings, update_org_settings na get_account_limits zinahitaji org:read au org:write wigo wa OAuth; muunganisho ulioundwa kabla hazijakuwepo huombwa kuidhinisha wigo huo zinapotumiwa kwa mara ya kwanza.

Uwezo, msaada na uagizaji

ZanaHoja kuuMaelezoInachofanya
get_supported_languages—R, IHuorodhesha lugha zinazozungumzwa na ejenti, pamoja na misimbo.
get_agent_capabilities—R, IHueleza ejenti inaweza kufanya nini kwenye simu na mipangilio na miunganisho ipi ipo.
escalate_to_humansummaryOHuomba msaada kutoka kwa timu ya ThunderPhone. Hujibu katika ThunderPhone. Kwa mashirika yanayoweza kushughulikia PHI, ni dokezo lisiloegemea upande wowote pekee linaloondoka ThunderPhone.
request_featuretitle, request, detailsOHutuma ombi la kipengele kwa timu ya ThunderPhone. Kiwango cha juu ni matatu kwa shirika kwa siku.
start_agent_importplatformR, IHurudisha kiungo cha dashibodi ambapo unaweka ufunguo wako wa Vapi, Retell, ElevenLabs au Bland na kuchagua ejenti. Hakuna zana inayopokea ufunguo huo.
get_agent_importimport_id ya hiariR, IHuorodhesha uagizaji wa hivi karibuni, au hali ya uagizaji mmoja na ejenti zilizopangwa.
commit_agent_importimport_id, item_ids za hiariOHuunda ejenti kutoka kwa uagizaji ulio tayari, chinichini. Wasimamizi pekee.

Sauti, malipo na nyaraka

ZanaHoja kuuMaelezoInachofanya
list_voices—R, IHuorodhesha sauti na lugha zinazotumika.
preview_voicevoice, language, textOHuzalisha mfano na kurejesha URL iliyotiwa sahihi.
list_voice_clones—R, IHuorodhesha nakala maalum za sauti.
get_billing_summary—R, IHupata salio na bei rasmi za viwango; hakuna mabadiliko ya malipo yanayofichuliwa.
search_docsquery, hiari limitR, I, OHutafuta katika faharasa ya nyaraka za umma.
get_doc_pagepathR, I, OHurejesha ukurasa mmoja wa umma wa nyaraka za Markdown.

Matokeo kuhusu ejenti, simu, nambari, kampeni au mpangilio yana web_url, ukurasa unaolingana wa dashibodi, ili uweze kuufungua katika ThunderPhone au kuendelea na Zeus huko.

Zana zote za bidhaa hutumia njia zilezile za msimbo wa REST kama API ya umma. Kwa hiyo, uthibitishaji wa REST, uwekaji wa mipaka kwa shirika, majukumu, idhini ya malipo, viwango vya matumizi, uthibitisho wa TCPA, usalama wa mtoa huduma, na tabia ya ukaguzi hutumika bila mabadiliko.

Kuhariri prompt moja kwa moja

update_agent inaweza kubadilisha sehemu ya rasimu ya prompt bila kutuma maandishi yote tena. prompt_edits ni orodha iliyopangwa ya jozi za kutafuta na kubadilisha, katika muundo uleule unaorejeshwa na review_prompt na refactor_prompt:

{
  "agent_id": 123,
  "expected_prompt_sha256": "9c1f…",
  "prompt_edits": [
    {
      "find": "Ask for their name and their phone number, then tell them we will call back.",
      "replace": "Tell them we will call back, then ask for their name. Once they answer, ask for their phone number."
    }
  ]
}

Seva hutumia mabadiliko kwa mpangilio kwenye rasimu ya sasa ya prompt ya ejenti (prompt iliyotumwa kwa uzalishaji ikiwa hakuna rasimu) na huandika matokeo kwenye rasimu kupitia njia ileile inayotumiwa na update_agent ya prompt nzima. Kila find lazima ionekane mara moja tu katika prompt jinsi ilivyo wakati zamu ya mabadiliko hayo inapofika. Isipoonekana, hakuna kinachoandikwa na hitilafu hutaja mabadiliko hayo:

MsimboMaanaCha kufanya
prompt_edit_not_foundMaandishi ya find hayapo katika rasimu ya sasa ya prompt. edit_index huonyesha mabadiliko gani.Soma ejenti tena na unakili kifungu hicho sawasawa.
prompt_edit_ambiguousMaandishi ya find yanaonekana zaidi ya mara moja. occurrences huonyesha mara ngapi.Jumuisha maandishi zaidi yanayozunguka.
stale_promptexpected_prompt_sha256 si SHA-256 ya rasimu ya sasa ya prompt: ilibadilika baada ya kuisoma.Soma ejenti tena, andika upya badiliko kulingana na maandishi ya sasa, kisha tuma SHA-256 yake.
conflictUandishi mwingine ulifanyika kati ya seva kusoma rasimu na kuiandika.Jaribu tena; rasimu haikubadilishwa na mwito huu.

expected_prompt_sha256 ni ya hiari na pia hulinda uandishi wa prompt nzima. Tumia prompt_sha256 kutoka review_prompt, au source_prompt_sha256 kutoka refactor_prompt. Mwito wowote unaobadilisha prompt hurejesha prompt_sha256 ya maandishi mapya, previous_prompt_sha256 wakati seva ilisoma rasimu kwanza, na next_step inayopendekeza review_prompt huku previous_prompt ikiwekwa kuwa maandishi ya kabla ya badiliko. REST API hupokea prompt nzima pekee: PATCH /v1/agents/{agent_id} yenye prompt na if_updated_at.

Kuthibitisha vitendo visivyoweza kutenduliwa

Zana zilizowekwa alama D hubadilisha au kuondoa kitu, au huanza kupiga simu kwa watu halisi. Zile ambazo haziwezi kutenduliwa zinahitaji maombi mawili. Ombi la kwanza halibadilishi chochote na hurejesha:

{
  "status": "confirmation_required",
  "action": "Delete agent",
  "target": { "id": 195, "name": "Front Desk Receptionist" },
  "confirmation_token": "…",
  "expires_in_seconds": 600,
  "next_step": "…"
}

Msaidizi humwonyesha mtumiaji kinachoathiriwa na kuomba uthibitisho. Kisha hurudia ombi kwa hoja zilezile pamoja na confirmation_token. Tokeni ni halali kwa dakika 10, hutumika mara moja (hata kama simu hiyo itashindwa), na inahusu shirika moja, mtu mmoja, zana moja na seti moja kamili ya hoja, hivyo kufuta maejenti watatu kunahitaji uthibitisho mara tatu. campaign_action yenye pause au stop huruka hatua hii ili kampeni inayoendelea iweze kusimamishwa mara moja kila wakati, na vivyo hivyo test_integration yenye GET. Baadhi ya zana za D hutekelezwa kwa ombi moja kwa sababu D inaashiria athari yake, si uthibitisho wa upande wa seva: update_agent hubadilisha yaliyokuwa kwenye rasimu (discard_agent_draft huyarejesha), deploy_agent hubadilisha usanidi unaotumika, update_phone_number huelekeza upya simu zinazoendelea, sync_mcp_server_tools hubadilisha katalogi ya zana ya seva ya mbali, import_voip_numbers huelekeza upya nambari kwa mtoa huduma wako, run_agent_tests na run_simulation zinaweza kutumia salio, send_sms na place_call humfikia mtu halisi (place_call huhifadhi uthibitisho wake wa idhini), na provision_phone_number hununua nambari. test_my_agent hutumia salio la majaribio na inahitaji consent_to_charge. run_replays hutumia pesa pia; nukuu yake ya dry_run na kikomo cha max_cost_cents hutumika badala ya uthibitisho. Mteja wako wa MCP bado anaweza kukuomba uidhinishe haya.

Baadhi ya mabadiliko yanayoweza kurekebishwa bado husubiri idhini: block_callers, unblock_callers na save_voip_setup kila wakati, update_org_settings inapozima tahadhari au kuongeza nambari ya majaribio, na update_agent wakati attention_reasons zake zinazima mojawapo ya tahadhari za ejenti. next_step yao inakuomba uthibitishe mabadiliko mahususi badala ya kuonya kwamba hayawezi kurekebishwa.

Prompt za kuanzia

prompts/list hutangaza mitiririko kumi na miwili ya kazi inayoweza kutumika tena:

  • create_inbound_receptionist
  • run_agent_tests
  • buy_and_attach_number
  • review_low_grade_calls
  • add_url_to_agent_knowledge
  • improve_agent_from_calls
  • check_change_before_deploy
  • test_my_agent
  • diagnose_phone_number
  • why_campaign_not_calling
  • call_report
  • import_agents

Tumia prompts/get kwa jina la prompt lililoorodheshwa na hoja zake zilizotangazwa ili kupokea ujumbe wa mtumiaji ulio tayari kutekelezwa.

Rasilimali

resources/list hutoa marejeleo ya umma yaliyohifadhiwa kwenye kache:

URIMaudhui
thunderphone://docs/llms.txtFaharasa ya umma ya nyaraka.
thunderphone://docs/quickstartMarkdown ya kuanza haraka.
thunderphone://pricingMarkdown ya bei za sasa za umma.
thunderphone://guides/prompt-styleMwongozo wa mtindo wa prompt wa ejenti ya sauti ambao review_prompt hukagua dhidi yake. Vitambulisho vya miongozo yake (P1, W2 na kadhalika) ndivyo vinavyotajwa na matokeo.
thunderphone://guides/working-with-thunderphoneJinsi msaidizi anavyopaswa kutumia zana hizi: hatua ndogo za marekebisho, ukaguzi kabla ya kila uchapishaji, idhini ya mtumiaji kwa chochote kinachowekwa hewani au kinachotozwa, na kamwe asiombe siri.

Soma mojawapo kwa resources/read. Uletaji wa umma hutumia muda mfupi wa kusubiri, kikomo cha 2 MiB, na kache ya ndani ya mchakato ya dakika kumi.

Itifaki na hitilafu

Seva inasaidia matoleo ya itifaki 2025-06-18 na 2025-03-26; hurudisha toleo la mteja linalotumika na vinginevyo huchagua 2025-06-18. Inatekeleza initialize, ping, zana, prompt, rasilimali na arifa. Arifa hurejesha 202 Accepted. Seva hii isiyo na hali haifichui kisikilizaji cha SSE wala ufutaji wa kipindi, hivyo GET na DELETE hurejesha 405 Method Not Allowed pamoja na Allow: POST.

Hitilafu za zana hubaki kuwa majibu ya JSON-RPC yaliyofaulu yenye isError: true. Maandishi yake yana sentensi fupi ikifuatiwa na bloku ya JSON:

{
  "code": "insufficient_balance",
  "detail": "There is not enough prepaid balance.",
  "next_step": "Call get_billing_summary, add funds in Organization > Billing, then retry."
}

Kiambishi awali tofauti cha outbound_tcpa_confirmation_required: huhifadhiwa kwa place_call. Mbinu za JSON-RPC zisizojulikana hurejesha -32601 katika jibu la HTTP 200. Makundi ya JSON-RPC hayaungwi mkono na MCP 2025-06-18 na hurejesha hitilafu safi ya ombi batili -32600.