आउटबाउंड कॉल करा (API)

आउटबाउंड कॉलिंगद्वारे तुम्ही ThunderPhone ला गंतव्य क्रमांक आणि एजंट कॉन्फिगरेशन देऊ शकता आणि AI तुमच्या वतीने कॉल करू शकते. सामान्य वापराच्या बाबी:

• अपॉइंटमेंट पुष्टीकरणे
• सर्वेक्षणासाठी परतीचे कॉल
• मिस्ड कॉलनंतरचे "दुसऱ्या प्रयत्नाचे" फॉलो-अप
• डिस्पॅच-शैलीतील सूचना

पूर्वअटी

1. VoIP नंबर जोडा

   आउटबाउंड कॉलिंगसाठी तुम्ही from_number चा मालक असणे आवश्यक आहे, जो VoIP कनेक्शन द्वारे जोडलेला असतो. डेमो क्रमांक केवळ इनबाउंडसाठी असतात. पहा तुमचे स्वतःचे क्रमांक जोडा.

2. एजंट तयार करा

   आउटबाउंडसाठीचा prompt सहसा एजंटने स्वतःची आणि त्याच्या उद्देशाची ओळख करून देण्यापासून सुरू होतो — "नमस्कार, उद्या दुपारी 3 वाजताच्या तुमच्या अपॉइंटमेंटची पुष्टी करण्यासाठी Acme कडून कॉल करत आहे…" 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 webhook च्या प्रतिसाद स्कीमाशी जुळते:

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 webhook चे सदस्यत्व घ्या — कॉल संपल्याचे जाणून घेण्याचा हा सर्वात जलद मार्ग आहे. तुम्ही इनबाउंड webhook स्वीकारू शकत नसल्यास, दर काही सेकंदांनी 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 मिनिटे) आहे.

पुढील पायऱ्या