> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API कनेक्शन

> किसी भी HTTP API को एक ऐसे फ़ंक्शन में बदलें जिसे आपका एजेंट बातचीत के बीच में कॉल कर सके — एक cURL कमांड पेस्ट करें और बाकी काम विज़ार्ड को करने दें।

API कनेक्शन कस्टम HTTP फंक्शन हैं जिन्हें आपके एजेंट बातचीत के दौरान कॉल कर सकते हैं — ऑर्डर देखना, टिकट बनाना, अपने बैकएंड से अकाउंट स्टेटस प्राप्त करना। आप एंडपॉइंट को **Connections → APIs** (`/dashboard/api-connections`) में एक बार परिभाषित करते हैं; जिन एजेंटों के साथ कनेक्शन अटैच है, वे बातचीत की जरूरत के अनुसार इसे कॉल कर सकते हैं।

इसे बनाने के दो तरीके हैं: ऐसी कोई चीज़ पेस्ट करें जिसका विज़ार्ड विश्लेषण कर सके, या कनेक्शन को मैन्युअल रूप से सेट अप करें।

## तेज़ तरीका: पेस्ट करें और विश्लेषण करें

<Steps>
  <Step title="New API connection पर क्लिक करें">
    डायलॉग विज़ार्ड पर खुलता है। बॉक्स में एक सैंपल **cURL command**,
    **OpenAPI/Swagger spec**, **Postman export**, **TypeScript
    interface**, या **Zod schema** पेस्ट करें।
  </Step>

  <Step title="Analyze पर क्लिक करें">
    ThunderPhone आपके पेस्ट से पूरा कनेक्शन अनुमानित करता है — URL,
    मेथड, हेडर्स, और मिले हुए क्वेरी पैरामीटर्स और रिक्वेस्ट बॉडी से
    प्राप्त पैरामीटर स्कीमा। आपके पेस्ट किए गए हेडर्स (ऑथ हेडर्स सहित)
    एंडपॉइंट कॉन्फ़िगरेशन में शामिल कर दिए जाते हैं।
  </Step>

  <Step title="हाइलाइट किए गए फ़ील्ड की पुष्टि करें">
    अनुमानित कॉन्फ़िगरेशन समीक्षा के लिए अनुमानित फ़ील्ड हाइलाइट करके
    खुलता है। नाम, विवरण और पैरामीटर टाइप समायोजित करें ताकि एजेंट समझ
    सके कि फंक्शन को कब और कैसे कॉल करना है — मॉडल विवरण पढ़ता है।
  </Step>

  <Step title="वैलिडेट करें और सेव करें">
    सेव करने से पहले आपके एंडपॉइंट पर लाइव टेस्ट रिक्वेस्ट चलती है। यदि
    रिक्वेस्ट विफल होती है, तो कनेक्शन सेव नहीं होता — URL, ऑथ हेडर्स,
    या बॉडी ठीक करें और फिर कोशिश करें। सफलता पर कनेक्शन **Validated**
    बैज के साथ स्टोर हो जाता है।
  </Step>
</Steps>

अगर विज़ार्ड को आपके पेस्ट में रिक्वेस्ट URL नहीं मिलता, तो वह इसकी सूचना देगा —
पूरा `http(s)` एंडपॉइंट शामिल करें और फिर कोशिश करें।

## मैन्युअल सेटअप

विज़ार्ड में **Set up manually →** पर क्लिक करें (या वापस जाने के लिए **Want AI to infer this?
Try the Wizard →**)। मैन्युअल बिल्डर में दो एडिटर होते हैं:

* **Visual** — डिस्प्ले नाम, फंक्शन नाम, रिक्वेस्ट
  **URL**, **method** (`POST`, `GET`, `PUT`, `PATCH`, `DELETE`), कस्टम
  **headers**, और पैरामीटर स्कीमा के लिए फ़ॉर्म फ़ील्ड (**Add property** हर उस
  आर्ग्युमेंट के लिए जिसे एजेंट दे सकता है)।
* **JSON** — रॉ JSON के रूप में वही परिभाषा, किसी टूल स्पेक को सीधे पेस्ट करने
  या फाइन-ट्यून करने के लिए।

एक **Test Request** पैनल (वैकल्पिक) आपको सेव करने से पहले कॉन्फ़िगर की गई रिक्वेस्ट
चलाने देता है और स्टेटस, लेटेंसी और रिस्पॉन्स प्रीव्यू दिखाता है।
**Validate & Save** हमेशा यह टेस्ट चलाता है और केवल सफलता पर सेव करता है।

<Tip>
  पैरामीटर्स को सामान्य भाषा में विवरण दें ("Customer email address,
  e.g. [jane@example.com](mailto:jane@example.com)")। एजेंट कॉल के बीच में, रियल टाइम में इन
  विवरणों के आधार पर आर्ग्युमेंट चुनता है।
</Tip>

## अपने कनेक्शन मैनेज करें

हर कनेक्शन रो उसका वैलिडेशन स्टेटस दिखाती है — **Validated**,
**Untested**, या **Error** — उसका फंक्शन नाम, और कौन से एजेंट इसका उपयोग करते हैं।
रो के एक्शन मेनू से आप यह कर सकते हैं:

* **Edit** — कॉन्फ़िगरेशन फिर से खोलें।
* **Clone** — इसे शुरुआती बिंदु के रूप में डुप्लिकेट करें (कॉपी
  Untested से शुरू होती है)।
* **Revision history** — पुराने वर्ज़न देखें और किसी एक को एडिटर में रिस्टोर करें।
* **Transfer** — कनेक्शन को अपने किसी अन्य संगठन में कॉपी या मूव करें।
  मूव करने से यह यहां से हट जाता है; इसका उपयोग करने वाले एजेंटों को फिर से
  कॉन्फ़िगर करना पड़ सकता है।
* **Delete** — स्थायी है; कनेक्शन का उपयोग करने वाले एजेंटों को फिर से
  कॉन्फ़िगर करना होगा।

## इसे किसी एजेंट से अटैच करें

बिल्डर के API connections सेक्शन में कनेक्शन को किसी एजेंट से जोड़ें
([एक एजेंट बनाएं](/hi/guides/build-an-agent))। सूची दिखाती है कि हर कनेक्शन का उपयोग
कौन से एजेंट करते हैं, ताकि आप एक नज़र में समझ सकें कि किसी बदलाव का क्या प्रभाव पड़ेगा।

## अगले कदम

<CardGroup cols={2}>
  <Card title="API के ज़रिए टूल इंटीग्रेशन" icon="code" href="/hi/guides/build-tool-integration">
    प्रोग्रामेटिक रूप से वही कनेक्शन बनाएं और मैनेज करें।
  </Card>

  <Card title="ऐप्स कनेक्ट करें" icon="cable" href="/hi/guides/connect-apps">
    पहले से बने Google, Slack, HubSpot, Salesforce, और Cal.com कनेक्शन।
  </Card>

  <Card title="MCP सर्वर जोड़ें" icon="server" href="/hi/guides/mcp-servers">
    अपने एजेंट्स के लिए एक पूरा टूल सर्वर एक्सपोज़ करें।
  </Card>

  <Card title="इंटीग्रेशन API रेफरेंस" icon="book" href="/api-reference/integrations">
    इंटीग्रेशन रिसोर्स का हर फ़ील्ड।
  </Card>
</CardGroup>