ഔട്ട്‌ബൗണ്ട് കോളുകൾ നടത്തുക (API)

നിങ്ങളുടെ സ്വന്തം കോഡിൽ നിന്ന് AI നയിക്കുന്ന ഔട്ട്‌ബൗണ്ട് കോൾ ട്രിഗർ ചെയ്യുക — സർവേ, ഫോളോ-അപ്പ്, അല്ലെങ്കിൽ സ്ഥിരീകരണ ഫ്ലോകൾ.

ഔട്ട്‌ബൗണ്ട് കോളിംഗ് ഉപയോഗിച്ച് ലക്ഷ്യ നമ്പറും ഏജന്റ് കോൺഫിഗറേഷനും ThunderPhone-ന് നൽകി, നിങ്ങളുടെ പേരിൽ AI-യെക്കൊണ്ട് കോൾ ചെയ്യിക്കാം. സാധാരണ ഉപയോഗ സാഹചര്യങ്ങൾ:

• അപ്പോയിന്റ്മെന്റ് സ്ഥിരീകരണങ്ങൾ
• സർവേ കോൾബാക്കുകൾ
• മിസ്ഡ് കോളിന് ശേഷമുള്ള "രണ്ടാമത്തെ ശ്രമം" ഫോളോ-അപ്പുകൾ
• ഡിസ്പാച്ച് ശൈലിയിലുള്ള അറിയിപ്പുകൾ

മുൻവ്യവസ്ഥകൾ#

1. ഔട്ട്‌ബൗണ്ട് പ്രവർത്തനക്ഷമമായ ഒരു നമ്പർ തിരഞ്ഞെടുക്കുക

   നിങ്ങൾ സ്വന്തമാക്കിയ ഒരു നമ്പർ VoIP കണക്ഷൻ വഴി ഉപയോഗിക്കുക, അല്ലെങ്കിൽ Phone Numbers പേജിൽ നിന്ന് ഔട്ട്‌ബൗണ്ട് കോളുകൾക്കായി നിങ്ങളുടെ ThunderPhone നമ്പറുകൾ ഉപയോഗിക്കാൻ അനുമതി അഭ്യർഥിക്കുക. ThunderPhone നമ്പറുകൾ ആദ്യം ഇൻബൗണ്ടിന് മാത്രമുള്ളവയാണ്. ThunderPhone ഓരോ അഭ്യർഥനയും മാനുവലായി പരിശോധിക്കുന്നു; അംഗീകരിച്ചുകഴിഞ്ഞാൽ, ആ നമ്പറുകൾക്ക് അംഗീകരിച്ച പ്രതിദിന പരിധിവരെ (00:00 UTC-ൽ പുനഃക്രമീകരിക്കുന്നു) കോളുകൾ നടത്താനും ക്യാമ്പെയ്‌നുകൾ പ്രവർത്തിപ്പിക്കാനും കഴിയും, കൂടാതെ നിങ്ങൾക്ക് ഉയർന്ന പരിധി അഭ്യർഥിക്കാനും കഴിയും. ഉപഭോക്തൃ VoIP നമ്പറുകൾക്ക് പ്രതിദിന പരിധിയില്ല, അതിനാൽ ഔട്ട്‌ബൗണ്ട് കോളിംഗിന് അവ ശുപാർശ ചെയ്യുന്നു. കാണുക നിങ്ങളുടെ സ്വന്തം നമ്പറുകൾ കൊണ്ടുവരുക.

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 മടക്കിനൽകും. ഡാഷ്‌ബോർഡിലെ Organization → Billing Settings എന്നതിൽ ബാലൻസ് ടോപ്പ് അപ്പ് ചെയ്യുക അല്ലെങ്കിൽ ഓട്ടോ-റീലോഡ് പ്രവർത്തനക്ഷമമാക്കുക. നിങ്ങളുടെ sk_live_ കീക്ക് GET /v1/billing ഉപയോഗിച്ച് ബാലൻസ് പരിശോധിക്കാനാകും, പക്ഷേ ടോപ്പ് അപ്പ് ചെയ്യാനോ ഓട്ടോ-റീലോഡ് മാറ്റാനോ കഴിയില്ല.

സംരക്ഷിച്ച ഏജന്റ് ഉപയോഗിച്ച് കോൾ ചെയ്യുക#

ഏറ്റവും ലളിതമായ മാർഗം — 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":   "+14155552671",
    "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":   "+14155552671",
    "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 എന്നിവ ഉൾപ്പെടും.

കോളിന് ശേഷം ഘടനാപരമായ ഡാറ്റ എക്സ്ട്രാക്റ്റ് ചെയ്യാൻ നിങ്ങളുടെ ഏജന്റ് സജ്ജീകരിച്ചിട്ടുണ്ടെങ്കിൽ, ഫൈനലൈസേഷൻ പൂർത്തിയായ ശേഷം ആ ഡാറ്റ പ്രത്യേകം ഡെലിവർ ചെയ്യപ്പെടും.

സേവ് ചെയ്ത ഏജന്റിലേക്ക് ഓരോ കോളിനുമുള്ള വേരിയബിളുകൾ കൈമാറുക#

സേവ് ചെയ്ത ഏജന്റുകൾ prompt ടെക്സ്റ്റിൽ {{name}} അല്ലെങ്കിൽ {{name|there}} പോലുള്ള പ്ലേസ്‌ഹോൾഡറുകൾ ഉപയോഗിക്കാം. agent_id ഉപയോഗിച്ച് ഔട്ട്ബൗണ്ട് കോൾ ചെയ്യുമ്പോൾ, ആ കോളിന്റെ മൂല്യങ്ങളുള്ള variables കൈമാറുക:

{
  "from_number": "+[REDACTED_PHONE]",
  "to_number": "+[REDACTED_PHONE]",
  "agent_id": 12,
  "variables": {
    "name": "Jordan"
  }
}

പ്ലേസ്‌ഹോൾഡർ പേരുകൾ കീകളായുള്ള സ്ട്രിംഗ് മൂല്യങ്ങൾ ഉപയോഗിക്കുക. ഈ വേരിയബിളുകൾ സേവ് ചെയ്ത ഏജന്റുകൾക്കാണ് ബാധകം; ഈ ഗൈഡിലെ ഇൻലൈൻ config ഉദാഹരണം അവ ഉപയോഗിക്കുന്നില്ല.

കൈകാര്യം ചെയ്യേണ്ട പരാജയ മോഡുകൾ#

പൂർണ്ണമായ സ്ഥിരതയുള്ള എലിജിബിലിറ്റി-കോഡ് ലിസ്റ്റിനും രണ്ട് 409 പ്രതികരണ രൂപങ്ങൾക്കും ഔട്ട്ബൗണ്ട് കോളുകൾ റഫറൻസ് കാണുക. റിക്വസ്റ്റ് സ്വീകരിച്ച ശേഷവും കോൾ ചെയ്യുന്നതിനുമുമ്പും ഒരു സജീവ നമ്പർ അയോഗ്യമാകുകയാണെങ്കിൽ, അന്തിമ പരിശോധന വീണ്ടും ശ്രമിക്കാനാകാത്ത 409 പേലോഡ് നൽകും.

ഹോൾഡ് സമയം നിയന്ത്രിക്കുക#

വിളിക്കപ്പെടുന്നയാൾ പ്രതികരിക്കാൻ വൈകുന്നതിനാൽ ദൈർഘ്യമേറിയ ഔട്ട്ബൗണ്ട് കോളുകൾക്ക് (IVR ട്രീകൾ, ക്യൂകൾ) max_hold_seconds ഉപയോഗിച്ച് പരിധി നിശ്ചയിക്കാം:

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

കഴിഞ്ഞ N സെക്കൻഡിനുള്ളിൽ മനുഷ്യ ശബ്ദം ലഭിച്ചിട്ടില്ലെങ്കിൽ ഏജന്റ് കോൾ വിച്ഛേദിക്കും. സ്ഥിരസ്ഥിതി 900 സെക്കൻഡ് (15 മിനിറ്റ്) ആണ്.

അടുത്ത ഘട്ടങ്ങൾ#