---
title: "ઇનબાઉન્ડ કૉલ્સ હેન્ડલ કરો (API)"
description: "શરૂઆતથી અંત સુધી: એજન્ટને કૉન્ફિગર કરો, તેને ફોન નંબર સાથે અસાઇન કરો, કૉલ લો અને ટ્રાન્સક્રિપ્ટ તપાસો."
---

<Note>
  તમારો પ્રથમ એજન્ટ હાથેથી બનાવી રહ્યા છો? ડૅશબોર્ડ તમને આ જ
  પ્રવાહ — એજન્ટ બનાવો, નંબર ઉમેરો, સિમ્યુલેટ કરો, સમીક્ષા કરો — માટે
  માર્ગદર્શિત વિઝાર્ડ સાથે લઈ જાય છે. અહીંથી શરૂ કરો:
  [ડૅશબોર્ડ ક્વિકસ્ટાર્ટ](/gu/quickstart-dashboard).
</Note>

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

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

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

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

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

```bash
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 માં તેની જરૂર પડશે.

<Tip>
  સૌથી ઓછી કિંમતે સરળ પ્રશ્નોત્તરી માટે `spark` પસંદ કરો, અને જ્યાં ઝડપ
  સૌથી મહત્ત્વની હોય ત્યાં `bolt` પસંદ કરો. જ્યારે તમારા prompt ને વધુ
  ઊંડા તર્કની જરૂર હોય અને મોડેલ વિચારે ત્યારે અડધી સેકન્ડનો ફિલર
  સ્વીકારી શકે ત્યારે `storm-base-with-ack` પર અપગ્રેડ કરો. જુઓ
  [પ્રોડક્ટ ટિયર્સ](/api-reference/agents#product-tiers-at-a-glance).
</Tip>

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

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

```bash
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}`](/api-reference/phone-numbers#retrieve-a-phone-number)
પોલ કરો.

<Note>
  ThunderPhone નંબરો માત્ર ઇનબાઉન્ડ માટે છે. આઉટબાઉન્ડ કૉલ્સ માટે,
  [VoIP દ્વારા તમારા પોતાના નંબરો લાવો](/gu/guides/bring-your-own-numbers).
</Note>

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

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

```bash
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`](/api-reference/calls#list-calls) માં
`status="in_progress"` સાથે દેખાય છે. કૉલ સમાપ્ત થાય ત્યારે, રેકોર્ડ
`end_reason`, `duration_seconds`, `billable_minutes`, અને (છેવટે)
રેકોર્ડિંગ URL તથા AI ગ્રેડ સાથે અપડેટ થાય છે.

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

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

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

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

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

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

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

જો તમે
[`telephony.complete` વેબહૂક](/gu/webhooks/events)
સબ્સ્ક્રાઇબ કર્યો હોય, તો તમને એ જ ડેટા તમારા સર્વર પર POST તરીકે મળશે — જુઓ
[call.complete](/gu/webhooks/call-complete).

---

## આગળના પગલાં

<CardGroup cols={2}>
  <Card title="દરેક કૉલ માટે ડાયનેમિક કૉન્ફિગ" icon="bolt" href="/gu/guides/dynamic-call-config">
    ફોન નંબર અથવા webhookમાં કસ્ટમ લોજિકના આધારે દરેક કૉલર માટે અલગ એજન્ટ પસંદ કરો.
  </Card>
  <Card title="ટૂલ ઇન્ટિગ્રેશન ઉમેરો" icon="screwdriver-wrench" href="/gu/guides/build-tool-integration">
    વાતચીત દરમિયાન એજન્ટને તમારી APIs કૉલ કરવા દો.
  </Card>
  <Card title="કૉલ ટ્રાન્સફર કરો" icon="phone-arrow-right" href="/gu/guides/call-transfers">
    કૉલરોને સીધા રૂટ કરો અથવા તેમને કનેક્ટ કરતા પહેલાં ગંતવ્યને સ્ક્રીન કરો.
  </Card>
  <Card title="call.complete webhooks મેળવો" icon="bolt" href="/gu/webhooks/call-complete">
    દરેક પૂર્ણ થયેલા કૉલને તમારી CRM / એનાલિટિક્સ પાઇપલાઇનમાં સ્ટ્રીમ કરો.
  </Card>
  <Card title="AI ગ્રેડિંગ અને ઇશ્યૂ રિપોર્ટ્સ" icon="chart-line" href="/api-reference/calls#ai-call-grading">
    દરેક કૉલને આપમેળે સ્કોર કરો અને ફ્લૅગ કરેલાને સમીક્ષા માટે રૂટ કરો.
  </Card>
</CardGroup>