ان باؤنڈ کالز سنبھالیں (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۔

اگلے اقدامات