ThunderPhone v3 आता लाइव्ह आहे.स्वतःच सुरू करा—2¢/मिनिटपासून.घोषणा वाचा

Developer cookbook

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

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

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

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

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

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

एजंटमध्ये कॉल चालवणारा prompt, आवाज आणि उत्पादन स्तर एकत्रित असतो. तुम्ही एजंटवर max_call_duration_seconds आणि ring_duration_seconds यांसारख्या कॉल मर्यादाही सेट करू शकता. आउटबाउंड कॉलसाठी, कॉल समाप्त करण्यापूर्वी एजंट होल्डवर किती वेळ थांबेल हे मर्यादित करण्यासाठी तुम्ही max_hold_seconds देखील सेट करू शकता. Bolt एजंट ऐकण्याची आणि प्रतिसाद देण्याची पद्धत नियंत्रित करण्यासाठी audio_tier, endpointing आणि intelligence यांनाही समर्थन देतात. intelligence मध्ये lite आणि standard समर्थित आहेत. एजंट बोलण्यापूर्वी पूर्वरेकॉर्ड केलेला परिचय आणि जास्तीत जास्त दोन रिंग वाजवण्यासाठी एजंट intro_clip आणि intro_ring_count यांनाही समर्थन देतात. नवीन एजंटसाठी वेळ क्षेत्र देखील आवश्यक आहे. तुमचा एजंट बहुभाषिक असल्यास, भाषा बदलण्यापूर्वी तो विचारेल की कॉलरच्या भाषेनुसार वागेल हे नियंत्रित करण्यासाठी तुम्ही language_switching सेट करू शकता. विशिष्ट संज्ञा एजंट कशा प्रकारे उच्चारेल आणि कोणत्या संज्ञा ऐकेल हे नियंत्रित करण्यासाठी तुम्ही एजंटवर words देखील सेट करू शकता. प्रत्येक कॉन्फिगरेशन फील्डसाठी एजंट पहा; किमान आवश्यक कॉन्फिगरेशन असे आहे:

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 ऐवजी कॉन्फिगरेशन webhook द्वारे इनबाउंड कॉल रूट करत असल्यास, तो webhook आता प्रत्येक कॉलसाठी agent_id आणि variables सोबत timezone परत करू शकतो. Bolt एजंटसाठी, तुम्ही API राइट्समध्ये एजंटवर audio_tier, endpointing, आणि intelligence देखील सेट करू शकता. API अजूनही endpointing साठी उपनाव म्हणून जुने eagerness नाव स्वीकारते. तुमचा एजंट trigger="call_start" सह API कनेक्शन वापरत असल्यास, ThunderPhone प्रत्येक फोन कॉलच्या सुरुवातीला, अभिवादनापूर्वी, त्यांच्या जतन केलेल्या call_start_arguments वापरून ती साधने एकदा चालवू शकते.

तुमच्या आउटबाउंड कॉल्ससाठी कॉलबॅक

जेव्हा एखादी व्यक्ती मागील 30 दिवसांत तिला कॉल केलेल्या क्रमांकावर परत कॉल करते, तेव्हा उत्तर देणाऱ्या एजंटला त्या कॉलबद्दल एक संक्षिप्त पार्श्वभूमी टिप मिळते: तो कधी करण्यात आला, कोणत्या एजंटने केला आणि काय झाले (उत्तर नाही, व्हॉइसमेल किंवा संभाषण). इनबाउंड एजंट नसलेला क्रमांक हेच तपशील तुमच्या कॉन्फिगरेशन webhook कडे returning_call म्हणून पाठवतो. जर त्या क्रमांकासाठी webhook नसेल किंवा webhook कालबाह्य झाला अथवा त्याच्यापर्यंत पोहोचता आले नाही, तर कॉल समाप्त करण्याऐवजी आधीचा कॉल करणाऱ्या एजंटकडे पाठवला जातो. कॉलर ID बनावट असू शकतो, त्यामुळे आधीच्या कॉलचा सारांश आणि व्हेरिएबल्स केवळ प्रशासकाने संस्था → सामान्य → कॉलबॅक अंतर्गत आधीच्या कॉलचे तपशील शेअर करा सुरू केल्यासच शेअर केले जातात. पहा कॉलबॅक.

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

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


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