ইনবাউন্ড কল পরিচালনা করুন (API)

শুরু থেকে শেষ পর্যন্ত: একটি এজেন্ট কনফিগার করুন, সেটিকে একটি ফোন নম্বরে বরাদ্দ করুন, একটি কল গ্রহণ করুন এবং ট্রান্সক্রিপ্ট পরিদর্শন করুন।

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

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

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

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

একটি এজেন্ট prompt, ভয়েস এবং পণ্যের স্তরকে একত্র করে, যা কলটি পরিচালনা করবে। প্রতিটি কনফিগারেশন ফিল্ডের জন্য Agents দেখুন; ন্যূনতম প্রয়োজনীয়তা হলো:

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-এ এটি লাগবে।

2. একটি ফোন নম্বর নিন#

শুধু ডায়াল করার জন্য কিছু দরকার হলে, ThunderPhone-এর পুল থেকে একটি ThunderPhone নম্বর নিন:

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} পোল করুন।

3. এজেন্ট অ্যাসাইন করুন#

ধাপ 1-এর এজেন্টটিকে নম্বরের ইনবাউন্ড দিকের সঙ্গে যুক্ত করুন:

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-এ status="in_progress" সহ দেখা যাবে। কল শেষ হলে, রেকর্ডটি end_reason, duration_seconds, billable_minutes এবং (পরবর্তীতে) একটি রেকর্ডিং URL ও AI গ্রেডসহ আপডেট হবে।

5. ফলাফল পরীক্ষা করুন#

সাম্প্রতিক কলগুলোর তালিকা আনুন:

curl 'https://api.thunderphone.com/v1/calls?limit=5' \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

ট্রান্সক্রিপ্ট নিন:

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

এবং রেকর্ডিং URL নিন (স্বল্পমেয়াদি, স্বাক্ষরিত):

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

আপনি যদি telephony.complete webhook-এ সাবস্ক্রাইব করে থাকেন, তাহলে আপনার সার্ভারে POST হিসেবে একই ডেটা পাবেন — দেখুন call.complete।

পরবর্তী ধাপ#