Open in
فوری آغاز (API)
AI ایجنٹ کے ذریعے اپنی پہلی فون کال کا جواب دیں: API کلید حاصل کریں، ایک ایجنٹ بنائیں، فون نمبر فراہم کریں، اور لائیو ٹیسٹ کال کریں — یہ سب REST API کے ذریعے۔
یہ رہنما آپ کو ان چار REST کالز کے ذریعے لے جاتا ہے جو ایک AI ایجنٹ کے ساتھ آپ کی پہلی فون کال کا جواب دینے کے لیے درکار ہیں۔
مرحلہ 1: API کلید حاصل کریں
- لاگ ان کریں
app.thunderphone.com کھولیں۔
- کلیدوں پر جائیں
ڈیش بورڈ میں تنظیم → کلیدیں پر جائیں۔
- کلید بنائیں
کلید بنائیں پر کلک کریں، اسے نام دیں، اور
sk_live_...ویلیو کاپی کریں۔ خام کلید صرف ایک بار دکھائی جاتی ہے — اسے فوراً اپنے سیکرٹ مینیجر میں محفوظ کریں۔
اس رہنما میں، sk_live_YOUR_API_KEY کو اس ویلیو سے تبدیل کریں جو آپ نے
ابھی کاپی کی ہے۔ کلید خودکار طور پر آپ کی تنظیم کی شناخت کرتی ہے، اس لیے
آپ کو کبھی بھی URLs میں تنظیم کی 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 (اختیاری): ویب ہک سیٹ اپ کریں
حقیقی وقت کے ایونٹس کے لیے (متحرک کال روٹنگ، کال کے بعد کی پراسیسنگ) ایک ویب ہک اینڈ پوائنٹ شامل کریں۔ صرف ان ایونٹس کو سبسکرائب کریں جن کی آپ کو ضرورت ہو۔
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
ہیڈر کی تصدیق کے لیے اس سیکرٹ کو استعمال کریں (دیکھیں
ویب ہکس کا جائزہ)۔
مرحلہ 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"