Open in
అవుట్‌బౌండ్ కాల్‌లు చేయండి (API)
మీ స్వంత కోడ్ నుండి AI ఆధారిత అవుట్‌బౌండ్ కాల్‌ను ట్రిగ్గర్ చేయండి — సర్వే, ఫాలో-అప్ లేదా నిర్ధారణ ఫ్లోల కోసం.
అవుట్‌బౌండ్ కాలింగ్‌తో మీరు గమ్య నంబర్‌ను మరియు ఏజెంట్ కాన్ఫిగరేషన్‌ను ThunderPhoneకు అందించి, AI మీ తరఫున కాల్ చేయించవచ్చు. సాధారణ వినియోగ సందర్భాలు:
- అపాయింట్‌మెంట్ నిర్ధారణలు
- సర్వే ఫాలో-అప్ కాల్‌లు
- మిస్సైన కాల్ తర్వాత "రెండో ప్రయత్నం" ఫాలో-అప్‌లు
- డిస్పాచ్-శైలి నోటిఫికేషన్‌లు
ముందస్తు అవసరాలు
- అవుట్‌బౌండ్‌కు ప్రారంభించబడిన నంబర్‌ను ఎంచుకోండి
మీరు కలిగి ఉన్న నంబర్‌ను VoIP కనెక్షన్ ద్వారా ఉపయోగించండి లేదా Phone Numbers పేజీ నుండి అవుట్‌బౌండ్ కాల్‌ల కోసం మీ ThunderPhone నంబర్‌లను ఉపయోగించడానికి అనుమతి అభ్యర్థించండి. ThunderPhone నంబర్లు ప్రారంభంలో ఇన్‌బౌండ్‌కు మాత్రమే అందుబాటులో ఉంటాయి. ThunderPhone ప్రతి అభ్యర్థనను మాన్యువల్‌గా సమీక్షిస్తుంది; ఆమోదించబడిన తర్వాత, ఆ నంబర్లు ఆమోదించిన రోజువారీ పరిమితి వరకు కాల్‌లు చేయగలవు (00:00 UTC వద్ద రీసెట్ అవుతుంది), క్యాంపెయిన్‌లను నడపగలవు, అలాగే మీరు అధిక పరిమితిని అభ్యర్థించవచ్చు. కస్టమర్ VoIP నంబర్లకు రోజువారీ పరిమితి ఉండదు, కాబట్టి అవుట్‌బౌండ్ కాలింగ్ కోసం వాటిని మేము సిఫార్సు చేస్తాము. చూడండి మీ స్వంత నంబర్‌లను తీసుకురండి.
- ఏజెంట్‌ను సృష్టించండి
అవుట్‌బౌండ్‌కు అనుగుణమైన prompt సాధారణంగా ఏజెంట్ తనను తాను మరియు తన ఉద్దేశ్యాన్ని పరిచయం చేసుకోవడంతో ప్రారంభమవుతుంది — "హాయ్, రేపు మధ్యాహ్నం 3 గంటలకు మీ అపాయింట్‌మెంట్‌ను నిర్ధారించడానికి Acme నుంచి కాల్ చేస్తున్నాను…"
outbound_speak_orderనుagent_firstగా సెట్ చేయండి (డిఫాల్ట్). - సానుకూల బ్యాలెన్స్‌ను ఉంచండి
బ్యాలెన్స్ ≤
$0.00అయితే అవుట్‌బౌండ్ కాల్‌లు402 Payment Requiredను తిరిగి ఇస్తాయి. డ్యాష్‌బోర్డ్‌లోని సంస్థ → బిల్లింగ్ సెట్టింగ్‌లు కింద టాప్ అప్ చేయండి లేదా ఆటో-రీలోడ్‌ను ప్రారంభించండి. మీsk_live_కీGET /v1/billingతో బ్యాలెన్స్‌ను తనిఖీ చేయగలదు, కానీ టాప్ అప్ చేయలదు లేదా ఆటో-రీలోడ్‌ను మార్చలదు.
సేవ్ చేసిన ఏజెంట్‌తో కాల్ చేయండి
అత్యంత సులభమైన మార్గం — id ద్వారా ఏజెంట్‌ను సూచించండి:
curl -X POST https://api.thunderphone.com/v1/call \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"from_number": "+15551234567",
"to_number": "+14155552671",
"agent_id": 12
}'ప్రతిస్పందన:
{ "call_id": 987654321, "status": "initiated" }ఇన్‌లైన్ కాన్ఫిగ్‌తో కాల్ చేయండి
ఏజెంట్‌గా సేవ్ చేయడం విలువలేని ఒకేసారి ఉపయోగించే prompt కావాలంటే,
బదులుగా configను పంపండి. దీని ఆకారం
call.incoming webhook యొక్క ప్రతిస్పందన స్కీమాతో సరిపోతుంది:
curl -X POST https://api.thunderphone.com/v1/call \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"from_number": "+15551234567",
"to_number": "+14155552671",
"config": {
"prompt": "You are confirming Jane Doe appointment for 3pm tomorrow…",
"voice": "john",
"product": "spark"
}
}'కాల్‌ను అనుసరించండి
సమాంతరంగా,
telephony.complete వెబ్‌హుక్‌కు సభ్యత్వం పొందండి —
కాల్ ముగిసిందని తెలుసుకునేందుకు ఇది అత్యంత వేగవంతమైన మార్గం. మీరు ఇన్‌బౌండ్
వెబ్‌హుక్‌లను స్వీకరించలేకపోతే, ప్రతి కొన్ని సెకన్లకు ఒకసారి GET /v1/calls/{call_id}ను
పోల్ చేయండి; కాల్ ముగిసిన తర్వాత రికార్డ్‌లో end_reason, duration_seconds,
మరియు రికార్డింగ్ URL ఉంటాయి.
కాల్ తర్వాత నిర్మాణాత్మక డేటాను వెలికితీసేలా మీ ఏజెంట్‌ను సెటప్ చేసి ఉంటే, ఫైనలైజేషన్ పూర్తైన తర్వాత ఆ డేటా విడిగా అందించబడుతుంది.
సేవ్ చేసిన ఏజెంట్‌కు ప్రతి-కాల్ వేరియబుల్‌లను పంపండి
సేవ్ చేసిన ఏజెంట్‌లు prompt టెక్స్ట్‌లో {{name}} లేదా {{name|there}} వంటి
ప్లేస్‌హోల్డర్‌లను ఉపయోగించగలవు. మీరు agent_idతో అవుట్‌బౌండ్ కాల్ చేసినప్పుడు,
ఆ కాల్‌కు సంబంధించిన విలువలతో variablesను పంపండి:
{
"from_number": "+[REDACTED_PHONE]",
"to_number": "+[REDACTED_PHONE]",
"agent_id": 12,
"variables": {
"name": "Jordan"
}
}ప్లేస్‌హోల్డర్ పేరుతో కీ చేసిన స్ట్రింగ్ విలువలను ఉపయోగించండి. ఈ వేరియబుల్‌లు
సేవ్ చేసిన ఏజెంట్‌లకు వర్తిస్తాయి; ఈ గైడ్‌లోని ఇన్‌లైన్ config ఉదాహరణ వాటిని ఉపయోగించదు.
నిర్వహించాల్సిన వైఫల్య విధానాలు
| లోపం | పరిష్కారం |
|---|---|
402 Payment Required | బ్యాలెన్స్‌కు నిధులు జోడించండి లేదా ఆటో-రీలోడ్‌ను ప్రారంభించండి |
400 with code: destination_not_allowed | ThunderPhone ఆ నంబర్‌కు కాల్ చేయదు: చెల్లని నంబర్లు, అత్యవసర నంబర్లు, ప్రీమియం-రేట్ నంబర్లు, షార్ట్ కోడ్‌లు లేదా ఆంక్షలు విధించిన దేశాలు. ThunderPhone నంబర్ల నుండి సాధారణ US మరియు కెనడియన్ నంబర్లకు మాత్రమే కాల్ చేయవచ్చు (ప్రీమియం-రేట్ కాదు). ఏదో reason తెలియజేస్తుంది; నిరోధిత గమ్యస్థానాలు చూడండి |
409 with retryable: false for a ThunderPhone number | codeను అనుసరించండి: ఫోన్ నంబర్లు పేజీలో అవుట్‌బౌండ్ కాలింగ్‌ను అభ్యర్థించండి, పెండింగ్ సమీక్ష కోసం వేచి ఉండండి లేదా అర్హతగల మరొక నంబర్‌ను ఉపయోగించండి |
429 with code: platform_outbound_daily_limit_reached | సంస్థ ThunderPhone నంబర్ల నుండి నేటి అవుట్‌బౌండ్ కాల్‌లను ఉపయోగించుకుంది. resets_at (00:00 UTC) వరకు వేచి ఉండండి, ఫోన్ నంబర్లు పేజీలో అధిక పరిమితిని అభ్యర్థించండి లేదా మీ స్వంత VoIP కనెక్షన్‌లోని నంబర్ నుండి కాల్ చేయండి |
429 with code: concurrent_call_limit_reached | సంస్థలో దాని సమకాలీన-కాల్ పరిమితికు సమానంగా కాల్‌లు కొనసాగుతున్నాయి (డిఫాల్ట్‌గా 20, ఇన్‌బౌండ్, అవుట్‌బౌండ్, వెబ్ మరియు పరీక్ష కాల్‌లను లెక్కించి). Retry-After హెడ్డర్‌లోని సెకన్ల తర్వాత లేదా ఒక కాల్ ముగిసినప్పుడు మళ్లీ ప్రయత్నించండి; పరిమితిని పెంచడానికి support@thunderphone.comకు ఇమెయిల్ పంపండి |
429 with code: same_number_too_soon | మీరు 10 సెకన్ల కంటే తక్కువ సమయం క్రితం అదే to_numberకు కాల్ చేశారు. Retry-After హెడ్డర్‌లోని సెకన్ల తర్వాత మళ్లీ ప్రయత్నించండి |
409 with retryable: false for a customer VoIP number | code పేర్కొన్న స్థితిని సరిచేయండి; ధృవీకరణ విఫలమైతే, POST /v1/phone-numbers/{id}/verify-voipను అమలు చేయండి |
409 idempotency conflict | అసలు సాధారణీకరించిన అభ్యర్థనతో మాత్రమే కీని మళ్లీ ఉపయోగించండి లేదా కొత్త కీని పంపండి |
404 from_number is not registered to this organization | from_number మీ సంస్థలోని సక్రియ ఫోన్ నంబర్‌తో సరిపోలుతుందని నిర్ధారించండి. ఇప్పటికే ప్రొవిజనింగ్‌లో ఉన్న, విఫలమైన, విడుదలవుతున్న లేదా విడుదలైన నంబర్ కూడా ఈ ప్రతిస్పందనను ఇస్తుంది |
500 with only a detail field | అవుట్‌బౌండ్ ట్రంక్ కాన్ఫిగర్ చేయబడలేదు. సపోర్ట్‌ను సంప్రదించండి; ఇది మీరు సరిచేయగల నంబర్-స్థితి సమస్య కాదు |
502 Bad Gateway | తాత్కాలిక SIP / LiveKit వైఫల్యం; మళ్లీ ప్రయత్నించడం సురక్షితం |
పూర్తి స్థిరమైన అర్హత-కోడ్ జాబితా మరియు రెండు 409 ప్రతిస్పందన రూపాల కోసం
అవుట్‌బౌండ్ కాల్‌ల రిఫరెన్స్ను చూడండి.
అభ్యర్థన ఆమోదించబడిన తర్వాత కానీ కాల్ చేయడానికి ముందు యాక్టివ్ నంబర్ అనర్హంగా మారితే,
చివరి తనిఖీ మళ్లీ ప్రయత్నించలేని 409 పేలోడ్‌ను అందిస్తుంది.
హోల్డ్ సమయాన్ని నియంత్రించడం
కాలీ స్పందించడంలో నెమ్మదిగా ఉండటం వల్ల ఎక్కువసేపు నడిచే అవుట్‌బౌండ్ కాల్‌లను
(IVR ట్రీలు, క్యూలు) max_hold_secondsతో పరిమితం చేయవచ్చు:
{
"from_number": "+15551234567",
"to_number": "+14155552671",
"agent_id": 12,
"max_hold_seconds": 120
}గత N సెకన్లలో మానవ ఆడియో అందకపోతే ఏజెంట్ కాల్‌ను ముగిస్తుంది. డిఫాల్ట్‌గా 900 సెకన్లు (15 నిమిషాలు) ఉంటుంది.
తదుపరి దశలు
ప్రతి అభ్యర్థన ఫీల్డ్ మరియు లోపం కోడ్.
పూర్తయిన అవుట్‌బౌండ్ కాల్‌లను మీ సిస్టమ్‌కు స్ట్రీమ్ చేయండి.
బ్యాలెన్స్ కారణంగా అవుట్‌బౌండ్ ఎప్పుడూ విఫలం కాకుండా ఆటో-రీలోడ్ చేయండి.
ప్రొడక్షన్‌కు ముందు మీ అవుట్‌బౌండ్ ఏజెంట్‌ను డ్రై-రన్ చేయండి.