---
title: "ఇన్‌బౌండ్ కాల్‌లను నిర్వహించండి (API)"
description: "ఎండ్-టు-ఎండ్: ఏజెంట్‌ను కాన్ఫిగర్ చేయండి, దానిని ఫోన్ నంబర్‌కు కేటాయించండి, కాల్‌ను స్వీకరించండి మరియు ట్రాన్స్‌క్రిప్ట్‌ను పరిశీలించండి."
---

<Note>
  మీ మొదటి ఏజెంట్‌ను స్వయంగా నిర్మిస్తున్నారా? డ్యాష్‌బోర్డ్ ఇదే
  ప్రవాహాన్ని — ఏజెంట్‌ను నిర్మించడం, నంబర్‌ను జోడించడం, సిమ్యులేట్ చేయడం, సమీక్షించడం —
  గైడెడ్ విజార్డ్‌తో చూపిస్తుంది. ప్రారంభించడానికి
  [డ్యాష్‌బోర్డ్ క్విక్‌స్టార్ట్](/te/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 ద్వారా మీ స్వంత నంబర్‌లను తీసుకురండి](/te/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` వెబ్‌హుక్](/te/webhooks/events)కు సబ్‌స్క్రైబ్ అయి ఉంటే,
మీ సర్వర్‌కు POSTగా ఇదే డేటా అందుతుంది — చూడండి
[call.complete](/te/webhooks/call-complete).

---

## తదుపరి దశలు

<CardGroup cols={2}>
  <Card title="డైనమిక్ ప్రతి-కాల్ కాన్ఫిగరేషన్" icon="bolt" href="/te/guides/dynamic-call-config">
    ఫోన్ నంబర్ లేదా webhookలోని కస్టమ్ లాజిక్ ఆధారంగా ప్రతి కాలర్‌కు వేరే ఏజెంట్‌ను ఎంచుకోండి.
  </Card>
  <Card title="టూల్ ఇంటిగ్రేషన్‌లను జోడించండి" icon="screwdriver-wrench" href="/te/guides/build-tool-integration">
    సంభాషణ మధ్యలో మీ APIలను కాల్ చేయడానికి ఏజెంట్‌ను అనుమతించండి.
  </Card>
  <Card title="కాల్స్‌ను బదిలీ చేయండి" icon="phone-arrow-right" href="/te/guides/call-transfers">
    కాలర్‌లను నేరుగా రూట్ చేయండి లేదా కనెక్ట్ చేయడానికి ముందు గమ్యస్థానాన్ని స్క్రీన్ చేయండి.
  </Card>
  <Card title="call.complete webhookలను స్వీకరించండి" icon="bolt" href="/te/webhooks/call-complete">
    పూర్తైన ప్రతి కాల్‌ను మీ CRM / అనలిటిక్స్ పైప్‌లైన్‌కు స్ట్రీమ్ చేయండి.
  </Card>
  <Card title="AI గ్రేడింగ్ మరియు సమస్య నివేదికలు" icon="chart-line" href="/api-reference/calls#ai-call-grading">
    ప్రతి కాల్‌కు స్వయంచాలకంగా స్కోర్ ఇవ్వండి మరియు ఫ్లాగ్ చేసిన వాటిని సమీక్ష కోసం రూట్ చేయండి.
  </Card>
</CardGroup>