---
title: "इनबाउंड कॉल हैंडल करें (API)"
description: "एंड-टू-एंड: एक एजेंट कॉन्फ़िगर करें, उसे एक फोन नंबर असाइन करें, कॉल लें और ट्रांसक्रिप्ट की जांच करें।"
---
अपना पहला एजेंट खुद बना रहे हैं? डैशबोर्ड एक गाइडेड विज़र्ड के साथ
इसी फ्लो से गुज़ारता है — एजेंट बनाएँ, नंबर जोड़ें, सिमुलेट करें, समीक्षा करें।
[डैशबोर्ड क्विकस्टार्ट](/hi/quickstart-dashboard) से शुरू करें।
आपके टर्मिनल से, "AI से फोन का जवाब देने" का मानक फ्लो।
आप:
1. प्रॉम्प्ट और आवाज़ के साथ एक एजेंट बनाएँ।
2. एक फोन नंबर प्रोविज़न करें (या अपना नंबर लाएँ) और एजेंट को उसके
इनबाउंड हैंडलर के रूप में असाइन करें।
3. नंबर पर कॉल करें। कॉल लॉग, ट्रांसक्रिप्ट और रिकॉर्डिंग देखें।
कुल API कॉल: चार। कुल समय: पाँच मिनट से कम।
## 1. एजेंट बनाएँ
एक एजेंट में वह प्रॉम्प्ट, वॉइस और प्रोडक्ट टियर शामिल होते हैं जो
कॉल को संचालित करेंगे। आप एजेंट पर `max_call_duration_seconds`
और `ring_duration_seconds` जैसी कॉल सीमाएं भी सेट कर सकते हैं। एजेंट
पहले से रिकॉर्ड किया गया इंट्रो चलाने और एजेंट के बोलने से पहले अधिकतम दो रिंग
बजाने के लिए `intro_clip` और `intro_ring_count` को भी सपोर्ट करते हैं। नए एजेंट के लिए
टाइम ज़ोन भी आवश्यक है। यदि आपका एजेंट बहुभाषी है, तो आप `language_switching` सेट करके
नियंत्रित कर सकते हैं कि वह भाषा बदलने से पहले पूछे या कॉलर की भाषा का अनुसरण करे।
हर कॉन्फ़िगरेशन फ़ील्ड के लिए [Agents](/api-reference/agents) देखें; न्यूनतम आवश्यक कॉन्फ़िगरेशन यह है:
```bash
curl -X POST https://api.thunderphone.com/v1/agents \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Acme Support",
"prompt": "You are a friendly support agent for Acme. Help callers with orders and returns. Keep answers short.",
"voice": "john",
"product": "spark"
}'
```
लौटाया गया `id` सहेजें — चरण 2 में इसकी आवश्यकता होगी।
सबसे कम लागत पर सरल Q&A के लिए `spark` चुनें, और जब गति सबसे
महत्वपूर्ण हो तब `bolt` चुनें। जब आपके प्रॉम्प्ट को गहरी रीजनिंग की
आवश्यकता हो और मॉडल के सोचते समय आधे सेकंड का फिलर स्वीकार्य हो, तब
`storm-base-with-ack` पर अपग्रेड करें।
[प्रोडक्ट टियर](/api-reference/agents#product-tiers-at-a-glance) देखें।
## 2. फोन नंबर प्राप्त करें
अगर आपको केवल डायल करने के लिए कुछ चाहिए, तो ThunderPhone के पूल से
एक ThunderPhone नंबर प्राप्त करें:
```bash
curl -X POST https://api.thunderphone.com/v1/phone-numbers \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"area_code": "415"}'
```
रिस्पॉन्स में E.164 प्रारूप में एक `id` और एक `number` शामिल होता है। ThunderPhone
नंबर `status="provisioning"` से शुरू होते हैं और कुछ सेकंड के भीतर `active` हो जाते हैं —
अगर आप ट्रांज़िशन देखना चाहते हैं, तो
[`GET /v1/phone-numbers/{id}`](/api-reference/phone-numbers#retrieve-a-phone-number)
को पोल करें।
ThunderPhone नंबर शुरुआत में केवल इनबाउंड होते हैं। संगठन का एडमिन Phone Numbers पेज से
आउटबाउंड कॉलिंग का अनुरोध कर सकता है। ThunderPhone हर अनुरोध की मैन्युअल समीक्षा करता है;
स्वीकृति मिलने के बाद, नंबर कॉल कर सकते हैं और कैंपेन चला सकते हैं।
ग्राहक के VoIP नंबर अपरिवर्तित रहते हैं।
## 3. एजेंट असाइन करें
चरण 1 के एजेंट को नंबर की इनबाउंड दिशा से संबद्ध करें:
```bash
curl -X PATCH https://api.thunderphone.com/v1/phone-numbers/{phone_id} \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"inbound_agent_id": 12}'
```
बस इतना ही — नंबर लाइव है। आपके संगठन के लिए आउटबाउंड कॉलिंग स्वीकृत होने के बाद,
आप उसी PATCH में `outbound_agent_id` भी सेट कर सकते हैं। तब तक,
API उस असाइनमेंट को `400` के साथ अस्वीकार करता है।
यदि आप इनबाउंड कॉल को एक निश्चित `inbound_agent_id` के बजाय कॉन्फ़िग वेबहुक के माध्यम से रूट करते हैं, तो वह वेबहुक अब `agent_id` और `variables` के साथ हर कॉल के लिए `timezone` भी रिटर्न कर सकता है।
## 4. कॉल लें
अपने फोन से नंबर डायल करें। एजेंट कॉल उठाता है, आपके प्रॉम्प्ट के अनुसार अपना परिचय देता है,
और बातचीत शुरू हो जाती है।
कॉल जारी रहने के दौरान, यह
[`GET /v1/calls`](/api-reference/calls#list-calls) में
`status="in_progress"` के साथ दिखाई देती है। कॉल समाप्त होने पर, रिकॉर्ड में
`end_reason`, `duration_seconds`, `billable_minutes`, और (बाद में)
एक रिकॉर्डिंग URL और AI ग्रेड के साथ अपडेट हो जाता है।
इनबाउंड कॉल आपके संगठन की
[समवर्ती-कॉल सीमा](/api-reference/introduction#call-limits) में गिनी जाती हैं (डिफ़ॉल्ट रूप से प्रगति में 20
कॉल, जो आउटबाउंड, वेब और टेस्ट कॉल के साथ साझा होती हैं)। सीमा पर आने वाली कॉल को एजेंट के
जवाब देने से पहले अस्वीकार कर दिया जाता है और डिस्कनेक्ट कर दिया जाता है, उसका बिल नहीं लिया जाता, और उसे
`concurrent_call_limit_reached` एंड रीजन के साथ विफल कॉल के रूप में रिकॉर्ड किया जाता है। यदि आपको
अधिक सीमा चाहिए, तो support@thunderphone.com पर ईमेल करें।
## 5. परिणामों की जाँच करें
हाल की कॉल्स की सूची प्राप्त करें:
```bash
curl 'https://api.thunderphone.com/v1/calls?limit=5' \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"
```
ट्रांसक्रिप्ट प्राप्त करें:
```bash
curl https://api.thunderphone.com/v1/calls/{call_id}/transcript \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"
```
और रिकॉर्डिंग URL प्राप्त करें (अल्पकालिक, साइन किया हुआ):
```bash
curl https://api.thunderphone.com/v1/calls/{call_id}/audio \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"
```
अगर आपने
[`telephony.complete` webhook](/hi/webhooks/events)
को सब्सक्राइब किया है, तो आपको वही डेटा आपके सर्वर पर POST के रूप में मिलेगा — देखें
[call.complete](/hi/webhooks/call-complete)।
अगर आपके एजेंट में एक्सट्रैक्शन फ़ील्ड्स कॉन्फ़िगर किए गए हैं, तो पूर्ण कॉल पेलोड में
स्ट्रक्चर्ड एक्सट्रैक्टेड डेटा भी शामिल हो सकता है।
---
## अगले चरण
फ़ोन नंबर या webhook में कस्टम लॉजिक के आधार पर हर कॉलर के लिए अलग एजेंट चुनें।
एजेंट को बातचीत के दौरान आपके APIs कॉल करने दें।
कॉलर्स को सीधे रूट करें या कनेक्ट करने से पहले डेस्टिनेशन को स्क्रीन करें।
हर पूरी हुई कॉल को अपने CRM / एनालिटिक्स पाइपलाइन में स्ट्रीम करें।
हर कॉल को अपने-आप स्कोर करें और फ़्लैग की गई कॉल्स को रिव्यू के लिए रूट करें।