इनबाउंड कॉल हाताळा (API)

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

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

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

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

एजंट कॉल चालवणारा prompt, व्हॉइस आणि उत्पादन स्तर एकत्रित करतो. प्रत्येक कॉन्फिगरेशन फील्डसाठी Agents पहा; किमान आवश्यक हे आहे:

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 च्या पूलमधून डेमो नंबर प्रोव्हिजन करा:

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 समाविष्ट असतात. डेमो नंबर 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 देखील सेट करू शकता, त्यामुळे नंबर आउटबाउंड कॉल करण्यासाठीही तयार होईल.

4. कॉल घ्या

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

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

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.

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