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

ప్లాట్‌ఫారమ్‌లోని ప్రతిదానికీ ఒక మ్యాప్ — ప్రతి ఆబ్జెక్ట్ ఏమి చేస్తుంది, అది డ్యాష్‌బోర్డ్‌లో ఎక్కడ ఉంటుంది, దాన్ని ఏ API ఉపయోగిస్తుంది.

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

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

సంస్థలు#

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

సంస్థ → కీలు కింద మీరు సృష్టించే sk_live_ API కీ ఒక సంస్థకు అనుసంధానించబడుతుంది. ఈ అనుసంధానమే REST APIని ఎంతో సరళంగా ఉంచుతుంది: మీ కీ ఇప్పటికే సంస్థను గుర్తిస్తుంది కాబట్టి, మీరు URL పాత్‌లలో సంస్థ 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 నంబర్లు — ThunderPhone పూల్ నుండి ప్రొవిజన్ చేయబడిన నిజమైన U.S. నంబర్లు; సెకన్లలో యాక్టివ్ అవుతాయి, $1/నెలకు, అదనంగా 1¢/నిమిషానికి సర్‌చార్జ్ ఉంటుంది. ఇవి ప్రారంభంలో ఇన్‌బౌండ్‌కు మాత్రమే ఉంటాయి. సంస్థ అడ్మిన్ ఫోన్ నంబర్లు పేజీ నుండి అవుట్‌బౌండ్ కాలింగ్‌ను అభ్యర్థించవచ్చు; ThunderPhone ప్రతి అభ్యర్థనను మాన్యువల్‌గా సమీక్షిస్తుంది, మరియు ఆమోదించబడిన నంబర్లు కాల్‌లు చేయగలవు, క్యాంపెయిన్‌లను నిర్వహించగలవు. ఒక సంస్థ డిఫాల్ట్‌గా 25 నంబర్లను కలిగి ఉండవచ్చు.
• VoIP నంబర్లు — మీ స్వంత ప్రొవైడర్ నుండి VoIP కనెక్షన్ ద్వారా తీసుకువచ్చేవి. Twilio మరియు Telnyxలు API కీతో నేరుగా కనెక్ట్ అవుతాయి (Telnyxలో గైడెడ్ కొత్త-ఖాతా సెటప్ కూడా ఉంది); SignalWire, Vonage, Plivo మరియు ఇతర SIP ట్రంక్‌లు 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 కాంటాక్ట్‌ను upsert చేయడం, 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 ప్రొవైడర్‌ను కనెక్ట్ చేయండి.

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

డ్యాష్‌బోర్డ్‌లో: ప్రయోగాలు (/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). ఒక ఫోన్ కాల్ ఒక రీట్రైతో సహా గరిష్ఠంగా 13 సెకన్లు, మరియు ఒక విడ్జెట్ సెషన్ 10 సెకన్లు వేచి ఉంటుంది. ఫాల్‌బ్యాక్ ఏజెంట్ ఉండదు: ఉపయోగించగల కాన్ఫిగరేషన్ లేకపోతే ఫోన్ కాల్ ముగించబడుతుంది మరియు విడ్జెట్ సెషన్ విఫలమవుతుంది.
• నాన్-బ్లాకింగ్ ఈవెంట్‌లు ఫైర్-అండ్-ఫర్‌గెట్ నోటిఫికేషన్‌లు; ఎక్స్‌పోనెన్షియల్ బ్యాక్‌ఆఫ్‌తో మళ్లీ ప్రయత్నించబడతాయి — చూడండి డెలివరీ సెమాంటిక్స్.

ప్రతి అభ్యర్థనలో టైమ్‌స్టాంప్‌తో కూడిన HMAC-SHA256 సిగ్నేచర్ X-ThunderPhone-Signature-V2లో ఉంటుంది, అలాగే లెగసీ బాడీ-మాత్రమే సిగ్నేచర్ X-ThunderPhone-Signatureలో ఉంటుంది. చూడండి సిగ్నేచర్ ధృవీకరణ.

ఫంక్షన్ టూల్స్#

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

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