Open in
ముఖ్య భావనలు
ప్లాట్ఫారమ్లోని అన్నింటికీ ఒక మ్యాప్ — ప్రతి ఆబ్జెక్ట్ ఏమి చేస్తుంది, డ్యాష్బోర్డ్లో అది ఎక్కడ ఉంటుంది, ఏ API దానితో పనిచేస్తుంది.
ThunderPhone అనేది AI వాయిస్ ఏజెంట్లను నిర్మించడానికి, అమలు చేయడానికి, మెరుగుపరచడానికి పూర్తి ప్లాట్ఫారమ్. ఈ పేజీ మ్యాప్ వంటిది: మీరు ఎదుర్కొనే ప్రతి భావనకు ఒక చిన్న విభాగం, డ్యాష్బోర్డ్ ఉపరితలం మరియు దానికి మద్దతిచ్చే APIతో. ఒకసారి త్వరగా చదవండి, తర్వాత ఏ పదానికైనా వివరణ అవసరమైనప్పుడు తిరిగి చూడండి.
డ్యాష్బోర్డ్ సైడ్బార్ ఈ నిర్మాణాన్నే ప్రతిబింబిస్తుంది:
ప్రత్యక్ష పర్యవేక్షణ మరియు అవుట్బౌండ్ క్యాంపెయిన్లు.
మీ ఏజెంట్లు ఉపయోగించగల యాప్లు, APIలు, MCP సర్వర్లు మరియు VoIP ప్రొవైడర్లు.
మీ స్వంత కోడ్ కోసం వెబ్హుక్లు మరియు ఫంక్షన్ టూల్స్.
సంస్థలు
ఒక సంస్థ టెనెన్సీ యూనిట్. ఏజెంట్లు, ఫోన్ నంబర్లు, కాల్లు, కీలు వంటి ప్రతి ఇతర వనరు కచ్చితంగా ఒకే సంస్థకు చెందుతుంది. మీ ఖాతా అనేక సంస్థలకు చెందవచ్చు; ప్రతి సంస్థకు దాని స్వంత బ్యాలెన్స్, కీలు మరియు సభ్యుల జాబితా ఉంటాయి.
మీరు సంస్థ → కీలు కింద సృష్టించే sk_live_ API కీ ఒక సంస్థతో
అనుసంధానమై ఉంటుంది. ఈ అనుసంధానమే REST APIని చాలా సరళంగా ఉంచుతుంది:
మీ కీ ఇప్పటికే సంస్థను గుర్తిస్తుంది కాబట్టి, మీరు URL మార్గాల్లో సంస్థ ఐడీని ఎప్పుడూ ఇవ్వరు.
డ్యాష్బోర్డ్లో: సంస్థ స్విచర్ (సైడ్బార్ ఫుటర్) మరియు సంస్థ సెట్టింగ్లు — నా ఖాతా, సాధారణం, కీలు, అలర్ట్లు, బిల్లింగ్ సెట్టింగ్లు మరియు బిల్లింగ్ చరిత్ర ట్యాబ్లు. చూడండి సంస్థ సెట్టింగ్ల సూచిక.
APIలో: /v1/orgs,
/v1/developer/api-keys.
ఏజెంట్లు
ఒక ఏజెంట్ అనేది కాల్ను అమలు చేసే AI కాన్ఫిగరేషన్. ఇందులో ఇవి ఉంటాయి:
- ఏజెంట్ ఏమి చెబుతుంది, ఎలా ప్రవర్తిస్తుంది అనేదాన్ని నియంత్రించే prompt — బదిలీలు, కీప్యాడ్ నొక్కులు, కాల్ ముగింపులు వంటి కాల్ చర్యలతో సహా; ఇవి ప్రత్యేక కాన్ఫిగరేషన్ కాకుండా సాధారణ prompt పంక్తులు.
- ఒక ఇంజిన్ టియర్ (
spark,bolt,storm-*): Spark ఖర్చుకు, Bolt వేగానికి, Storm సంక్లిష్ట promptలలో మేధస్సుకు అనుకూలంగా ఉంటుంది. - ఒక వాయిస్, ప్రధాన భాష, మరియు ఐచ్ఛిక అదనపు భాషలు — కాలర్ భాష మార్చినప్పుడు ఏజెంట్ స్వయంచాలకంగా మారుతుంది. మద్దతు ఉన్న భాషలు చూడండి.
- జోడించిన సామర్థ్యాలు: కనెక్ట్ చేసిన యాప్లు, API కనెక్షన్లు, నాలెడ్జ్ బేస్లు, MCP సర్వర్లు, మరియు ఇన్లైన్ ఫంక్షన్ టూల్స్.
- ప్రవర్తన నియంత్రణలు: మాట్లాడే క్రమం, అంగీకార మోడ్, నేపథ్య ట్రాక్, హోల్డ్ గడువు.
బిల్డర్లో చేసిన మార్పులు డ్రాఫ్ట్లో స్వయంచాలకంగా సేవ్ అవుతాయి; మీరు ప్రచురించు క్లిక్ చేసే వరకు ఏదీ ప్రత్యక్షంగా మారదు. ప్రతి ప్రచురణ బిల్డర్లోని చరిత్ర ట్యాబ్లో స్నాప్షాట్గా నిల్వ ఉంటుంది, కాబట్టి మీరు మునుపటి ఏ వెర్షన్నైనా పరిశీలించి పునరుద్ధరించవచ్చు.
డ్యాష్బోర్డ్లో: వాయిస్ ఏజెంట్లు → ఏజెంట్ బిల్డర్
(/dashboard/agents). చూడండి
మీ మొదటి వాయిస్ ఏజెంట్ను నిర్మించండి.
APIలో: /v1/agents — CRUD,
నకలు చేయడం, బదిలీ చేయడం, వెర్షన్ చరిత్ర మరియు prompt సహాయకాలు.
వాయిస్లు
వాయిస్ లైబ్రరీలో ఏజెంట్ ఉపయోగించగల వాయిస్లు, వాటి ప్లే చేయగల నమూనాలు, అనుకూల భాషలు, లింగం మరియు యాస సమూహాలు, అలాగే ప్రీమియం వాయిస్/భాష అదనపు ఛార్జీలు ఉంటాయి. మీరు ఎంచుకునే ముందు, చెల్లింపు శాంప్లర్ మీ స్వంత 1–500 అక్షరాల పదబంధాన్ని సంశ్లేషించగలదు.
అర్హత ఉన్న సంస్థలు చిన్న WAV లేదా MP3 నమూనా నుంచి కస్టమ్ వాయిస్లు కూడా సృష్టించగలవు. కస్టమ్ వాయిస్లకు కోటా మరియు అసమకాలిక సృష్టి స్థితి ఉంటాయి; సిద్ధమైన తర్వాత, అవి లైబ్రరీ వాయిస్ల మాదిరిగానే ఏజెంట్ ఎంపికలో కనిపిస్తాయి.
డ్యాష్బోర్డ్లో: వాయిస్లు (/dashboard/voices). చూడండి
వాయిస్ లైబ్రరీ మరియు కస్టమ్ వాయిస్లు.
APIలో: /v1/voices,
వాయిస్ నమూనాలు, మరియు
కస్టమ్ వాయిస్లు.
ఫోన్ నంబర్లు
ఒక ఫోన్ నంబర్ సంస్థకు చెందినది మరియు ఇన్బౌండ్ కాల్లను ఒక ఏజెంట్కు రూట్ చేస్తుంది (అవుట్బౌండ్ కాల్లను కూడా నిర్వహించగలదు). రెండు మూలాలు:
- ThunderPhone నంబర్లు — ThunderPhone పూల్ నుంచి ప్రొవిజన్ చేయబడే నిజమైన U.S. నంబర్లు, సెకన్లలో సక్రియమవుతాయి, $1/నెలకు అదనంగా 1¢/నిమిషం అదనపు ఛార్జీ. ఇన్బౌండ్కు మాత్రమే; అవుట్బౌండ్కు మీ స్వంత క్యారియర్ అవసరం. ఒక సంస్థ డిఫాల్ట్గా 25 నంబర్లను కలిగి ఉండవచ్చు.
- VoIP నంబర్లు — మీ స్వంత ప్రొవైడర్ నుంచి ఒక VoIP కనెక్షన్ ద్వారా తీసుకువచ్చేవి. Twilio మరియు Telnyx నేరుగా కనెక్ట్ అవుతాయి (Telnyxలో గైడెడ్ సెటప్ ఉంది); SignalWire మరియు Vonage త్వరలో అందుబాటులోకి వస్తాయి — ప్రస్తుతం మీరు మాన్యువల్ SIP కాన్ఫిగరేషన్ ద్వారా వాటిని చేరుకోవచ్చు, ఇది ఏ SIP ట్రంక్నైనా అంగీకరిస్తుంది. దిగుమతి చేసి ధృవీకరించిన తర్వాత, VoIP నంబర్లు ఇన్బౌండ్ మరియు అవుట్బౌండ్కు మద్దతు ఇస్తాయి.
ప్రతి నంబర్ వరుసలో రూటింగ్ మోడ్ను సెట్ చేయవచ్చు, ఇన్బౌండ్ ఏజెంట్ను ఎంచుకోవచ్చు, మరియు నంబర్కు లేబుల్ ఇవ్వవచ్చు.
డ్యాష్బోర్డ్లో: ఫోన్ నంబర్లు (/dashboard/phone-numbers).
చూడండి ఫోన్ నంబర్ పొందండి.
APIలో: /v1/phone-numbers,
/v1/voip-connections,
/v1/phone-number-labels.
కాల్లు
ప్రతి ఇన్బౌండ్ కాల్, అవుట్బౌండ్ కాల్, సిమ్యులేషన్ మరియు విడ్జెట్ సెషన్ ఒక కాల్ లాగ్గా మారుతుంది. ఒక కాల్లో పూర్తి పాత్ర-ట్యాగ్ చేసిన ట్రాన్స్క్రిప్ట్, నిర్మిత టర్న్ చరిత్ర (టూల్ కాల్లతో సహా), రికార్డింగ్, బిల్లింగ్ మొత్తం, అలాగే ఐచ్ఛిక AI గ్రేడింగ్ మరియు సమస్య నివేదికలు ఉంటాయి.
కాల్ లైవ్లో ఉన్నప్పుడు, మీరు దానిని తెరిచి వినవచ్చు — మీరు నిశ్శబ్దంగా చేరతారు, కాల్లో ఉన్నవారెవరికీ మీరు వినిపించరు. వింటున్నప్పుడు, మీరు విస్పర్ చేయవచ్చు: కాల్ మధ్యలోనే మీ ఏజెంట్కు నేరుగా వెళ్లే సూచనను టైప్ చేయండి; కాల్ చేసినవారికి అది ఎప్పుడూ వినిపించదు, మరియు ఏజెంట్ దానిని ప్రత్యక్షంగా అనుసరిస్తుంది.
డ్యాష్బోర్డ్లో: ఆర్కైవ్ మరియు ప్రతి కాల్ వివరాల కోసం కాల్ హిస్టరీ (/dashboard/call-history);
కొనసాగుతున్న కాల్ల కోసం లైవ్. చూడండి
మీ కాల్లను సమీక్షించండి, వినండి మరియు మార్గనిర్దేశం చేయండి.
APIలో: /v1/calls — జాబితా, ట్రాన్స్క్రిప్ట్,
చరిత్ర, ఆడియో, గ్రేడింగ్, ఎగుమతి;
/v1/issue-reports.
క్లయింట్ పోర్టల్లు
ఒక క్లయింట్ పోర్టల్ అనేది బాహ్య క్లయింట్ కోసం బ్రాండ్ చేసిన, చదవడానికి మాత్రమే ఉన్న కాల్-హిస్టరీ వీక్షణ. సంస్థ అడ్మిన్లు కనిపించాల్సిన కాల్ల ఏజెంట్లను ఎంచుకుంటారు, ఆమోదించిన వీక్షకుల ఇమెయిల్లను జోడిస్తారు, లోగో మరియు యాస రంగును అప్లోడ్ చేస్తారు, అలాగే ఐచ్ఛికంగా కస్టమ్ డొమైన్ను ధృవీకరిస్తారు. డ్యాష్బోర్డ్ యాక్సెస్ పొందకుండా పోర్టల్ వీక్షకులు కాల్ వివరాలు, ట్రాన్స్క్రిప్ట్లు మరియు అందుబాటులో ఉన్న రికార్డింగ్లను పరిశీలించగలరు.
డ్యాష్బోర్డ్లో: క్లయింట్ పోర్టల్లు (/dashboard/client-portals). చూడండి
క్లయింట్ పోర్టల్లు.
APIలో: అడ్మిన్ నిర్వహణ ఉపరితలం కోసం /v1/client-portals.
వెబ్ విడ్జెట్లు
వెబ్ విడ్జెట్ మీ సైట్ సందర్శకులకు మైక్ ఆధారిత ఏజెంట్ సంభాషణను
అందిస్తుంది — ఫోన్ నంబర్ అవసరం లేదు. ఇది మీ అనుమతించిన డొమైన్లకు
ఒరిజిన్-లాక్ చేయబడిన ప్రచురించదగిన కీ (pk_live_...)తో
ప్రామాణీకరిస్తుంది, కాబట్టి క్లయింట్-సైడ్ కోడ్లో ఉపయోగించడం సురక్షితం.
కీలు రెండు మోడ్లలో ఒకదానిలో పనిచేస్తాయి: agent (ఒక ఏజెంట్కు స్థిరంగా
అనుసంధానించబడింది) లేదా webhook (ప్రతి సందర్శకుడికి మీ సర్వర్ కాన్ఫిగరేషన్ను ఎంచుకుంటుంది — చూడండి
ప్రతి కాల్కు డైనమిక్ కాన్ఫిగరేషన్). విడ్జెట్
సెషన్లు ఫోన్ కాల్ల మాదిరిగానే అదే కాల్ ఇన్ఫ్రాస్ట్రక్చర్ ద్వారా ప్రవహిస్తాయి.
డ్యాష్బోర్డ్లో: వెబ్ విడ్జెట్లు (/dashboard/web-widgets) —
విడ్జెట్లను సృష్టించండి, మోడ్ మరియు ఏజెంట్ను సెట్ చేయండి, అనుమతించిన డొమైన్లను నిర్వహించండి, మరియు
ఎంబెడ్ స్నిపెట్ను కాపీ చేయండి. చూడండి
వెబ్ విడ్జెట్ను సృష్టించండి.
APIలో: /v1/publishable-key,
/v1/mic-session, మరియు
విడ్జెట్ SDK డాక్యుమెంటేషన్.
నాలెడ్జ్ బేస్లు
నాలెడ్జ్ బేస్ అనేది మీ ఏజెంట్ తన సమాధానాలకు ఆధారం ఇవ్వడానికి కాల్ మధ్యలో శోధించగల డాక్యుమెంట్ల సమాహారం — ఫైల్లను అప్లోడ్ చేయండి, టెక్స్ట్ను పేస్ట్ చేయండి, లేదా URL ద్వారా వెబ్ పేజీలను ఇంపోర్ట్ చేయండి, ఆపై బిల్డర్లో నాలెడ్జ్ బేస్ను ఏజెంట్కు జత చేయండి. సంభాషణకు అవసరమైనప్పుడు ఏజెంట్ అంతర్నిర్మిత శోధన టూల్తో దాన్ని క్వెరీ చేస్తుంది.
డ్యాష్బోర్డ్లో: డాక్యుమెంట్ లైబ్రరీ కోసం నాలెడ్జ్ (/dashboard/knowledge);
ఏజెంట్కు ఒకదాన్ని జత చేయడానికి బిల్డర్లోని నాలెడ్జ్ విభాగం. చూడండి
మీ ఏజెంట్కు నాలెడ్జ్ బేస్ ఇవ్వండి.
కనెక్షన్లు
కనెక్షన్లు ఏజెంట్లు బయటి ప్రపంచాన్ని చేరుకునే మార్గం. ఒక సైడ్బార్ గ్రూప్లో నాలుగు రకాలు:
- యాప్స్ (
/dashboard/app-connections) — Slack, HubSpot, Salesforce, Google Calendar, Google Sheets, మరియు Cal.comకు OAuth కనెక్షన్లు. ఒకసారి కనెక్ట్ చేసి, ఆపై ఒక్కో ఆపరేషన్ టూల్లను (Slack సందేశాన్ని పోస్ట్ చేయడం, HubSpot కాంటాక్ట్ను అప్సర్ట్ చేయడం, Cal.com స్లాట్ను బుక్ చేయడం…) ఏ ఏజెంట్కైనా టోగుల్ చేయండి. చూడండి యాప్స్ను కనెక్ట్ చేయండి. - APIలు (
/dashboard/api-connections) — ఏదైనా HTTP APIని ఏజెంట్ చర్యగా మార్చండి. cURL కమాండ్ను పేస్ట్ చేస్తే AI విజార్డ్ టూల్ నిర్వచనాన్ని రూపొందిస్తుంది, లేదా దాన్ని మాన్యువల్గా నిర్మించండి; మీరు విడుదల చేసే ముందు టెస్ట్ రిక్వెస్ట్ బటన్ శాండ్బాక్స్ కాల్ను ప్రారంభిస్తుంది. చూడండి API కనెక్షన్లు — ఇది/v1/integrationsకు డ్యాష్బోర్డ్ రూపం. - MCP (
/dashboard/mcp-connections) — URL ద్వారా Model Context Protocol సర్వర్ను జోడించి, అది అందించే టూల్లను ఏజెంట్ ఉపయోగించనివ్వండి. చూడండి MCP సర్వర్ను జోడించండి. - VoIP (
/dashboard/voip-connections) — మీ స్వంత ఫోన్ నంబర్లను ఉపయోగించడానికి ప్రొవైడర్ క్రెడెన్షియల్లు. చూడండి VoIP ప్రొవైడర్ను కనెక్ట్ చేయండి.
బాహ్య MCP క్లయింట్ ఏజెంట్లను జాబితా చేయడానికి, కాల్లు మరియు ట్రాన్స్క్రిప్ట్లను పరిశీలించడానికి, మరియు కాల్లు చేయడానికి ThunderPhone తన స్వంత MCP ఎండ్పాయింట్ను కూడా అందిస్తుంది. చూడండి ThunderPhoneను MCP సర్వర్గా ఉపయోగించండి.
APIలో: /v1/integrations,
/v1/mcp-servers, మరియు
/v1/voip-connections; ఇవీ కూడా చూడండి
టూల్ ఇంటిగ్రేషన్ను నిర్మించండి.
క్యాంపెయిన్లు
క్యాంపెయిన్ భారీ స్థాయిలో అవుట్బౌండ్ కాల్లను చేస్తుంది: కాంటాక్ట్ల CSVను అప్లోడ్ చేయండి, ఏజెంట్ మరియు కాల్ చేసే నంబర్ను ఎంచుకోండి, అలాగే కాలింగ్ విండోను (రోజులు మరియు గంటలు, టైమ్జోన్కు అనుగుణంగా), కంకరెన్సీని, మరియు రీట్రై పాలసీని (గరిష్ఠ ప్రయత్నాలు మరియు ఏ ఫలితాలు — సమాధానం లేదు, వాయిస్మెయిల్, విఫలమైంది — మళ్లీ ప్రయత్నించబడతాయో) సెట్ చేయండి. క్యాంపెయిన్ జాబితా ద్వారా కొనసాగి ప్రతి కాల్ను కాల్ హిస్టరీలో నమోదు చేస్తుంది.
డ్యాష్బోర్డ్లో: క్యాంపెయిన్లు (/dashboard/campaigns). చూడండి
అవుట్బౌండ్ కాలింగ్ క్యాంపెయిన్ను నిర్వహించండి.
ఒకేసారి చేసే ప్రోగ్రామాటిక్ కాల్ల కోసం: అవుట్బౌండ్ కాల్ల API.
ప్రత్యక్ష పర్యవేక్షణ
ప్రత్యక్షం సంస్థ అంతటా ప్రగతిలో ఉన్న ప్రతి కాల్ను చూపిస్తుంది మరియు వాటిలో దేనినైనా తెరిచి నిజ సమయంలో విని సూచనలు ఇవ్వడానికి మిమ్మల్ని అనుమతిస్తుంది. ఇది పర్యవేక్షణ ఉపరితలం: కొత్త promptకు వచ్చే తొలి వాస్తవ ట్రాఫిక్ను గమనించండి లేదా నడుస్తున్న క్యాంపెయిన్పై నిఘా ఉంచండి.
డ్యాష్బోర్డ్లో: ప్రత్యక్షం (/dashboard/live). ప్రత్యక్ష కాల్లను గమనించి పర్యవేక్షించండి చూడండి.
సిమ్యులేషన్లు
ఒక సిమ్యులేషన్ అంటే మీ ఏజెంట్తో నిజమైన సంభాషణ చేసే AI కాలర్ — అదే టెలిఫోనీ మార్గం, నిజమైన ట్రాన్స్క్రిప్ట్, నిజమైన గ్రేడింగ్ — కాబట్టి మీరు విడుదల చేయడానికి ముందు (మరియు తర్వాత) పరీక్షించవచ్చు. దీన్ని ఒక ఏజెంట్ లేదా ఫోన్ నంబర్కు నిర్దేశించండి, కాలర్ దృశ్యాన్ని మీరే వ్రాయండి లేదా ఏజెంట్ యొక్క prompt నుండి AIతో దృశ్యాలను రూపొందించండి (మీరు అడిగితే ఎడ్జ్ కేస్లతో సహా), ఆపై కాల్ను ప్రత్యక్షంగా చూడండి.
దృశ్యాలు సూట్లుగా సమూహీకరించబడతాయి; ఇవి కనీస ఉత్తీర్ణత రేటును స్థిరపరుస్తాయి మరియు CIలో విడుదలలను నిరోధించగలవు. అంగీకరించిన బేస్లైన్తో పోలిస్తే రిగ్రెషన్లు ప్రతి దృశ్యానికి నివేదించబడతాయి.
డ్యాష్బోర్డ్లో: సిమ్యులేషన్లు (/dashboard/simulations), అలాగే ఏజెంట్ బిల్డర్లోని సిమ్యులేషన్ బటన్. కాల్ను సిమ్యులేట్ చేయండి చూడండి.
APIలో: /v1/test-calls మరియు సూట్ రన్నర్ — ఏజెంట్ను ఎండ్-టు-ఎండ్ పరీక్షించండి చూడండి.
ధ్రువీకరణ సెట్లు
ఒక ధ్రువీకరణ సెట్ నిజమైన కాల్ సందర్భాలను పునరావృతమయ్యే, సింగిల్-టర్న్ రిగ్రెషన్ తనిఖీలుగా మారుస్తుంది. ప్రతి ఉదాహరణ సంభాషణ సందర్భం, సంబంధిత కాలర్ ఆడియో, అసలు ప్రతిస్పందన మరియు ఆశించిన ప్రవర్తనను స్థిరపరుస్తుంది. మరొక కాల్ చేయకుండానే ప్రస్తుత ఏజెంట్ డ్రాఫ్ట్పై రీప్లేలు నడుస్తాయి; తాజా రన్ ఇప్పటికీ ఆ డ్రాఫ్ట్తో సరిపోలుతుందో లేదో డిప్లాయ్ డైలాగ్ చూపించగలదు.
డ్యాష్బోర్డ్లో: సంస్థ డేటాసెట్ కోసం ధ్రువీకరణ సెట్లు (/dashboard/validation), రన్ల కోసం ఏజెంట్ బిల్డర్లోని ధ్రువీకరణ ట్యాబ్. ధ్రువీకరణ సెట్లు చూడండి.
APIలో: /v1/validation-sets మరియు అదే రిఫరెన్స్ పేజీలోని ఏజెంట్/ఉదాహరణ రీప్లే ఎండ్పాయింట్లు.
ప్రయోగాలు
ఒక ప్రయోగం ప్రత్యక్ష ట్రాఫిక్పై ఏజెంట్ కాన్ఫిగరేషన్లను A/B పరీక్షిస్తుంది: వేరియంట్లను నిర్వచించండి (వేర్వేరు promptలు, ఇంజిన్లు లేదా సెట్టింగ్లు), వాటి మధ్య ట్రాఫిక్ను విభజించండి మరియు ప్రతి వేరియంట్ ఫలితాలను పోల్చండి. webhookలో బకెట్ లాజిక్ను స్వయంగా రూపొందించడానికి బదులుగా దీన్ని ఉపయోగించండి.
డ్యాష్బోర్డ్లో: ప్రయోగాలు (/dashboard/experiments) మరియు ఏజెంట్ బిల్డర్లోని A/B ట్యాబ్. ప్రయోగాలు (A/B పరీక్ష) చూడండి.
సమస్యలు
ఒక సమస్య అనేది నిర్దిష్ట కాల్లో ఫ్లాగ్ చేయబడిన సమస్య — మానవ సమీక్షకుడు నమోదు చేసినది లేదా AI గ్రేడింగ్ గుర్తించినది. సమస్యలు తీవ్రత, మూలం మరియు స్థితిని కలిగి ఉంటాయి; సమస్యల పేజీ ట్రయాజ్ క్యూ: ఫిల్టర్ చేయండి, సమస్య ఉన్న కాల్ను పరిశీలించండి మరియు పరిష్కారాలను ట్రాక్ చేయండి.
డ్యాష్బోర్డ్లో: సమస్యలు (/dashboard/issues), అలాగే కాల్ హిస్టరీలో ప్రతి కాల్కు ఫ్లాగ్ చేసే ఎంపిక. సమస్యల ట్రయాజ్ చూడండి.
APIలో: /v1/issue-reports.
నివేదికలు
ఒక నివేదిక మీ కాల్ డేటా గురించి సహజ భాషలో అడిగిన ప్రశ్నకు ("గత వారం కాలర్లు మానవుడిని అడగడానికి ఉన్న ప్రధాన మూడు కారణాలు ఏమిటి?") మీరు ఎంచుకున్న ఏజెంట్లు మరియు తేదీ పరిధికి పరిమితమైన AI-వ్రాసిన విశ్లేషణతో సమాధానమిస్తుంది.
డ్యాష్బోర్డ్లో: నివేదికలు (/dashboard/reports). నివేదికలు చూడండి.
పరిశీలన సామర్థ్యం
పరిశీలన సామర్థ్యం అనేది మెట్రిక్ల ఉపరితలం: కాల్ పరిమాణం, ఫలితాలు మరియు కాలక్రమంలో నాణ్యతను ఏజెంట్, సమయ విండో ఆధారంగా ఫిల్టర్ చేయవచ్చు మరియు తదుపరి విశ్లేషణ కోసం ఎగుమతి చేయవచ్చు.
డ్యాష్బోర్డ్లో: పరిశీలన సామర్థ్యం (/dashboard/observability).
పరిశీలన సామర్థ్యం చూడండి.
హెచ్చరికలు
ఒక హెచ్చరిక నియమం సమయ విండోలో ఒక మెట్రిక్ను (విజయ రేటు, వైఫల్య రేటు, సగటు స్కోర్, కాల్ పరిమాణం, సూట్ రిగ్రెషన్లు) గమనిస్తుంది మరియు అది మీ పరిమితిని దాటినప్పుడు ట్రిగ్గర్ అవుతుంది. నోటిఫికేషన్లు ఇమెయిల్ మరియు Slackకు వెళ్తాయి మరియు మీ webhook ఎండ్పాయింట్లకు alert.triggered ఈవెంట్ను ట్రిగ్గర్ చేస్తాయి.
డ్యాష్బోర్డ్లో: సంస్థ → హెచ్చరికలు. హెచ్చరికలు చూడండి.
వెబ్హుక్లు
కాల్ సమయంలో మరియు కాల్ తర్వాత జరిగే అంశాల కోసం ThunderPhone మీ సర్వర్కు HTTP POST వెబ్హుక్లను పంపుతుంది. రెండు డెలివరీ నమూనాలు:
- వెబ్హుక్ ఎండ్పాయింట్లు (సిఫార్సు చేయబడినవి): ప్రతి ఎండ్పాయింట్కు ప్రత్యేక సీక్రెట్లు మరియు ఈవెంట్ సబ్స్క్రిప్షన్లతో అనేక URLలను
/v1/developer/webhook-endpointsవద్ద నిర్వహించండి. - లెగసీ సింగిల్-URL వెబ్హుక్: ప్రతి సంస్థకు ఒక URL. దీన్ని
/v1/webhookవద్ద లేదా సంస్థ → సాధారణం కింద నిర్వహించండి. వెనుకబడిన అనుకూలత కోసం ఉంచబడింది.
ఈవెంట్లు రెండు తరగతులుగా విభజించబడతాయి:
- బ్లాకింగ్ ఈవెంట్లు మీ సర్వర్ నుంచి జరుగుతున్న కాల్ను ఆకృతీకరించే కాన్ఫిగరేషన్తో ప్రతిస్పందనను ఆశిస్తాయి — అవి
ఇన్కమింగ్-కాల్ ఈవెంట్లు
(
telephony.incoming/web.incoming). ప్రతిస్పందించడానికి మీకు గరిష్ఠంగా 10 సెకన్లు ఉంటాయి; సమయం ముగిస్తే స్థిరంగా కేటాయించిన ఏజెంట్ కాల్ను నిర్వహిస్తుంది. - నాన్-బ్లాకింగ్ ఈవెంట్లు ఫైర్-అండ్-ఫర్గెట్ నోటిఫికేషన్లు, ఇవి ఎక్స్పోనెన్షియల్ బ్యాక్ఆఫ్తో మళ్లీ ప్రయత్నించబడతాయి — చూడండి డెలివరీ సెమాంటిక్స్.
ప్రతి అభ్యర్థనలో X-ThunderPhone-Signatureలో HMAC-SHA256 సిగ్నేచర్ ఉంటుంది. చూడండి
సిగ్నేచర్ ధృవీకరణ.
ఫంక్షన్ టూల్స్
ఫంక్షన్ టూల్ అనేది మీ ఏజెంట్ సంభాషణ మధ్యలో కాల్ చేయగల HTTP ఎండ్పాయింట్. మీరు ThunderPhoneకు OpenAI-శైలి ఫంక్షన్ స్కీమాతో పాటు ఎండ్పాయింట్ URL ఇస్తారు; ఏజెంట్ దాన్ని ఎప్పుడు కాల్ చేయాలో నిర్ణయిస్తుంది, ThunderPhone తన సర్వర్ల నుంచి సంతకం చేసిన HTTP అభ్యర్థనను పంపి ఫలితాన్ని ఏజెంట్కు తిరిగి అందిస్తుంది.
ఏజెంట్లు అంతర్నిర్మిత కాల్ సామర్థ్యాలతో కూడా వస్తాయి — కాల్ను బదిలీ చేయడం, కీప్యాడ్ (DTMF) ఇన్పుట్ పంపడం, కాల్ ముగించడం, హోల్డ్లో వేచి ఉండడం — వీటిని టూల్ నిర్వచనాల బదులు సాధారణ prompt లైన్లతో ప్రారంభించవచ్చు.
డ్యాష్బోర్డ్లో: బిల్డర్లోని API కనెక్షన్లు విభాగం (చూడండి కనెక్షన్లు).
APIలో: /v1/integrations మరియు
ఫంక్షన్ టూల్స్ స్పెసిఫికేషన్.
బృందం మరియు పాత్రలు
ప్రతి సంస్థలో రెండు పాత్రలతో సభ్యుల జాబితా ఉంటుంది: సభ్యులు ఏజెంట్లను నిర్మించి నిర్వహిస్తారు; అడ్మిన్లు బృందం మరియు బిల్లింగ్ను కూడా నిర్వహిస్తారు. ఇమెయిల్ ద్వారా ఆహ్వానించండి — ఆహ్వానాల గడువు 7 రోజుల తర్వాత ముగుస్తుంది, వాటిని రద్దు చేయవచ్చు; సభ్యుని వరుసలోని ⋯ మెనూ పాత్రలను మార్చుతుంది లేదా ఒకరిని తొలగిస్తుంది. సింగిల్ సైన్-ఆన్ను సంస్థవ్యాప్తంగా కాన్ఫిగర్ చేయవచ్చు — చూడండి SSO.
డ్యాష్బోర్డ్లో: సంస్థ → సాధారణం. చూడండి మీ బృందాన్ని ఆహ్వానించండి.
APIలో: /v1/members,
/v1/invites.
బిల్లింగ్
ThunderPhone ప్రీపెయిడ్. ప్రతి సంస్థకు USD బ్యాలెన్స్ ఉంటుంది; ఏజెంట్ యొక్క నిమిషానికి రేటు ప్రకారం కాల్లకు దానిలోంచి ఛార్జ్ చేయబడుతుంది (ఇంజిన్ టియర్తో పాటు సర్చార్జ్లు —
మీరు సెట్టింగ్లను మార్చినప్పుడు బిల్డర్ మొత్తం రేటును ప్రత్యక్షంగా చూపిస్తుంది, మరియు
ఎంచుకున్న అదనపు భాషలు నిమిషానికి 3¢ జోడిస్తాయి). బ్యాలెన్స్ సున్నాకు చేరినప్పుడు, ఇన్బౌండ్ కాల్లు తిరస్కరించబడతాయి మరియు అవుట్బౌండ్ కాల్లు
402 Payment Requiredను తిరిగి ఇస్తాయి.
మాన్యువల్గా టాప్ అప్ చేయండి లేదా బ్యాలెన్స్ పరిమితి, రీఫిల్ మొత్తం, మరియు ఐచ్ఛిక నెలవారీ ఖర్చు పరిమితితో ఆటో టాప్ అప్ ప్రారంభించండి — తద్వారా వాక్యం మధ్యలో కాల్ ఎప్పటికీ నిలిచిపోదు.
డ్యాష్బోర్డ్లో: సంస్థ → బిల్లింగ్ సెట్టింగ్లు మరియు బిల్లింగ్ చరిత్ర. చూడండి నిధులు జోడించి ఆటో టాప్ అప్ ప్రారంభించండి, అలాగే పూర్తి ధరల సూచిక.
APIలో: /v1/billing.
యాప్లోని కోపైలట్
డ్యాష్బోర్డ్లో అంతర్నిర్మిత కోపైలట్ ఉంది — దానిని "నేను X ఎలా చేయాలి" అని అడిగితే, ఈ డాక్యుమెంటేషన్ ఆధారంగా సమాధానం ఇస్తుంది, అసలు నియంత్రణలను హైలైట్ చేసే క్లిక్-బై-క్లిక్ వివరణలను అందిస్తుంది, మరియు గైడెడ్ టూర్లలో దేనినైనా మళ్లీ ప్లే చేయగలదు. ఈ పేజీలో ప్రస్తావించిన నియంత్రణను కనుగొనడానికి ఇదే వేగవంతమైన మార్గం. చూడండి యాప్లోని కోపైలట్ను అడగండి.
అన్నింటినీ కలిపి చూడండి
ఐదు దశల విజార్డ్: ఏజెంట్ → బిల్లింగ్ → నంబర్ → సిమ్యులేషన్ → సమీక్ష.
నాలుగు REST కాల్లలో అదే తొలి కాల్.
ఏజెంట్ను రూపొందించండి, నిధులు జోడించండి, నంబర్ పొందండి, కాల్లను సిమ్యులేట్ చేసి సమీక్షించండి.
OAuth యాప్లు, కస్టమ్ APIలు, MCP సర్వర్లు, మరియు VoIP ప్రొవైడర్లు.
రిపోర్ట్లు, పరిశీలన సామర్థ్యం, ప్రయోగాలు, సమస్యలు, మరియు అలర్ట్లు.
ఆహ్వానాలు మరియు పాత్రలు, API కీలు, భద్రత, మరియు SSO.
API రెసిపీలు: ఇన్బౌండ్, అవుట్బౌండ్, డైనమిక్ కాన్ఫిగ్, టూల్స్, టెస్టింగ్.
HMAC తనిఖీని ఒకసారి సరిగ్గా చేసి, ప్రతిచోటా మళ్లీ ఉపయోగించండి.