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

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

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

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

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

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

એજન્ટ prompt, વૉઇસ અને પ્રોડક્ટ ટિયરને એકસાથે રાખે છે, જે કૉલને સંચાલિત કરશે. દરેક કન્ફિગરેશન ફીલ્ડ માટે એજન્ટ્સ જુઓ; ન્યૂનતમ આ છે:

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": "spark"
  }'

પરત મળેલ 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 પણ સેટ કરી શકો છો, જેથી નંબર આઉટબાઉન્ડ કૉલ કરવા માટે પણ તૈયાર રહે.

4. કૉલ લો#

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

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

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 વેબહૂક સબ્સ્ક્રાઇબ કર્યો હોય, તો તમને એ જ ડેટા તમારા સર્વર પર POST તરીકે મળશે — જુઓ call.complete.

આગળના પગલાં#