---
title: "ਤੁਰੰਤ ਸ਼ੁਰੂਆਤ (API)"
description: "AI ਏਜੰਟ ਨਾਲ ਆਪਣੀ ਪਹਿਲੀ ਫ਼ੋਨ ਕਾਲ ਦਾ ਜਵਾਬ ਦਿਓ: API ਕੁੰਜੀ ਪ੍ਰਾਪਤ ਕਰੋ, ਏਜੰਟ ਬਣਾਓ, ਫ਼ੋਨ ਨੰਬਰ ਪ੍ਰੋਵਿਜ਼ਨ ਕਰੋ ਅਤੇ ਲਾਈਵ ਟੈਸਟ ਕਾਲ ਕਰੋ — ਸਭ ਕੁਝ REST API ਰਾਹੀਂ।"
---

ਇਹ ਗਾਈਡ ਤੁਹਾਨੂੰ ਉਹਨਾਂ ਚਾਰ REST ਕਾਲਾਂ ਰਾਹੀਂ ਲੰਘਾਉਂਦੀ ਹੈ ਜਿਨ੍ਹਾਂ ਨਾਲ ਤੁਸੀਂ AI ਏਜੰਟ ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਆਪਣੀ ਪਹਿਲੀ ਫ਼ੋਨ ਕਾਲ ਦਾ ਜਵਾਬ ਦੇ ਸਕਦੇ ਹੋ।

<Info>
  ਤੁਹਾਨੂੰ ਇੱਕ [ThunderPhone ਖਾਤੇ](https://app.thunderphone.com) ਦੀ ਲੋੜ ਹੋਵੇਗੀ।
  ਸਾਈਨ ਅੱਪ ਮੁਫ਼ਤ ਹੈ ਅਤੇ ਇੱਕ ਮਿੰਟ ਤੋਂ ਘੱਟ ਸਮਾਂ ਲੈਂਦਾ ਹੈ। ਕੀ ਤੁਸੀਂ curl ਕਰਨ ਦੀ ਬਜਾਏ ਕਲਿੱਕ ਕਰਨਾ ਪਸੰਦ ਕਰਦੇ ਹੋ?
  [ਡੈਸ਼ਬੋਰਡ ਕੁਇੱਕਸਟਾਰਟ](/pa/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 ਕੁੰਜੀ ਬਣਾਓ](/pa/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`
ਹੈਡਰ ਦੀ ਪੁਸ਼ਟੀ ਕਰਨ ਲਈ ਉਸ ਸੀਕ੍ਰੇਟ ਦੀ ਵਰਤੋਂ ਕਰੋ ([ਵੈੱਬਹੁੱਕ ਸੰਖੇਪ ਜਾਣਕਾਰੀ](/pa/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="/pa/tools/overview">
    ਗੱਲਬਾਤ ਦੌਰਾਨ ਆਪਣੇ ਏਜੰਟ ਨੂੰ ਤੁਹਾਡੇ API ਕਾਲ ਕਰਨ ਦਿਓ।
  </Card>
  <Card title="ਆਉਟਬਾਊਂਡ ਕਾਲਾਂ ਕਰੋ" icon="arrow-up-right" href="/api-reference/outbound-calls">
    ਆਪਣੇ ਕੋਡ ਤੋਂ ਕਾਲਾਂ ਟ੍ਰਿਗਰ ਕਰੋ।
  </Card>
  <Card title="ਵੈੱਬਹੁੱਕ ਸੰਭਾਲੋ" icon="bolt" href="/pa/webhooks/overview">
    ਰੀਅਲ ਟਾਈਮ ਵਿੱਚ ਕਾਲ ਇਵੈਂਟਾਂ ਦਾ ਜਵਾਬ ਦਿਓ।
  </Card>
  <Card title="ਪੂਰਾ API ਹਵਾਲਾ" icon="book" href="/api-reference/introduction">
    ਹਰੇਕ ਪਬਲਿਕ ਐਂਡਪੁਆਇੰਟ ਦਾ ਦਸਤਾਵੇਜ਼ੀਕਰਨ ਕੀਤਾ ਗਿਆ ਹੈ।
  </Card>
</CardGroup>