---
title: "فوری آغاز (API)"
description: "AI ایجنٹ کے ذریعے اپنی پہلی فون کال کا جواب دیں: API کلید حاصل کریں، ایک ایجنٹ بنائیں، فون نمبر فراہم کریں، اور لائیو ٹیسٹ کال کریں — یہ سب REST API کے ذریعے۔"
---

یہ رہنما آپ کو ان چار REST کالز کے ذریعے لے جاتا ہے جو ایک AI ایجنٹ کے ساتھ آپ کی پہلی فون کال کا جواب دینے کے لیے درکار ہیں۔

<Info>
  آپ کو ایک [ThunderPhone اکاؤنٹ](https://app.thunderphone.com) درکار ہوگا۔
  سائن اپ مفت ہے اور ایک منٹ سے کم وقت لیتا ہے۔ کیا آپ curl چلانے کے بجائے کلک کرنا پسند کرتے ہیں؟
  [ڈیش بورڈ کوئیک اسٹارٹ](/ur/quickstart-dashboard) بغیر کوئی کوڈ لکھے
  اسی پہلی کال تک پہنچاتا ہے۔
</Info>

## مرحلہ 1: API کلید حاصل کریں

<Steps>
  <Step title="لاگ ان کریں">
    [app.thunderphone.com](https://app.thunderphone.com) کھولیں۔
  </Step>
  <Step title="کلیدوں پر جائیں">
    ڈیش بورڈ میں **تنظیم → کلیدیں** پر جائیں۔
  </Step>
  <Step title="کلید بنائیں">
    **کلید بنائیں** پر کلک کریں، اسے نام دیں، اور
    `sk_live_...` ویلیو کاپی کریں۔ خام کلید **صرف ایک بار** دکھائی جاتی ہے — اسے فوراً
    اپنے سیکرٹ مینیجر میں محفوظ کریں۔
  </Step>
</Steps>

<Tip>
  رُک گئے ہیں؟ [سرور API کلید بنائیں](/ur/guides/api-keys) اس
  عمل کی مرحلہ وار تفصیل بتاتا ہے، اور اِن ایپ کوپائلٹ
  ہر کنٹرول کو براہِ راست آپ کے لیے نمایاں کر سکتا ہے۔
</Tip>

اس رہنما میں، `sk_live_YOUR_API_KEY` کو اس ویلیو سے تبدیل کریں جو آپ نے
ابھی کاپی کی ہے۔ کلید خودکار طور پر آپ کی تنظیم کی شناخت کرتی ہے، اس لیے
آپ کو کبھی بھی URLs میں تنظیم کی id شامل کرنے کی ضرورت نہیں ہوتی۔

## مرحلہ 2: ایک ایجنٹ بنائیں

ایک ایجنٹ طے کرتا ہے کہ AI گفتگوؤں کو کیسے سنبھالتا ہے — prompt، آواز،
پروڈکٹ ٹئیر، ٹولز، اور ویجیٹ کی اہلیت۔

<CodeGroup>
```bash cURL
curl -X POST https://api.thunderphone.com/v1/agents \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name":   "Customer Support",
    "prompt": "You are a friendly support agent for Acme Corp. Help with orders, returns, and product info. Be concise and helpful.",
    "voice":  "john",
    "product": "spark"
  }'
```

```python Python
import os, requests

agent = requests.post(
    "https://api.thunderphone.com/v1/agents",
    headers={"Authorization": f"Bearer {os.environ['THUNDERPHONE_API_KEY']}"},
    json={
        "name":   "Customer Support",
        "prompt": "You are a friendly support agent for Acme Corp. Help with orders, returns, and product info. Be concise and helpful.",
        "voice":  "john",
        "product": "spark",
    },
).json()
print("Agent id:", agent["id"])
```

```javascript Node.js
const agent = await fetch("https://api.thunderphone.com/v1/agents", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.THUNDERPHONE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    name:    "Customer Support",
    prompt:  "You are a friendly support agent for Acme Corp. Help with orders, returns, and product info. Be concise and helpful.",
    voice:   "john",
    product: "spark",
  }),
}).then((r) => r.json());
console.log("Agent id:", agent.id);
```
</CodeGroup>

<Tip>
  پروڈکٹ ٹئیرز: `spark` لاگت کے لیے بہتر بنایا گیا ہے، `bolt` رفتار کے لیے، اور
  `storm-base` / `storm-extra` پیچیدہ prompts میں ذہانت کے لیے۔ مکمل
  موازنے کے لیے [ایجنٹس](/api-reference/agents#product-tiers-at-a-glance) دیکھیں۔
</Tip>

## مرحلہ 3: فون نمبر فراہم کریں

یہ کال ThunderPhone سے ایک نمبر مانگتی ہے اور آپ کے نئے
ایجنٹ کو ان باؤنڈ ہینڈلر کے طور پر مقرر کرتی ہے۔ (VoIP
فراہم کنندہ سے اپنا نمبر لانے کے لیے، اس کے بجائے [VoIP کنکشنز](/api-reference/voip-connections)
دیکھیں۔)

<CodeGroup>
```bash cURL
# First provision
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"}'

# Then assign the agent you created in Step 2
curl -X PATCH https://api.thunderphone.com/v1/phone-numbers/<id-from-previous> \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"inbound_agent_id": 12}'
```

```python Python
number = requests.post(
    "https://api.thunderphone.com/v1/phone-numbers",
    headers={"Authorization": f"Bearer {os.environ['THUNDERPHONE_API_KEY']}"},
    json={"area_code": "415"},
).json()
requests.patch(
    f"https://api.thunderphone.com/v1/phone-numbers/{number['id']}",
    headers={"Authorization": f"Bearer {os.environ['THUNDERPHONE_API_KEY']}"},
    json={"inbound_agent_id": agent["id"]},
)
print("Your ThunderPhone number:", number["number"])
```
</CodeGroup>

آپ کا نیا نمبر `status="provisioning"` سے شروع ہوتا ہے اور چند سیکنڈز میں
`active` ہو جاتا ہے؛ جب تک آپ اپنا براؤزر بند کریں گے، نمبر
کالز وصول کرنے کے لیے تیار ہو چکا ہوگا۔

## مرحلہ 4 (اختیاری): ویب ہک سیٹ اپ کریں

حقیقی وقت کے ایونٹس کے لیے (متحرک کال روٹنگ، کال کے بعد کی پراسیسنگ)
ایک ویب ہک اینڈ پوائنٹ شامل کریں۔ صرف ان ایونٹس کو سبسکرائب کریں جن کی آپ کو ضرورت ہو۔

```bash
curl -X POST https://api.thunderphone.com/v1/developer/webhook-endpoints \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "label":  "Prod webhook",
    "url":    "https://your-server.com/thunderphone-webhook",
    "events": ["telephony.incoming", "telephony.complete"]
  }'
```

جواب میں ایک بار استعمال ہونے والا `secret` شامل ہوتا ہے — اسے اپنے سیکرٹ
منیجر میں کاپی کریں۔ آنے والی درخواستوں میں `X-ThunderPhone-Signature`
ہیڈر کی تصدیق کے لیے اس سیکرٹ کو استعمال کریں (دیکھیں
[ویب ہکس کا جائزہ](/ur/webhooks/overview))۔

## مرحلہ 5: اپنے ایجنٹ کی جانچ کریں

اس نمبر پر کال کریں جو آپ نے ابھی فراہم کیا ہے۔ ایجنٹ کال اٹھاتا ہے، اپنا
تعارف دیتا ہے، اور آپ کے prompt کی پیروی کرتا ہے۔

کال ختم ہونے کے بعد اس کا جائزہ لیں:

```bash
curl https://api.thunderphone.com/v1/calls \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

ٹرانسکرپٹ اور ریکارڈنگ URL حاصل کرنے کے لیے کسی مخصوص کال کی تفصیلات دیکھیں:

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

---

## اگلے مراحل

<CardGroup cols={2}>
  <Card title="فنکشن ٹولز شامل کریں" icon="screwdriver-wrench" href="/ur/tools/overview">
    اپنے ایجنٹ کو گفتگو کے دوران آپ کے APIs کال کرنے دیں۔
  </Card>
  <Card title="آؤٹ باؤنڈ کالز کریں" icon="arrow-up-right" href="/api-reference/outbound-calls">
    اپنے کوڈ سے کالز ٹرگر کریں۔
  </Card>
  <Card title="ویب ہکس ہینڈل کریں" icon="bolt" href="/ur/webhooks/overview">
    حقیقی وقت میں کال ایونٹس پر ردعمل دیں۔
  </Card>
  <Card title="مکمل API حوالہ" icon="book" href="/api-reference/introduction">
    ہر عوامی اینڈ پوائنٹ، دستاویزی شکل میں۔
  </Card>
</CardGroup>