---
title: "ಒಳಬರುವ ಕರೆಗಳನ್ನು ನಿರ್ವಹಿಸಿ (API)"
description: "ಆರಂಭದಿಂದ ಅಂತ್ಯದವರೆಗೆ: ಏಜೆಂಟ್ ಅನ್ನು ಕಾನ್ಫಿಗರ್ ಮಾಡಿ, ಅದನ್ನು ಫೋನ್ ಸಂಖ್ಯೆಗೆ ನಿಯೋಜಿಸಿ, ಕರೆ ಸ್ವೀಕರಿಸಿ ಮತ್ತು ಪ್ರತಿಲಿಪಿಯನ್ನು ಪರಿಶೀಲಿಸಿ."
---

<Note>
  ನಿಮ್ಮ ಮೊದಲ ಏಜೆಂಟ್ ಅನ್ನು ಕೈಯಾರೆ ನಿರ್ಮಿಸುತ್ತಿದ್ದೀರಾ? ಡ್ಯಾಶ್‌ಬೋರ್ಡ್ ಇದೇ
  ಹರಿವನ್ನು — ಏಜೆಂಟ್ ನಿರ್ಮಿಸಿ, ಸಂಖ್ಯೆ ಸೇರಿಸಿ, ಸಿಮ್ಯುಲೇಟ್ ಮಾಡಿ, ಪರಿಶೀಲಿಸಿ — ಮಾರ್ಗದರ್ಶಿತ
  ವಿಜಾರ್ಡ್‌ನೊಂದಿಗೆ ನಡೆಸಿಕೊಡುತ್ತದೆ. ಇಲ್ಲಿ ಪ್ರಾರಂಭಿಸಿ:
  [ಡ್ಯಾಶ್‌ಬೋರ್ಡ್ ತ್ವರಿತಾರಂಭ](/kn/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>
  ಅತಿ ಕಡಿಮೆ ವೆಚ್ಚದಲ್ಲಿ ಸರಳ Q&A ಗಾಗಿ `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 ಮೂಲಕ ನಿಮ್ಮ ಸ್ವಂತ ಸಂಖ್ಯೆಗಳನ್ನು ತನ್ನಿ](/kn/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` ವೆಬ್‌ಹುಕ್](/kn/webhooks/events) ಗೆ ಚಂದಾದಾರರಾಗಿದ್ದರೆ,
ನಿಮ್ಮ ಸರ್ವರ್‌ಗೆ POST ಆಗಿ ಇದೇ ಡೇಟಾವನ್ನು ಸ್ವೀಕರಿಸುತ್ತೀರಿ — ನೋಡಿ
[call.complete](/kn/webhooks/call-complete).

---

## ಮುಂದಿನ ಹಂತಗಳು

<CardGroup cols={2}>
  <Card title="ಡೈನಾಮಿಕ್ ಪ್ರತಿ-ಕರೆ ಕಾನ್ಫಿಗ್" icon="bolt" href="/kn/guides/dynamic-call-config">
    ಫೋನ್ ಸಂಖ್ಯೆಯ ಆಧಾರದಲ್ಲಿ ಅಥವಾ webhook‌ನಲ್ಲಿನ ಕಸ್ಟಮ್ ಲಾಜಿಕ್ ಆಧಾರದಲ್ಲಿ ಪ್ರತಿ ಕರೆಗಾರರಿಗೆ ವಿಭಿನ್ನ ಏಜೆಂಟ್ ಆಯ್ಕೆಮಾಡಿ.
  </Card>
  <Card title="ಟೂಲ್ ಏಕೀಕರಣಗಳನ್ನು ಸೇರಿಸಿ" icon="screwdriver-wrench" href="/kn/guides/build-tool-integration">
    ಸಂಭಾಷಣೆಯ ಮಧ್ಯದಲ್ಲಿ ನಿಮ್ಮ APIಗಳನ್ನು ಕರೆಯಲು ಏಜೆಂಟ್‌ಗೆ ಅನುಮತಿಸಿ.
  </Card>
  <Card title="ಕರೆಗಳನ್ನು ವರ್ಗಾಯಿಸಿ" icon="phone-arrow-right" href="/kn/guides/call-transfers">
    ಕರೆಗಾರರನ್ನು ನೇರವಾಗಿ ರೂಟ್ ಮಾಡಿ ಅಥವಾ ಅವರನ್ನು ಸಂಪರ್ಕಿಸುವ ಮೊದಲು ಗಮ್ಯಸ್ಥಾನವನ್ನು ಪರಿಶೀಲಿಸಿ.
  </Card>
  <Card title="call.complete webhookಗಳನ್ನು ಸ್ವೀಕರಿಸಿ" icon="bolt" href="/kn/webhooks/call-complete">
    ಪೂರ್ಣಗೊಂಡ ಪ್ರತಿಯೊಂದು ಕರೆಯನ್ನು ನಿಮ್ಮ CRM / ಅನಾಲಿಟಿಕ್ಸ್ ಪೈಪ್‌ಲೈನ್‌ಗೆ ಸ್ಟ್ರೀಮ್ ಮಾಡಿ.
  </Card>
  <Card title="AI ಗ್ರೇಡಿಂಗ್ ಮತ್ತು ಸಮಸ್ಯೆ ವರದಿಗಳು" icon="chart-line" href="/api-reference/calls#ai-call-grading">
    ಪ್ರತಿಯೊಂದು ಕರೆಯನ್ನು ಸ್ವಯಂಚಾಲಿತವಾಗಿ ಸ್ಕೋರ್ ಮಾಡಿ ಮತ್ತು ಫ್ಲ್ಯಾಗ್ ಮಾಡಲಾದವುಗಳನ್ನು ಪರಿಶೀಲನೆಗೆ ರೂಟ್ ಮಾಡಿ.
  </Card>
</CardGroup>