---
title: "API कनेक्शन"
description: "किसी भी HTTP API को ऐसे फंक्शन में बदलें जिसे आपका एजेंट बातचीत के बीच में कॉल कर सके: एक cURL कमांड पेस्ट करें और विज़ार्ड टूल डेफिनिशन, पैरामीटर्स और ऑथ बनाता है।"
---
API कनेक्शन कस्टम HTTP फ़ंक्शन हैं जिन्हें आपके एजेंट बातचीत के दौरान कॉल कर सकते हैं — किसी ऑर्डर को देखना, टिकट बनाना, या अपने बैकएंड से अकाउंट स्टेटस प्राप्त करना। आप एंडपॉइंट को **कनेक्शन → APIs** (`/dashboard/api-connections`) के तहत एक बार परिभाषित करते हैं; जिन एजेंटों के साथ कनेक्शन अटैच है, वे बातचीत की ज़रूरत के अनुसार इसे इनवोक कर सकते हैं।
इसे बनाने के दो तरीके हैं: विज़ार्ड द्वारा एनालाइज़ की जा सकने वाली कोई चीज़ पेस्ट करें, या कनेक्शन को मैन्युअली सेट अप करें।
## तेज़ तरीका: पेस्ट करें और एनालाइज़ करें
डायलॉग विज़ार्ड पर खुलता है। बॉक्स में एक सैंपल **cURL कमांड**,
**OpenAPI/Swagger स्पेक**, **Postman एक्सपोर्ट**, **TypeScript
इंटरफ़ेस**, या **Zod स्कीमा** पेस्ट करें।
ThunderPhone आपके पेस्ट से पूरा कनेक्शन अनुमानित करता है — URL,
मेथड, हेडर्स, और मिले हुए क्वेरी पैरामीटर्स तथा रिक्वेस्ट बॉडी से
निकाला गया पैरामीटर स्कीमा। आपके पेस्ट किए हेडर्स (ऑथ हेडर्स सहित)
एंडपॉइंट कॉन्फ़िगरेशन में शामिल कर दिए जाते हैं।
अनुमानित कॉन्फ़िगरेशन रिव्यू के लिए अनुमान लगाए गए फ़ील्ड को हाइलाइट
करके खुलता है। नाम, डिस्क्रिप्शन और पैरामीटर टाइप समायोजित करें ताकि
एजेंट समझ सके कि फ़ंक्शन को कब और कैसे कॉल करना है — मॉडल
डिस्क्रिप्शन ही पढ़ता है।
सेव करने से पहले आपके एंडपॉइंट के विरुद्ध एक लाइव टेस्ट रिक्वेस्ट चलती है।
यदि रिक्वेस्ट विफल होती है, तो कनेक्शन सेव नहीं होता — URL, ऑथ
हेडर्स या बॉडी ठीक करें और फिर से कोशिश करें। सफल होने पर कनेक्शन
**वैलिडेटेड** बैज के साथ स्टोर हो जाता है।
यदि विज़ार्ड को आपके पेस्ट में कोई रिक्वेस्ट URL नहीं मिलता, तो वह आपको बताएगा —
पूरा `http(s)` एंडपॉइंट शामिल करें और फिर से कोशिश करें।
## मैन्युअल सेट अप
विज़ार्ड में **मैन्युअली सेट अप करें →** पर क्लिक करें (या वापस जाने के लिए **क्या AI से इसका अनुमान लगवाना चाहते हैं?
विज़ार्ड आज़माएँ →** पर क्लिक करें)। मैन्युअल बिल्डर में दो एडिटर होते हैं:
- **विज़ुअल** — डिस्प्ले नाम, फ़ंक्शन नाम, रिक्वेस्ट
**URL**, **मेथड** (`POST`, `GET`, `PUT`, `PATCH`, `DELETE`), कस्टम
**हेडर्स**, और पैरामीटर स्कीमा (एजेंट द्वारा दिए जा सकने वाले प्रत्येक
आर्ग्युमेंट के लिए **प्रॉपर्टी जोड़ें**) के लिए फ़ॉर्म फ़ील्ड।
- **JSON** — रॉ JSON के रूप में वही डेफ़िनिशन, जिसे सीधे टूल स्पेक पेस्ट
करने या फ़ाइन-ट्यून करने के लिए उपयोग किया जा सकता है।
एक **टेस्ट रिक्वेस्ट** पैनल (वैकल्पिक) आपको सेव करने से पहले कॉन्फ़िगर की गई रिक्वेस्ट
चलाने देता है और स्टेटस, लेटेंसी तथा रिस्पॉन्स प्रीव्यू दिखाता है।
**वैलिडेट करें और सेव करें** हमेशा यह टेस्ट चलाता है और केवल सफलता पर सेव करता है।
हेडर वैल्यू केवल-लिखने योग्य हैं। सेव होने के बाद वे एन्क्रिप्ट हो जाती हैं और डैशबोर्ड या API में फिर कभी नहीं दिखाई जातीं। जब आप किसी कनेक्शन को एडिट करते हैं, तो सेव किया गया हेडर वैल्यू की जगह डॉट्स के साथ उसका नाम और **सेव किया गया** नोट दिखाता है:
सेव की गई वैल्यू बनाए रखने के लिए इसे जैसा है वैसा ही छोड़ दें, या बदलने के लिए नई वैल्यू टाइप करें। टेस्ट रिक्वेस्ट और लाइव कॉल सेव की गई वैल्यू का उपयोग करते हैं। **क्लोन** सेव की गई वैल्यू को नए कनेक्शन में कॉपी करता है।
पैरामीटर्स को सामान्य भाषा में डिस्क्रिप्शन दें ("कस्टमर का ईमेल एड्रेस,
उदाहरण: jane@example.com")। एजेंट इन डिस्क्रिप्शन से रियल टाइम में,
कॉल के बीच में आर्ग्युमेंट चुनता है।
## अपने कनेक्शन मैनेज करें
हर कनेक्शन रो उसका वैलिडेशन स्टेटस दिखाती है — **वैलिडेटेड**,
**अनटेस्टेड**, या **एरर** — उसका फ़ंक्शन नाम, और उसे इस्तेमाल करने वाले एजेंट।
रो के एक्शन मेनू से आप:
- **एडिट** — कॉन्फ़िगरेशन फिर से खोलें।
- **क्लोन** — शुरुआती बिंदु के रूप में इसकी डुप्लीकेट बनाएं (कॉपी
अनटेस्टेड स्थिति में शुरू होती है)।
- **रिविज़न हिस्ट्री** — पुराने वर्ज़न देखें और किसी एक को एडिटर में
रिस्टोर करें।
- **ट्रांसफ़र** — कनेक्शन को अपने किसी अन्य संगठन में कॉपी या मूव करें।
मूव करने पर यह यहाँ से हट जाता है; इसका इस्तेमाल करने वाले एजेंटों को
फिर से कॉन्फ़िगर करना पड़ सकता है।
- **डिलीट** — स्थायी है; कनेक्शन इस्तेमाल करने वाले एजेंटों को फिर से
कॉन्फ़िगर करना होगा।
## इसे किसी एजेंट से अटैच करें
बिल्डर के API कनेक्शन सेक्शन में एजेंट के साथ कनेक्शन जोड़ें
([एजेंट बनाएं](/hi/guides/build-an-agent))। सूची दिखाती है कि कौन से एजेंट प्रत्येक कनेक्शन
का इस्तेमाल करते हैं, ताकि आप एक नज़र में जान सकें कि बदलाव का क्या असर होगा।
## अगले चरण
उन्हीं कनेक्शनों को प्रोग्रामेटिक रूप से बनाएं और मैनेज करें।
पहले से बने Google, Slack, HubSpot, Salesforce और Cal.com कनेक्शन।
अपने एजेंट्स को पूरा टूल सर्वर उपलब्ध कराएं।
इंटीग्रेशन रिसोर्स का हर फ़ील्ड।