آؤٹ باؤنڈ کالز کریں (API)

ThunderPhone کو ایک منزل نمبر اور ایجنٹ کی کنفیگریشن دے کر آپ AI سے اپنی جانب سے کال کروا سکتے ہیں۔ عام استعمال کے معاملات:

• اپائنٹمنٹ کی تصدیقیں
• سروے کے لیے دوبارہ کالز
• مسڈ کال کے بعد "دوسری کوشش" کی پیروی
• ڈسپیچ طرز کی اطلاعات

پیشگی شرائط

1. VoIP نمبر فراہم کریں

   آؤٹ باؤنڈ کالنگ کے لیے ضروری ہے کہ from_number آپ کی ملکیت میں ہو، بذریعہ VoIP کنکشن۔ ڈیمو نمبرز صرف ان باؤنڈ کے لیے ہوتے ہیں۔ دیکھیں اپنے نمبرز فراہم کریں۔

2. ایک ایجنٹ بنائیں

   آؤٹ باؤنڈ طرز کا prompt عموماً ایجنٹ کے اپنے تعارف اور مقصد بیان کرنے سے شروع ہوتا ہے — "ہیلو، یہ Acme ہے، ہم کل دوپہر 3 بجے کے لیے آپ کی اپائنٹمنٹ کی تصدیق کرنے کے لیے کال کر رہے ہیں…" outbound_speak_order کو agent_first پر سیٹ کریں (یہ ڈیفالٹ ہے)۔

3. مثبت بیلنس برقرار رکھیں

   اگر بیلنس $0.00 سے کم یا برابر ہو تو آؤٹ باؤنڈ کالز 402 Payment Required لوٹاتی ہیں۔ بیلنس بڑھانے کے لیے POST /v1/billing/top-up استعمال کریں یا خودکار ری لوڈ فعال کریں۔

محفوظ شدہ ایجنٹ کے ساتھ کال کریں

سب سے آسان طریقہ — ایجنٹ کو ID کے ذریعے حوالہ دیں:

curl -X POST https://api.thunderphone.com/v1/call \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from_number": "+15551234567",
    "to_number":   "+14155550199",
    "agent_id":    12
  }'

جواب:

{ "call_id": 987654321, "status": "initiated" }

ان لائن کنفیگ کے ساتھ کال کریں

اگر آپ کو ایک مرتبہ استعمال ہونے والا ایسا prompt چاہیے جسے ایجنٹ کے طور پر محفوظ کرنا مناسب نہیں، تو اس کے بجائے config منتقل کریں۔ اس کی ساخت call.incoming ویب ہک کے جواب کے اسکیما سے مطابقت رکھتی ہے:

curl -X POST https://api.thunderphone.com/v1/call \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from_number": "+15551234567",
    "to_number":   "+14155550199",
    "config": {
      "prompt":  "You are confirming Jane Doe appointment for 3pm tomorrow…",
      "voice":   "john",
      "product": "spark"
    }
  }'

کال کی پیروی کریں

متوازی طور پر telephony.complete ویب ہک کے لیے رجسٹر کریں — کال ختم ہونے کا جاننے کا یہ تیز ترین طریقہ ہے۔ اگر آپ ان باؤنڈ ویب ہکس قبول نہیں کر سکتے تو ہر چند سیکنڈ بعد GET /v1/calls/{call_id} کو پول کریں؛ کال ختم ہونے پر ریکارڈ میں end_reason، duration_seconds، اور ریکارڈنگ URL شامل ہوتا ہے۔

قابلِ توجہ ناکامی کی صورتیں

ہولڈ وقت کو کنٹرول کرنا

جو آؤٹ باؤنڈ کالز وصول کنندہ کے جواب دینے میں سستی کی وجہ سے طویل ہو جاتی ہیں (IVR ٹریز، قطاریں)، انہیں max_hold_seconds کے ذریعے محدود کیا جا سکتا ہے:

{
  "from_number": "+15551234567",
  "to_number":   "+14155550199",
  "agent_id":    12,
  "max_hold_seconds": 120
}

اگر گزشتہ N سیکنڈز میں کوئی انسانی آڈیو موصول نہ ہوئی ہو تو ایجنٹ کال ختم کر دیتا ہے۔ ڈیفالٹ 900 (15 منٹ) ہے۔

اگلے مراحل