---
title: "ਆਉਣ ਵਾਲੀਆਂ ਕਾਲਾਂ ਸੰਭਾਲੋ (API)"
description: "ਸ਼ੁਰੂ ਤੋਂ ਅੰਤ ਤੱਕ: ਇੱਕ ਏਜੰਟ ਕੌਂਫਿਗਰ ਕਰੋ, ਇਸਨੂੰ ਫ਼ੋਨ ਨੰਬਰ ਨਾਲ ਜੋੜੋ, ਕਾਲ ਲਵੋ ਅਤੇ ਟ੍ਰਾਂਸਕ੍ਰਿਪਟ ਦੀ ਜਾਂਚ ਕਰੋ।"
---

<Note>
  ਆਪਣਾ ਪਹਿਲਾ ਏਜੰਟ ਹੱਥੋਂ ਬਣਾ ਰਹੇ ਹੋ? ਡੈਸ਼ਬੋਰਡ ਤੁਹਾਨੂੰ ਇਹੀ
  ਫਲੋ — ਏਜੰਟ ਬਣਾਓ, ਨੰਬਰ ਸ਼ਾਮਲ ਕਰੋ, ਸਿਮੂਲੇਟ ਕਰੋ, ਸਮੀਖਿਆ ਕਰੋ — ਇੱਕ
  ਗਾਈਡ ਕੀਤੇ ਵਿਜ਼ਾਰਡ ਨਾਲ ਕਰਵਾਉਂਦਾ ਹੈ। ਇੱਥੋਂ ਸ਼ੁਰੂ ਕਰੋ:
  [ਡੈਸ਼ਬੋਰਡ ਕਵਿਕਸਟਾਰਟ](/pa/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 ਰਾਹੀਂ ਆਪਣੇ ਨੰਬਰ ਲਿਆਓ](/pa/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` ਵੈੱਬਹੁੱਕ](/pa/webhooks/events)
ਦੀ ਸਬਸਕ੍ਰਿਪਸ਼ਨ ਲਈ ਹੈ, ਤਾਂ ਤੁਹਾਨੂੰ ਇਹੀ ਡਾਟਾ ਤੁਹਾਡੇ ਸਰਵਰ ਨੂੰ POST ਦੇ ਰੂਪ
ਵਿੱਚ ਮਿਲੇਗਾ — ਵੇਖੋ
[call.complete](/pa/webhooks/call-complete)।

---

## ਅਗਲੇ ਕਦਮ

<CardGroup cols={2}>
  <Card title="ਹਰ ਕਾਲ ਲਈ ਡਾਇਨਾਮਿਕ ਕੌਂਫਿਗ" icon="bolt" href="/pa/guides/dynamic-call-config">
    ਫ਼ੋਨ ਨੰਬਰ ਜਾਂ webhook ਵਿੱਚ ਕਸਟਮ ਲੌਜਿਕ ਦੇ ਆਧਾਰ 'ਤੇ ਹਰ ਕਾਲਰ ਲਈ ਵੱਖਰਾ ਏਜੰਟ ਚੁਣੋ।
  </Card>
  <Card title="ਟੂਲ ਇੰਟੀਗ੍ਰੇਸ਼ਨ ਜੋੜੋ" icon="screwdriver-wrench" href="/pa/guides/build-tool-integration">
    ਏਜੰਟ ਨੂੰ ਗੱਲਬਾਤ ਦੌਰਾਨ ਤੁਹਾਡੀਆਂ APIs ਕਾਲ ਕਰਨ ਦਿਓ।
  </Card>
  <Card title="ਕਾਲਾਂ ਟ੍ਰਾਂਸਫ਼ਰ ਕਰੋ" icon="phone-arrow-right" href="/pa/guides/call-transfers">
    ਕਾਲਰਾਂ ਨੂੰ ਸਿੱਧਾ ਰੂਟ ਕਰੋ ਜਾਂ ਕਨੈਕਟ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ ਮੰਜ਼ਿਲ ਦੀ ਜਾਂਚ ਕਰੋ।
  </Card>
  <Card title="call.complete webhooks ਪ੍ਰਾਪਤ ਕਰੋ" icon="bolt" href="/pa/webhooks/call-complete">
    ਹਰ ਮੁਕੰਮਲ ਕਾਲ ਨੂੰ ਆਪਣੀ CRM / analytics ਪਾਈਪਲਾਈਨ ਵਿੱਚ ਸਟ੍ਰੀਮ ਕਰੋ।
  </Card>
  <Card title="AI ਗ੍ਰੇਡਿੰਗ ਅਤੇ ਸਮੱਸਿਆ ਰਿਪੋਰਟਾਂ" icon="chart-line" href="/api-reference/calls#ai-call-grading">
    ਹਰ ਕਾਲ ਨੂੰ ਆਪਣੇ ਆਪ ਸਕੋਰ ਕਰੋ ਅਤੇ ਫ਼ਲੈਗ ਕੀਤੀਆਂ ਕਾਲਾਂ ਨੂੰ ਸਮੀਖਿਆ ਲਈ ਰੂਟ ਕਰੋ।
  </Card>
</CardGroup>