ThunderPhone 2.0 அறிமுகமாகிவிட்டது.நீங்களே தொடங்கலாம்; நிமிடத்திற்கு 2¢ முதல்.அறிவிப்பைப் படிக்கவும்

Getting Started

விரைவுத் தொடக்கம் (API)

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

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

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

  1. உள்நுழைக

    app.thunderphone.com ஐத் திறக்கவும்.

  2. விசைகளுக்குச் செல்லவும்

    டாஷ்போர்டில் நிறுவனம் → விசைகள் என்பதற்குச் செல்லவும்.

  3. விசையை உருவாக்கவும்

    விசையை உருவாக்கு என்பதைக் கிளிக் செய்து, அதற்குப் பெயரிட்டு, sk_live_... மதிப்பை நகலெடுக்கவும். மூல விசை ஒருமுறை மட்டுமே காட்டப்படும் — அதை உடனடியாக உங்கள் ரகசிய மேலாளரில் சேமிக்கவும்.

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

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

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

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
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"])
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);

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

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

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
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"])

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

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

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

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 மேலோட்டம் பார்க்கவும்).

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

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

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

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

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

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"

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