ThunderPhone v3 હવે લાઇવ છે.સેલ્ફ-સર્વ, 2¢/મિનિટથી.જાહેરાત વાંચો

Developer cookbook

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

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

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

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

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

  1. આઉટબાઉન્ડ-સક્ષમ નંબર પસંદ કરો

    તમારા માલિકીના નંબરનો ઉપયોગ VoIP કનેક્શન દ્વારા કરો, અથવા Phone Numbers પેજ પરથી તમારા ThunderPhone નંબરોને આઉટબાઉન્ડ કૉલ માટે વાપરવાની પરવાનગી માગો. ThunderPhone નંબરો શરૂઆતમાં ફક્ત ઇનબાઉન્ડ હોય છે. ThunderPhone દરેક વિનંતીની મેન્યુઅલી સમીક્ષા કરે છે; મંજૂરી મળ્યા પછી, તે નંબરો મંજૂર દૈનિક મર્યાદા સુધી કૉલ કરી શકે છે (00:00 UTC પર રીસેટ થાય છે) અને કેમ્પેઇન ચલાવી શકે છે, અને તમે વધુ ઊંચી મર્યાદા માગી શકો છો. ગ્રાહકના VoIP નંબરોની કોઈ દૈનિક મર્યાદા નથી, તેથી અમે આઉટબાઉન્ડ કૉલિંગ માટે તેમની ભલામણ કરીએ છીએ. જુઓ તમારા પોતાના નંબરો લાવો.

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

    આઉટબાઉન્ડ-કેન્દ્રિત prompt સામાન્ય રીતે એજન્ટ પોતાનો અને તેના હેતુનો પરિચય આપે તે રીતે શરૂ થાય છે — "નમસ્તે, હું Acme તરફથી આવતીકાલે બપોરે 3 વાગ્યે તમારી એપોઇન્ટમેન્ટની પુષ્ટિ કરવા કૉલ કરી રહ્યો છું…" outbound_speak_order ને agent_first પર સેટ કરો (ડિફૉલ્ટ).

  3. હકારાત્મક બેલેન્સ જાળવો

    બેલેન્સ ≤ $0.00 હોય તો આઉટબાઉન્ડ કૉલ 402 Payment Required પરત કરે છે. ડૅશબોર્ડમાં Organization → Billing Settings હેઠળ ટૉપ અપ કરો અથવા ઑટો-રીલોડ સક્ષમ કરો. તમારી 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"
    }
  }'

છેલ્લી મૌન ચેક-ઇન પછી શું થાય તે નિયંત્રિત કરો

સાચવેલા એજન્ટ્સ ઉપયોગ કરે છે તેવી જ મૌન અંતિમ-ક્રિયા સેટિંગ્સ તમે ઇનલાઇન config માં પણ આપી શકો છો:

{
  "from_number": "+[REDACTED_PHONE]",
  "to_number": "+[REDACTED_PHONE]",
  "config": {
    "silence_final_action": "hang_up"
  }
}

છેલ્લી મૌન ચેક-ઇન પછી શું થાય તે પસંદ કરવા માટે silence_final_action નો ઉપયોગ કરો. તમે silence_final_message પણ આપી શકો છો અને, જ્યારે અંતિમ ક્રિયા ટ્રાન્સફર હોય, ત્યારે silence_transfer_destination પણ આપી શકો છો.

ઇનલાઇન config માં શબ્દોની સૂચિ ઉમેરો

ઇનલાઇન આઉટબાઉન્ડ કૉલ્સમાં સાચવેલા એજન્ટ્સ જેવી જ words સૂચિ શામેલ હોઈ શકે છે. એજન્ટને પહેલાં સાચવ્યા વિના કૉલ કસ્ટમ ઉચ્ચારણ અથવા સાંભળવાના નિયમોનું પાલન કરે તે માટે આનો ઉપયોગ કરો.

{
  "from_number": "+[REDACTED_PHONE]",
  "to_number": "+[REDACTED_PHONE]",
  "config": {
    "prompt": "[REDACTED_LITERAL]",
    "voice": "john",
    "product": "spark",
    "words": []
  }
}

કૉલને અનુસરો

queued_at સમય સાથેનો પ્રતિસાદ સૂચવે છે કે ThunderPhone ની આઉટબાઉન્ડ ક્ષમતા ઉપયોગમાં છે: જગ્યા ઉપલબ્ધ થાય ત્યારે, 10 મિનિટની અંદર કૉલ ડાયલ થાય છે, અને જો જગ્યા ઉપલબ્ધ ન થાય તો end_reason તરીકે outbound_queue_timeout સાથે સમાપ્ત થાય છે. તમારે ફરી પ્રયાસ કરવાની જરૂર નથી. કતારમાં રહેલા કૉલ્સ જુઓ.

સમાંતર રીતે, કૉલ પૂર્ણ થઈ છે તે જાણવાની સૌથી ઝડપી રીત માટે telephony.complete વેબહૂક સબ્સ્ક્રાઇબ કરો. તમે ડાયલિંગ, જવાબ અપાયો, વૉઇસમેલ અને હોલ્ડમાં ફેરફારો જેવા લાઇવ પ્રગતિ અપડેટ્સ માટે call.status_changed પણ સબ્સ્ક્રાઇબ કરી શકો છો. જો તમે ઇનબાઉન્ડ વેબહૂક સ્વીકારી શકતા ન હો, તો દરેક થોડા સેકન્ડે 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 સાથે code: destination_not_allowedThunderPhone તે નંબર પર કૉલ કરતું નથી: અમાન્ય નંબરો, ઇમરજન્સી નંબરો, પ્રીમિયમ-દર નંબરો, શોર્ટ કોડ્સ, પ્રતિબંધિત દેશો અથવા તમારી સંસ્થાએ આઉટબાઉન્ડ કૉલિંગ માટે અવરોધિત કરેલું US રાજ્ય. ThunderPhone નંબરો પરથી, સામાન્ય US અને કેનેડિયન નંબરો માન્ય છે, અને કેટલાક આંતરરાષ્ટ્રીય ગંતવ્યો માન્ય છે તથા ગંતવ્યના દરે બિલ કરવામાં આવે છે. reason જણાવે છે કે કયું; અવરોધિત ગંતવ્યો જુઓ
ThunderPhone નંબર માટે retryable: false સાથે 409codeને અનુસરો: ફોન નંબર્સ પૃષ્ઠ પર આઉટબાઉન્ડ કૉલિંગની વિનંતી કરો, બાકી સમીક્ષાની રાહ જુઓ અથવા અન્ય પાત્ર નંબરનો ઉપયોગ કરો
429 સાથે code: platform_outbound_daily_limit_reachedસંસ્થાએ આજે ThunderPhone નંબરો પરથી આઉટબાઉન્ડ કૉલ્સની મર્યાદા વાપરી લીધી છે. resets_at (00:00 UTC) સુધી રાહ જુઓ, ફોન નંબર્સ પૃષ્ઠ પર વધુ મર્યાદાની વિનંતી કરો અથવા તમારા પોતાના VoIP કનેક્શન પરના નંબર પરથી કૉલ કરો
429 સાથે code: concurrent_call_limit_reachedસંસ્થામાં તેની સમવર્તી-કૉલ મર્યાદા જેટલા કૉલ પ્રગતિમાં છે (મૂળભૂત રીતે 20, જેમાં ઇનબાઉન્ડ, આઉટબાઉન્ડ, વેબ અને ટેસ્ટ કૉલ્સ ગણાય છે). Retry-After હેડરમાં દર્શાવેલા સેકન્ડ પછી અથવા કૉલ સમાપ્ત થાય ત્યારે ફરી પ્રયાસ કરો; મર્યાદા વધારવા માટે support@thunderphone.com પર ઈમેલ કરો
429 સાથે code: outbound_queue_fullસંસ્થાના 50 કતારમાંના કૉલ્સ રાહ જોઈ રહ્યા છે. Retry-After હેડરમાં દર્શાવેલા સેકન્ડ પછી ફરી પ્રયાસ કરો
429 સાથે code: same_number_too_soonતમે 10 સેકન્ડથી ઓછા સમય પહેલાં એ જ to_number પર કૉલ કર્યો હતો. Retry-After હેડરમાં દર્શાવેલા સેકન્ડ પછી ફરી પ્રયાસ કરો
ગ્રાહકના VoIP નંબર માટે retryable: false સાથે 409code દ્વારા દર્શાવેલી સ્થિતિ સુધારો; ચકાસણીની નિષ્ફળતાઓ માટે POST /v1/phone-numbers/{id}/verify-voip ચલાવો
409 આઇડેમ્પોટન્સી સંઘર્ષકીનો ફરી ઉપયોગ માત્ર મૂળ સામાન્યકૃત વિનંતી સાથે કરો અથવા નવી કી મોકલો
404 from_number is not registered to this organizationખાતરી કરો કે from_number તમારી સંસ્થાના સક્રિય ફોન નંબર સાથે મેળ ખાય છે. જે નંબર પહેલેથી પ્રોવિઝન થઈ રહ્યો હોય, નિષ્ફળ થયો હોય, રિલીઝ થઈ રહ્યો હોય અથવા રિલીઝ થઈ ગયો હોય તે પણ આ પ્રતિસાદ આપે છે
માત્ર detail ફીલ્ડ સાથે 500કોઈ આઉટબાઉન્ડ ટ્રંક કન્ફિગર કરેલ નથી. સપોર્ટનો સંપર્ક કરો; આ એવી નંબર-સ્થિતિની સમસ્યા નથી જેને તમે સુધારી શકો
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 મિનિટ) છે.

જો તમે સાચવેલા એજન્ટ અને આઉટબાઉન્ડ કૉલ વિનંતી બંને પર max_hold_seconds સેટ કરો છો, તો તે કૉલ માટે પ્રતિ-કૉલ મૂલ્યનો ઉપયોગ થાય છે.


આગળના પગલાં