---
title: "உள்வரும் அழைப்புகளைக் கையாளுங்கள் (API)"
description: "முழுமையாக: ஒரு ஏஜென்டை உள்ளமைக்கவும், அதை ஒரு தொலைபேசி எண்ணுக்கு ஒதுக்கவும், அழைப்பை ஏற்கவும், உரைப்பதிவைப் பரிசோதிக்கவும்."
---

<Note>
  உங்கள் முதல் ஏஜென்ட்டை கைமுறையாக உருவாக்குகிறீர்களா? டாஷ்போர்டு இதே
  செயலோட்டத்தை — ஏஜென்ட்டை உருவாக்குதல், எண்ணைச் சேர்த்தல், சிமுலேஷன் செய்தல், மதிப்பாய்வு செய்தல் —
  வழிகாட்டும் விசார்டுடன் நடத்திச் செல்லும். தொடங்க
  [டாஷ்போர்டு விரைவுத் தொடக்கத்திற்குச்](/ta/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)
ஐ poll செய்யவும்.

<Note>
  ThunderPhone எண்கள் உள்வரும் அழைப்புகளுக்கு மட்டுமே. வெளிச்செல்லும் அழைப்புகளுக்கு,
  [VoIP வழியாக உங்கள் சொந்த எண்களைக் கொண்டுவரவும்](/ta/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` வெப்ஹுக்கிற்கு](/ta/webhooks/events)
சந்தா செய்திருந்தால், அதே தரவு உங்கள் சர்வருக்கு POST ஆக வரும் — 
[call.complete](/ta/webhooks/call-complete) ஐப் பார்க்கவும்.

---

## அடுத்த படிகள்

<CardGroup cols={2}>
  <Card title="ஒவ்வொரு அழைப்பிற்கும் மாறும் கட்டமைப்பு" icon="bolt" href="/ta/guides/dynamic-call-config">
    தொலைபேசி எண் அல்லது webhook-இல் உள்ள தனிப்பயன் தர்க்கத்தின் அடிப்படையில் ஒவ்வொரு அழைப்பாளருக்கும் வேறு ஏஜென்டைத் தேர்ந்தெடுக்கவும்.
  </Card>
  <Card title="கருவி ஒருங்கிணைப்புகளைச் சேர்க்கவும்" icon="screwdriver-wrench" href="/ta/guides/build-tool-integration">
    உரையாடலின் நடுவில் ஏஜென்ட் உங்கள் API-களை அழைக்க அனுமதிக்கவும்.
  </Card>
  <Card title="அழைப்புகளை மாற்றி இணைக்கவும்" icon="phone-arrow-right" href="/ta/guides/call-transfers">
    அழைப்பாளர்களை நேரடியாக வழிமாற்றவும் அல்லது இணைப்பதற்கு முன் இலக்கைச் சரிபார்க்கவும்.
  </Card>
  <Card title="call.complete webhook-களைப் பெறவும்" icon="bolt" href="/ta/webhooks/call-complete">
    முடிவடைந்த ஒவ்வொரு அழைப்பையும் உங்கள் CRM / பகுப்பாய்வு பைப்லைனுக்கு ஸ்ட்ரீம் செய்யவும்.
  </Card>
  <Card title="AI மதிப்பீடு மற்றும் சிக்கல் அறிக்கைகள்" icon="chart-line" href="/api-reference/calls#ai-call-grading">
    ஒவ்வொரு அழைப்பையும் தானாக மதிப்பெண்களிடவும்; குறியிடப்பட்டவற்றை மதிப்பாய்விற்கு வழிமாற்றவும்.
  </Card>
</CardGroup>