দ্রুত শুরু (API)
এই গাইডটি আপনাকে চারটি REST কলের মাধ্যমে আপনার AI এজেন্ট দিয়ে প্রথম ফোন কলের উত্তর দেওয়ার পদ্ধতি দেখায়।
ধাপ 1: একটি API কী নিন
- লগ ইন করুন
app.thunderphone.com খুলুন।
- কীসমূহে যান
ড্যাশবোর্ডে সংস্থা → কীসমূহ-এ যান।
- একটি কী তৈরি করুন
কী তৈরি করুন-এ ক্লিক করুন, এটির একটি নাম দিন এবং
sk_live_...মানটি কপি করুন। মূল কীটি শুধু একবারই দেখানো হয় — এটি অবিলম্বে আপনার সিক্রেট ম্যানেজারে সংরক্ষণ করুন।
এই গাইডজুড়ে, sk_live_YOUR_API_KEY-এর জায়গায় আপনি যে মানটি
এইমাত্র কপি করেছেন তা দিন। কীটি স্বয়ংক্রিয়ভাবে আপনার সংস্থাকে শনাক্ত করে, তাই
URL-এ আপনাকে কখনোই একটি org id দিতে হবে না।
ধাপ 2: একটি এজেন্ট তৈরি করুন
একটি এজেন্ট নির্ধারণ করে AI কীভাবে কথোপকথন পরিচালনা করবে — 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": "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"
}'
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"])
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);
ধাপ 3: একটি ফোন নম্বর প্রভিশন করুন
এই কলটি একটি নম্বরের জন্য ThunderPhone-এর ডেমো পুলে অনুরোধ পাঠায় এবং আপনার নতুন এজেন্টকে ইনবাউন্ড হ্যান্ডলার হিসেবে নির্ধারণ করে। (কোনো VoIP প্রোভাইডার থেকে নিজের নম্বর আনতে চাইলে, পরিবর্তে VoIP সংযোগ দেখুন।)
# 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}'
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"])
আপনার নতুন নম্বরটি status="provisioning" অবস্থায় শুরু হয় এবং কয়েক সেকেন্ডের
মধ্যে active-এ রূপান্তরিত হয়; আপনি ব্রাউজার বন্ধ করার আগেই নম্বরটি কল
নেওয়ার জন্য প্রস্তুত হয়ে যায়।
ধাপ 4 (ঐচ্ছিক): একটি webhook সেট আপ করুন
রিয়েল-টাইম ইভেন্টের জন্য (ডাইনামিক কল রাউটিং, কল-পরবর্তী প্রক্রিয়াকরণ) একটি webhook এন্ডপয়েন্ট যোগ করুন। শুধু আপনার প্রয়োজনীয় ইভেন্টগুলোতেই সাবস্ক্রাইব করুন।
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-এর সারসংক্ষেপ)।
ধাপ 5: আপনার এজেন্ট পরীক্ষা করুন
আপনি যে নম্বরটি প্রভিশন করেছেন তাতে কল করুন। এজেন্ট কল ধরে, নিজের পরিচয় দেয় এবং আপনার prompt অনুসরণ করে।
কল শেষ হওয়ার পরে সেটি পরিদর্শন করুন:
curl https://api.thunderphone.com/v1/calls \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"
ট্রান্সক্রিপ্ট এবং রেকর্ডিং URL আনতে একটি নির্দিষ্ট কলের বিস্তারিত দেখুন:
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"