Developer cookbook

इनबाउंड कॉल हैंडल करें (API)

एंड-टू-एंड: एक एजेंट कॉन्फ़िगर करें, उसे एक फोन नंबर असाइन करें, कॉल लें और ट्रांसक्रिप्ट की जांच करें।

आपके टर्मिनल से "AI से फोन का जवाब दिलाने" का मानक फ्लो। आप:

1. प्रॉम्प्ट और वॉइस के साथ एक एजेंट बनाएं।
2. फोन नंबर प्रोविज़न करें (या अपना नंबर लाएं) और एजेंट को उसका इनबाउंड हैंडलर असाइन करें।
3. नंबर पर कॉल करें। कॉल लॉग, ट्रांसक्रिप्ट और रिकॉर्डिंग देखें।

कुल API कॉल्स: चार। कुल समय: पांच मिनट से कम।

1. एजेंट बनाएं#

एक एजेंट प्रॉम्प्ट, वॉइस और प्रोडक्ट टियर को एक साथ रखता है जो कॉल को संचालित करेंगे। हर कॉन्फ़िगरेशन फ़ील्ड के लिए एजेंट्स देखें; न्यूनतम कॉन्फ़िगरेशन यह है:

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. कॉल लें#

अपने फोन से नंबर डायल करें। एजेंट कॉल उठाता है, आपके प्रॉम्प्ट के अनुसार अपना परिचय देता है और बातचीत शुरू होती है।

कॉल चल रही होने पर, वह 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 देखें।

अगले चरण#