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 విలువ core లేదా pro కావచ్చు, మరియు audio_tier (హియరింగ్) విలువ lite, standard, plus లేదా max కావచ్చు (Max సాధారణంగా అందుబాటులో లేదు). పాత విలువలు (lite మరియు standard ఇంటెలిజెన్స్ కోసం; హియరింగ్ కోసం lean, hearing, మరియు deep_hearing) ఇప్పటికీ ఆమోదించబడతాయి. ఫుల్ డ్యూప్లెక్స్ ఏజెంట్‌లు మద్దతు ఉన్న భాషలలో ఒకే వాయిస్‌ను కొనసాగిస్తాయి, కాబట్టి ఆ కాల్‌లకు ప్రతి భాషకు వాయిస్ మార్పిడి వర్తించదు. ఏజెంట్‌లు ఏజెంట్ మాట్లాడే ముందు ముందుగా రికార్డ్ చేసిన పరిచయాన్ని మరియు గరిష్ఠంగా రెండు రింగ్‌లను ప్లే చేయడానికి 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": "bolt"
  }'

తిరిగి వచ్చిన 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 బదులుగా కాన్ఫిగరేషన్ వెబ్‌హుక్ ద్వారా ఇన్‌బౌండ్ కాల్‌లను రూట్ చేస్తే, ఆ వెబ్‌హుక్ ఇప్పుడు ప్రతి కాల్‌కు agent_id, variablesతో పాటు timezoneను కూడా తిరిగి ఇవ్వగలదు. Bolt ఏజెంట్‌ల కోసం, మీరు API రైట్‌లలో ఏజెంట్‌పై audio_tier, endpointing, మరియు intelligenceను కూడా సెట్ చేయవచ్చు. API ఇప్పటికీ పాత eagerness పేరును endpointingకు ఉపనామంగా అంగీకరిస్తుంది. మీ ఏజెంట్ trigger="call_start"తో API కనెక్షన్‌లను ఉపయోగిస్తే, ThunderPhone ప్రతి ఫోన్ కాల్ ప్రారంభంలో, అభివాదానికి ముందు, వాటి సేవ్ చేసిన call_start_argumentsను ఉపయోగించి ఆ టూల్‌లను ఒకసారి అమలు చేయగలదు.

మీ అవుట్‌బౌండ్ కాల్‌లకు తిరిగి వచ్చే కాల్‌లు

ఎవరైనా గత 30 రోజుల్లో వారికి కాల్ చేసిన నంబర్‌కు తిరిగి కాల్ చేస్తే, సమాధానం ఇచ్చే ఏజెంట్‌కు ఆ కాల్‌పై సంక్షిప్త నేపథ్య గమనిక అందుతుంది: అది ఎప్పుడు చేయబడింది, ఏ ఏజెంట్ ద్వారా చేయబడింది మరియు ఏమి జరిగింది (సమాధానం లేదు, వాయిస్‌మెయిల్ లేదా సంభాషణ). ఇన్‌బౌండ్ ఏజెంట్ లేని నంబర్ అదే వివరాలను మీ కాన్ఫిగ్ వెబ్‌హుక్‌కు returning_callగా పంపుతుంది. ఆ నంబర్‌కు వెబ్‌హుక్ లేకపోతే, లేదా వెబ్‌హుక్ సమయం ముగిసినా లేదా చేరుకోలేకపోయినా, కాల్ ముగియకుండా మునుపటి కాల్ చేసిన ఏజెంట్‌కు వెళ్తుంది. కాలర్ 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 webhookకు సబ్‌స్క్రైబ్ అయి ఉంటే, అదే డేటా మీ సర్వర్‌కు POSTగా అందుతుంది — చూడండి call.complete.

మీ ఏజెంట్‌కు ఎక్స్‌ట్రాక్షన్ ఫీల్డ్‌లు కాన్ఫిగర్ చేసి ఉంటే, పూర్తైన కాల్ పేలోడ్‌లో నిర్మాణాత్మకంగా ఎక్స్‌ట్రాక్ట్ చేసిన డేటా కూడా ఉండవచ్చు. ఏజెంట్ ఆ సెట్టింగ్‌ను ఓవర్‌రైడ్ చేయకపోతే, కాల్ సారాంశాలు మీ సంస్థ ThunderPhoneలో ఉపయోగించే భాషలో వ్రాయబడతాయి.


తదుపరి దశలు

ప్రతి కాల్‌కు డైనమిక్ కాన్ఫిగరేషన్

ఫోన్ నంబర్ లేదా webhookలోని కస్టమ్ లాజిక్ ఆధారంగా ప్రతి కాలర్‌కు వేర్వేరు ఏజెంట్‌ను ఎంచుకోండి.

టూల్ ఇంటిగ్రేషన్‌లను జోడించండి

సంభాషణ మధ్యలో మీ APIలను కాల్ చేయడానికి ఏజెంట్‌ను అనుమతించండి.

కాల్‌లను ట్రాన్స్‌ఫర్ చేయండి

కాలర్‌లను నేరుగా రూట్ చేయండి లేదా కనెక్ట్ చేయడానికి ముందు గమ్యస్థానాన్ని స్క్రీన్ చేయండి.

call.complete webhookలను స్వీకరించండి

పూర్తయిన ప్రతి కాల్‌ను మీ CRM / అనలిటిక్స్ పైప్‌లైన్‌కు స్ట్రీమ్ చేయండి.

AI గ్రేడింగ్ మరియు సమస్య నివేదికలు

ప్రతి కాల్‌కు స్వయంచాలకంగా స్కోర్ ఇవ్వండి మరియు ఫ్లాగ్ చేసిన వాటిని సమీక్షకు రూట్ చేయండి.