Open in
দ্রুত শুরু (API)
একটি AI এজেন্ট দিয়ে আপনার প্রথম ফোন কলের উত্তর দিন: একটি API কী নিন, একটি এজেন্ট তৈরি করুন, একটি ফোন নম্বর প্রভিশন করুন এবং একটি লাইভ টেস্ট কল করুন — সবকিছু REST API-এর মাধ্যমে।
এই গাইডটি আপনাকে AI এজেন্টের মাধ্যমে আপনার প্রথম ফোন কলের উত্তর দিতে যে চারটি REST কল লাগে, সেগুলো দেখাবে।
ধাপ 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"