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

اپنے کوڈ سے AI کے ذریعے آؤٹ باؤنڈ کال شروع کریں — سروے، فالو اَپ، یا تصدیقی فلوز کے لیے۔

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

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

پیشگی شرائط#

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

   آؤٹ باؤنڈ کالنگ کے لیے ضروری ہے کہ آپ from_number کے مالک ہوں، جو ایک VoIP کنکشن کے ذریعے ہو۔ ThunderPhone نمبرز صرف اِن باؤنڈ کے لیے ہیں۔ ملاحظہ کریں اپنے نمبرز فراہم کریں۔

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

   آؤٹ باؤنڈ طرز کا prompt عموماً ایجنٹ کے اپنے تعارف اور مقصد بیان کرنے سے شروع ہوتا ہے — "Hi, this is Acme calling to confirm your appointment for tomorrow at 3pm…" 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 منٹ) ہے۔

اگلے مراحل#