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

तुमच्या स्वतःच्या कोडमधून AI-चालित आउटबाउंड कॉल ट्रिगर करा — सर्वेक्षण, फॉलो-अप किंवा पुष्टीकरण प्रवाहांसाठी.

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

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

पूर्वअटी#

1. आउटबाउंड सक्षम क्रमांक निवडा

   तुमच्या मालकीचा क्रमांक VoIP कनेक्शनद्वारे वापरा किंवा Phone Numbers पेजवरून तुमचे ThunderPhone क्रमांक आउटबाउंड कॉलसाठी वापरण्याची परवानगी मागा. ThunderPhone क्रमांक सुरुवातीला फक्त इनबाउंड असतात. ThunderPhone प्रत्येक विनंतीचे हाताने पुनरावलोकन करते; मंजुरीनंतर, ते क्रमांक मंजूर दैनंदिन मर्यादेपर्यंत (00:00 UTC ला रीसेट होणारी) कॉल करू शकतात आणि मोहिमा चालवू शकतात, तसेच तुम्ही अधिक मर्यादेची विनंती करू शकता. ग्राहकांच्या VoIP क्रमांकांना दैनंदिन मर्यादा नसते, त्यामुळे आउटबाउंड कॉलिंगसाठी आम्ही त्यांची शिफारस करतो. पहा तुमचे स्वतःचे क्रमांक आणा.

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

   आउटबाउंडसाठी तयार केलेला prompt सहसा एजंटने स्वतःची आणि उद्देशाची ओळख करून देण्याने सुरू होतो — "नमस्कार, तुमची उद्या दुपारी 3 वाजताची अपॉइंटमेंट निश्चित करण्यासाठी Acme कडून कॉल करत आहे…" outbound_speak_order ला agent_first (डीफॉल्ट) वर सेट करा.

3. शिल्लक सकारात्मक ठेवा

   शिल्लक ≤ $0.00 असल्यास आउटबाउंड कॉल 402 Payment Required परत करतात. डॅशबोर्डमध्ये Organization → Billing Settings अंतर्गत रक्कम भरा किंवा ऑटो-रीलोड सक्षम करा. तुमची sk_live_ की GET /v1/billing वापरून शिल्लक तपासू शकते, पण रक्कम भरू किंवा ऑटो-रीलोड बदलू शकत नाही.

जतन केलेल्या एजंटसह कॉल करा#

सर्वात सोपा मार्ग — 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":   "+14155552671",
    "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":   "+14155552671",
    "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 समाविष्ट असते.

तुमचा एजंट कॉलनंतर संरचित डेटा काढण्यासाठी सेट केलेला असल्यास, अंतिमीकरण पूर्ण झाल्यानंतर तो डेटा स्वतंत्रपणे वितरित केला जातो.

सेव्ह केलेल्या एजंटला प्रति-कॉल व्हेरिएबल्स द्या#

सेव्ह केलेले एजंट prompt मजकुरात {{name}} किंवा {{name|there}} यांसारखे प्लेसहोल्डर वापरू शकतात. तुम्ही agent_id सह आउटबाउंड कॉल करता तेव्हा, त्या कॉलच्या मूल्यांसह variables पाठवा:

{
  "from_number": "+[REDACTED_PHONE]",
  "to_number": "+[REDACTED_PHONE]",
  "agent_id": 12,
  "variables": {
    "name": "Jordan"
  }
}

प्लेसहोल्डरच्या नावानुसार की असलेली स्ट्रिंग मूल्ये वापरा. हे व्हेरिएबल्स सेव्ह केलेल्या एजंटसाठी लागू होतात; या मार्गदर्शिकेतील इनलाइन config उदाहरण त्यांचा वापर करत नाही.

हाताळण्यासारख्या अयशस्वी अवस्था#

स्थिर पात्रता-कोडची संपूर्ण यादी आणि 409 प्रतिसादाचे दोन्ही स्वरूप यांसाठी आउटबाउंड कॉल्स संदर्भ पहा. विनंती स्वीकारल्यानंतर पण कॉल लावण्यापूर्वी सक्रिय नंबर अपात्र झाल्यास, अंतिम तपासणी पुन्हा प्रयत्न न करता येणारा 409 पेलोड परत करते.

होल्ड वेळ नियंत्रित करणे#

कॉल प्राप्त करणारी व्यक्ती प्रतिसाद देण्यात धीमी असल्यामुळे दीर्घकाळ चालणारे आउटबाउंड कॉल (IVR ट्री, क्यू) max_hold_seconds वापरून मर्यादित करता येतात:

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

मागील N सेकंदांत मानवी आवाज प्राप्त झाला नसेल, तर एजंट कॉल बंद करतो. डीफॉल्ट 900 सेकंद (15 मिनिटे) आहे.

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