வெளிச்செல்லும் அழைப்புகளை மேற்கொள்ளுங்கள் (API)

உங்கள் சொந்த குறியீட்டிலிருந்து AI இயக்கும் வெளிச்செல்லும் அழைப்பைத் தொடங்குங்கள் — கருத்துக்கணிப்பு, தொடர்நடவடிக்கை அல்லது உறுதிப்படுத்தல் ஓட்டங்களுக்காக.

வெளிச்செல்லும் அழைப்பு மூலம், இலக்கு எண்ணையும் ஏஜென்ட் கட்டமைப்பையும் ThunderPhone-க்கு வழங்கி, உங்கள் சார்பாக AI அழைப்பை மேற்கொள்ளச் செய்யலாம். பொதுவான பயன்பாடுகள்:

• சந்திப்பு உறுதிப்படுத்தல்கள்
• கணக்கெடுப்பு மறுஅழைப்புகள்
• தவறவிட்ட அழைப்புக்குப் பிறகான "இரண்டாவது முயற்சி" தொடர்தொடர்புகள்
• அனுப்பீட்டு வகை அறிவிப்புகள்

முன்நிபந்தனைகள்#

1. ஒரு VoIP எண்ணைக் கொண்டு வாருங்கள்

   வெளிச்செல்லும் அழைப்புக்கு, from_number எண்ணை நீங்கள் VoIP இணைப்பு மூலம் சொந்தமாகக் கொண்டிருக்க வேண்டும். ThunderPhone எண்கள் உள்வரும் அழைப்புகளுக்கு மட்டும். உங்கள் சொந்த எண்களைக் கொண்டு வாருங்கள் என்பதைப் பார்க்கவும்.

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

   வெளிச்செல்லும் அழைப்புக்கு ஏற்ற prompt-ல், ஏஜென்ட் தன்னையும் அதன் நோக்கத்தையும் அறிமுகப்படுத்துவதுடன் தொடங்குவது வழக்கம் — "Hi, this is Acme calling to confirm your appointment for tomorrow at 3pm…" outbound_speak_order-ஐ agent_first ஆக அமைக்கவும் (இயல்புநிலை).

3. நேர்மறை இருப்பை வைத்திருங்கள்

   இருப்பு ≤ $0.00 ஆக இருந்தால், வெளிச்செல்லும் அழைப்புகள் 402 Payment Required ஐ வழங்கும். இதன் மூலம் இருப்பை நிரப்பவும்: POST /v1/billing/top-up அல்லது தானியங்கி மீள்நிரப்பலை இயக்கவும்.

சேமித்த ஏஜென்ட்டுடன் அழைப்பை மேற்கொள்ளுங்கள்#

எளிய வழி — id மூலம் ஏஜென்ட்டைக் குறிப்பிடுங்கள்:

curl -X POST https://api.thunderphone.com/v1/call \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from_number": "+15551234567",
    "to_number":   "+14155550199",
    "agent_id":    12
  }'

பதில்:

{ "call_id": 987654321, "status": "initiated" }

இன்லைன் கட்டமைப்புடன் அழைப்பை மேற்கொள்ளுங்கள்#

ஏஜென்ட்டாகச் சேமிக்கத் தேவையில்லாத ஒருமுறை prompt வேண்டுமெனில், அதற்குப் பதிலாக config-ஐ அனுப்பவும். இதன் வடிவம் call.incoming webhook-இன் பதில் ஸ்கீமாவுடன் பொருந்தும்:

curl -X POST https://api.thunderphone.com/v1/call \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from_number": "+15551234567",
    "to_number":   "+14155550199",
    "config": {
      "prompt":  "You are confirming Jane Doe appointment for 3pm tomorrow…",
      "voice":   "john",
      "product": "spark"
    }
  }'

அழைப்பைப் பின்தொடருங்கள்#

இதற்கு இணையாக, telephony.complete webhook-க்கு சந்தா செலுத்துங்கள் — அழைப்பு முடிந்ததை அறிய இதுவே மிக வேகமான வழி. உள்வரும் webhooks-ஐ ஏற்க முடியாவிட்டால், சில விநாடிகளுக்கு ஒருமுறை GET /v1/calls/{call_id}-ஐ கண்காணிக்கவும்; அழைப்பு முடிந்ததும் பதிவில் end_reason, duration_seconds, மற்றும் பதிவின் URL இடம்பெறும்.

கையாள வேண்டிய தோல்வி நிலைகள்#

ஹோல்ட் நேரத்தைக் கட்டுப்படுத்துதல்#

அழைப்பைப் பெறுபவர் பதிலளிக்க தாமதிப்பதால் நீளமாகும் வெளிச்செல்லும் அழைப்புகளை (IVR மரங்கள், வரிசைகள்) max_hold_seconds மூலம் வரம்பிடலாம்:

{
  "from_number": "+15551234567",
  "to_number":   "+14155550199",
  "agent_id":    12,
  "max_hold_seconds": 120
}

கடந்த N விநாடிகளில் மனித குரல் எதுவும் பெறப்படவில்லை என்றால் ஏஜென்ட் அழைப்பைத் துண்டிக்கும். இயல்புநிலை 900 (15 நிமிடங்கள்).

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