---
title: "ইনবাউন্ড কল পরিচালনা করুন (API)"
description: "শুরু থেকে শেষ পর্যন্ত: একটি এজেন্ট কনফিগার করুন, সেটিকে একটি ফোন নম্বরে বরাদ্দ করুন, একটি কল গ্রহণ করুন এবং ট্রান্সক্রিপ্ট পরিদর্শন করুন।"
---

<Note>
  হাতে করে আপনার প্রথম এজেন্ট তৈরি করছেন? ড্যাশবোর্ড একটি
  নির্দেশিত উইজার্ডের মাধ্যমে এই একই প্রবাহটি দেখায় — এজেন্ট তৈরি করুন, নম্বর যোগ করুন, সিমুলেট করুন, পর্যালোচনা করুন।
  শুরু করুন
  [ড্যাশবোর্ড কুইকস্টার্ট](/bn/quickstart-dashboard) থেকে।
</Note>

আপনার টার্মিনাল থেকে AI দিয়ে ফোন রিসিভ করার আদর্শ প্রবাহ।
আপনি করবেন:

1. একটি prompt ও ভয়েসসহ এজেন্ট তৈরি করুন।
2. একটি ফোন নম্বর প্রভিশন করুন (অথবা নিজের নম্বর আনুন) এবং এজেন্টকে তার
   ইনবাউন্ড হ্যান্ডলার হিসেবে অ্যাসাইন করুন।
3. নম্বরটিতে কল করুন। কল লগ, ট্রান্সক্রিপ্ট এবং রেকর্ডিং পর্যবেক্ষণ করুন।

মোট API কল: চারটি। মোট সময়: পাঁচ মিনিটের কম।

## 1. একটি এজেন্ট তৈরি করুন

একটি এজেন্ট prompt, ভয়েস এবং পণ্যের স্তরকে একত্র করে, যা কলটি পরিচালনা করবে।
প্রতিটি কনফিগারেশন ফিল্ডের জন্য [Agents](/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-এর মাধ্যমে আপনার নিজের নম্বর আনুন](/bn/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` webhook](/bn/webhooks/events)-এ সাবস্ক্রাইব করে থাকেন,
তাহলে আপনার সার্ভারে POST হিসেবে একই ডেটা পাবেন — দেখুন
[call.complete](/bn/webhooks/call-complete)।

---

## পরবর্তী ধাপ

<CardGroup cols={2}>
  <Card title="ডায়নামিক প্রতি-কল কনফিগারেশন" icon="bolt" href="/bn/guides/dynamic-call-config">
    ফোন নম্বর বা webhook-এর কাস্টম লজিকের ভিত্তিতে প্রতিটি কলারের জন্য ভিন্ন এজেন্ট বেছে নিন।
  </Card>
  <Card title="টুল ইন্টিগ্রেশন যোগ করুন" icon="screwdriver-wrench" href="/bn/guides/build-tool-integration">
    কথোপকথনের মাঝখানে এজেন্টকে আপনার API কল করতে দিন।
  </Card>
  <Card title="কল ট্রান্সফার করুন" icon="phone-arrow-right" href="/bn/guides/call-transfers">
    কলারদের সরাসরি রাউট করুন অথবা সংযোগ দেওয়ার আগে গন্তব্য যাচাই করুন।
  </Card>
  <Card title="call.complete webhook গ্রহণ করুন" icon="bolt" href="/bn/webhooks/call-complete">
    প্রতিটি সম্পন্ন কল আপনার CRM / অ্যানালিটিক্স পাইপলাইনে স্ট্রিম করুন।
  </Card>
  <Card title="AI গ্রেডিং এবং সমস্যা প্রতিবেদন" icon="chart-line" href="/api-reference/calls#ai-call-grading">
    প্রতিটি কল স্বয়ংক্রিয়ভাবে স্কোর করুন এবং চিহ্নিত কলগুলো পর্যালোচনার জন্য রাউট করুন।
  </Card>
</CardGroup>