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

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

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

முன்தேவைகள்

1. ஒரு VoIP எண்ணை வழங்குங்கள்

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

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

   வெளிச்செல்லும் அழைப்புக்கான prompt பொதுவாக ஏஜென்ட் தன்னையும் அதன் நோக்கத்தையும் அறிமுகப்படுத்துவதில் தொடங்கும் — "வணக்கம், நாளை மாலை 3 மணிக்கான உங்கள் சந்திப்பை உறுதிப்படுத்த Acme-லிருந்து அழைக்கிறேன்…" 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 வெப்ஹுக் பதில் ஸ்கீமாவுடன் பொருந்தும்:

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 வெப்ஹுக்-க்கு சந்தா பெறுங்கள் — அழைப்பு முடிந்ததை அறிய இது மிக விரைவான வழி. உள்வரும் வெப்ஹுக்குகளை ஏற்க முடியாவிட்டால், ஒவ்வொரு சில வினாடிகளுக்கும் 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 நிமிடங்கள்).

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