આઉટબાઉન્ડ કૉલ કરો (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 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":   "+14155550199",
    "config": {
      "prompt":  "You are confirming Jane Doe appointment for 3pm tomorrow…",
      "voice":   "john",
      "product": "spark"
    }
  }'

કૉલને અનુસરો

સમાંતર રીતે, telephony.complete webhook ને સબ્સ્ક્રાઇબ કરો — કૉલ પૂર્ણ થયો છે તે જાણવાની આ સૌથી ઝડપી રીત છે. જો તમે ઇનબાઉન્ડ webhook સ્વીકારી શકતા ન હો, તો દર બે-ત્રણ સેકન્ડે GET /v1/calls/{call_id} પોલ કરો; કૉલ પૂર્ણ થયા પછી રેકોર્ડમાં end_reason, duration_seconds અને રેકોર્ડિંગ URL શામેલ હોય છે.

હેન્ડલ કરવા યોગ્ય નિષ્ફળતા સ્થિતિઓ

હોલ્ડ સમય નિયંત્રિત કરવો

જવાબ આપનાર પ્રતિસાદ આપવામાં ધીમો હોવાથી લાંબા ચાલતા આઉટબાઉન્ડ કૉલ્સને (IVR ટ્રી, કતારો) max_hold_seconds વડે મર્યાદિત કરી શકાય છે:

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

છેલ્લા N સેકન્ડમાં કોઈ માનવ અવાજ પ્રાપ્ત ન થયો હોય તો એજન્ટ કૉલ બંધ કરે છે. ડિફૉલ્ટ 900 (15 મિનિટ) છે.

આગળનાં પગલાં