ان باؤنڈ کالز ہینڈل کریں (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 کے پول سے 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 شامل ہوتا ہے۔ ThunderPhone نمبر 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۔

اگلے مراحل#