ప్రారంభించండి

అవుట్‌బౌండ్ కాల్‌లు చేయండి (API)

అవుట్‌బౌండ్ కాలింగ్‌తో మీరు గమ్యస్థాన నంబర్ మరియు ఏజెంట్ కాన్ఫిగరేషన్‌ను ThunderPhone‌కు అందించి, మీ తరఫున AI ద్వారా కాల్ చేయించవచ్చు. సాధారణ వినియోగ సందర్భాలు:

ముందస్తు అవసరాలు

  1. ఒక VoIP నంబర్‌ను తీసుకురండి

    అవుట్‌బౌండ్ కాలింగ్ కోసం మీరు from_numberను VoIP కనెక్షన్ ద్వారా కలిగి ఉండాలి. డెమో నంబర్‌లు ఇన్‌బౌండ్‌కు మాత్రమే పరిమితం. చూడండి: మీ స్వంత నంబర్‌లను తీసుకురండి.

  2. ఏజెంట్‌ను సృష్టించండి

    అవుట్‌బౌండ్‌కు అనుగుణమైన prompt సాధారణంగా ఏజెంట్ తనను మరియు దాని ఉద్దేశ్యాన్ని పరిచయం చేసుకోవడంతో ప్రారంభమవుతుంది — "హాయ్, రేపు మధ్యాహ్నం 3 గంటల మీ అపాయింట్‌మెంట్‌ను నిర్ధారించడానికి Acme నుండి కాల్ చేస్తున్నాను…" outbound_speak_orderను agent_firstగా సెట్ చేయండి (డిఫాల్ట్).

  3. సానుకూల బ్యాలెన్స్‌ను ఉంచండి

    బ్యాలెన్స్ ≤ $0.00 అయితే అవుట్‌బౌండ్ కాల్‌లు 402 Payment Requiredను తిరిగి ఇస్తాయి. దీనిద్వారా టాప్ అప్ చేయండి: POST /v1/billing/top-up లేదా ఆటో-రీలోడ్‌ను ప్రారంభించండి.

సేవ్ చేసిన ఏజెంట్‌తో కాల్ చేయండి

అత్యంత సరళమైన మార్గం — 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":   "+14155550199",
    "agent_id":    12
  }'

ప్రతిస్పందన:

{ "call_id": 987654321, "status": "initiated" }

ఇన్‌లైన్ కాన్ఫిగ్‌తో కాల్ చేయండి

ఏజెంట్‌గా సేవ్ చేయాల్సిన అవసరం లేని ఒకేసారి ఉపయోగించే prompt కావాలంటే, బదులుగా configను పంపండి. దీని ఆకారం call.incoming వెబ్‌హుక్ ప్రతిస్పందన స్కీమాతో సరిపోతుంది:

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":   "+14155550199",
    "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 ఉంటాయి.

నిర్వహించదగిన వైఫల్య రకాలు

లోపంపరిష్కారం
402 Payment Requiredబ్యాలెన్స్‌ను టాప్ అప్ చేయండి లేదా ఆటో-రీలోడ్‌ను ప్రారంభించండి
403 అవుట్‌బౌండ్ బ్లాక్ చేయబడింది (డెమో నంబర్)బదులుగా VoIP నంబర్‌ను తీసుకురండి
403 అవుట్‌బౌండ్ బ్లాక్ చేయబడింది (ధృవీకరించని VoIP)POST /v1/phone-numbers/{id}/verify-voipను అమలు చేయండి
404 from_number is not registered to this organizationfrom_number మీకు చెందిన ఫోన్ నంబర్‌తో సరిపోతుందో నిర్ధారించండి
502 Bad Gatewayతాత్కాలిక SIP / LiveKit వైఫల్యం; మళ్లీ ప్రయత్నించడం సురక్షితం

హోల్డ్ సమయాన్ని నియంత్రించడం

కాల్ స్వీకరించే వ్యక్తి ప్రతిస్పందించడంలో ఆలస్యం వల్ల ఎక్కువసేపు కొనసాగే అవుట్‌బౌండ్ కాల్‌లను (IVR ట్రీలు, క్యూలు) max_hold_secondsతో పరిమితం చేయవచ్చు:

{
  "from_number": "+15551234567",
  "to_number":   "+14155550199",
  "agent_id":    12,
  "max_hold_seconds": 120
}

గత N సెకన్లలో మానవ ఆడియో అందకపోతే ఏజెంట్ కాల్‌ను ముగిస్తుంది. డిఫాల్ట్ 900 (15 నిమిషాలు).

తదుపరి దశలు

అవుట్‌బౌండ్ కాల్‌ల రిఫరెన్స్

ప్రతి రిక్వెస్ట్ ఫీల్డ్ మరియు ఎర్రర్ కోడ్.

call.complete స్వీకరించండి

పూర్తయిన అవుట్‌బౌండ్ కాల్‌లను మీ సిస్టమ్‌కు స్ట్రీమ్ చేయండి.

బిల్లింగ్

బ్యాలెన్స్ కారణంగా అవుట్‌బౌండ్ ఎప్పుడూ విఫలం కాకుండా ఆటో-రీలోడ్ చేయండి.

అవుట్‌బౌండ్ ఏజెంట్‌లను పరీక్షించండి

ప్రొడక్షన్‌కు ముందు మీ అవుట్‌బౌండ్ ఏజెంట్‌ను డ్రై-రన్ చేయండి.