> ## 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)

> एंड-टू-एंड: एक एजेंट कॉन्फ़िगर करें, उसे एक फोन नंबर असाइन करें, कॉल लें और ट्रांसक्रिप्ट की जांच करें।

<Note>
  अपना पहला एजेंट हाथ से बना रहे हैं? डैशबोर्ड एक गाइडेड विज़ार्ड के
  साथ यही सटीक फ्लो दिखाता है — एजेंट बनाएं, नंबर जोड़ें, सिमुलेट करें,
  रिव्यू करें। [डैशबोर्ड क्विकस्टार्ट](/hi/quickstart-dashboard) से शुरू करें।
</Note>

आपके टर्मिनल से "AI से फोन का जवाब दिलाने" का मानक फ्लो।
आप:

1. प्रॉम्प्ट और वॉइस के साथ एक एजेंट बनाएं।
2. फोन नंबर प्रोविज़न करें (या अपना नंबर लाएं) और एजेंट को उसका
   इनबाउंड हैंडलर असाइन करें।
3. नंबर पर कॉल करें। कॉल लॉग, ट्रांसक्रिप्ट और रिकॉर्डिंग देखें।

कुल API कॉल्स: चार। कुल समय: पांच मिनट से कम।

## 1. एजेंट बनाएं

एक एजेंट प्रॉम्प्ट, वॉइस और प्रोडक्ट टियर को एक साथ रखता है जो कॉल
को संचालित करेंगे। हर कॉन्फ़िगरेशन फ़ील्ड के लिए [एजेंट्स](/api-reference/agents) देखें;
न्यूनतम कॉन्फ़िगरेशन यह है:

```bash theme={null}
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 में इसकी ज़रूरत होगी।

<Tip>
  सबसे कम लागत पर आसान Q\&A के लिए `spark` चुनें, और जब स्पीड
  सबसे महत्वपूर्ण हो तब `bolt` चुनें। जब आपके प्रॉम्प्ट को गहरी रीजनिंग
  चाहिए और मॉडल के सोचने के दौरान आधे सेकंड का फिलर स्वीकार्य हो, तो
  `storm-base-with-ack` पर अपग्रेड करें। [प्रोडक्ट टियर्स](/api-reference/agents#product-tiers-at-a-glance)
  देखें।
</Tip>

## 2. फोन नंबर पाएं

अगर आपको सिर्फ कॉल करने के लिए कोई नंबर चाहिए, तो ThunderPhone के पूल से
एक डेमो नंबर प्रोविज़न करें:

```bash theme={null}
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` शामिल होता है।
डेमो नंबर `status="provisioning"` से शुरू होते हैं और कुछ सेकंड में
`active` हो जाते हैं — अगर आपको यह ट्रांज़िशन देखना है, तो
[`GET /v1/phone-numbers/{id}`](/api-reference/phone-numbers#retrieve-a-phone-number)
को पोल करें।

<Note>
  प्रोडक्शन के लिए डेमो नंबर छोड़ें और
  [VoIP के माध्यम से अपने नंबर लाएं](/hi/guides/bring-your-own-numbers)।
  डेमो नंबर केवल इनबाउंड होते हैं और उनकी वॉल्यूम सीमा होती है।
</Note>

## 3. एजेंट असाइन करें

चरण 1 के एजेंट को नंबर की इनबाउंड दिशा के साथ एसोसिएट करें:

```bash theme={null}
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` भी सेट कर सकते हैं,
ताकि नंबर आउटबाउंड कॉल करने के लिए भी तैयार हो।

## 4. कॉल लें

अपने फोन से नंबर डायल करें। एजेंट कॉल उठाता है, आपके प्रॉम्प्ट के अनुसार
अपना परिचय देता है और बातचीत शुरू होती है।

कॉल चल रही होने पर, वह
[`GET /v1/calls`](/api-reference/calls#list-calls) में
`status="in_progress"` के साथ दिखाई देती है। कॉल समाप्त होने पर रिकॉर्ड
`end_reason`, `duration_seconds`, `billable_minutes` और (अंततः)
रिकॉर्डिंग URL तथा AI ग्रेड के साथ अपडेट होता है।

## 5. परिणाम जांचें

हाल की कॉल्स की सूची फ़ेच करें:

```bash theme={null}
curl 'https://api.thunderphone.com/v1/calls?limit=5' \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

ट्रांसक्रिप्ट प्राप्त करें:

```bash theme={null}
curl https://api.thunderphone.com/v1/calls/{call_id}/transcript \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

और रिकॉर्डिंग URL (अल्पकालिक, साइन किया हुआ):

```bash theme={null}
curl https://api.thunderphone.com/v1/calls/{call_id}/audio \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

अगर आपने
[`telephony.complete` वेबहुक](/hi/webhooks/events)
को सब्सक्राइब किया है, तो आपको वही डेटा आपके सर्वर पर POST के रूप में मिलेगा —
[call.complete](/hi/webhooks/call-complete) देखें।

***

## अगले चरण

<CardGroup cols={2}>
  <Card title="डायनामिक प्रति-कॉल कॉन्फ़िग" icon="bolt" href="/hi/guides/dynamic-call-config">
    फ़ोन नंबर या वेबहुक में कस्टम लॉजिक के आधार पर हर कॉलर के लिए अलग एजेंट चुनें।
  </Card>

  <Card title="टूल इंटीग्रेशन जोड़ें" icon="screwdriver-wrench" href="/hi/guides/build-tool-integration">
    एजेंट को बातचीत के बीच में आपके API कॉल करने दें।
  </Card>

  <Card title="call.complete वेबहुक प्राप्त करें" icon="bolt" href="/hi/webhooks/call-complete">
    हर पूरी हुई कॉल को अपने CRM / एनालिटिक्स पाइपलाइन में स्ट्रीम करें।
  </Card>

  <Card title="AI ग्रेडिंग और समस्या रिपोर्ट" icon="chart-line" href="/api-reference/calls#ai-call-grading">
    हर कॉल को अपने-आप स्कोर करें और फ़्लैग की गई कॉल को रिव्यू के लिए रूट करें।
  </Card>
</CardGroup>