ThunderPhone v3 je dostupan.Postavite sve sami, već od 2 ¢/min.Pročitajte objavu

Connect tools & data

Koristite ThunderPhone kao MCP poslužitelj

Izradite, testirajte, provjerite i upravljajte glasovnim agentima ThunderPhonea iz Claudea, ChatGPT-a, Claude Codea, Codexa, Cursora, VS Codea ili drugog Streamable HTTP MCP klijenta.

ThunderPhone izlaže Streamable HTTP poslužitelj Model Context Protocola na adresi:

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

Ovo je suprotan smjer od povezivanja udaljenog MCP poslužitelja s glasovnim agentom:

SmjerRezultat
Udaljeni MCP poslužitelj → ThunderPhone agentGlasovni agent može pozivati alate udaljenog poslužitelja.
ThunderPhone → Vaš MCP klijentVaš agent za programiranje može izraditi, testirati i upravljati ThunderPhoneom.

Autentifikacija

Prema zadanim postavkama koristite OAuth za klijente direktorija: prijavite se, odaberite organizaciju i odobrite zatražene dozvole. Vezu prekinite u odjeljku Postavke → Sigurnost → Aplikacije koje ste povezali. Promjena ili ponovno postavljanje lozinke ili promjena e-adrese računa također opoziva vezu, stoga nakon toga ponovno povežite klijent.

Za klijente konfigurirane s API ključem izradite ključ sk_live_ u odjeljku Integracije → API ključevi i izložite ga MCP klijentu kao THUNDERPHONE_API_KEY. Ključ je povezan s jednom organizacijom; ID u vlasništvu druge organizacije ponaša se kao da nije pronađen.

Organizacije koje obrađuju PHI

Ako pozivi vaše organizacije mogu sadržavati zaštićene zdravstvene informacije (PHI), zato što imate BAA s ThunderPhoneom ili su vaši agenti određeni za obradu PHI-ja, gornji URL nikada ne vraća sadržaj poziva: prijepise, snimke, ocjene, popise poziva, izvoze, ishode kampanja, analitiku poziva i uvide, razgovore sastavljene na temelju stvarnih poziva i rezultate reprodukcije. Ti alati vraćaju pogrešku s code: "phi_content_unavailable". Izrada, testiranje i konfiguriranje agenata funkcioniraju kao i obično.

Taj je URL naveden u javnim direktorijima pomoćnika koji možda ne mogu prenositi PHI. Ako vaša organizacija ima vlastiti BAA s pružateljem pomoćnika koji pokriva radni prostor koji upotrebljavate:

  1. Administrator organizacije otvara Organizacija → Općenito → Pristup AI pomoćniku u ThunderPhoneu i potvrđuje taj obuhvat.
  2. Umjesto toga povežite pomoćnika kao prilagođeni poveznik s ovim URL-om:
https://api.thunderphone.com/v1/mcp/baa

Sadržaj poziva tada je ondje dostupan, uključujući pozive koji mogu sadržavati PHI. Povlačenjem potvrde to se zaustavlja pri sljedećem zahtjevu pomoćnika. Poziv koji je vaša organizacija obradila kao poziv koji ne sadrži PHI dostupan je na oba URL-a.

CLI i stdio alternative

ThunderPhone CLI može zapisati konfiguraciju klijenta uz očuvanje nepovezanih poslužitelja:

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

Nakon globalne instalacije paketa @thunderphone/mcp, upotrijebite thunderphone-mcp setup s istim opcijama. Postavljanje podržava Claude Code, Codex, Cursor, VS Code, Gemini, Claude Desktop i Windsurf. Prednost ima izravni HTTP; Desktop koristi stdio.

Za svaki klijent koji podržava stdio konfigurirajte command: "npx" s args: ["-y", "@thunderphone/mcp"]. Omotač najprije koristi THUNDERPHONE_API_KEY, zatim vjerodajnice iz thunderphone login, osvježava istekle tokene, a zatim koristi OAuth putem mcp-remote. Prijava uređajem i OAuth zahtijevaju odgovarajuće uvođenje API OAuth-a. Put s API ključem to ne zahtijeva. Izravne HTTP konfiguracije ne čitaju spremište CLI vjerodajnica; upotrijebite stdio omotač za ponovnu upotrebu prijave uređajem.

Ovo su alternative ručnim konfiguracijama klijenta u nastavku.

Konfiguracija klijenta

Claude i ChatGPT prijavljuju se putem OAutha; API ključ nije potreban. Ako još nemate ThunderPhone račun, na stranici za prijavu odaberite Izradite račun i nakon potvrde e-pošte vratit ćete se na zaslon za odobrenje.

Claude (web, stolno računalo i mobilni uređaji)

  1. Otvorite Prilagodba → Poveznici (Postavke → Poveznici u starijim verzijama). Ako se ThunderPhone prikazuje u direktoriju poveznika, odaberite ga. U suprotnom odaberite Dodajte prilagođeni poveznik, nazovite ga ThunderPhone i unesite https://api.thunderphone.com/v1/mcp.
  2. Odaberite Povežite, prijavite se u ThunderPhone, odaberite organizaciju i odobrite dozvole.
  3. U chatu omogućite ThunderPhone iz izbornika alata i zatražite što vam je potrebno, na primjer „Prikaži moje agente”.

Claude traži potvrdu prije prve upotrebe svakog alata. Kako biste preskočili većinu tih upita, otvorite Prilagodba → Poveznici → ThunderPhone i postavite Alati samo za čitanje na uvijek dopušteno. Ti alati samo dohvaćaju podatke: agente, pozive, prijepise, stanja računa i dokumentaciju. Ostavite Alati za pisanje/brisanje na potvrdi ako želite vidjeti svaku promjenu prije nego što se izvrši.

Prilagođeni poveznici zahtijevaju plaćeni Claude paket. U paketima Team i Enterprise vlasnik najprije dodaje poveznik u postavkama poveznika organizacije, a zatim svaki član povezuje vlastiti ThunderPhone račun.

Što je drugačije u Claudeu

Claude (poveznik i dodatak Claude Code) dobiva uži skup alata, u skladu s pravilima direktorija poveznika za Claude:

  • Svaki poziv i poruka potvrđuju se zasebno. place_call i send_sms najprije vraćaju pregled (agenta, brojeve s kojih se poziva i na koje se poziva te, za poruku, sadržaj poruke) uz confirmation_token; ništa se ne poziva niti šalje dok Claude nakon Vaše potvrde ne ponovi zahtjev s tokenom.
  • Nema upravljanja kampanjama. create_campaign, add_campaign_contacts i campaign_action nisu dostupni; izradite, učitajte i pokrenite kampanje na nadzornoj ploči. list_campaigns, get_campaign_stats i check_campaign i dalje rade.
  • Nema test_integration. Testirajte zahtjev integracije na njezinoj stranici na nadzornoj ploči.
  • preview_voice reproducira fiksnu oglednu pozdravnu poruku glasom i na jeziku koji odaberete; ne izgovara prilagođeni tekst.
  • list_voices i list_agents vraćaju sažetak; get_agent sadrži potpunu konfiguraciju agenta.

Obavijest o umjetnoj inteligenciji

Svaki poziv koji ThunderPhone agent upućuje ili na koji odgovara počinje izgovorenom obavijesti o umjetnoj inteligenciji. Prema zadanim postavkama kaže: "Ovaj je poziv s pomoćnikom umjetne inteligencije te će biti snimljen i transkribiran." Isključivanje te obavijesti (consent_announcement_enabled postavljeno na false ili ai_live_processing_disclosure_override isključen) odbija se osim ako administrator organizacije prethodno nije zabilježio potpisanu potvrdu na nadzornoj ploči, iz bilo kojeg klijenta, uključujući Claude.

ChatGPT

  1. Ako se ThunderPhone prikazuje u direktoriju aplikacija za ChatGPT, odaberite ga i povežite.
  2. U suprotnom otvorite Postavke → Aplikacije i poveznici → Napredne postavke, uključite Način za razvojne programere i izradite poveznik s URL-om https://api.thunderphone.com/v1/mcp i OAuth provjerom autentičnosti.
  3. Prijavite se u ThunderPhone, odaberite organizaciju i odobrite dozvole. Dodajte ThunderPhone u chat iz izbornika alata.

Brisanje agenta ili telefonskog broja, odbacivanje skice, pokretanje kampanje i slanje testnog zahtjeva koji može upisivati podatke u vanjski sustav zahtijevaju drugu potvrdu u bilo kojoj aplikaciji; pogledajte Potvrđivanje destruktivnih radnji.

Claude Code

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

Codex

Dodajte ovo u ~/.codex/config.toml:

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

Cursor

Izradite .cursor/mcp.json:

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

Claude Desktop

Dodajte most mcp-remote u konfiguraciju aplikacije 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

Izradite .vscode/mcp.json i unesite ključ putem upita za unos u VS Codeu:

{
  "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}"
      }
    }
  }
}

Alati

Svaki alat sadrži MCP napomene. U tablicama R znači samo za čitanje, D destruktivno, I idempotentno, a O interakciju s otvorenim svijetom/mrežom. Crtica znači da nije postavljena nikakva napomena.

Veza

AlatGlavni argumentiNapomeneŠto radi
get_connection_identity—R, IProvjerava vjerodajnicu i vraća njezinu organizaciju i sigurne metapodatke vjerodajnice.

Agenti

AlatGlavni argumentiNapomeneŠto radi
list_agents—R, IPrikazuje agente.
get_agentagent_idR, IDohvaća jednog agenta.
create_agentkonfiguracija agenta—Stvara agenta. Prima iste postavke kao update_agent, uključujući steps, handoffs, intro_clip i intro_ring_count.
update_agentagent_id, promijenjena polja, neobavezni prompt_edits, expected_prompt_sha256DPriprema polja u skici agenta i zamjenjuje ono što je skica sadržavala. Izvršava se bez koraka potvrde: implementirani agent ostaje nepromijenjen dok ne pokrenete deploy_agent, a discard_agent_draft vraća skicu. Možete postaviti i max_hold_seconds, system_tool_settings i words. Da biste promijenili dio prompta, pošaljite prompt_edits (pogledajte Uređivanje prompta na mjestu).
deploy_agentagent_id, neobavezni if_updated_atD, IPromiče skicu u produkciju.
discard_agent_draftagent_id, neobavezni if_updated_at, confirmation_token pri drugom zahtjevuD, IOdbacuje pripremljene promjene. U dva koraka, pogledajte Potvrđivanje destruktivnih radnji.
duplicate_agentagent_id, neobavezni name—Kopira agenta unutar organizacije.
delete_agentagent_id, confirmation_token pri drugom zahtjevuD, ITrajno briše agenta. U dva koraka.
list_agent_versionsagent_idR, IPrikazuje implementirane verzije konfiguracije.
list_prompt_revisionsagent_id, neobavezni source, limit, offsetR, IPrikazuje svaku promjenu teksta prompta agenta, uključujući skice, svaku s razlikom u odnosu na reviziju koju je zamijenila. Dostupno kada je komplet alata za iteraciju agenta dostupan vašoj vezi (pogledajte u nastavku).
review_promptagent_id, neobavezni prompt, previous_prompt, quote_id, max_cost_cents—Pregledava skicu prompta (ili tekst koji pošaljete) prema vodiču za stil promptova. Svaki nalaz citira odlomak, navodi smjernicu i nudi izmjenu za pronalaženje i zamjenu; rezultat također navodi ponašanja koja prompt zahtijeva, sa stabilnim ID-ovima, je li potrebno preoblikovanje te, za vlastiti prompt agenta, trebaju li se osvježiti njegovi testni razgovori. Ne mijenja ništa na agentu; popis se sprema uz reviziju njegova prompta. Alat se naplaćuje, pa nije označen kao samo za čitanje: najprije zatražite ponudu pomoću dry_run, zatim ga ponovno pokrenite bez dry_run, s vraćenim quote_id i max_cost_cents. Ova plaćena pokretanja sada se računaju u isto ograničenje kompleta alata organizacije kao i druga pokretanja kompleta alata. Dostupno kada je komplet alata za iteraciju agenta dostupan vašoj vezi (pogledajte u nastavku).
refactor_promptagent_id, neobavezni prompt, inventory, instructions, quote_id, max_cost_cents—Preoblikuje prompt u strukturu vodiča za stil i svako ponašanje označava kao zadržano, spojeno, preformulirano ili uklonjeno. Vraća novi tekst i razliku te ga prema zadanim postavkama ponovno čita kako bi prijavio behavior_changes (dodano, uklonjeno ili promijenjeno) i behavior_preserved; primijenite ga pomoću update_agent. Alat se naplaćuje: zatražite ponudu pomoću dry_run, zatim ga jednom pokrenite s vraćenim quote_id i max_cost_cents. Dostupno kada je komplet alata za iteraciju agenta dostupan vašoj vezi (pogledajte u nastavku).
list_reusable_instructions—R, IPrikazuje višekratno upotrebljive upute: zajednička pravila prompta povezana s mnogim agentima putem reusable_instruction_ids alata update_agent.
create_reusable_instructionname, content—Stvara nepovezanu višekratno upotrebljivu uputu. Samo administratori.

Telefonski brojevi i pružatelji usluga

AlatGlavni argumentiOznakeŠto radi
list_phone_numbers—R, INavodi brojeve organizacije i usmjeravanje.
get_phone_number_limits—R, IDohvaća upotrebu i ograničenja upravljanih brojeva.
provision_phone_numberneobavezni area_code, city, state, idempotency_keyD, OKupuje dolazni broj kojim upravlja ThunderPhone.
list_voip_connections—R, INavodi povezane operatere korisnika.
search_voip_numbersconnection_id, country, type, neobavezni area_codeR, I, OPretražuje inventar operatera.
import_voip_numbersconnection_id, numbersD, OUvozi brojeve koji su već u vlasništvu kod operatera.
update_phone_numberphone_number_id, polja za usmjeravanje/oznaku/webhookDAžurira usmjeravanje broja, uključujući dodjelu agenta.
delete_phone_numberphone_number_id, confirm, neobavezni release_at_provider, confirmation_token u drugom zahtjevuD, I, OOslobađa broj. U dva koraka.
get_voip_setup_sessionneobavezni session_idR, IDohvaća vođeno postavljanje operatera (status, kontrolni popis, pitanje na koje čeka odgovor) ili navodi otvorena postavljanja. Postavljanje se pokreće na nadzornoj ploči jer je potrebna lozinka operatera. Samo za administratore.
answer_voip_setup_questionsession_id, question_id, answerOProsljeđuje korisnikov odgovor postavljanju. Na lozinke, pristanak za testni poziv, adresu poslužitelja, korisničko ime i dopuštenje ThunderPhoneu za prijavu na račun pružatelja odgovara se samo u čarobnjaku za postavljanje; za njih vraća poveznicu na čarobnjak i ne šalje ništa.
save_voip_setupsession_id, neobavezni name, confirmation_token u drugom zahtjevuD, I, OSprema povezanu skicu veze kako bi se mogla upotrebljavati. U dva koraka.
check_phone_numberphone_number ili phone_number_idR, I, ODijagnosticira jedan od vlastitih brojeva organizacije na temelju dokaza: usmjeravanja, veze, provjere, nedavnih poziva operatera i testnih poziva te odredišta na koje ga operater šalje.

SMS

AlatGlavni argumentiNapomeneŠto radi
send_smsfrom_number, to, body, idempotency_keyD, I, OŠalje jednu SMS poruku s običnim tekstom putem povezanog Twilio ili Telnyx broja.

Pozivi

AlatGlavni argumentiNapomeneOpis
list_callsneobavezni filtri, limit, offsetR, INavodi pozive uz filtre REST povijesti poziva, uključujući exclude_test_calls.
get_callcall_idR, IDohvaća status i metapodatke poziva.
get_call_transcriptcall_id, neobavezni liveR, IDohvaća transkript poziva.
get_call_audio_urlcall_id, neobavezni downloadR, I, OVraća potpisani URL za zvuk; zvuk se nikada ne strujno prenosi putem MCP-a.
get_call_gradecall_idR, IDohvaća najnoviju ocjenu poziva.
place_callagent_id, from_number, to_numberD, OUpućuje jedan neidemponentni odlazni poziv.
export_callsfiltri poziva, export_formatR, IIzvozi do ograničenja REST krajnje točke kao JSON ili CSV.
get_call_analyticsneobavezni since_days, agent_idR, IAgregira stvarne pozive prema statusu, smjeru, ishodu, ocjeni i problemu, pri čemu se testni pozivi broje zasebno.
get_call_insightscall_ids (do 10)R, IOdjednom dohvaća ocjenu, ishod, sažetak i otkrivene probleme za više poziva.

Testiranje i provjera

AlatGlavni argumentiOznakeŠto radi
list_test_scenariosagent_idR, INavodi testne scenarije.
create_test_scenarioagent_id, title, scenario_prompt, neobavezni uvjeti—Stvara scenarij.
generate_test_scenariosagent_id, neobavezni count, include_edge_cases, localeOGenerira scenarije iz upita agenta.
run_agent_testsagent_id, channel, consent_to_charge, neobavezan odabir/matricaD, OIzvršava scenarije putem weba ili telefonije.
get_test_runagent_id, batch_idR, IDohvaća status skupine i rezultate po scenariju.
test_my_agentagent_id, consent_to_charge, neobavezni scenario_ids, count, wait_secondsD, OTestira agenta u jednom pozivu: pokreće njegove spremljene scenarije (generirajući neke ako ih nema) i čeka do jedne minute na ocjene ili vraća batch_id za get_test_run. Naplaćuje se kao run_agent_tests.
test_in_textagent_id, callers (1 do 3 opisa), neobavezni version, directionOBesplatni tekstni test: simulirani pozivatelji tekstom razgovaraju s nacrtom agenta (ili aktivnom verzijom) kroz stvarni kanal, a prijepisi se vraćaju za otprilike minutu. Rezultati alata su simulirani.
run_simulationagent_id, consent_to_charge, neobavezni scenario_prompt, direction, languageD, OPokreće jedan simulirani telefonski poziv između AI pozivatelja i nacrta agenta kako bi osoba mogla poslušati promjenu. Vraća pokretanje u stanju in_progress. Snima se kada agent snima pozive, a ocjenjuje nakon završetka. Naplaćuje se kao testni poziv, najprije iz besplatnog proračuna za testiranje.
get_simulationsimulation_idR, IDohvaća status simuliranog poziva i, nakon njegova završetka, ono što je proizveo: kratkotrajni URL snimke i prijepis kada agent snima pozive te ocjenu nakon završetka ocjenjivanja (null prije toga).
list_validation_runsagent_idR, INavodi nedavna pokretanja provjere nacrta.
get_validation_statusagent_idR, IDohvaća najnovije stanje provjere i podudaranje nacrta.
list_conversationsagent_id, neobavezni split, sourceR, INavodi razgovore na kojima se agent testira. Zahtijeva alatni komplet za iteraciju agenta.
get_conversationconversation_idR, IDohvaća jedan testni razgovor s njegovim trenutačnim replikama. Zahtijeva alatni komplet za iteraciju agenta.
get_conversation_revisionsconversation_id, neobavezni limit, offsetR, INavodi svaku reviziju testnog razgovora: kako se i zašto promijenio (osvježen zbog promjene upita, vraćen iz ranije revizije), dodana, uklonjena i promijenjena ponašanja, premještene ili povučene primjere te razliku redaka. Zahtijeva alatni komplet za iteraciju agenta.
generate_conversationsagent_id, neobavezni count, styleOPiše simulirane testne razgovore prema nacrtu agenta i njihove najteže trenutke pretvara u primjere za provjeru s ključevima odgovora. Najprije zatražite ponudu pomoću dry_run; stvarno pokretanje zahtijeva njegov quote_id i max_cost_cents. Zahtijeva alatni komplet za iteraciju agenta.
import_conversationsagent_id, neobavezni since_days, max_callsOPretvara nedavne pozive agenta u testne razgovore (najviše dva po pozivatelju, pozivi bez snimanja se preskaču) i njihove najteže trenutke u primjere. Najprije zatražite ponudu pomoću dry_run; stvarno pokretanje zahtijeva njegov quote_id i max_cost_cents. Zahtijeva alatni komplet za iteraciju agenta.
refresh_conversationsagent_id, neobavezni conversation_ids, from_prompt_revision_idOAžurira testne razgovore agenta prema njegovu trenutačnom upitu nakon dodavanja, uklanjanja ili promjene ponašanja: ponovno ih usmjerava, vraća raniju reviziju (uključujući stvarni zvuk) ili ponovno piše zastarjele replike te povlači primjere čija je rečenica pozivatelja nestala. Najprije zatražite ponudu pomoću dry_run; stvarno pokretanje zahtijeva njegov quote_id i max_cost_cents. Zahtijeva alatni komplet za iteraciju agenta.
get_conversation_jobjob_idR, IDohvaća zadatak generiranja, uvoza ili osvježavanja: status, dosadašnji trošak u odnosu na ograničenje i ono što je napisao ili osvježio. Zahtijeva alatni komplet za iteraciju agenta.
run_replaysagent_id, neobavezni overrides, split, engine, sample_size, sample_seed, max_cost_cents, quote_id, dry_runD, OPonovno reproducira uzorak primjera agenta prema njegovu nacrtu ili prema zamjenama kao što su kandidatni upit, glas ili razina te procjenjuje svaki odgovor prema ključu odgovora primjera. Točne reprodukcije pokreću snimljeni zvuk replike kao što bi to učinio aktivni poziv; stope prolaznosti prijavljuju se po mehanizmu. Reprodukcije PHI poziva izvode se kao PHI, a konfiguracija na kojoj se ne mogu izvršiti (glas ElevenLabs, eksperimentalni proizvod) odbija se. dry_run vraća procjenu, odabrani sample_seed i quote_id; stvarno pokretanje šalje isti zahtjev s tim quote_id i sample_seed te max_cost_cents, strogim ograničenjem: svaki zahtjev rezervira svoju gornju granicu prije slanja, a pokretanje se zaustavlja umjesto da pošalje zahtjev koji ne stane, stoga ostavite procijenjeni largest_reservation_cents slobodnog prostora po radniku. Točna reprodukcija rezervira najgori slučaj, otprilike od 85 centi do $1.25 po aktivnoj reprodukciji za tipičnu repliku (istodobno se izvode dvije), nasuprot stvarnom trošku od nekoliko centi; pokretanje se naplaćuje prema stvarnom trošku reprodukcija, stoga postavite max_cost_cents s rezervom. Točna reprodukcija izvodi se unutar proračuna za uobičajenu repliku plus jedno ponovno izvršavanje kakvo provodi produkcija (ponovno nadmetanje odgovora i ponovni pokušaj nadzornika); replika kojoj treba više bilježi se kao pogreška replay_budget_exhausted, zasebno se broji kao budget_exhausted, ne uključuje se u stopu prolaznosti i na testnom skupu ne troši kohortu. Na testnom skupu kohorta sa snimljenim zvukom pozivatelja u konfiguraciji koja nije Bolt v2 odbija se (test_needs_exact_replay) i ostaje neiskorištena: tu konfiguraciju mjerite na razvojnom skupu. Zahtijeva alatni komplet za iteraciju agenta.
compare_configsagent_id, configs (2 do 4, prva je osnovna vrijednost), neobavezni sample_size, sample_seed, max_cost_cents, quote_id, dry_runOPonovno reproducira iste primjere u svakoj konfiguraciji i prijavljuje stopu prolaznosti, primjere ispravljene i pokvarene u odnosu na osnovnu vrijednost, latenciju do prvog zvuka, koliko je često pozivatelj čekao na potvrdu, otkucaje ili tišinu te trošak po replici, po mehanizmu. Zatražite ponudu pomoću dry_run kao za run_replays. Samo razvojni skup: na testnom skupu zahtjev se odbija (comparison_dev_only); usporedite na razvojnom skupu, a zatim odabranu konfiguraciju izmjerite pomoću run_replays. Zahtijeva alatni komplet za iteraciju agenta.
get_replay_runrun_id, neobavezni include_traceR, IDohvaća ukupne vrijednosti pokretanja reprodukcije, promjene ishoda i rezultate po primjeru te njegovu skupinu za usporedbu. Točne reprodukcije kojima je trebalo više od proračuna broje se zasebno (budget_exhausted), izvan stope prolaznosti. Zahtijeva alatni komplet za iteraciju agenta.
create_talk_linkagent_id, neobavezni variant_id, language, expires_in_minutesOStvara jednokratnu poveznicu koju osoba otvara u pregledniku da bi razgovarala s trenutačnim nacrtom agenta, kao gumb Razgovor na nadzornoj ploči. Poveznica prema zadanim postavkama istječe nakon 30 minuta (najviše 120); razgovor se naplaćuje kao testni poziv za Razgovor. Pogledajte Poveznice za razgovor.

Alati označeni kao oni kojima je potreban komplet alata za iteraciju agenta dio su tog kompleta; komplet alata omogućuje se po organizaciji dok je u beta fazi, a bez njega vraćaju feature_not_enabled s uputama za sljedeće korake. Svaki razgovor agenta nalazi se u njegovoj razvojnoj ili testnoj podjeli. Testna podjela služi za mjerenje promjene, a ne za njezino podešavanje, pa alati za razgovore vraćaju razgovor iz testne podjele samo kao njegov id, podjelu, izvor, status i brojanja. Pokretanje reprodukcije u testnoj podjeli reproducira jednu cijelu testnu kohortu (sample_size i sample_seed se zanemaruju), svaki primjer na mehanizmu koji njegovi podaci dopuštaju, određenom iz primjera prije pokretanja (točno za snimljeni zvuk pozivatelja, tekstualno za primjer koji sadrži samo tekst; konfiguracija koja nije Bolt v2 nema točnu putanju, pa se kohorta sa snimljenim zvukom za nju odbija s test_needs_exact_replay i ostaje neiskorištena; engine se izostavlja ili je auto, jer se exact ili text odbija s test_engine_per_example i ništa se ne vraća na tekst), te vraća samo ukupne rezultate po mehanizmu: stopu prolaznosti, neuspjehe prema ozbiljnosti i vrsti, latenciju i trošak. Njegov prvi rezultat koji pohrani reprodukciju troši kohortu, pa sljedeće testno pokretanje, za bilo koji prompt, uzima drugu, a ako nijedna ne preostane odbija se s no_test_cohort (uvoz poziva ili generiranje razgovora popunjava nove kohorte); pokretanje koje završi prije pohranjivanja reprodukcije (Core ne može točno reproducirati njegove zvučne primjere, exact_replay_unavailable, njegov kapacitet za reprodukciju ostaje zauzet, core_busy, ili je svakom potezu ponestalo proračuna, replay_budget_exhausted) ostavlja kohortu neiskorištenom. U razvojnoj podjeli točna reprodukcija koju Core ne može pokrenuti vraća se na tekst, a pokretanje se označava kao degraded. Usporedbe se pokreću samo u razvojnoj podjeli. Svaki alat koji se naplaćuje prihvaća quote_id svojeg probnog pokretanja, valjan za jedno pokretanje: trajno se potroši jednom, kada pokretanje započne, a početak koji je odbijen ili prije toga ne uspije ostavlja ga upotrebljivim; pokretanje koje ne uspije nakon toga to navodi te se ponavlja s novim probnim pokretanjem za novi quote_id. Uz OAuth, review_prompt i refactor_prompt trebaju opseg agents:write, uključujući probna pokretanja, a alati za razgovore i reprodukciju trebaju testing:write za pokretanje. Osobe na nadzornoj ploči vide cijelu testnu podjelu. Poziv čiji se pozivatelj nalazi u testnoj podjeli agenta izdvaja se jer je dio testnog skupa. U organizaciji s kompletom alata, list_calls, get_call, get_call_transcript, get_call_audio_url, get_call_grade i export_calls vraćaju ga točno kao {"call_id", "start_time", "held_out": true} (started_at umjesto start_time u recima izvoza), bez njegova prijepisa, snimke, povijesti, ocjene ili izvješća; svako drugo polje poziva izostaje, zato izdvojeni red najprije pročitajte prema njegovu held_out. REST API čini isto za API ključeve i OAuth tokene, a njegovi prikazi za mnogo poziva (sažeci izvješća, klasteri problema, istrage, izvješća cjevovoda) izostavljaju izdvojene pozive iz svojih brojanja, klastera i uzoraka te zadržavaju svaki tekst koji je model napisao iz njih. Upis u izdvojeni poziv (ocjenjivanje, promicanje u testni scenarij, ponovno generiranje poteza) odbija se s held_out_call. Testni scenarij koji je netko unaprijedio iz izdvojenog poziva vraća se iz list_test_scenarios i u testnim pokretanjima točno kao {"id", "held_out": true}, a pokretanje simulacije iz njega, iz get_test_run i alata za simulaciju, točno kao {"id", "scenario_id", "held_out": true}; njegovi simulirani pozivi također su izdvojeni, a testna pokretanja ga i dalje pokreću. Razvojni razgovor, primjer ili rezultat reprodukcije kopiran iz poziva izdvojenog pozivatelja (podjele su po agentu, pa taj pozivatelj može biti u testnoj podjeli drugog agenta) čita se kao onaj iz testne podjele. Osobe na nadzornoj ploči vide izdvojene pozive u cijelosti, a administrator može jednom API ključu omogućiti njihov potpuni prikaz (include_held_out_calls, prema zadanim postavkama isključen, postavlja se samo na nadzornoj ploči), za integraciju kojoj je potreban svaki poziv; MCP ga nikada ne koristi. Webhookovi ostaju nepromijenjeni. Organizacije bez kompleta alata ne vide polje held_out ni ikakvu promjenu.

generate_conversations, import_conversations i refresh_conversations troše modele kredite. Najprije ih pozovite s dry_run: true: odgovor je procjena troška, korak po korak, s quote_id, i ništa se ne izvršava. Procjena obuhvaća svaki zahtjev koji izvršavanje može uputiti pri uobičajenoj veličini. Stvarno izvršavanje zahtijeva taj quote_id (ističe nakon 15 minuta i radi samo s istim argumentima) i max_cost_cents, čvrsto ograničenje: prije svakog zahtjeva posao rezervira najviše koliko taj zahtjev može stajati te se zaustavlja umjesto da pošalje zahtjev koji ne stane u ograničenje, zadržavajući ono što je napisao. Zbog te rezervacije izvršavanje se može zaustaviti s dijelom ograničenja koji nije potrošen; largest_reservation_cents u procjeni navodi koliku rezervu treba ostaviti. Simulirani pozivatelji izmišljaju se na temelju upute agenta; style: "adversarial" stvara zahtjevne pozivatelje koji ciljaju slabe točke upute, a ti razgovori uvijek idu u razvojni skup. target: "changed_behaviors" usmjerava pozivatelje na ono što se promijenilo u posljednjoj izmjeni upute. Svaki agent istodobno pokreće jedan od tih poslova ili jedno izvršavanje ponavljanja, tako da osvježavanje nikada ne mijenja primjere na kojima se izvršava ponavljanje; pokretanje dok se drugo izvršava vraća job_active, replay_run_active ili conversation_job_active s informacijom o tome što treba pričekati.

Nakon izmjene upute koja dodaje, uklanja ili mijenja ponašanje, review_prompt na nacrtu agenta izvješćuje o broju testnih razgovora izrađenih za uputu s drugim ponašanjima (conversations.refresh_suggested). refresh_conversations ih zatim usklađuje s nacrtom, tako da razvojni i testni skup mjere novu uputu na povijestima koje je mogla proizvesti. Osvježavanje nikada ništa ne gubi: svaki razgovor zadržava svaku raniju reviziju, a kada se uklonjeno pravilo vrati, vraća se revizija iz vremena kada je postojalo sa stvarnim zvukom pozivatelja. Osvježavanje koje pokrene agent za kodiranje izostavlja razgovore testnog skupa i razgovore kopirane iz izdvojenih poziva iz odabira, procjene, napretka i troška; navođenje jednog u conversation_ids vraća 403 test_conversation. Osoba ih osvježava iz nadzorne ploče, a agentima za kodiranje rezultati tog posla prikazuju ih samo kao identifikatore i brojeve. active primjer čiju povijest, odgovor ili ključ odgovora osvježavanje prepiše vraća se u pending_review, s oznakom refreshed_needs_review. Procjena za osvježavanje obračunava svaki razgovor koji pročita kao da je prepisan, svaki poziv modela po njegovu izlaznom ograničenju te vrijedi za uputu i razgovore za koje je izrađena: kada se bilo koji promijeni prije izvršavanja, ponovno izradite procjenu; kada se uputa promijeni tijekom izvršavanja, posao se zaustavlja kao failed, zadržavajući ono što je osvježio.

Znanje

AlatGlavni argumentiNapomeneŠto radi
list_knowledge_bases—R, IPrikazuje baze znanja.
create_knowledge_basename, neobavezno description—Stvara bazu znanja.
add_knowledge_documentknowledge_base_id, name, content—Dodaje tekst ili Markdown.
import_knowledge_urlurl, neobavezno nameOStavlja javnu stranicu u red za siguran unos.
search_knowledgeknowledge_base_id, queryR, IPretražuje produkcijsko dohvaćanje.

Integracije, webhookovi i udaljeni MCP poslužitelji

AlatGlavni argumentiNapomeneŠto radi
list_integrations—R, INavodi integracije HTTP funkcija.
create_integrationdisplay_name, specifikacija funkcije spec, neobavezna polja krajnje točke—Stvara HTTP alat. Dodajte zaglavlja za autentifikaciju u nadzornoj ploči.
test_integrationurl, neobavezni metoda/tijelo/vremensko ograničenje, integration_id s header_names, confirmation_token pri drugom zahtjevuD, OŠalje ograničeni testni zahtjev zaštićen od SSRF-a. Spremljene vrijednosti zaglavlja popunjavaju se iz integracije i šalju samo njezinu vlastitom hostu. POST (zadano), PUT, PATCH i DELETE odvijaju se u dva koraka; GET se izvršava odmah.
list_webhook_endpoints—R, INavodi potpisane krajnje točke webhooka.
list_webhook_deliveriesneobavezni agent_id, neobavezni endpoint_idR, INavodi nedavne ishode isporuke webhooka bez korisnog tereta.
create_webhook_endpointlabel, url, neobavezni događaji/statusOStvara potpisanu krajnju točku webhooka.
copy_webhook_endpointendpoint_id, target_agent_idIKopira webhook agenta, uključujući tajnu za potpisivanje, na drugog agenta na poslužitelju. Samo za administratore.
test_webhook_endpointendpoint_idOŠalje sintetički događaj uobičajenim postupkom isporuke.
list_mcp_servers—R, INavodi udaljene poslužitelje koje mogu pozivati glasovni agenti.
create_mcp_serverdisplay_name, urlORegistrira i sinkronizira udaljeni poslužitelj. Poslužitelji kojima su potrebna zaglavlja za autentifikaciju dodaju se u nadzornoj ploči.
sync_mcp_server_toolsserver_idD, OOsvježava katalog alata udaljenog poslužitelja.

Kampanje

AlatGlavni argumentiOznakeŠto radi
list_campaigns—R, IPrikazuje odlazne kampanje.
create_campaignpolja kampanje—Stvara nacrt kampanje.
add_campaign_contactscampaign_id, contacts—Dodaje do 5.000 JSON kontakata.
campaign_actioncampaign_id, action, neobavezni consent_to_charge, confirmation_token pri drugom zahtjevuD, OPokreće start, pause, resume ili stop. start i resume izvode se u dva koraka; pause i stop izvode se odmah.
get_campaign_statscampaign_idR, IDohvaća brojače i nedavne ishode.
check_campaignneobavezni campaign_id, contact_phone_number, contact_statusR, IObjašnjava zašto kampanja ne poziva: njezin vremenski prozor za pozivanje u vlastitoj vremenskoj zoni, kontakte koji su sada na redu i što sprječava biranje.

Postavke organizacije i blokirani pozivatelji

AlatGlavni argumentiNapomeneŠto radi
get_org_settings—R, IČita vremensku zonu, radno vrijeme, testne brojeve, oznake ishoda poziva, nazive statusa i koja su upozorenja isključena, uz updated_at.
update_org_settingspromijenjene postavke, if_updated_at, confirmation_token kada se zatražiD, IMijenja ih (samo administratori). Popisi i objekti zamjenjuju pohranjenu vrijednost. Isključivanje upozorenja ili dodavanje testnog broja postupak je u dva koraka. Rezultat sadrži stare vrijednosti za poništavanje.
get_account_limits—R, IDohvaća ograničenja platforme s vlastitim vrijednostima ove organizacije.
list_blocked_callersneobavezni number, searchR, INavodi brojeve blokiranih pozivatelja.
block_callersnumbers, neobavezni note, confirmation_token pri drugom zahtjevuD, IOdbija pozive s tih brojeva prije nego što se javi bilo koji agent. Postupak u dva koraka, samo administratori.
unblock_callersnumbers, confirmation_token pri drugom zahtjevuD, IUklanja brojeve s popisa blokiranih brojeva. Postupak u dva koraka, samo administratori.

get_org_settings, update_org_settings i get_account_limits zahtijevaju org:read ili org:write OAuth opseg; od veze uspostavljene prije nego što su bili dostupni zatražit će se odobrenje pri prvoj upotrebi.

Mogućnosti, pomoć i uvozi

AlatGlavni argumentiNapomeneŠto radi
get_supported_languages—R, INavodi jezike kojima agenti govore, s kodovima.
get_agent_capabilities—R, INavodi što agent može učiniti tijekom poziva te koje su postavke i integracije dostupne.
escalate_to_humansummaryOTraži pomoć od tima ThunderPhone. Odgovaraju u ThunderPhoneu. Za organizacije koje mogu obrađivati PHI iz ThunderPhonea odlazi samo neutralna napomena.
request_featuretitle, request, detailsOPodnosi zahtjev za značajku timu ThunderPhone. Najviše tri po organizaciji dnevno.
start_agent_importplatformR, IVraća poveznicu na nadzornu ploču na kojoj unosite svoj ključ za Vapi, Retell, ElevenLabs ili Bland i odabirete agente. Nijedan alat ne prima ključ.
get_agent_importneobavezni import_idR, INavodi nedavne uvoze ili status jednog uvoza i preslikane agente.
commit_agent_importimport_id, neobavezni item_idsOStvara agente iz spremnog uvoza u pozadini. Samo administratori.

Glasovi, naplata i dokumentacija

AlatGlavni argumentiNapomeneŠto radi
list_voices—R, INavodi glasove i podržane jezike.
preview_voicevoice, language, textOGenerira uzorak i vraća potpisani URL.
list_voice_clones—R, INavodi prilagođene klonove glasova.
get_billing_summary—R, IDohvaća stanje računa i mjerodavne cijene razina; nisu dostupne izmjene plaćanja.
search_docsquery, neobavezno limitR, I, OPretražuje indeks javne dokumentacije.
get_doc_pagepathR, I, ODohvaća jednu javnu Markdown stranicu dokumentacije.

Rezultati o agentu, pozivu, broju, kampanji ili postavci sadrže web_url, odgovarajuću stranicu nadzorne ploče, pa je možete otvoriti u ThunderPhoneu ili ondje nastaviti sa Zeusom.

Svi alati proizvoda koriste iste REST putanje koda kao javni API. Stoga se REST provjera, opseg organizacije, uloge, odobrenje naplate, kvote, TCPA potvrda, sigurnost pružatelja usluga i ponašanje revizije primjenjuju nepromijenjeno.

Uređivanje prompta na mjestu

update_agent može izmijeniti dio nacrta prompta bez ponovnog slanja cijelog teksta. prompt_edits je uređeni popis parova za pronalaženje i zamjenu, u istom formatu koji vraćaju review_prompt i 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."
    }
  ]
}

Poslužitelj primjenjuje izmjene redom na trenutačni nacrt prompta agenta (na objavljeni prompt ako nema nacrta) i zapisuje rezultat u nacrt istim putem kao i update_agent za cijeli prompt. Svaki find mora se pojaviti točno jednom u promptu u stanju u kojem se nalazi kada dođe red na tu izmjenu. Ako se ne pojavi, ništa se ne zapisuje, a pogreška navodi izmjenu:

KôdZnačenjeŠto učiniti
prompt_edit_not_foundTekst find nije u trenutačnom nacrtu prompta. edit_index navodi o kojoj se izmjeni radi.Ponovno pročitajte agenta i točno kopirajte odlomak.
prompt_edit_ambiguousTekst find pojavljuje se više puta. occurrences navodi koliko puta.Uključite više okolnog teksta.
stale_promptexpected_prompt_sha256 nije SHA-256 trenutačnog nacrta prompta: promijenio se nakon što ste ga pročitali.Ponovno pročitajte agenta, preoblikujte izmjenu prema trenutačnom tekstu i pošaljite njegov SHA-256.
conflictDrugo je zapisivanje izvršeno između čitanja nacrta na poslužitelju i njegova zapisivanja.Pokušajte ponovno; ovaj poziv nije promijenio nacrt.

expected_prompt_sha256 nije obavezan i također štiti zapisivanje cijelog prompta. Upotrijebite prompt_sha256 iz review_prompt ili source_prompt_sha256 iz refactor_prompt. Svaki poziv koji mijenja prompt vraća prompt_sha256 za novi tekst, previous_prompt_sha256 kada je poslužitelj prvo pročitao nacrt te next_step koji predlaže review_prompt s postavljenim previous_prompt na tekst prije izmjene. REST API prihvaća samo cijeli prompt: PATCH /v1/agents/{agent_id} s prompt i if_updated_at.

Potvrđivanje destruktivnih radnji

Alati označeni slovom D mijenjaju ili uklanjaju nešto ili započinju pozivanje stvarnih osoba. Za one čije se radnje ne mogu poništiti potrebna su dva zahtjeva. Prvi zahtjev ne mijenja ništa i vraća:

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

Pomoćnik korisniku prikazuje na što to utječe i traži potvrdu. Zatim ponavlja zahtjev s istim argumentima i dodatnim confirmation_token. Token vrijedi 10 minuta, funkcionira jednom (čak i ako taj poziv ne uspije) te se odnosi na jednu organizaciju, jednu osobu, jedan alat i jedan točan skup argumenata, pa su za brisanje triju glasovnih agenata potrebne tri potvrde. campaign_action s pause ili stop preskače ovaj korak kako bi se pokrenuta kampanja uvijek mogla odmah zaustaviti, kao i test_integration s GET. Neki alati s oznakom D izvršavaju se jednim zahtjevom jer D označava njihov učinak, a ne potvrdu na strani poslužitelja: update_agent zamjenjuje ono što je sadržavala skica (discard_agent_draft to poništava), deploy_agent zamjenjuje aktivnu konfiguraciju, update_phone_number preusmjerava aktivne pozive, sync_mcp_server_tools zamjenjuje katalog alata udaljenog poslužitelja, import_voip_numbers preusmjerava brojeve na vašeg pružatelja telekomunikacijskih usluga, run_agent_tests i run_simulation mogu potrošiti kredit, send_sms i place_call kontaktiraju stvarnu osobu (place_call zadržava vlastitu potvrdu pristanka), a provision_phone_number kupuje broj. test_my_agent troši kredit za testiranje i zahtijeva consent_to_charge. run_replays također troši novac; njegova procjena za dry_run i ograničenje max_cost_cents služe kao zamjena za potvrdu. Vaš MCP klijent i dalje može zatražiti da ih odobrite.

Neke promjene koje se mogu poništiti i dalje čekaju potvrdu: block_callers, unblock_callers i save_voip_setup uvijek, update_org_settings kada isključuje upozorenje ili dodaje testni broj te update_agent kada njegovi attention_reasons isključuju jedno od upozorenja agenta. Njihov next_step traži da potvrdite točnu promjenu umjesto da upozorava kako se ona ne može poništiti.

Početni upiti

prompts/list oglašava dvanaest ponovno upotrebljivih tijekova rada:

  • 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

Upotrijebite prompts/get s navedenim nazivom upita i njegovim deklariranim argumentima da biste primili korisničku poruku spremnu za pokretanje.

Resursi

resources/list izlaže javne, predmemorirane reference:

URISadržaj
thunderphone://docs/llms.txtJavni indeks dokumentacije.
thunderphone://docs/quickstartMarkdown za brzi početak.
thunderphone://pricingTrenutačni javni Markdown s cijenama.
thunderphone://guides/prompt-styleVodič za stil upita glasovnog agenta prema kojem provjerava review_prompt. ID-jevi smjernica (P1, W2 i slično) oni su na koje se nalazi pozivaju.
thunderphone://guides/working-with-thunderphoneKako asistent treba raditi s ovim alatima: kratki krugovi rada na nacrtu, provjera prije svakog postavljanja, korisnikova potvrda za sve što je aktivno ili se naplaćuje te nikada ne tražiti tajne.

Pročitajte pojedini resurs pomoću resources/read. Javna dohvaćanja koriste kratko vremensko ograničenje, ograničenje od 2 MiB i desetominutnu predmemoriju unutar procesa.

Protokol i pogreške

Poslužitelj podržava verzije protokola 2025-06-18 i 2025-03-26; vraća podržanu verziju klijenta, a u suprotnom odabire 2025-06-18. Implementira initialize, ping, alate, upite, resurse i obavijesti. Obavijesti vraćaju 202 Accepted. Ovaj poslužitelj bez stanja ne izlaže SSE slušatelj ni brisanje sesije, stoga GET i DELETE vraćaju 405 Method Not Allowed uz Allow: POST.

Neuspjesi alata ostaju uspješni JSON-RPC odgovori s isError: true. Njihov tekst sadržava kratku rečenicu nakon koje slijedi JSON blok:

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

Zasebni prefiks outbound_tcpa_confirmation_required: zadržava se za place_call. Nepoznate JSON-RPC metode vraćaju -32601 u HTTP odgovoru 200. MCP 2025-06-18 ne podržava JSON-RPC skupove zahtjeva te vraćaju jasnu pogrešku neispravnog zahtjeva -32600.