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

இந்த வழிகாட்டி, AI ஏஜென்ட் மூலம் உங்கள் முதல் தொலைபேசி அழைப்பிற்குப் பதிலளிக்கத் தேவையான நான்கு REST அழைப்புகளை உங்களுக்கு விளக்குகிறது.

<Info>
  உங்களுக்கு ஒரு [ThunderPhone கணக்கு](https://app.thunderphone.com) தேவைப்படும்.
  பதிவு செய்வது இலவசம்; ஒரு நிமிடத்திற்கும் குறைவாகவே ஆகும். curl கட்டளையை இயக்குவதற்குப் பதிலாகக் கிளிக் செய்ய விரும்புகிறீர்களா?
  [டாஷ்போர்டு விரைவுத் தொடக்கம்](/ta/quickstart-dashboard), எந்தக் குறியீடும் எழுதாமல் அதே
  முதல் அழைப்பை அடைய உதவுகிறது.
</Info>

## படி 1: API விசையைப் பெறுக

<Steps>
  <Step title="உள்நுழைக">
    [app.thunderphone.com](https://app.thunderphone.com) ஐத் திறக்கவும்.
  </Step>
  <Step title="விசைகளுக்குச் செல்லவும்">
    டாஷ்போர்டில் **நிறுவனம் → விசைகள்** என்பதற்குச் செல்லவும்.
  </Step>
  <Step title="விசையை உருவாக்கவும்">
    **விசையை உருவாக்கு** என்பதைக் கிளிக் செய்து, அதற்குப் பெயரிட்டு,
    `sk_live_...` மதிப்பை நகலெடுக்கவும். மூல விசை **ஒருமுறை மட்டுமே** காட்டப்படும் — அதை
    உடனடியாக உங்கள் ரகசிய மேலாளரில் சேமிக்கவும்.
  </Step>
</Steps>

<Tip>
  சிக்கியுள்ளீர்களா? [சர்வர் API விசையை உருவாக்குக](/ta/guides/api-keys) இந்த
  செயல்முறையைப் படிப்படியாக விரிவாக விளக்குகிறது; மேலும் பயன்பாட்டுக்குள் உள்ள கோபைலட்
  ஒவ்வொரு கட்டுப்பாட்டையும் நேரடியாக உங்களுக்குக் காட்டும்.
</Tip>

இந்த வழிகாட்டி முழுவதும், `sk_live_YOUR_API_KEY` என்பதற்குப் பதிலாக நீங்கள்
இப்போது நகலெடுத்த மதிப்பைப் பயன்படுத்தவும். விசை உங்கள் நிறுவனத்தைத் தானாக அடையாளம் காணும்;
எனவே URL-களில் நிறுவன ID-யை ஒருபோதும் சேர்க்க வேண்டியதில்லை.

## படி 2: ஏஜென்டை உருவாக்குக

AI உரையாடல்களைக் கையாளும் விதத்தை ஏஜென்ட் வரையறுக்கிறது — prompt, குரல்,
தயாரிப்பு நிலை, கருவிகள் மற்றும் விட்ஜெட் தகுதி.

<CodeGroup>
```bash cURL
curl -X POST https://api.thunderphone.com/v1/agents \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name":   "Customer Support",
    "prompt": "You are a friendly support agent for Acme Corp. Help with orders, returns, and product info. Be concise and helpful.",
    "voice":  "john",
    "product": "spark"
  }'
```

```python Python
import os, requests

agent = requests.post(
    "https://api.thunderphone.com/v1/agents",
    headers={"Authorization": f"Bearer {os.environ['THUNDERPHONE_API_KEY']}"},
    json={
        "name":   "Customer Support",
        "prompt": "You are a friendly support agent for Acme Corp. Help with orders, returns, and product info. Be concise and helpful.",
        "voice":  "john",
        "product": "spark",
    },
).json()
print("Agent id:", agent["id"])
```

```javascript Node.js
const agent = await fetch("https://api.thunderphone.com/v1/agents", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.THUNDERPHONE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    name:    "Customer Support",
    prompt:  "You are a friendly support agent for Acme Corp. Help with orders, returns, and product info. Be concise and helpful.",
    voice:   "john",
    product: "spark",
  }),
}).then((r) => r.json());
console.log("Agent id:", agent.id);
```
</CodeGroup>

<Tip>
  தயாரிப்பு நிலைகள்: `spark` செலவுக்காக உகந்ததாக்கப்பட்டது, `bolt` வேகத்திற்காக, மற்றும்
  சிக்கலான prompt-களில் நுண்ணறிவுக்காக `storm-base` / `storm-extra`. முழுமையான
  ஒப்பீட்டிற்கு [ஏஜென்ட்கள்](/api-reference/agents#product-tiers-at-a-glance) பக்கத்தைப் பார்க்கவும்.
</Tip>

## படி 3: ஒரு தொலைபேசி எண்ணை வழங்கவும்

இந்த அழைப்பு ThunderPhone-இடம் ஒரு எண்ணைக் கோரி, உங்கள் புதிய
ஏஜென்டை உள்வரும் அழைப்புக் கையாளராக ஒதுக்குகிறது. (VoIP
வழங்குநரிடமிருந்து உங்கள் சொந்த எண்ணைக் கொண்டுவர, அதற்குப் பதிலாக
[VoIP இணைப்புகளை](/api-reference/voip-connections) பார்க்கவும்.)

<CodeGroup>
```bash cURL
# First provision
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"}'

# Then assign the agent you created in Step 2
curl -X PATCH https://api.thunderphone.com/v1/phone-numbers/<id-from-previous> \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"inbound_agent_id": 12}'
```

```python Python
number = requests.post(
    "https://api.thunderphone.com/v1/phone-numbers",
    headers={"Authorization": f"Bearer {os.environ['THUNDERPHONE_API_KEY']}"},
    json={"area_code": "415"},
).json()
requests.patch(
    f"https://api.thunderphone.com/v1/phone-numbers/{number['id']}",
    headers={"Authorization": f"Bearer {os.environ['THUNDERPHONE_API_KEY']}"},
    json={"inbound_agent_id": agent["id"]},
)
print("Your ThunderPhone number:", number["number"])
```
</CodeGroup>

உங்கள் புதிய எண் `status="provisioning"` நிலையிலிருந்து தொடங்கி, சில
வினாடிகளில் `active` நிலைக்கு மாறும்; நீங்கள் உலாவியை மூடும் நேரத்தில்
அந்த எண் அழைப்புகளை ஏற்கத் தயாராக இருக்கும்.

## படி 4 (விருப்பத்தேர்வு): ஒரு webhook-ஐ அமைக்கவும்

நிகழ்நேர நிகழ்வுகளுக்கு (மாறும் அழைப்பு வழிமாற்றம், அழைப்புக்குப் பிந்தைய செயலாக்கம்)
ஒரு webhook endpoint-ஐச் சேர்க்கவும். உங்களுக்குத் தேவையான நிகழ்வுகளுக்கு மட்டும்
சந்தா செலுத்தவும்.

```bash
curl -X POST https://api.thunderphone.com/v1/developer/webhook-endpoints \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "label":  "Prod webhook",
    "url":    "https://your-server.com/thunderphone-webhook",
    "events": ["telephony.incoming", "telephony.complete"]
  }'
```

பதிலில் ஒருமுறை மட்டுமே கிடைக்கும் `secret` இருக்கும் — அதை உங்கள் ரகசிய
மேலாளருக்கு நகலெடுக்கவும். உள்வரும் கோரிக்கைகளில் உள்ள
`X-ThunderPhone-Signature` header-ஐச் சரிபார்க்க அந்த ரகசியத்தைப் பயன்படுத்தவும்
([Webhooks மேலோட்டம்](/ta/webhooks/overview) பார்க்கவும்).

## படி 5: உங்கள் ஏஜென்டைச் சோதிக்கவும்

நீங்கள் இப்போது வழங்கிய எண்ணை அழைக்கவும். ஏஜென்ட் அழைப்பை ஏற்று, தன்னை
அறிமுகப்படுத்தி, உங்கள் prompt-ஐப் பின்பற்றும்.

அழைப்பு முடிந்த பிறகு அதைச் சரிபார்க்கவும்:

```bash
curl https://api.thunderphone.com/v1/calls \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

உரையாடல் பதிவையும் பதிவு URL-ஐயும் பெற, குறிப்பிட்ட அழைப்பின் விவரங்களுக்குச் செல்லவும்:

```bash
curl https://api.thunderphone.com/v1/calls/{call_id}/transcript \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
curl https://api.thunderphone.com/v1/calls/{call_id}/audio \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

---

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

<CardGroup cols={2}>
  <Card title="செயல்பாட்டு கருவிகளைச் சேர்க்கவும்" icon="screwdriver-wrench" href="/ta/tools/overview">
    உரையாடலின்போது உங்கள் ஏஜென்ட் உங்கள் API-களை அழைக்க அனுமதிக்கவும்.
  </Card>
  <Card title="வெளிச்செல்லும் அழைப்புகளை மேற்கொள்ளவும்" icon="arrow-up-right" href="/api-reference/outbound-calls">
    உங்கள் சொந்த குறியீட்டிலிருந்து அழைப்புகளைத் தொடங்கவும்.
  </Card>
  <Card title="webhook-களைக் கையாளவும்" icon="bolt" href="/ta/webhooks/overview">
    அழைப்பு நிகழ்வுகளுக்கு நிகழ்நேரத்தில் பதிலளிக்கவும்.
  </Card>
  <Card title="முழுமையான API குறிப்பு" icon="book" href="/api-reference/introduction">
    ஒவ்வொரு பொதுவான endpoint-உம் ஆவணப்படுத்தப்பட்டுள்ளது.
  </Card>
</CardGroup>