---
title: "ಹೊರಹೋಗುವ ಕರೆಗಳನ್ನು ಮಾಡಿ (API)"
description: "ನಿಮ್ಮ ಸ್ವಂತ ಕೋಡ್‌ನಿಂದ AI-ಚಾಲಿತ ಹೊರಹೋಗುವ ಕರೆಯನ್ನು ಪ್ರಾರಂಭಿಸಿ — ಸಮೀಕ್ಷೆ, ಅನುಸರಣೆ, ಅಥವಾ ದೃಢೀಕರಣ ಹರಿವುಗಳಿಗಾಗಿ."
---

ಹೊರಹೋಗುವ ಕರೆ ಮಾಡುವುದರಿಂದ ನೀವು ಗಮ್ಯಸ್ಥಾನ ಸಂಖ್ಯೆಯನ್ನು ಮತ್ತು ಏಜೆಂಟ್
ಕಾನ್ಫಿಗರೇಶನ್ ಅನ್ನು ThunderPhone ಗೆ ನೀಡಬಹುದು ಹಾಗೂ AI ನಿಮ್ಮ ಪರವಾಗಿ ಕರೆಯನ್ನು
ಮಾಡುತ್ತದೆ. ಸಾಮಾನ್ಯ ಬಳಕೆಯ ಸಂದರ್ಭಗಳು:

- ಅಪಾಯಿಂಟ್‌ಮೆಂಟ್ ದೃಢೀಕರಣಗಳು
- ಸಮೀಕ್ಷೆ ಮರುಕರೆಗಳು
- ಮಿಸ್ಡ್ ಕಾಲ್‌ನ ನಂತರದ "ಎರಡನೇ ಪ್ರಯತ್ನ" ಅನುಸರಣೆಗಳು
- ಡಿಸ್ಪ್ಯಾಚ್ ಶೈಲಿಯ ಅಧಿಸೂಚನೆಗಳು

<Note>
  ಸಂಪೂರ್ಣ ಪಟ್ಟಿಗೆ ಕರೆ ಮಾಡಬೇಕೇ? ಡ್ಯಾಶ್‌ಬೋರ್ಡ್‌ನ
  [**ಅಭಿಯಾನಗಳು**](/kn/guides/outbound-campaigns) ವೈಶಿಷ್ಟ್ಯವು
  (`/dashboard/campaigns`) ಸಂಪರ್ಕಗಳ CSV ಅನ್ನು ಪಡೆದು, ಸಮಯವಲಯವನ್ನು
  ಪರಿಗಣಿಸುವ ಕರೆ ಸಮಯಾವಧಿಗಳು, ಏಕಕಾಲಿಕತೆ ಮತ್ತು ಮರುಪ್ರಯತ್ನ ನೀತಿಯನ್ನು
  ನಿಮಗಾಗಿ ನಿರ್ವಹಿಸುತ್ತದೆ. ಈ ಮಾರ್ಗದರ್ಶಿ ಏಕ ಪ್ರೋಗ್ರಾಮ್ಯಾಟಿಕ್ ಕರೆಗಳನ್ನು ಒಳಗೊಂಡಿದೆ.
</Note>

## ಪೂರ್ವಾಪೇಕ್ಷಿತಗಳು

<Steps>
  <Step title="VoIP ಸಂಖ್ಯೆಯನ್ನು ಒದಗಿಸಿ">
    ಹೊರಹೋಗುವ ಕರೆ ಮಾಡಲು ನೀವು `from_number` ಅನ್ನು
    [VoIP ಸಂಪರ್ಕದ](/api-reference/voip-connections) ಮೂಲಕ ಹೊಂದಿರಬೇಕು. ThunderPhone ಸಂಖ್ಯೆಗಳು
    ಒಳಬರುವ ಕರೆಗಳಿಗೆ ಮಾತ್ರ. [ನಿಮ್ಮ ಸ್ವಂತ ಸಂಖ್ಯೆಗಳನ್ನು ಒದಗಿಸಿ](/kn/guides/bring-your-own-numbers)
    ನೋಡಿ.
  </Step>
  <Step title="ಏಜೆಂಟ್ ರಚಿಸಿ">
    ಹೊರಹೋಗುವ ಕರೆಗಳಿಗೆ ಹೊಂದುವ prompt ಸಾಮಾನ್ಯವಾಗಿ ಏಜೆಂಟ್ ತನ್ನನ್ನು ಮತ್ತು ತನ್ನ
    ಉದ್ದೇಶವನ್ನು ಪರಿಚಯಿಸುವುದರೊಂದಿಗೆ ಪ್ರಾರಂಭವಾಗುತ್ತದೆ — "ಹಾಯ್, ನಾಳೆ ಮಧ್ಯಾಹ್ನ 3 ಗಂಟೆಗೆ ಇರುವ
    ನಿಮ್ಮ ಅಪಾಯಿಂಟ್‌ಮೆಂಟ್ ದೃಢೀಕರಿಸಲು Acme ನಿಂದ ಕರೆ ಮಾಡುತ್ತಿದ್ದೇನೆ…" `outbound_speak_order` ಅನ್ನು
    `agent_first` ಗೆ ಹೊಂದಿಸಿ (ಇದು ಡೀಫಾಲ್ಟ್).
  </Step>
  <Step title="ಧನಾತ್ಮಕ ಬ್ಯಾಲೆನ್ಸ್ ಉಳಿಸಿಕೊಳ್ಳಿ">
    ಬ್ಯಾಲೆನ್ಸ್ ≤ `$0.00` ಆಗಿದ್ದರೆ ಹೊರಹೋಗುವ ಕರೆಗಳು `402 Payment Required` ಅನ್ನು
    ಹಿಂತಿರುಗಿಸುತ್ತವೆ. [`POST /v1/billing/top-up`](/api-reference/billing#top-up-balance) ಮೂಲಕ
    ಹಣ ಸೇರಿಸಿ ಅಥವಾ [ಸ್ವಯಂ ಮರುಲೋಡ್](/api-reference/billing#update-auto-reload) ಸಕ್ರಿಯಗೊಳಿಸಿ.
  </Step>
</Steps>

## ಉಳಿಸಿದ ಏಜೆಂಟ್‌ನೊಂದಿಗೆ ಕರೆ ಮಾಡಿ

ಅತ್ಯಂತ ಸರಳ ಮಾರ್ಗ — id ಮೂಲಕ ಏಜೆಂಟ್ ಅನ್ನು ಉಲ್ಲೇಖಿಸಿ:

```bash
curl -X POST https://api.thunderphone.com/v1/call \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from_number": "+15551234567",
    "to_number":   "+14155550199",
    "agent_id":    12
  }'
```

ಪ್ರತಿಕ್ರಿಯೆ:

```json
{ "call_id": 987654321, "status": "initiated" }
```

<Warning>
  `status: "initiated"` ಎಂದರೆ ವಿನಂತಿಯನ್ನು ಸ್ವೀಕರಿಸಲಾಗಿದೆ ಎಂದಷ್ಟೇ — ಕರೆ
  **ಇನ್ನೂ ಸಂಪರ್ಕಗೊಂಡಿಲ್ಲ**. ಸಕ್ರಿಯ ಸ್ಥಿತಿಗಾಗಿ
  [`GET /v1/calls/{call_id}`](/api-reference/calls#retrieve-a-call) ಅನ್ನು ಪರಿಶೀಲಿಸಿ
  (`in_progress` → `completed` / `failed`).
</Warning>

## ಇನ್‌ಲೈನ್ ಕಾನ್ಫಿಗ್‌ನೊಂದಿಗೆ ಕರೆ ಮಾಡಿ

ಏಜೆಂಟ್ ಆಗಿ ಉಳಿಸಲು ಯೋಗ್ಯವಲ್ಲದ ಒಂದು ಬಾರಿಯ prompt ಬೇಕಾದರೆ,
ಬದಲಿಗೆ `config` ಅನ್ನು ಕಳುಹಿಸಿ. ಇದರ ಆಕಾರವು
[`call.incoming` ವೆಬ್‌ಹುಕ್](/kn/webhooks/call-incoming) ನ ಪ್ರತಿಕ್ರಿಯೆ ಸ್ಕೀಮಾಗೆ ಹೊಂದಿಕೆಯಾಗುತ್ತದೆ:

```bash
curl -X POST https://api.thunderphone.com/v1/call \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from_number": "+15551234567",
    "to_number":   "+14155550199",
    "config": {
      "prompt":  "You are confirming Jane Doe appointment for 3pm tomorrow…",
      "voice":   "john",
      "product": "spark"
    }
  }'
```

## ಕರೆಯನ್ನು ಅನುಸರಿಸಿ

ಸಮಾನಾಂತರವಾಗಿ,
[`telephony.complete` ವೆಬ್‌ಹುಕ್](/kn/webhooks/events) ಗೆ ಚಂದಾದಾರರಾಗಿ —
ಕರೆ ಮುಗಿದಿದೆ ಎಂದು ತಿಳಿಯಲು ಇದು ಅತ್ಯಂತ ವೇಗವಾದ ವಿಧಾನವಾಗಿದೆ. ನೀವು ಒಳಬರುವ
ವೆಬ್‌ಹುಕ್‌ಗಳನ್ನು ಸ್ವೀಕರಿಸಲು ಸಾಧ್ಯವಾಗದಿದ್ದರೆ, ಪ್ರತಿ ಕೆಲವು ಸೆಕೆಂಡುಗಳಿಗೊಮ್ಮೆ
`GET /v1/calls/{call_id}` ಅನ್ನು ಪರಿಶೀಲಿಸಿ; ಕರೆ ಮುಗಿದ ನಂತರ ದಾಖಲೆಯು
`end_reason`, `duration_seconds`, ಮತ್ತು ರೆಕಾರ್ಡಿಂಗ್ URL ಅನ್ನು ಒಳಗೊಂಡಿರುತ್ತದೆ.

## ನಿರ್ವಹಿಸಬೇಕಾದ ವೈಫಲ್ಯ ವಿಧಾನಗಳು

| ದೋಷ | ಪರಿಹಾರ |
|-------|-----|
| `402 Payment Required` | ಬ್ಯಾಲೆನ್ಸ್‌ಗೆ ಹಣ ಸೇರಿಸಿ ಅಥವಾ ಸ್ವಯಂ ಮರುಲೋಡ್ ಸಕ್ರಿಯಗೊಳಿಸಿ |
| `403` ಹೊರಹೋಗುವ ಕರೆ ನಿರ್ಬಂಧಿಸಲಾಗಿದೆ (ThunderPhone ಸಂಖ್ಯೆ) | ಬದಲಿಗೆ VoIP ಸಂಖ್ಯೆಯನ್ನು ಒದಗಿಸಿ |
| `403` ಹೊರಹೋಗುವ ಕರೆ ನಿರ್ಬಂಧಿಸಲಾಗಿದೆ (ಪರಿಶೀಲಿಸದ VoIP) | [`POST /v1/phone-numbers/{id}/verify-voip`](/api-reference/phone-numbers#verify-a-voip-sourced-number) ಅನ್ನು ಚಲಾಯಿಸಿ |
| `404 from_number is not registered to this organization` | `from_number` ನೀವು ಹೊಂದಿರುವ ಫೋನ್ ಸಂಖ್ಯೆಗೆ ಹೊಂದುತ್ತದೆ ಎಂದು ದೃಢೀಕರಿಸಿ |
| `502 Bad Gateway` | ತಾತ್ಕಾಲಿಕ SIP / LiveKit ವೈಫಲ್ಯ; ಮರುಪ್ರಯತ್ನಿಸುವುದು ಸುರಕ್ಷಿತ |

## ಹೋಲ್ಡ್ ಸಮಯವನ್ನು ನಿಯಂತ್ರಿಸುವುದು

ಕರೆ ಸ್ವೀಕರಿಸುವವರು ಪ್ರತಿಕ್ರಿಯಿಸಲು ನಿಧಾನವಾಗಿರುವುದರಿಂದ ದೀರ್ಘವಾಗುವ ಹೊರಹೋಗುವ ಕರೆಗಳಿಗೆ
(IVR ಟ್ರೀಗಳು, ಸರದಿಗಳು) `max_hold_seconds` ಮೂಲಕ ಮಿತಿಯನ್ನು ಹೊಂದಿಸಬಹುದು:

```json
{
  "from_number": "+15551234567",
  "to_number":   "+14155550199",
  "agent_id":    12,
  "max_hold_seconds": 120
}
```

ಕಳೆದ N ಸೆಕೆಂಡುಗಳಲ್ಲಿ ಯಾವುದೇ ಮಾನವ ಧ್ವನಿ ಸ್ವೀಕರಿಸದಿದ್ದರೆ ಏಜೆಂಟ್ ಕರೆಯನ್ನು ಕೊನೆಗೊಳಿಸುತ್ತದೆ. ಡೀಫಾಲ್ಟ್ 900 (15 ನಿಮಿಷಗಳು).

---

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

<CardGroup cols={2}>
  <Card title="ಹೊರಹೋಗುವ ಕರೆಗಳ ಉಲ್ಲೇಖ" icon="phone-arrow-up-right" href="/api-reference/outbound-calls">
    ಪ್ರತಿ ವಿನಂತಿ ಕ್ಷೇತ್ರ ಮತ್ತು ದೋಷ ಸಂಕೇತ.
  </Card>
  <Card title="call.complete ಸ್ವೀಕರಿಸಿ" icon="bolt" href="/kn/webhooks/call-complete">
    ಪೂರ್ಣಗೊಂಡ ಹೊರಹೋಗುವ ಕರೆಗಳನ್ನು ನಿಮ್ಮ ವ್ಯವಸ್ಥೆಗೆ ಸ್ಟ್ರೀಮ್ ಮಾಡಿ.
  </Card>
  <Card title="ಬಿಲ್ಲಿಂಗ್" icon="credit-card" href="/api-reference/billing">
    ಬಾಕಿಯ ಕಾರಣದಿಂದ ಹೊರಹೋಗುವ ಕರೆ ಎಂದಿಗೂ ವಿಫಲವಾಗದಂತೆ ಸ್ವಯಂ ಮರುಲೋಡ್ ಮಾಡಿ.
  </Card>
  <Card title="ಹೊರಹೋಗುವ ಏಜೆಂಟ್‌ಗಳನ್ನು ಪರೀಕ್ಷಿಸಿ" icon="flask" href="/kn/guides/test-agents">
    ಉತ್ಪಾದನೆಗೆ ಮೊದಲು ನಿಮ್ಮ ಹೊರಹೋಗುವ ಏಜೆಂಟ್ ಅನ್ನು ಡ್ರೈ-ರನ್ ಮಾಡಿ.
  </Card>
</CardGroup>