---
title: "येणारे कॉल हाताळा (API)"
description: "सुरुवातीपासून शेवटपर्यंत: एजंट कॉन्फिगर करा, तो फोन नंबरला नियुक्त करा, कॉल घ्या आणि ट्रान्स्क्रिप्ट तपासा."
---

<Note>
  तुमचा पहिला एजंट स्वतः तयार करत आहात? डॅशबोर्ड तुम्हाला याच
  प्रक्रियेतून — एजंट तयार करा, नंबर जोडा, सिम्युलेट करा, पुनरावलोकन करा — मार्गदर्शित
  विझार्डद्वारे नेतो. येथे सुरू करा:
  [डॅशबोर्ड क्विकस्टार्ट](/mr/quickstart-dashboard).
</Note>

तुमच्या टर्मिनलवरून, "AI सह फोनला उत्तर देणे" ही मानक प्रक्रिया.
तुम्ही:

1. prompt आणि आवाजासह एजंट तयार कराल.
2. फोन नंबर प्रोव्हिजन करा (किंवा तुमचा नंबर आणा) आणि एजंटला त्याचा
   इनबाउंड हँडलर म्हणून नियुक्त करा.
3. नंबरवर कॉल करा. कॉल लॉग, ट्रान्स्क्रिप्ट आणि रेकॉर्डिंग पहा.

एकूण API कॉल: चार. एकूण वेळ: पाच मिनिटांपेक्षा कमी.

## 1. एजंट तयार करा

एजंटमध्ये कॉल हाताळण्यासाठीचा prompt, आवाज आणि उत्पादन स्तर एकत्रित असतो.
प्रत्येक कॉन्फिगरेशन फील्डसाठी [एजंट्स](/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 मध्ये लागेल.

<Tip>
  सर्वात कमी खर्चात साध्या प्रश्नोत्तरांसाठी `spark` निवडा; वेग
  सर्वाधिक महत्त्वाचा असल्यास `bolt` निवडा. तुमच्या prompt ला अधिक सखोल विचाराची
  आवश्यकता असल्यास आणि मॉडेल विचार करत असताना अर्ध्या सेकंदाचा फिलर चालत असल्यास
  `storm-base-with-ack` वर अपग्रेड करा. पहा
  [उत्पादन स्तर](/api-reference/agents#product-tiers-at-a-glance).
</Tip>

## 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)
पोल करा.

<Note>
  ThunderPhone नंबर केवळ इनबाउंडसाठी आहेत. आउटबाउंड कॉलसाठी,
  [VoIP द्वारे तुमचे स्वतःचे नंबर आणा](/mr/guides/bring-your-own-numbers).
</Note>

## 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`
सेट करू शकता, त्यामुळे नंबर आउटबाउंड कॉलसाठीही तयार होईल.

## 4. कॉल घ्या

तुमच्या फोनवरून नंबर डायल करा. एजंट कॉल उचलतो, तुमच्या prompt नुसार स्वतःची
ओळख करून देतो आणि संभाषण सुरू होते.

कॉल सुरू असताना, तो
[`GET /v1/calls`](/api-reference/calls#list-calls) मध्ये
`status="in_progress"` सह दिसतो. कॉल संपल्यावर, रेकॉर्ड `end_reason`,
`duration_seconds`, `billable_minutes` आणि (नंतर)
रेकॉर्डिंग URL व AI श्रेणीसह अपडेट होते.

## 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` वेबहुक](/mr/webhooks/events)
साठी सदस्यता घेतली असल्यास, तुम्हाला तुमच्या सर्व्हरवर POST म्हणून तोच डेटा मिळेल — पहा
[call.complete](/mr/webhooks/call-complete).

---

## पुढील पायऱ्या

<CardGroup cols={2}>
  <Card title="कॉलनुसार डायनॅमिक कॉन्फिगरेशन" icon="bolt" href="/mr/guides/dynamic-call-config">
    फोन नंबर किंवा webhook मधील कस्टम लॉजिकनुसार प्रत्येक कॉलरसाठी वेगळा एजंट निवडा.
  </Card>
  <Card title="टूल इंटिग्रेशन्स जोडा" icon="screwdriver-wrench" href="/mr/guides/build-tool-integration">
    संभाषणादरम्यान एजंटला तुमच्या API कॉल करू द्या.
  </Card>
  <Card title="कॉल ट्रान्सफर करा" icon="phone-arrow-right" href="/mr/guides/call-transfers">
    कॉलर्सना थेट रूट करा किंवा त्यांना जोडण्यापूर्वी गंतव्याची पडताळणी करा.
  </Card>
  <Card title="call.complete webhooks प्राप्त करा" icon="bolt" href="/mr/webhooks/call-complete">
    प्रत्येक पूर्ण झालेला कॉल तुमच्या CRM / अॅनालिटिक्स पाइपलाइनमध्ये स्ट्रीम करा.
  </Card>
  <Card title="AI ग्रेडिंग आणि समस्या अहवाल" icon="chart-line" href="/api-reference/calls#ai-call-grading">
    प्रत्येक कॉलला आपोआप स्कोअर द्या आणि चिन्हांकित कॉल्स पुनरावलोकनासाठी रूट करा.
  </Card>
</CardGroup>