فوری آغاز (API)

یہ گائیڈ آپ کو ان چار REST کالز سے گزارتی ہے جو AI ایجنٹ کے ساتھ اپنی پہلی فون کال کا جواب دینے کے لیے درکار ہیں۔

مرحلہ 1: API کلید حاصل کریں

1. لاگ ان کریں

   app.thunderphone.com کھولیں۔

2. کلیدوں پر جائیں

   ڈیش بورڈ میں تنظیم → کلیدیں پر جائیں۔

3. ایک کلید بنائیں

   کلید بنائیں پر کلک کریں، اسے ایک نام دیں، اور sk_live_... ویلیو کاپی کریں۔ اصل کلید صرف ایک بار دکھائی جاتی ہے — اسے فوراً اپنے سیکرٹ مینیجر میں محفوظ کریں۔

اس گائیڈ میں ہر جگہ sk_live_YOUR_API_KEY کو اس ویلیو سے تبدیل کریں جو آپ نے ابھی کاپی کی ہے۔ کلید خودکار طور پر آپ کی تنظیم کی شناخت کرتی ہے، اس لیے آپ کو کبھی URLs میں 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 (اختیاری): ویب ہک سیٹ اپ کریں

ریئل ٹائم ایونٹس کے لیے (متحرک کال روٹنگ، کال کے بعد کی پروسیسنگ)، ایک ویب ہک اینڈ پوائنٹ شامل کریں۔ صرف ان ایونٹس کو سبسکرائب کریں جن کی آپ کو ضرورت ہے۔

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"

اگلے مراحل