येणारे कॉल हाताळा (API)

सुरुवातीपासून शेवटपर्यंत: एजंट कॉन्फिगर करा, तो फोन नंबरला नियुक्त करा, कॉल घ्या आणि ट्रान्सक्रिप्ट तपासा.

तुमच्या टर्मिनलमधून, "AI सह फोनला उत्तर द्या" हा प्रमाणित प्रवाह. तुम्ही:

1. prompt आणि व्हॉइससह एजंट तयार कराल.
2. फोन नंबर प्रोव्हिजन कराल (किंवा स्वतःचा आणाल) आणि एजंटला त्याचा इनबाउंड हँडलर म्हणून नियुक्त कराल.
3. नंबरवर कॉल कराल. कॉल लॉग, ट्रान्सक्रिप्ट आणि रेकॉर्डिंग पाहाल.

एकूण API कॉल: चार. एकूण वेळ: पाच मिनिटांपेक्षा कमी.

1. एजंट तयार करा#

एजंटमध्ये कॉल चालवणारा prompt, आवाज आणि उत्पादन स्तर एकत्रित असतो. तुम्ही एजंटवर max_call_duration_seconds आणि ring_duration_seconds यांसारख्या कॉल मर्यादाही सेट करू शकता. नवीन एजंटसाठी वेळ क्षेत्रही आवश्यक असते. प्रत्येक कॉन्फिगरेशन फील्डसाठी एजंट्स पहा; किमान आवश्यक कॉन्फिगरेशन असे आहे:

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 देखील सेट करू शकता. तोपर्यंत, API त्या नियुक्तीला 400 सह नाकारते.

तुम्ही इनबाउंड कॉल्सना निश्चित inbound_agent_id ऐवजी कॉन्फिग वेबहुकद्वारे रूट करत असल्यास, तो वेबहुक आता agent_id आणि variables सोबत प्रत्येक कॉलसाठी timezone परत करू शकतो.

4. कॉल घ्या#

तुमच्या फोनवरून नंबर डायल करा. एजंट कॉल उचलतो, तुमच्या prompt नुसार स्वतःची ओळख करून देतो आणि संभाषण सुरू होते.

कॉल सुरू असताना, तो GET /v1/calls मध्ये status="in_progress" सह दिसतो. कॉल संपल्यावर, रेकॉर्डमध्ये end_reason, duration_seconds, billable_minutes आणि (पुढे) रेकॉर्डिंग URL व AI ग्रेडसह अपडेट होते.

इनबाउंड कॉल तुमच्या संस्थेच्या एकाचवेळी कॉल मर्यादेत गणल्या जातात (डीफॉल्टनुसार प्रगतीपथावर असलेले 20 कॉल, जे आउटबाउंड, वेब आणि टेस्ट कॉलसह सामायिक असतात). मर्यादा गाठल्यानंतर आलेला कॉल एजंटने उत्तर देण्यापूर्वी नाकारला जातो आणि डिस्कनेक्ट केला जातो, त्यासाठी बिल आकारले जात नाही आणि concurrent_call_limit_reached या समाप्ती कारणासह अयशस्वी कॉल म्हणून नोंदवला जातो. तुम्हाला जास्त मर्यादा हवी असल्यास support@thunderphone.com वर ईमेल करा.

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 पहा.

तुमच्या एजंटसाठी एक्स्ट्रॅक्शन फील्ड कॉन्फिगर केले असल्यास, पूर्ण झालेल्या कॉलच्या पेलोडमध्ये संरचित एक्स्ट्रॅक्ट केलेला डेटादेखील समाविष्ट असू शकतो.

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