---
title: "দ্রুত শুরু (API)"
description: "একটি AI এজেন্ট দিয়ে আপনার প্রথম ফোন কলের উত্তর দিন: একটি API কী নিন, একটি এজেন্ট তৈরি করুন, একটি ফোন নম্বর প্রভিশন করুন এবং একটি লাইভ টেস্ট কল করুন — সবকিছু REST API-এর মাধ্যমে।"
---

এই গাইডটি আপনাকে AI এজেন্টের মাধ্যমে আপনার প্রথম ফোন কলের উত্তর দিতে যে চারটি REST কল লাগে, সেগুলো দেখাবে।

<Info>
  আপনার একটি [ThunderPhone অ্যাকাউন্ট](https://app.thunderphone.com) লাগবে।
  সাইন আপ বিনামূল্যে এবং এক মিনিটেরও কম সময় লাগে। curl কমান্ডের বদলে ক্লিক করতে চান?
  কোনো কোড না লিখেই একই প্রথম কলে পৌঁছাতে [ড্যাশবোর্ড কুইকস্টার্ট](/bn/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 কী তৈরি করুন](/bn/guides/api-keys) এই
  প্রক্রিয়াটি ধাপে ধাপে বিস্তারিতভাবে দেখায়, এবং অ্যাপের মধ্যে থাকা copilot
  আপনার জন্য প্রতিটি নিয়ন্ত্রণ সরাসরি হাইলাইট করতে পারে।
</Tip>

এই গাইডজুড়ে, `sk_live_YOUR_API_KEY`-এর বদলে আপনি এইমাত্র কপি করা মানটি ব্যবহার করুন।
কীটি স্বয়ংক্রিয়ভাবে আপনার সংস্থাকে শনাক্ত করে, তাই URL-এ কখনও org 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` গতির জন্য, এবং
  জটিল prompt-এ বুদ্ধিমত্তার জন্য `storm-base` / `storm-extra`। সম্পূর্ণ
  তুলনার জন্য [এজেন্টসমূহ](/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 (ঐচ্ছিক): একটি webhook সেট আপ করুন

রিয়েল-টাইম ইভেন্টের জন্য (ডায়নামিক কল রাউটিং, কল-পরবর্তী প্রক্রিয়াকরণ)
একটি webhook এন্ডপয়েন্ট যোগ করুন। শুধু আপনার প্রয়োজনীয় ইভেন্টগুলোতেই সাবস্ক্রাইব করুন।

```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`
হেডার যাচাই করতে সেই সিক্রেট ব্যবহার করুন ([Webhooks ওভারভিউ](/bn/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="/bn/tools/overview">
    কথোপকথনের সময় আপনার এজেন্টকে আপনার API কল করতে দিন।
  </Card>
  <Card title="আউটবাউন্ড কল করুন" icon="arrow-up-right" href="/api-reference/outbound-calls">
    আপনার নিজস্ব কোড থেকে কল ট্রিগার করুন।
  </Card>
  <Card title="webhook পরিচালনা করুন" icon="bolt" href="/bn/webhooks/overview">
    রিয়েল-টাইমে কল ইভেন্টে প্রতিক্রিয়া জানান।
  </Card>
  <Card title="সম্পূর্ণ API রেফারেন্স" icon="book" href="/api-reference/introduction">
    প্রতিটি পাবলিক এন্ডপয়েন্টের ডকুমেন্টেশন।
  </Card>
</CardGroup>