Open in
விரைவுத் தொடக்கம் (API)
AI ஏஜென்டுடன் உங்கள் முதல் தொலைபேசி அழைப்பிற்குப் பதிலளிக்கவும்: API விசையைப் பெறுங்கள், ஏஜென்டை உருவாக்குங்கள், ஒரு தொலைபேசி எண்ணை ஒதுக்குங்கள், நேரடி சோதனை அழைப்பை மேற்கொள்ளுங்கள் — அனைத்தும் REST API மூலம்.
இந்த வழிகாட்டி, AI ஏஜென்ட் மூலம் உங்கள் முதல் தொலைபேசி அழைப்பிற்குப் பதிலளிக்கத் தேவையான நான்கு REST அழைப்புகளை உங்களுக்கு விளக்குகிறது.
படி 1: API விசையைப் பெறுக
- உள்நுழைக
app.thunderphone.com ஐத் திறக்கவும்.
- விசைகளுக்குச் செல்லவும்
டாஷ்போர்டில் நிறுவனம் → விசைகள் என்பதற்குச் செல்லவும்.
- விசையை உருவாக்கவும்
விசையை உருவாக்கு என்பதைக் கிளிக் செய்து, அதற்குப் பெயரிட்டு,
sk_live_...மதிப்பை நகலெடுக்கவும். மூல விசை ஒருமுறை மட்டுமே காட்டப்படும் — அதை உடனடியாக உங்கள் ரகசிய மேலாளரில் சேமிக்கவும்.
இந்த வழிகாட்டி முழுவதும், sk_live_YOUR_API_KEY என்பதற்குப் பதிலாக நீங்கள்
இப்போது நகலெடுத்த மதிப்பைப் பயன்படுத்தவும். விசை உங்கள் நிறுவனத்தைத் தானாக அடையாளம் காணும்;
எனவே URL-களில் நிறுவன ID-யை ஒருபோதும் சேர்க்க வேண்டியதில்லை.
படி 2: ஏஜென்டை உருவாக்குக
AI உரையாடல்களைக் கையாளும் விதத்தை ஏஜென்ட் வரையறுக்கிறது — prompt, குரல், தயாரிப்பு நிலை, கருவிகள் மற்றும் விட்ஜெட் தகுதி.
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"
}'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"])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 இணைப்புகளை பார்க்கவும்.)
# 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}'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"அடுத்த படிகள்
உரையாடலின்போது உங்கள் ஏஜென்ட் உங்கள் API-களை அழைக்க அனுமதிக்கவும்.
உங்கள் சொந்த குறியீட்டிலிருந்து அழைப்புகளைத் தொடங்கவும்.
அழைப்பு நிகழ்வுகளுக்கு நிகழ்நேரத்தில் பதிலளிக்கவும்.
ஒவ்வொரு பொதுவான endpoint-உம் ஆவணப்படுத்தப்பட்டுள்ளது.