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

আপনার টার্মিনাল থেকে "AI দিয়ে ফোনের উত্তর দেওয়া"-র আদর্শ ফ্লো। আপনি করবেন:

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

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

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

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

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-এর পুল থেকে একটি ডেমো নম্বর প্রভিশন করুন:

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 থাকে। ডেমো নম্বরগুলো 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 ওয়েবহুক-এ সাবস্ক্রাইব করে থাকেন, তাহলে আপনার সার্ভারে POST হিসেবে একই ডেটা পাবেন — দেখুন call.complete।

পরবর্তী ধাপ