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

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 ஐப் பார்க்கவும்.

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