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

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

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

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

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

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

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

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

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.

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