ఇన్‌బౌండ్ కాల్‌లను నిర్వహించండి (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.

తదుపరి దశలు#