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

Developer cookbook

ઇનબાઉન્ડ કૉલ હેન્ડલ કરો (API)

શરૂઆતથી અંત સુધી: એજન્ટ કન્ફિગર કરો, તેને ફોન નંબર સાથે જોડો, કૉલ લો અને ટ્રાન્સક્રિપ્ટ તપાસો.

તમારા ટર્મિનલમાંથી ફોનનો "AI વડે જવાબ આપો" એવો પ્રમાણભૂત પ્રવાહ. તમે આ કરશો:

  1. prompt અને વૉઇસ સાથે એજન્ટ બનાવો.
  2. ફોન નંબર પ્રોવિઝન કરો (અથવા તમારો નંબર લાવો) અને એજન્ટને તેના ઇનબાઉન્ડ હેન્ડલર તરીકે સોંપો.
  3. નંબર પર કૉલ કરો. કૉલ લૉગ, ટ્રાન્સક્રિપ્ટ અને રેકોર્ડિંગ જુઓ.

કુલ API કૉલ્સ: ચાર. કુલ સમય: 5 મિનિટથી ઓછો.

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

એજન્ટ prompt, voice અને કૉલ ચલાવનાર પ્રોડક્ટ ટિયરનું સંયોજન છે. તમે એજન્ટ પર max_call_duration_seconds અને ring_duration_seconds જેવી કૉલ મર્યાદાઓ પણ સેટ કરી શકો છો. આઉટબાઉન્ડ કૉલ માટે, તમે max_hold_seconds પણ સેટ કરી શકો છો જેથી કૉલ સમાપ્ત કરતા પહેલાં એજન્ટ હોલ્ડ પર કેટલો સમય રાહ જુએ તે મર્યાદિત કરી શકાય. Bolt એજન્ટ્સ સાંભળવાની અને જવાબ આપવાની રીત નિયંત્રિત કરવા માટે audio_tier, endpointing, અને intelligence ને પણ સપોર્ટ કરે છે: intelligence core અથવા pro હોઈ શકે છે, અને audio_tier (હિયરિંગ) lite, standard, plus અથવા max હોઈ શકે છે (Max સામાન્ય રીતે ઉપલબ્ધ નથી). જૂનાં મૂલ્યો (lite અને standard intelligence માટે; lean, hearing અને deep_hearing હિયરિંગ માટે) હજુ પણ સ્વીકારવામાં આવે છે. ફુલ ડુપ્લેક્સ એજન્ટ્સ સપોર્ટેડ ભાષાઓમાં એક જ voice જાળવી રાખે છે, તેથી તે કૉલ્સમાં પ્રતિ-ભાષા voice સ્વિચિંગ લાગુ પડતું નથી. એજન્ટ્સ એજન્ટ બોલે તે પહેલાં પૂર્વ-રેકોર્ડ કરેલો પરિચય અને વધુમાં વધુ બે રિંગ વગાડવા માટે intro_clip અને intro_ring_count ને પણ સપોર્ટ કરે છે. નવા એજન્ટ્સને સમય ઝોન પણ જરૂરી છે. જો તમારો એજન્ટ બહુભાષી હોય, તો ભાષા બદલતા પહેલાં તે પૂછે કે કૉલરની ભાષાને અનુસરે તે નિયંત્રિત કરવા માટે તમે language_switching સેટ કરી શકો છો. ચોક્કસ શબ્દો તે કેવી રીતે બોલે અને કયા શબ્દો માટે સાંભળે તે નિયંત્રિત કરવા માટે તમે એજન્ટ પર words પણ સેટ કરી શકો છો. દરેક કૉન્ફિગરેશન ફીલ્ડ માટે Agents જુઓ; ન્યૂનતમ જરૂરીયાત આ છે:

curl -X POST https://api.thunderphone.com/v1/agents \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name":    "Acme Support",
    "prompt":  "You are a friendly support agent for Acme. Help callers with orders and returns. Keep answers short.",
    "voice":   "john",
    "product": "bolt"
  }'

પરત મળેલ id સાચવો — પગલું 2 માં તેની જરૂર પડશે.

2. ફોન નંબર મેળવો

જો તમને ડાયલ કરવા માટે માત્ર કંઈક જોઈએ છે, તો ThunderPhone ના પૂલમાંથી ThunderPhone નંબર મેળવો:

curl -X POST https://api.thunderphone.com/v1/phone-numbers \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"area_code": "415"}'

પ્રતિસાદમાં E.164 માં id અને number શામેલ હોય છે. ThunderPhone નંબરો status="provisioning" થી શરૂ થાય છે અને થોડી સેકન્ડમાં active બની જાય છે — જો તમને રસ હોય તો પરિવર્તન જોવા માટે GET /v1/phone-numbers/{id} ને વારંવાર તપાસો.

3. એજન્ટ સોંપો

પગલું 1 ના એજન્ટને નંબરની ઇનબાઉન્ડ દિશા સાથે સાંકળો:

curl -X PATCH https://api.thunderphone.com/v1/phone-numbers/{phone_id} \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"inbound_agent_id": 12}'

બસ એટલું જ — નંબર લાઇવ છે. તમારી સંસ્થા માટે આઉટબાઉન્ડ કૉલિંગ મંજૂર થયા પછી, તમે એ જ PATCH માં outbound_agent_id પણ સેટ કરી શકો છો. ત્યાં સુધી, API તે અસાઇનમેન્ટને 400 સાથે નકારે છે.

જો તમે ઇનબાઉન્ડ કૉલ્સને નિશ્ચિત inbound_agent_idને બદલે કૉન્ફિગ વેબહૂક દ્વારા રૂટ કરો છો, તો તે વેબહૂક હવે agent_id અને variables સાથે દરેક કૉલ માટેનું timezone પરત કરી શકે છે. Bolt એજન્ટ્સ માટે, તમે API રાઇટ્સમાં એજન્ટ પર audio_tier, endpointing, અને intelligence પણ સેટ કરી શકો છો. API હજી પણ endpointing માટે ઉપનામ તરીકે જૂનું eagerness નામ સ્વીકારે છે. જો તમારો એજન્ટ trigger="call_start" સાથે API કનેક્શન્સનો ઉપયોગ કરે છે, તો ThunderPhone દરેક ફોન કૉલની શરૂઆતમાં, અભિવાદન પહેલાં, તેમના સાચવેલા call_start_argumentsનો ઉપયોગ કરીને તે ટૂલ્સ એક વાર ચલાવી શકે છે.

તમારી આઉટબાઉન્ડ કૉલ્સ માટે કૉલબૅક્સ

જ્યારે કોઈ વ્યક્તિ છેલ્લા 30 દિવસમાં તેને કૉલ કરનારા નંબર પર પાછો કૉલ કરે છે, ત્યારે જવાબ આપતા એજન્ટને તે કૉલ વિશે ટૂંકી પૃષ્ઠભૂમિ નોંધ મળે છે: તે ક્યારે કરવામાં આવ્યો હતો, કયા એજન્ટ દ્વારા અને શું થયું હતું (જવાબ મળ્યો નહીં, વૉઇસમેઇલ અથવા વાતચીત). ઇનબાઉન્ડ એજન્ટ વિનાનો નંબર આ જ વિગતો તમારા config webhook પર returning_call તરીકે મોકલે છે. જો તે નંબર પાસે webhook ન હોય, અથવા webhook સમયસમાપ્તિ પામે અથવા પહોંચી ન શકાય, તો કૉલ સમાપ્ત થવાને બદલે અગાઉનો કૉલ કરનાર એજન્ટ પાસે જાય છે. કૉલર ID નકલી હોઈ શકે છે, તેથી અગાઉના કૉલનો સારાંશ અને variables ફક્ત ત્યારે જ શેર થાય છે જ્યારે એડમિન Organization → General → Callbacks હેઠળ અગાઉના કૉલની વિગતો શેર કરો ચાલુ કરે. કૉલબૅક્સ જુઓ.

4. કૉલ લો

તમારા ફોનથી નંબર ડાયલ કરો. એજન્ટ કૉલ ઉપાડે છે, તમારા prompt મુજબ પોતાનો પરિચય આપે છે અને વાતચીત શરૂ થાય છે.

કૉલ ચાલુ હોય ત્યારે, તે GET /v1/calls માં status="in_progress" સાથે દેખાય છે. કૉલ સમાપ્ત થાય ત્યારે, રેકોર્ડ end_reason, duration_seconds, billable_minutes અને (આખરે) રેકોર્ડિંગ URL તથા AI ગ્રેડ સાથે અપડેટ થાય છે.

ઇનબાઉન્ડ કૉલ્સ તમારી સંસ્થાની સમવર્તી-કૉલ મર્યાદામાં ગણાય છે (ડિફૉલ્ટરૂપે ચાલુ સ્થિતિમાં 20 કૉલ્સ, જે આઉટબાઉન્ડ, વેબ અને ટેસ્ટ કૉલ્સ સાથે શેર થાય છે). મર્યાદા પર આવતો કૉલ એજન્ટ જવાબ આપે તે પહેલાં નકારવામાં આવે છે અને ડિસકનેક્ટ કરવામાં આવે છે, તેનું બિલ લેવાતું નથી, અને concurrent_call_limit_reached અંત કારણ સાથે નિષ્ફળ કૉલ તરીકે નોંધાય છે. જો તમને વધુ ઊંચી મર્યાદાની જરૂર હોય તો support@thunderphone.com પર ઇમેઇલ કરો.

5. પરિણામો તપાસો

તાજેતરના કૉલ્સની સૂચિ મેળવો:

curl 'https://api.thunderphone.com/v1/calls?limit=5' \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

ટ્રાન્સક્રિપ્ટ મેળવો:

curl https://api.thunderphone.com/v1/calls/{call_id}/transcript \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

અને રેકોર્ડિંગ URL (ટૂંકા સમય માટે માન્ય, સાઇન કરેલ):

curl https://api.thunderphone.com/v1/calls/{call_id}/audio \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

જો તમે telephony.complete webhook માટે સબ્સ્ક્રાઇબ કર્યું હોય, તો તમને એ જ ડેટા તમારા સર્વર પર POST તરીકે મળશે — જુઓ call.complete.

જો તમારા એજન્ટ માટે એક્સ્ટ્રેક્શન ફીલ્ડ્સ કૉન્ફિગર કરેલા હોય, તો પૂર્ણ થયેલા કૉલ પેલોડમાં સંરચિત રીતે એક્સ્ટ્રેક્ટ કરેલો ડેટા પણ સામેલ હોઈ શકે છે. એજન્ટ તે સેટિંગને ઓવરરાઇડ ન કરે ત્યાં સુધી, કૉલ સારાંશો ThunderPhoneમાં તમારી સંસ્થા જે ભાષાનો ઉપયોગ કરે છે તેમાં લખવામાં આવે છે.


આગળના પગલાં