உள்வரும் அழைப்புகளைக் கையாளுங்கள் (API)

உங்கள் டெர்மினலிலிருந்து, “AI மூலம் தொலைபேசி அழைப்பிற்குப் பதிலளி” என்பதற்கான நிலையான செயல்முறை. நீங்கள் செய்ய வேண்டியது:

1. prompt மற்றும் குரலுடன் ஒரு ஏஜென்ட்டை உருவாக்குங்கள்.
2. ஒரு தொலைபேசி எண்ணை ஒதுக்குங்கள் (அல்லது உங்களுடையதைப் பயன்படுத்துங்கள்) மற்றும் அதன் உள்வரும் கையாளியாக ஏஜென்ட்டை ஒதுக்குங்கள்.
3. எண்ணை அழையுங்கள். அழைப்பு பதிவு, உரைநகல் மற்றும் பதிவைக் கவனியுங்கள்.

மொத்த API அழைப்புகள்: நான்கு. மொத்த நேரம்: ஐந்து நிமிடங்களுக்குள்.

1. ஏஜென்ட்டை உருவாக்குங்கள்

ஒரு ஏஜென்ட், அழைப்பை இயக்கும் 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":    "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-இல் அது தேவைப்படும்.

2. தொலைபேசி எண்ணைப் பெறுங்கள்

அழைப்பதற்காக ஏதாவது ஒரு எண் மட்டுமே தேவைப்பட்டால், ThunderPhone-இன் தொகுப்பிலிருந்து ஒரு டெமோ எண்ணை ஒதுக்குங்கள்:

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 இருக்கும். டெமோ எண்கள் status="provisioning" நிலையில் தொடங்கி சில வினாடிகளுக்குள் active ஆகும் — தேவைப்பட்டால் மாற்றத்தைக் காண GET /v1/phone-numbers/{id} ஐ இடைவேளைகளில் அழைக்கவும்.

3. ஏஜென்ட்டை ஒதுக்குங்கள்

படி 1-இல் உள்ள ஏஜென்ட்டை எண்ணின் உள்வரும் திசையுடன் இணைக்கவும்:

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-இல் status="in_progress" உடன் தோன்றும். அழைப்பு முடிந்ததும், பதிவில் end_reason, duration_seconds, billable_minutes, மற்றும் (இறுதியில்) ஒரு பதிவு URL மற்றும் AI மதிப்பீடு புதுப்பிக்கப்படும்.

5. முடிவுகளை ஆய்வு செய்யுங்கள்

சமீபத்திய அழைப்புகளின் பட்டியலைப் பெறுங்கள்:

curl 'https://api.thunderphone.com/v1/calls?limit=5' \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

உரைநகலைப் பெறுங்கள்:

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

மேலும் பதிவின் URL-ஐப் பெறுங்கள் (குறுகிய காலத்திற்கு மட்டுமே செல்லுபடியாகும், கையொப்பமிடப்பட்டது):

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

நீங்கள் telephony.complete வெப்ஹுக்கிற்கு சந்தா செய்திருந்தால், அதே தரவை உங்கள் சர்வருக்கு POST ஆகப் பெறுவீர்கள் — call.complete-ஐப் பார்க்கவும்.

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