---
title: "ان باؤنڈ کالز ہینڈل کریں (API)"
description: "ابتدا سے انتہا تک: ایک ایجنٹ کنفیگر کریں، اسے فون نمبر سے منسلک کریں، کال لیں، اور ٹرانسکرپٹ کا جائزہ لیں۔"
---

<Note>
  کیا آپ اپنا پہلا ایجنٹ خود بنا رہے ہیں؟ ڈیش بورڈ اسی عین
  طریقۂ کار میں آپ کی رہنمائی کرتا ہے — ایجنٹ بنائیں، نمبر شامل کریں، نقل کریں، جائزہ لیں —
  ایک رہنمائی والے وزرڈ کے ساتھ۔ یہاں سے شروع کریں:
  [ڈیش بورڈ کوئک اسٹارٹ](/ur/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 کے ذریعے اپنے نمبر لائیں](/ur/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` ویب ہک](/ur/webhooks/events)
سبسکرائب کیا ہے تو آپ کو یہی ڈیٹا اپنے سرور پر POST کے طور پر موصول ہوگا — دیکھیں:
[call.complete](/ur/webhooks/call-complete)۔

---

## اگلے مراحل

<CardGroup cols={2}>
  <Card title="ہر کال کے لیے متحرک کنفیگ" icon="bolt" href="/ur/guides/dynamic-call-config">
    فون نمبر یا webhook میں حسب ضرورت منطق کی بنیاد پر ہر کالر کے لیے مختلف ایجنٹ منتخب کریں۔
  </Card>
  <Card title="ٹول انٹیگریشنز شامل کریں" icon="screwdriver-wrench" href="/ur/guides/build-tool-integration">
    ایجنٹ کو گفتگو کے دوران آپ کی APIs کال کرنے دیں۔
  </Card>
  <Card title="کالز منتقل کریں" icon="phone-arrow-right" href="/ur/guides/call-transfers">
    کالرز کو براہِ راست روٹ کریں یا انہیں منسلک کرنے سے پہلے منزل کی جانچ کریں۔
  </Card>
  <Card title="call.complete webhooks وصول کریں" icon="bolt" href="/ur/webhooks/call-complete">
    ہر مکمل شدہ کال کو اپنی CRM / analytics پائپ لائن میں اسٹریم کریں۔
  </Card>
  <Card title="AI گریڈنگ اور مسئلے کی رپورٹس" icon="chart-line" href="/api-reference/calls#ai-call-grading">
    ہر کال کو خودکار طور پر اسکور کریں اور نشان زدہ کالز کو جائزے کے لیے روٹ کریں۔
  </Card>
</CardGroup>