---
title: "வெளிச்செல்லும் அழைப்புகளை மேற்கொள்ளுங்கள் (API)"
description: "உங்கள் சொந்த குறியீட்டிலிருந்து AI இயக்கும் வெளிச்செல்லும் அழைப்பைத் தொடங்குங்கள் — கருத்துக்கணிப்பு, தொடர்நடவடிக்கை அல்லது உறுதிப்படுத்தல் ஓட்டங்களுக்காக."
---

வெளிச்செல்லும் அழைப்பு மூலம், இலக்கு எண்ணையும் ஏஜென்ட்
கட்டமைப்பையும் ThunderPhone-க்கு வழங்கி, உங்கள் சார்பாக AI அழைப்பை
மேற்கொள்ளச் செய்யலாம். பொதுவான பயன்பாடுகள்:

- சந்திப்பு உறுதிப்படுத்தல்கள்
- கணக்கெடுப்பு மறுஅழைப்புகள்
- தவறவிட்ட அழைப்புக்குப் பிறகான "இரண்டாவது முயற்சி" தொடர்தொடர்புகள்
- அனுப்பீட்டு வகை அறிவிப்புகள்

<Note>
  முழுப் பட்டியலுக்கும் அழைக்க வேண்டுமா? டாஷ்போர்டின்
  [**பிரச்சாரங்கள்**](/ta/guides/outbound-campaigns) அம்சம்
  (`/dashboard/campaigns`) தொடர்புகளின் CSV கோப்பை ஏற்று,
  நேர மண்டலத்தை கருத்தில் கொண்ட அழைப்பு நேரங்கள், ஒரேநேர அழைப்புகள்,
  மற்றும் மீண்டும் முயற்சிக்கும் கொள்கையை உங்களுக்காகக் கையாளும்.
  இந்த வழிகாட்டி ஒற்றை நிரலாக்க அழைப்புகளைப் பற்றியது.
</Note>

## முன்நிபந்தனைகள்

<Steps>
  <Step title="ஒரு VoIP எண்ணைக் கொண்டு வாருங்கள்">
    வெளிச்செல்லும் அழைப்புக்கு, `from_number` எண்ணை நீங்கள்
    [VoIP இணைப்பு](/api-reference/voip-connections) மூலம் சொந்தமாகக்
    கொண்டிருக்க வேண்டும். ThunderPhone எண்கள் உள்வரும் அழைப்புகளுக்கு
    மட்டும். [உங்கள் சொந்த எண்களைக் கொண்டு வாருங்கள்](/ta/guides/bring-your-own-numbers)
    என்பதைப் பார்க்கவும்.
  </Step>
  <Step title="ஒரு ஏஜென்ட்டை உருவாக்குங்கள்">
    வெளிச்செல்லும் அழைப்புக்கு ஏற்ற prompt-ல், ஏஜென்ட் தன்னையும் அதன்
    நோக்கத்தையும் அறிமுகப்படுத்துவதுடன் தொடங்குவது வழக்கம் — "Hi, this is Acme calling to
    confirm your appointment for tomorrow at 3pm…" `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` webhook](/ta/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` webhook](/ta/webhooks/events)-க்கு
சந்தா செலுத்துங்கள் — அழைப்பு முடிந்ததை அறிய இதுவே மிக வேகமான வழி.
உள்வரும் webhooks-ஐ ஏற்க முடியாவிட்டால், சில விநாடிகளுக்கு ஒருமுறை
`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="/ta/webhooks/call-complete">
    முடிவடைந்த வெளிச்செல்லும் அழைப்புகளை உங்கள் அமைப்புக்கு ஸ்ட்ரீம் செய்யுங்கள்.
  </Card>
  <Card title="பில்லிங்" icon="credit-card" href="/api-reference/billing">
    இருப்பு காரணமாக வெளிச்செல்லும் அழைப்பு தோல்வியடையாமல் தானியங்கி ரீலோடு செய்யுங்கள்.
  </Card>
  <Card title="வெளிச்செல்லும் ஏஜென்ட்களைச் சோதித்தல்" icon="flask" href="/ta/guides/test-agents">
    உற்பத்திக்கு முன் உங்கள் வெளிச்செல்லும் ஏஜென்ட்டை ட்ரை-ரன் செய்யுங்கள்.
  </Card>
</CardGroup>