ప్రధాన భావనలు

ThunderPhone అనేది AI వాయిస్ ఏజెంట్లను నిర్మించడానికి, అమలు చేయడానికి, మెరుగుపరచడానికి పూర్తి ప్లాట్‌ఫారమ్. ఈ పేజీ ఒక మ్యాప్: మీరు ఎదుర్కొనే ప్రతి భావనకు, డ్యాష్‌బోర్డ్ ఉపరితలం మరియు దానికి మద్దతిచ్చే APIతో పాటు, ఒక్కో చిన్న విభాగం. ఒకసారి వేగంగా చూడండి, ఆపై ఏ పదానికి వివరణ అవసరమైనా తిరిగి రండి.

డ్యాష్‌బోర్డ్ సైడ్‌బార్ ఈ నిర్మాణాన్ని ప్రతిబింబిస్తుంది:

సంస్థలు

ఒక సంస్థ అనేది టెనెన్సీ యూనిట్. ఏజెంట్లు, ఫోన్ నంబర్లు, కాల్స్, కీలు వంటి ప్రతి ఇతర వనరు కచ్చితంగా ఒక సంస్థకు చెందుతుంది. మీ ఖాతా అనేక సంస్థలకు చెందవచ్చు; ప్రతి దానికి దాని స్వంత బ్యాలెన్స్, స్వంత కీలు, స్వంత సభ్యుల జాబితా ఉంటాయి.

మీరు సంస్థ → కీలు కింద సృష్టించే sk_live_ API కీ ఒక సంస్థకు అనుసంధానించబడుతుంది. ఈ అనుసంధానమే REST APIని చాలా సరళంగా ఉంచుతుంది: మీ కీ ఇప్పటికే సంస్థను గుర్తిస్తుంది కాబట్టి, మీరు URL పాత్‌లలో ఎప్పుడూ org id ఉంచరు.

డ్యాష్‌బోర్డ్‌లో: సంస్థ స్విచ్చర్ (సైడ్‌బార్ ఫుటర్) మరియు సంస్థ సెట్టింగ్‌లు — నా ఖాతా, సాధారణం, కీలు, హెచ్చరికలు, బిల్లింగ్ సెట్టింగ్‌లు మరియు బిల్లింగ్ చరిత్ర కోసం ట్యాబ్‌లు. చూడండి సంస్థ సెట్టింగ్‌ల సూచిక.

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 పూల్ నుండి ప్రొవిజన్ చేయబడిన నిజమైన U.S. నంబర్లు, సెకన్లలో అందుబాటులోకి వస్తాయి. ఇవి ఇన్‌బౌండ్‌కు మాత్రమే పరిమితం, చిన్న మౌఖిక నిరాకరణ ప్రకటనతో సమాధానం ఇస్తాయి మరియు డ్యాష్‌బోర్డ్ ఒక సంస్థకు వీటిని 10కి పరిమితం చేస్తుంది. మొదటి పరీక్షకు సరైనవి; ఉత్పాదన కోసం కాదు.
• 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.

వెబ్ విడ్జెట్లు

వెబ్ విడ్జెట్ మీ సైట్ సందర్శకులకు మైక్ ఆధారిత సంభాషణను ఏజెంట్‌తో అందిస్తుంది — ఫోన్ నంబర్ అవసరం లేదు. ఇది మీ అనుమతించిన డొమైన్‌లకు origin-locked అయిన ప్రచురించదగిన కీ (pk_live_...)తో ప్రామాణీకరిస్తుంది, కాబట్టి క్లయింట్-సైడ్ కోడ్‌లో ఉపయోగించడం సురక్షితం.

కీలు రెండు మోడ్‌లలో ఒకదానిలో పనిచేస్తాయి: agent (ఒక ఏజెంట్‌కు స్థిరంగా అనుసంధానించబడినది) లేదా webhook (ప్రతి సందర్శకునికి మీ సర్వర్ కాన్ఫిగరేషన్‌ను ఎంచుకుంటుంది — ప్రతి కాల్‌కు డైనమిక్ కాన్ఫిగరేషన్ చూడండి). విడ్జెట్ సెషన్‌లు ఫోన్ కాల్‌ల మాదిరిగానే అదే కాల్ ఇన్‌ఫ్రాస్ట్రక్చర్ ద్వారా ప్రవహిస్తాయి.

డాష్‌బోర్డ్‌లో: వెబ్ విడ్జెట్లు (/dashboard/web-widgets) — విడ్జెట్‌లను సృష్టించండి, మోడ్ మరియు ఏజెంట్‌ను సెట్ చేయండి, అనుమతించిన డొమైన్‌లను నిర్వహించండి, మరియు embed snippet‌ను కాపీ చేయండి. చూడండి వెబ్ విడ్జెట్‌ను సృష్టించండి.

APIలో: /v1/publishable-key, /v1/mic-session, మరియు Widget SDK డాక్యుమెంటేషన్.

నాలెడ్జ్ బేస్‌లు

నాలెడ్జ్ బేస్ అనేది మీ ఏజెంట్ కాల్ మధ్యలో తన సమాధానాలకు ఆధారంగా శోధించగల డాక్యుమెంట్‌ల సమాహారం — ఫైల్‌లను అప్‌లోడ్ చేయండి, టెక్స్ట్‌ను పేస్ట్ చేయండి, లేదా URL ద్వారా వెబ్ పేజీలను దిగుమతి చేయండి, ఆపై builderలో నాలెడ్జ్ బేస్‌ను ఏజెంట్‌కు అనుసంధానించండి. సంభాషణకు అవసరమైనప్పుడు ఏజెంట్ అంతర్నిర్మిత శోధన టూల్‌తో దీనిని ప్రశ్నిస్తుంది.

డాష్‌బోర్డ్‌లో: డాక్యుమెంట్ లైబ్రరీ కోసం నాలెడ్జ్ (/dashboard/knowledge); ఏజెంట్‌కు దానిని అనుసంధానించడానికి builderలోని నాలెడ్జ్ విభాగం. చూడండి మీ ఏజెంట్‌కు నాలెడ్జ్ బేస్ ఇవ్వండి.

కనెక్షన్‌లు

ఏజెంట్‌లు బయటి ప్రపంచాన్ని చేరుకోవడానికి కనెక్షన్‌లు ఉపయోగపడతాయి. నాలుగు రకాలు, ఒకే సైడ్‌బార్ సమూహం:

• యాప్‌లు (/dashboard/app-connections) — Slack, HubSpot, Salesforce, Google Calendar, Google Sheets, మరియు Cal.comకు OAuth కనెక్షన్‌లు. ఒకసారి కనెక్ట్ చేసి, ఆపై ప్రతి ఆపరేషన్ టూల్‌ను (Slack సందేశాన్ని పోస్ట్ చేయడం, HubSpot కాంటాక్ట్‌ను అప్సర్ట్ చేయడం, Cal.com స్లాట్‌ను బుక్ చేయడం…) ఏ ఏజెంట్‌కైనా టోగుల్ చేయండి. చూడండి యాప్‌లను కనెక్ట్ చేయండి.
• APIs (/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 endpoint‌ను కూడా అందిస్తుంది. చూడండి ThunderPhoneను MCP సర్వర్‌గా ఉపయోగించండి.

APIలో: /v1/integrations, /v1/mcp-servers, మరియు /v1/voip-connections; అలాగే చూడండి టూల్ ఇంటిగ్రేషన్‌ను రూపొందించండి.

క్యాంపెయిన్‌లు

క్యాంపెయిన్ పెద్ద స్థాయిలో అవుట్‌బౌండ్ కాల్‌లను చేస్తుంది: కాంటాక్ట్‌ల CSVను అప్‌లోడ్ చేయండి, ఏజెంట్ మరియు from-numberను ఎంచుకోండి, మరియు కాలింగ్ విండోను (రోజులు మరియు గంటలు, టైమ్‌జోన్‌ను పరిగణనలోకి తీసుకుని), concurrencyని, అలాగే retry విధానాన్ని (గరిష్ట ప్రయత్నాలు మరియు ఏ ఫలితాలు — సమాధానం లేదు, voicemail, విఫలమైంది — మళ్లీ ప్రయత్నించబడతాయో) సెట్ చేయండి. క్యాంపెయిన్ జాబితా ద్వారా పని చేసి ప్రతి కాల్‌ను కాల్ చరిత్రలో రికార్డ్ చేస్తుంది.

డాష్‌బోర్డ్‌లో: క్యాంపెయిన్‌లు (/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‌లు, ఇంజిన్‌లు లేదా సెట్టింగ్‌లు), వాటి మధ్య ట్రాఫిక్‌ను విభజించండి, మరియు ప్రతి వేరియంట్ ఫలితాలను పోల్చండి. వెబ్‌హుక్‌లో బకెట్ లాజిక్‌ను స్వయంగా రూపొందించడానికి బదులుగా దీన్ని ఉపయోగించండి.

డ్యాష్‌బోర్డ్‌లో: ప్రయోగాలు (/dashboard/experiments) మరియు ఏజెంట్ బిల్డర్‌లోని A/B ట్యాబ్. ప్రయోగాలు (A/B పరీక్ష) చూడండి.

సమస్యలు

ఒక సమస్య అనేది నిర్దిష్ట కాల్‌పై గుర్తించబడిన సమస్య — మానవ సమీక్షకుడు నమోదు చేసినది లేదా AI గ్రేడింగ్ గుర్తించినది. సమస్యలు తీవ్రత, మూలం, మరియు స్థితిని కలిగి ఉంటాయి; సమస్యల పేజీ ట్రయాజ్ క్యూ: ఫిల్టర్ చేయండి, సమస్య కలిగించిన కాల్‌ను పరిశీలించండి, మరియు పరిష్కారాలను ట్రాక్ చేయండి.

డ్యాష్‌బోర్డ్‌లో: సమస్యలు (/dashboard/issues), అలాగే కాల్ చరిత్రలో ప్రతి కాల్‌కు ఫ్లాగ్ చేసే ఎంపిక. సమస్యల ట్రయాజ్ చూడండి.

APIలో: /v1/issue-reports.

నివేదికలు

ఒక నివేదిక మీరు ఎంచుకున్న ఏజెంట్‌లు మరియు తేదీ పరిధికి పరిమితం చేసి, మీ కాల్ డేటాపై సహజ భాషలో అడిగిన ప్రశ్నకు (“గత వారం కాలర్లు మనిషితో మాట్లాడాలని అడిగిన ప్రధాన మూడు కారణాలు ఏమిటి?”) AI రాసిన విశ్లేషణతో సమాధానం ఇస్తుంది.

డ్యాష్‌బోర్డ్‌లో: నివేదికలు (/dashboard/reports). నివేదికలు చూడండి.

పరిశీలన సామర్థ్యం

పరిశీలన సామర్థ్యం అనేది మెట్రిక్స్ ఉపరితలం: కాల్ వాల్యూమ్, ఫలితాలు, మరియు కాలక్రమేణా నాణ్యత; ఏజెంట్ మరియు సమయ విండో ఆధారంగా ఫిల్టర్ చేయవచ్చు, అలాగే తదుపరి విశ్లేషణ కోసం ఎగుమతి చేయవచ్చు.

డ్యాష్‌బోర్డ్‌లో: పరిశీలన సామర్థ్యం (/dashboard/observability). పరిశీలన సామర్థ్యం చూడండి.

హెచ్చరికలు

ఒక హెచ్చరిక నియమం సమయ విండోలో ఒక మెట్రిక్‌ను (విజయ రేటు, వైఫల్య రేటు, సగటు స్కోర్, కాల్ వాల్యూమ్, సూట్ రిగ్రెషన్‌లు) పర్యవేక్షించి, అది మీ పరిమితిని దాటినప్పుడు ట్రిగర్ అవుతుంది. నోటిఫికేషన్‌లు ఇమెయిల్ మరియు Slackకు వెళ్తాయి, అలాగే మీ వెబ్‌హుక్ ఎండ్‌పాయింట్‌లకు 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 ఎలా చేయాలి" అని అడిగితే, ఈ డాక్యుమెంట్‌ల ఆధారంగా సమాధానం ఇస్తుంది, వాస్తవ నియంత్రణలను హైలైట్ చేసే క్లిక్-బై-క్లిక్ వాక్‌థ్రూలను అందిస్తుంది, మరియు ఏదైనా గైడెడ్ టూర్లను మళ్లీ ప్లే చేయగలదు. ఈ పేజీలో పేర్కొన్న నియంత్రణను కనుగొనడానికి ఇదే అత్యంత వేగవంతమైన మార్గం. చూడండి యాప్‌లోని కోపైలట్‌ను అడగండి.

అన్నింటినీ కలిపి చూడండి