આઉટબાઉન્ડ કૉલ કરો (API)

તમારા પોતાના કોડમાંથી AI-સંચાલિત આઉટબાઉન્ડ કૉલ ટ્રિગર કરો — સર્વે, ફૉલો-અપ અથવા પુષ્ટિ ફ્લો માટે.

આઉટબાઉન્ડ કૉલિંગ દ્વારા તમે ThunderPhone ને ગંતવ્ય નંબર અને એજન્ટ કૉન્ફિગ્યુરેશન આપી શકો છો અને AI તમારી તરફથી કૉલ કરી શકે છે. સામાન્ય ઉપયોગના કિસ્સાઓ:

• અપૉઇન્ટમેન્ટની પુષ્ટિઓ
• સર્વે માટેના પાછા કૉલ
• મિસ્ડ કૉલ પછીના "બીજા પ્રયાસ" ફૉલો-અપ્સ
• ડિસ્પેચ-શૈલીની સૂચનાઓ

પૂર્વજરૂરિયાતો#

1. VoIP નંબર લાવો

   આઉટબાઉન્ડ કૉલિંગ માટે તમારે VoIP કનેક્શન દ્વારા from_number ધરાવવો આવશ્યક છે. ThunderPhone નંબરો માત્ર ઇનબાઉન્ડ માટે છે. જુઓ તમારા પોતાના નંબરો લાવો.

2. એજન્ટ બનાવો

   આઉટબાઉન્ડ-કેન્દ્રિત prompt સામાન્ય રીતે એજન્ટ દ્વારા પોતાની ઓળખ અને હેતુ જણાવવાથી શરૂ થાય છે — "નમસ્તે, Acme તરફથી કાલે બપોરે 3 વાગ્યે તમારી અપૉઇન્ટમેન્ટની પુષ્ટિ કરવા માટે કૉલ કરી રહ્યા છીએ…" 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 શામેલ હોય છે.

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

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

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

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

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

આગામી પગલાં#