मुख्य अवधारणाएँ

ThunderPhone AI वॉइस एजेंट बनाने, चलाने और बेहतर करने के लिए एक पूर्ण प्लेटफ़ॉर्म है। यह पेज एक मैप है: आपको मिलने वाली हर अवधारणा, प्रत्येक के लिए एक छोटा सेक्शन, साथ में डैशबोर्ड की सतह और उसे सपोर्ट करने वाला API। इसे एक बार जल्दी से पढ़ें, फिर जब भी किसी शब्द को समझने की ज़रूरत हो, वापस आएँ। डैशबोर्ड साइडबार इसी संरचना को दर्शाता है:

---

​

संगठन

संगठन टेनेंसी की इकाई है। हर अन्य रिसोर्स — एजेंट, फ़ोन नंबर, कॉल, keys — ठीक एक संगठन से संबंधित होता है। आपका अकाउंट कई संगठनों से संबंधित हो सकता है; हर एक का अपना बैलेंस, अपनी keys और अपनी सदस्य सूची होती है। संगठन → Keys के अंतर्गत बनाई गई sk_live_ API key एक संगठन से बंधी होती है। यही बाइंडिंग REST API को इतना सरल बनाती है: आपको URL paths में कभी org id नहीं डालना पड़ता, क्योंकि आपकी key पहले से उसकी पहचान करती है। डैशबोर्ड में: संगठन स्विचर (साइडबार फ़ूटर) और संगठन सेटिंग्स — General, Keys, Alerts, Billing Settings और Billing History के टैब। API में: /v1/orgs, /v1/developer/api-keys।

---

​

एजेंट

एक एजेंट वह AI कॉन्फ़िगरेशन है जो कॉल चलाता है। इसमें शामिल हैं:

• एक प्रॉम्प्ट, जो यह नियंत्रित करता है कि एजेंट क्या कहता है और कैसे व्यवहार करता है — जिसमें ट्रांसफर, कीपैड प्रेस और हैंग-अप जैसी कॉल कार्रवाइयाँ शामिल हैं, जो अलग कॉन्फ़िगरेशन के बजाय सामान्य प्रॉम्प्ट लाइनें होती हैं।
• एक इंजन टियर (spark, bolt, storm-*): Spark को लागत के लिए ऑप्टिमाइज़ किया गया है, Bolt को गति के लिए, और Storm को जटिल प्रॉम्प्ट पर इंटेलिजेंस के लिए।
• एक वॉइस, साथ में एक प्राथमिक भाषा और वैकल्पिक अतिरिक्त भाषाएँ — कॉलर के भाषा बदलने पर एजेंट अपने-आप भाषा बदल देता है। समर्थित भाषाएँ देखें।
• संलग्न क्षमताएँ: कनेक्टेड ऐप्स, API कनेक्शन, नॉलेज बेस, MCP सर्वर, और इनलाइन फंक्शन टूल।
• व्यवहार नियंत्रण: बोलने का क्रम, स्वीकृति मोड, बैकग्राउंड ट्रैक, होल्ड टाइमआउट।

बिल्डर में किए गए एडिट अपने-आप ड्राफ़्ट में सेव होते हैं; जब तक आप डिप्लॉय पर क्लिक नहीं करते, कुछ भी लाइव नहीं होता। हर डिप्लॉय को बिल्डर के हिस्ट्री टैब में स्नैपशॉट किया जाता है, इसलिए आप किसी भी पिछले वर्ज़न का निरीक्षण और उसे रिस्टोर कर सकते हैं। डैशबोर्ड में: वॉइस एजेंट्स → एजेंट बिल्डर (/dashboard/agents)। अपना पहला वॉइस एजेंट बनाएँ देखें। API में: /v1/agents — CRUD, डुप्लिकेट, ट्रांसफर, वर्ज़न हिस्ट्री और प्रॉम्प्ट हेल्पर्स।

---

​

फ़ोन नंबर

एक फ़ोन नंबर किसी संगठन का होता है और इनबाउंड कॉल को एक एजेंट तक रूट करता है (और आउटबाउंड कॉल कर सकता है)। इसके दो स्रोत हैं:

• डेमो नंबर — 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।

---

​

वेब विजेट

वेब विजेट आपकी साइट के विज़िटरों को एजेंट के साथ माइक-आधारित बातचीत देता है — फ़ोन नंबर की ज़रूरत नहीं। यह एक पब्लिशेबल key (pk_live_...) से ऑथेंटिकेट करता है, जो आपके अनुमत डोमेन के लिए origin-locked होती है, इसलिए यह क्लाइंट-साइड कोड में सुरक्षित है। Keys दो में से एक मोड में चलती हैं: agent (एक एजेंट से स्टैटिक रूप से बंधी) या webhook (आपका सर्वर हर विज़िटर के लिए कॉन्फ़िगरेशन चुनता है — देखें डायनेमिक प्रति-कॉल कॉन्फ़िगरेशन)। विजेट सेशन फ़ोन कॉल जैसी ही कॉल इन्फ्रास्ट्रक्चर से गुजरते हैं। डैशबोर्ड में: वेब विजेट (/dashboard/web-widgets) — विजेट बनाएँ, मोड और एजेंट सेट करें, अनुमत डोमेन मैनेज करें, और एम्बेड स्निपेट कॉपी करें। देखें वेब विजेट बनाएँ। API में: /v1/publishable-key, /v1/mic-session, और Widget SDK दस्तावेज़।

---

​

नॉलेज बेस

एक नॉलेज बेस दस्तावेज़ों का एक सेट है जिसे आपका एजेंट कॉल के दौरान अपने जवाबों को आधार देने के लिए खोज सकता है — फ़ाइलें सीधे अपलोड करें या Google Drive से इंपोर्ट करें, फिर बिल्डर में नॉलेज बेस को किसी एजेंट से अटैच करें। बातचीत की आवश्यकता होने पर एजेंट बिल्ट-इन सर्च टूल से इसे क्वेरी करता है। डैशबोर्ड में: दस्तावेज़ लाइब्रेरी के लिए नॉलेज (/dashboard/knowledge); किसी एजेंट से इसे अटैच करने के लिए बिल्डर का नॉलेज सेक्शन। देखें अपने एजेंट को नॉलेज बेस दें。

---

​

कनेक्शंस

कनेक्शंस वे तरीके हैं जिनसे एजेंट बाहरी दुनिया तक पहुंचते हैं। चार प्रकार, एक साइडबार ग्रुप:

• ऐप्स (/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 प्रोवाइडर कनेक्ट करें।

API में: /v1/integrations और /v1/voip-connections; यह भी देखें टूल इंटीग्रेशन बनाएं।

---

​

कैंपेन्स

एक कैंपेन बड़े पैमाने पर आउटबाउंड कॉल करता है: कॉन्टैक्ट्स की CSV अपलोड करें, एजेंट और फ्रॉम-नंबर चुनें, और कॉलिंग विंडो (दिन और घंटे, टाइमज़ोन-अवेयर), कन्करेंसी और रिट्राई पॉलिसी (अधिकतम प्रयास और किन नतीजों — कोई जवाब नहीं, वॉइसमेल, विफल — को दोबारा प्रयास किया जाए) सेट करें। कैंपेन सूची पर काम करता है और हर कॉल को कॉल हिस्ट्री में रिकॉर्ड करता है। डैशबोर्ड में: कैंपेन्स (/dashboard/campaigns)। देखें आउटबाउंड कॉलिंग कैंपेन चलाएं। एकमुश्त प्रोग्रामैटिक कॉल के लिए: आउटबाउंड कॉल्स API।

---

​

लाइव मॉनिटरिंग

लाइव संगठन में प्रगति पर चल रही हर कॉल दिखाता है, और आपको उनमें से किसी को रियल टाइम में सुनने और व्हिस्पर करने के लिए खोलने देता है। यह सुपरविज़न इंटरफ़ेस है: किसी नए प्रॉम्प्ट पर पहला वास्तविक ट्रैफ़िक देखें, या चल रहे कैंपेन पर नज़र रखें। डैशबोर्ड में: लाइव (/dashboard/live)। देखें लाइव कॉल्स देखें और सुपरवाइज़ करें।

---

​

सिमुलेशंस

एक सिमुलेशन एक AI कॉलर है जो आपके एजेंट के साथ वास्तविक बातचीत करता है — वही टेलीफोनी पाथ, वास्तविक ट्रांसक्रिप्ट, वास्तविक ग्रेडिंग — ताकि आप डिप्लॉय करने से पहले (और बाद में) टेस्ट कर सकें। इसे किसी एजेंट या फोन नंबर पर पॉइंट करें, कॉलर सिनेरियो खुद लिखें या एजेंट के प्रॉम्प्ट से AI के साथ सिनेरियो जनरेट करें (अगर कहें तो एज केस भी शामिल होंगे), और कॉल को लाइव देखें। सिनेरियो सूट्स में ग्रुप होते हैं जो न्यूनतम पास रेट पिन करते हैं और CI में रिलीज़ गेट कर सकते हैं; स्वीकृत बेसलाइन के मुकाबले रिग्रेशंस हर सिनेरियो के लिए रिपोर्ट किए जाते हैं। डैशबोर्ड में: सिमुलेशंस (/dashboard/simulations), साथ ही एजेंट बिल्डर के अंदर सिमुलेशन बटन। देखें कॉल सिमुलेट करें। API में: /v1/test-calls और सूट रनर — देखें एजेंट को एंड-टू-एंड टेस्ट करें।

---

​

एक्सपेरिमेंट्स

एक एक्सपेरिमेंट लाइव ट्रैफ़िक पर एजेंट कॉन्फ़िगरेशन का A/B टेस्ट करता है: वेरिएंट्स (अलग प्रॉम्प्ट्स, इंजन या सेटिंग्स) परिभाषित करें, उनके बीच ट्रैफ़िक विभाजित करें, और हर वेरिएंट के नतीजों की तुलना करें। वेबहुक में मैन्युअल रूप से बकेट लॉजिक बनाने के बजाय इसका उपयोग करें। डैशबोर्ड में: एक्सपेरिमेंट्स (/dashboard/experiments) और एजेंट बिल्डर में A/B टैब। देखें एक्सपेरिमेंट्स (A/B टेस्टिंग)。

---

​

समस्याएँ

एक समस्या किसी विशिष्ट कॉल पर चिह्नित की गई समस्या है — जिसे किसी मानव समीक्षक ने दर्ज किया हो या AI ग्रेडिंग ने पहचाना हो। समस्याओं में गंभीरता, स्रोत और स्थिति होती है, और समस्याएँ पेज ट्रायेज क्यू है: फ़िल्टर करें, समस्या वाली कॉल का निरीक्षण करें और सुधारों को ट्रैक करें। डैशबोर्ड में: समस्याएँ (/dashboard/issues), साथ ही कॉल हिस्ट्री में हर कॉल के लिए फ्लैगिंग। समस्याओं का ट्रायेज देखें। API में: /v1/issue-reports.

---

​

रिपोर्ट्स

एक रिपोर्ट आपके कॉल डेटा के बारे में किसी प्राकृतिक-भाषा प्रश्न (“पिछले सप्ताह कॉल करने वालों ने किसी इंसान से बात करने के लिए शीर्ष तीन कारण क्या बताए?”) का AI-लिखित विश्लेषण देकर उत्तर देती है, जो आपके चुने गए एजेंटों और तारीख सीमा तक सीमित होता है। डैशबोर्ड में: रिपोर्ट्स (/dashboard/reports)। रिपोर्ट्स देखें।

---

​

ऑब्ज़र्वेबिलिटी

ऑब्ज़र्वेबिलिटी मेट्रिक्स का इंटरफ़ेस है: समय के साथ कॉल वॉल्यूम, परिणाम और क्वालिटी, जिन्हें एजेंट और समय विंडो के आधार पर फ़िल्टर किया जा सकता है, तथा डाउनस्ट्रीम विश्लेषण के लिए एक्सपोर्ट किया जा सकता है। डैशबोर्ड में: ऑब्ज़र्वेबिलिटी (/dashboard/observability)। ऑब्ज़र्वेबिलिटी देखें।

---

​

अलर्ट्स

एक अलर्ट नियम किसी समय विंडो में किसी मेट्रिक (सफलता दर, विफलता दर, औसत स्कोर, कॉल वॉल्यूम, सुइट रिग्रेशन) को मॉनिटर करता है और आपके थ्रेशोल्ड को पार करने पर ट्रिगर होता है। नोटिफ़िकेशन ईमेल और Slack पर जाते हैं, और आपके webhook endpoints पर alert.triggered इवेंट ट्रिगर करते हैं। डैशबोर्ड में: संगठन → अलर्ट्स। अलर्ट्स देखें।

---

​

Webhooks

कॉल के दौरान और उसके बाद घटनाएँ होने पर ThunderPhone आपके सर्वर को HTTP POST webhooks भेजता है। डिलीवरी के दो मॉडल हैं:

• Webhook endpoints (अनुशंसित): कई URLs को /v1/developer/webhook-endpoints पर हर एंडपॉइंट के लिए सीक्रेट्स और हर एंडपॉइंट के लिए इवेंट सब्सक्रिप्शन के साथ मैनेज करें।
• लेगेसी सिंगल-URL webhook: हर संगठन के लिए एक URL। इसे /v1/webhook पर या संगठन → सामान्य में मैनेज किया जाता है। बैकवर्ड कंपैटिबिलिटी के लिए रखा गया है।

इवेंट्स दो श्रेणियों में विभाजित हैं:

• ब्लॉकिंग इवेंट्स आपके सर्वर से ऐसे कॉन्फ़िगरेशन के साथ उत्तर की अपेक्षा करते हैं जो चल रही कॉल को आकार देता है — अर्थात इनकमिंग-कॉल इवेंट्स (telephony.incoming / web.incoming)। आपके पास उत्तर देने के लिए अधिकतम 10 सेकंड होते हैं; टाइमआउट होने पर स्टैटिक रूप से असाइन किया गया एजेंट कॉल संभालता है।
• नॉन-ब्लॉकिंग इवेंट्स फायर-एंड-फॉरगेट नोटिफ़िकेशन हैं, जिन्हें एक्सपोनेंशियल बैकऑफ के साथ फिर से भेजा जाता है — डिलीवरी सेमांटिक्स देखें।

हर अनुरोध में X-ThunderPhone-Signature में एक HMAC-SHA256 सिग्नेचर होता है। सिग्नेचर वेरिफ़िकेशन देखें।

---

​

फंक्शन टूल्स

एक फंक्शन टूल एक HTTP एंडपॉइंट है जिसे आपका एजेंट बातचीत के बीच में कॉल कर सकता है। आप ThunderPhone को OpenAI-स्टाइल फंक्शन स्कीमा और एक एंडपॉइंट URL देते हैं; एजेंट तय करता है कि इसे कब कॉल करना है, और ThunderPhone अपने सर्वरों से साइन किया हुआ HTTP अनुरोध करता है और परिणाम एजेंट को वापस देता है। एजेंट्स में बिल्ट-इन कॉल क्षमताएँ भी होती हैं — कॉल ट्रांसफ़र करना, कीपैड (DTMF) इनपुट भेजना, कॉल समाप्त करना, होल्ड पर इंतज़ार करना — जिन्हें आप टूल डेफ़िनिशन के बजाय साधारण प्रॉम्प्ट लाइनों से सक्षम करते हैं। डैशबोर्ड में: बिल्डर का API कनेक्शंस सेक्शन (देखें कनेक्शंस)। API में: /v1/integrations और फंक्शन टूल्स स्पेसिफ़िकेशन।

---

​

टीम और भूमिकाएँ

हर संगठन में दो भूमिकाओं वाली सदस्यों की सूची होती है: सदस्य एजेंट बनाते और संचालित करते हैं; एडमिन्स टीम और बिलिंग भी मैनेज करते हैं। ईमेल से आमंत्रण भेजें — आमंत्रण 7 दिनों के बाद समाप्त हो जाते हैं और रद्द किए जा सकते हैं; किसी सदस्य की पंक्ति में ⋯ मेनू से भूमिकाएँ बदली जा सकती हैं या किसी को हटाया जा सकता है। सिंगल साइन-ऑन को पूरे संगठन के लिए कॉन्फ़िगर किया जा सकता है — SSO देखें। डैशबोर्ड में: संगठन → सामान्य। अपनी टीम को आमंत्रित करें देखें। API में: /v1/members, /v1/invites.

---

​

बिलिंग

ThunderPhone प्रीपेड है। हर संगठन में USD बैलेंस होता है; कॉल एजेंट की प्रति-मिनट दर पर उससे शुल्क काटती हैं (इंजन टियर और अधिभार — सेटिंग्स बदलते समय बिल्डर लाइव ऑल-इन दर दिखाता है, और प्रीमियम भाषाएँ 2¢/मिनट जोड़ती हैं)। बैलेंस शून्य होने पर, इनबाउंड कॉल अस्वीकार कर दी जाती हैं और आउटबाउंड कॉल 402 Payment Required लौटाती हैं। मैन्युअल रूप से टॉप अप करें, या बैलेंस थ्रेशोल्ड, रीफिल राशि और वैकल्पिक मासिक खर्च सीमा के साथ ऑटो टॉप-अप सक्षम करें — ताकि कोई कॉल वाक्य के बीच में कभी बंद न हो। डैशबोर्ड में: संगठन → बिलिंग सेटिंग्स और बिलिंग हिस्ट्री। देखें फंड जोड़ें और ऑटो टॉप-अप चालू करें। API में: /v1/billing।

---

​

इन-ऐप कोपायलट

डैशबोर्ड में बिल्ट-इन कोपायलट शामिल है — उससे पूछें “मैं X कैसे करूँ” और यह इन डॉक्स से जवाब देता है, वास्तविक कंट्रोल्स को हाइलाइट करने वाले क्लिक-दर-क्लिक वॉकथ्रू प्रदान करता है, और किसी भी गाइडेड टूर को फिर से चला सकता है। यह इस पेज में बताए गए किसी कंट्रोल को खोजने का सबसे तेज़ तरीका है। देखें इन-ऐप कोपायलट से पूछें।

---

​

इसे साथ में समझें