ആരംഭിക്കാം

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

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

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

  1. ഒരു VoIP നമ്പർ കൊണ്ടുവരുക

    ഔട്ട്ബൗണ്ട് കോളിംഗിന് നിങ്ങൾ from_number ഒരു VoIP കണക്ഷൻ വഴി സ്വന്തമാക്കിയിരിക്കണം. ഡെമോ നമ്പറുകൾ ഇൻബൗണ്ടിന് മാത്രമുള്ളതാണ്. കാണുക നിങ്ങളുടെ സ്വന്തം നമ്പറുകൾ കൊണ്ടുവരുക.

  2. ഒരു ഏജന്റ് സൃഷ്ടിക്കുക

    ഔട്ട്ബൗണ്ടിനായുള്ള prompt സാധാരണയായി ഏജന്റ് സ്വയം പരിചയപ്പെടുത്തിയും അതിന്റെ ഉദ്ദേശ്യം വ്യക്തമാക്കിയും തുടങ്ങുന്നതാണ് — "നമസ്കാരം, നാളത്തെ 3pm-നുള്ള നിങ്ങളുടെ അപ്പോയിന്റ്മെന്റ് സ്ഥിരീകരിക്കാൻ 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 എന്നിവ ഉൾപ്പെടും.

കൈകാര്യം ചെയ്യേണ്ട പരാജയ രീതികൾ

പിശക്പരിഹാരം
402 Payment Requiredബാലൻസ് ടോപ്പ് അപ്പ് ചെയ്യുക അല്ലെങ്കിൽ ഓട്ടോ-റീലോഡ് പ്രവർത്തനക്ഷമമാക്കുക
403 ഔട്ട്ബൗണ്ട് തടഞ്ഞു (ഡെമോ നമ്പർ)പകരം ഒരു VoIP നമ്പർ കൊണ്ടുവരുക
403 ഔട്ട്ബൗണ്ട് തടഞ്ഞു (സ്ഥിരീകരിക്കാത്ത VoIP)POST /v1/phone-numbers/{id}/verify-voip പ്രവർത്തിപ്പിക്കുക
404 from_number is not registered to this organizationfrom_number നിങ്ങൾ സ്വന്തമാക്കിയ ഫോൺ നമ്പറുമായി പൊരുത്തപ്പെടുന്നുവെന്ന് സ്ഥിരീകരിക്കുക
502 Bad Gatewayതാൽക്കാലിക SIP / LiveKit പരാജയം; വീണ്ടും ശ്രമിക്കുന്നത് സുരക്ഷിതമാണ്

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

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

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

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

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

ഔട്ട്ബൗണ്ട് കോളുകൾ റഫറൻസ്

എല്ലാ റിക്വസ്റ്റ് ഫീൽഡുകളും എറർ കോഡുകളും.

call.complete സ്വീകരിക്കുക

പൂർത്തിയായ ഔട്ട്ബൗണ്ട് കോളുകൾ നിങ്ങളുടെ സിസ്റ്റത്തിലേക്ക് സ്ട്രീം ചെയ്യുക.

ബില്ലിംഗ്

ബാലൻസ് കാരണം ഔട്ട്ബൗണ്ട് ഒരിക്കലും പരാജയപ്പെടാതിരിക്കാൻ ഓട്ടോ-റീലോഡ്.

ഔട്ട്ബൗണ്ട് ഏജന്റുമാരെ പരിശോധിക്കുക

പ്രൊഡക്ഷന് മുമ്പ് നിങ്ങളുടെ ഔട്ട്ബൗണ്ട് ഏജന്റ് ഡ്രൈ-റൺ ചെയ്യുക.