Open in
ഔട്ട്ബൗണ്ട് കോളുകൾ നടത്തുക (API)
നിങ്ങളുടെ സ്വന്തം കോഡിൽ നിന്ന് AI നയിക്കുന്ന ഔട്ട്ബൗണ്ട് കോൾ ട്രിഗർ ചെയ്യുക — സർവേ, ഫോളോ-അപ്പ്, അല്ലെങ്കിൽ സ്ഥിരീകരണ ഫ്ലോകൾ.
ഔട്ട്ബൗണ്ട് കോളിംഗ് ഉപയോഗിച്ച് ലക്ഷ്യ നമ്പറും ഏജന്റ് കോൺഫിഗറേഷനും ThunderPhone-ന് നൽകി, നിങ്ങളുടെ പേരിൽ AI-യെക്കൊണ്ട് കോൾ ചെയ്യിക്കാം. സാധാരണ ഉപയോഗ സാഹചര്യങ്ങൾ:
- അപ്പോയിന്റ്മെന്റ് സ്ഥിരീകരണങ്ങൾ
- സർവേ കോൾബാക്കുകൾ
- മിസ്ഡ് കോളിന് ശേഷമുള്ള "രണ്ടാമത്തെ ശ്രമം" ഫോളോ-അപ്പുകൾ
- ഡിസ്പാച്ച് ശൈലിയിലുള്ള അറിയിപ്പുകൾ
മുൻവ്യവസ്ഥകൾ
- ഔട്ട്ബൗണ്ട് പ്രവർത്തനക്ഷമമായ ഒരു നമ്പർ തിരഞ്ഞെടുക്കുക
നിങ്ങൾ സ്വന്തമാക്കിയ ഒരു നമ്പർ VoIP കണക്ഷൻ വഴി ഉപയോഗിക്കുക, അല്ലെങ്കിൽ Phone Numbers പേജിൽ നിന്ന് ഔട്ട്ബൗണ്ട് കോളുകൾക്കായി നിങ്ങളുടെ ThunderPhone നമ്പറുകൾ ഉപയോഗിക്കാൻ അനുമതി അഭ്യർഥിക്കുക. ThunderPhone നമ്പറുകൾ ആദ്യം ഇൻബൗണ്ടിന് മാത്രമുള്ളവയാണ്. ThunderPhone ഓരോ അഭ്യർഥനയും മാനുവലായി പരിശോധിക്കുന്നു; അംഗീകരിച്ചുകഴിഞ്ഞാൽ, ആ നമ്പറുകൾക്ക് അംഗീകരിച്ച പ്രതിദിന പരിധിവരെ (00:00 UTC-ൽ പുനഃക്രമീകരിക്കുന്നു) കോളുകൾ നടത്താനും ക്യാമ്പെയ്നുകൾ പ്രവർത്തിപ്പിക്കാനും കഴിയും, കൂടാതെ നിങ്ങൾക്ക് ഉയർന്ന പരിധി അഭ്യർഥിക്കാനും കഴിയും. ഉപഭോക്തൃ VoIP നമ്പറുകൾക്ക് പ്രതിദിന പരിധിയില്ല, അതിനാൽ ഔട്ട്ബൗണ്ട് കോളിംഗിന് അവ ശുപാർശ ചെയ്യുന്നു. കാണുക നിങ്ങളുടെ സ്വന്തം നമ്പറുകൾ കൊണ്ടുവരുക.
- ഒരു ഏജന്റ് സൃഷ്ടിക്കുക
ഔട്ട്ബൗണ്ട് സ്വഭാവമുള്ള ഒരു prompt സാധാരണയായി ഏജന്റ് സ്വയം പരിചയപ്പെടുത്തിയും അതിന്റെ ഉദ്ദേശ്യം വ്യക്തമാക്കിയും തുടങ്ങുന്നു — "Hi, this is Acme calling to confirm your appointment for tomorrow at 3pm…"
outbound_speak_orderagent_firstആയി സജ്ജമാക്കുക (സ്ഥിരസ്ഥിതി). - പോസിറ്റീവ് ബാലൻസ് നിലനിർത്തുക
ബാലൻസ് ≤
$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"
}
}'അവസാന നിശ്ശബ്ദത ചെക്ക്-ഇന്നിന് ശേഷം എന്ത് സംഭവിക്കണമെന്ന് നിയന്ത്രിക്കുക
സേവ് ചെയ്ത ഏജന്റുകൾ ഉപയോഗിക്കുന്ന അതേ നിശ്ശബ്ദത അന്തിമ-പ്രവർത്തന ക്രമീകരണങ്ങൾ ഇൻലൈൻ config-ലും നിങ്ങൾക്ക് നൽകാം:
{
"from_number": "+[REDACTED_PHONE]",
"to_number": "+[REDACTED_PHONE]",
"config": {
"silence_final_action": "hang_up"
}
}അവസാന നിശ്ശബ്ദത ചെക്ക്-ഇന്നിന് ശേഷം എന്ത് സംഭവിക്കണമെന്ന് തിരഞ്ഞെടുക്കാൻ silence_final_action ഉപയോഗിക്കുക. നിങ്ങൾക്ക് silence_final_message നൽകാനും കഴിയും; അന്തിമ പ്രവർത്തനം ട്രാൻസ്ഫർ ആണെങ്കിൽ, silence_transfer_destination-ഉം നൽകാം.
ഇൻലൈൻ config-ലേക്ക് ഒരു വാക്കുകളുടെ പട്ടിക ചേർക്കുക
ഇൻലൈൻ ഔട്ട്ബൗണ്ട് കോളുകളിൽ സേവ് ചെയ്ത ഏജന്റുകളുടേതിന് സമാനമായ words പട്ടിക ഉൾപ്പെടുത്താം.
ആദ്യം ഒരു ഏജന്റിനെ സേവ് ചെയ്യാതെ തന്നെ, കോൾ ഇഷ്ടാനുസൃത ഉച്ചാരണം അല്ലെങ്കിൽ കേൾവി
നിയമങ്ങൾ പാലിക്കണമെന്ന് നിങ്ങൾ ആഗ്രഹിക്കുമ്പോൾ ഇത് ഉപയോഗിക്കുക.
{
"from_number": "+[REDACTED_PHONE]",
"to_number": "+[REDACTED_PHONE]",
"config": {
"prompt": "[REDACTED_LITERAL]",
"voice": "john",
"product": "spark",
"words": []
}
}കോൾ പിന്തുടരുക
queued_at സമയമുള്ള ഒരു പ്രതികരണം ThunderPhone-ന്റെ ഔട്ട്ബൗണ്ട് ശേഷി ഉപയോഗത്തിലാണെന്ന് സൂചിപ്പിക്കുന്നു: ലഭ്യമായപ്പോൾ കോൾ 10 മിനിറ്റിനുള്ളിൽ ഡയൽ ചെയ്യും; ശേഷി ലഭ്യമല്ലെങ്കിൽ end_reason outbound_queue_timeout ഉപയോഗിച്ച് കോൾ അവസാനിക്കും. നിങ്ങൾ വീണ്ടും ശ്രമിക്കേണ്ടതില്ല. ക്യൂവിലുള്ള കോളുകൾ കാണുക.
അതേസമയം, ഒരു കോൾ അവസാനിച്ചതായി അറിയാനുള്ള ഏറ്റവും വേഗമേറിയ മാർഗമായ
telephony.complete വെബ്ഹുക്കിലേക്ക് സബ്സ്ക്രൈബ് ചെയ്യുക —
തത്സമയ പുരോഗതി അപ്ഡേറ്റുകൾക്കായി
call.status_changed-ലേക്കും സബ്സ്ക്രൈബ് ചെയ്യാം; ഡയൽ ചെയ്യൽ, ഉത്തരം ലഭിച്ചത്, വോയ്സ്മെയിൽ, ഹോൾഡ് മാറ്റങ്ങൾ എന്നിവ ഇതിൽ ഉൾപ്പെടും.
നിങ്ങൾക്ക് ഇൻബൗണ്ട് വെബ്ഹുക്കുകൾ സ്വീകരിക്കാൻ കഴിയുന്നില്ലെങ്കിൽ, ഓരോ
ഏതാനും സെക്കൻഡിലും 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 ഉദാഹരണം അവ ഉപയോഗിക്കുന്നില്ല.
കൈകാര്യം ചെയ്യേണ്ട പരാജയ മോഡുകൾ
| പിശക് | പരിഹാരം |
|---|---|
402 Payment Required | ബാലൻസ് ടോപ്പ് അപ്പ് ചെയ്യുക അല്ലെങ്കിൽ ഓട്ടോ-റീലോഡ് പ്രവർത്തനക്ഷമമാക്കുക |
400, code: destination_not_allowed സഹിതം | ThunderPhone ആ നമ്പറിലേക്ക് വിളിക്കില്ല: അസാധുവായ നമ്പറുകൾ, എമർജൻസി നമ്പറുകൾ, പ്രീമിയം-റേറ്റ് നമ്പറുകൾ, ഷോർട്ട് കോഡുകൾ, ഉപരോധമുള്ള രാജ്യങ്ങൾ, അല്ലെങ്കിൽ ഔട്ട്ബൗണ്ട് കോളിംഗിനായി നിങ്ങളുടെ സ്ഥാപനം തടഞ്ഞിട്ടുള്ള ഒരു US സംസ്ഥാനം. ThunderPhone നമ്പറുകളിൽ നിന്ന്, സാധാരണ US, കനേഡിയൻ നമ്പറുകൾ അനുവദനീയമാണ്; ചില അന്തർദേശീയ ലക്ഷ്യസ്ഥാനങ്ങളും അനുവദനീയമാണ്, അവയ്ക്ക് ലക്ഷ്യസ്ഥാന നിരക്കിൽ നിരക്ക് ഈടാക്കും. ഏതാണെന്ന് reason വ്യക്തമാക്കും; തടഞ്ഞ ലക്ഷ്യസ്ഥാനങ്ങൾ കാണുക |
ThunderPhone നമ്പറിന് retryable: false സഹിതം 409 | code പിന്തുടരുക: Phone Numbers പേജിൽ ഔട്ട്ബൗണ്ട് കോളിംഗ് അഭ്യർത്ഥിക്കുക, തീർപ്പാക്കാത്ത പരിശോധനയ്ക്കായി കാത്തിരിക്കുക, അല്ലെങ്കിൽ യോഗ്യമായ മറ്റൊരു നമ്പർ ഉപയോഗിക്കുക |
429, code: platform_outbound_daily_limit_reached സഹിതം | സ്ഥാപനം ThunderPhone നമ്പറുകളിൽ നിന്നുള്ള ഇന്നത്തെ ഔട്ട്ബൗണ്ട് കോളുകൾ ഉപയോഗിച്ചുകഴിഞ്ഞു. resets_at (00:00 UTC) വരെ കാത്തിരിക്കുക, Phone Numbers പേജിൽ ഉയർന്ന പരിധി അഭ്യർത്ഥിക്കുക, അല്ലെങ്കിൽ നിങ്ങളുടെ സ്വന്തം VoIP കണക്ഷനിലെ നമ്പറിൽ നിന്ന് വിളിക്കുക |
429, code: concurrent_call_limit_reached സഹിതം | സ്ഥാപനത്തിൽ അതിന്റെ ഒരേസമയം നടക്കുന്ന കോൾ പരിധി (സ്ഥിരസ്ഥിതിയായി 20, ഇൻബൗണ്ട്, ഔട്ട്ബൗണ്ട്, വെബ്, ടെസ്റ്റ് കോളുകൾ ഉൾപ്പെടെ) വരെയുള്ള കോളുകൾ പുരോഗതിയിലാണ്. Retry-After ഹെഡറിലെ സെക്കൻഡുകൾ കഴിഞ്ഞോ ഒരു കോൾ അവസാനിക്കുമ്പോഴോ വീണ്ടും ശ്രമിക്കുക; പരിധി ഉയർത്താൻ support@thunderphone.com-ലേക്ക് ഇമെയിൽ അയയ്ക്കുക |
429, code: outbound_queue_full സഹിതം | സ്ഥാപനത്തിന് കാത്തിരിക്കുന്ന 50 ക്യൂ ചെയ്ത കോളുകൾ ഉണ്ട്. Retry-After ഹെഡറിലെ സെക്കൻഡുകൾ കഴിഞ്ഞ് വീണ്ടും ശ്രമിക്കുക |
429, code: same_number_too_soon സഹിതം | നിങ്ങൾ അതേ to_number-ലേക്ക് 10 സെക്കൻഡിൽ താഴെ മുമ്പ് വിളിച്ചു. Retry-After ഹെഡറിലെ സെക്കൻഡുകൾ കഴിഞ്ഞ് വീണ്ടും ശ്രമിക്കുക |
ഉപഭോക്തൃ VoIP നമ്പറിന് retryable: false സഹിതം 409 | code സൂചിപ്പിക്കുന്ന അവസ്ഥ തിരുത്തുക; പരിശോധന പരാജയപ്പെടുകയാണെങ്കിൽ POST /v1/phone-numbers/{id}/verify-voip പ്രവർത്തിപ്പിക്കുക |
409 ഐഡംപൊട്ടൻസി വൈരുദ്ധ്യം | യഥാർത്ഥ നോർമലൈസ് ചെയ്ത അഭ്യർത്ഥനയ്ക്കൊപ്പം മാത്രം കീ വീണ്ടും ഉപയോഗിക്കുക, അല്ലെങ്കിൽ പുതിയ കീ അയയ്ക്കുക |
404 from_number is not registered to this organization | from_number നിങ്ങളുടെ സ്ഥാപനത്തിലെ സജീവ ഫോൺ നമ്പറുമായി പൊരുത്തപ്പെടുന്നുവെന്ന് സ്ഥിരീകരിക്കുക. ഇതിനകം പ്രൊവിഷനിംഗ് ഘട്ടത്തിലുള്ളതോ പരാജയപ്പെട്ടതോ റിലീസ് ചെയ്യുന്നതോ റിലീസ് ചെയ്തതോ ആയ നമ്പറും ഈ പ്രതികരണം നൽകും |
detail ഫീൽഡ് മാത്രം ഉള്ള 500 | ഔട്ട്ബൗണ്ട് ട്രങ്ക് കോൺഫിഗർ ചെയ്തിട്ടില്ല. പിന്തുണയുമായി ബന്ധപ്പെടുക; ഇത് നിങ്ങൾക്ക് തിരുത്താനാകുന്ന നമ്പർ-അവസ്ഥാ പ്രശ്നമല്ല |
502 Bad Gateway | താൽക്കാലിക SIP / LiveKit പരാജയം; വീണ്ടും ശ്രമിക്കുന്നത് സുരക്ഷിതമാണ് |
പൂർണ്ണമായ സ്ഥിരതയുള്ള എലിജിബിലിറ്റി-കോഡ് ലിസ്റ്റിനും രണ്ട് 409 പ്രതികരണ രൂപങ്ങൾക്കും
ഔട്ട്ബൗണ്ട് കോളുകൾ റഫറൻസ് കാണുക.
റിക്വസ്റ്റ് സ്വീകരിച്ച ശേഷവും കോൾ ചെയ്യുന്നതിനുമുമ്പും ഒരു സജീവ നമ്പർ അയോഗ്യമാകുകയാണെങ്കിൽ,
അന്തിമ പരിശോധന വീണ്ടും ശ്രമിക്കാനാകാത്ത 409 പേലോഡ് നൽകും.
ഹോൾഡ് സമയം നിയന്ത്രിക്കുക
സ്വീകരിക്കുന്നയാൾ പ്രതികരിക്കാൻ വൈകുന്നതിനാൽ ദൈർഘ്യമേറുന്ന ഔട്ട്ബൗണ്ട് കോളുകൾക്ക്
(IVR ട്രീകൾ, ക്യൂകൾ) കോളിൽ max_hold_seconds ഉപയോഗിച്ചോ അല്ലെങ്കിൽ സേവ് ചെയ്ത ഏജന്റിൽ അത് സജ്ജീകരിച്ചോ പരിധി നിശ്ചയിക്കാം:
{
"from_number": "+15551234567",
"to_number": "+14155552671",
"agent_id": 12,
"max_hold_seconds": 120
}കഴിഞ്ഞ N സെക്കൻഡിനുള്ളിൽ മനുഷ്യ ശബ്ദം ലഭിച്ചിട്ടില്ലെങ്കിൽ ഏജന്റ് കോൾ വിച്ഛേദിക്കും. സ്ഥിരസ്ഥിതി 900 സെക്കൻഡ് (15 മിനിറ്റ്) ആണ്.
സേവ് ചെയ്ത ഏജന്റിലും ഔട്ട്ബൗണ്ട് കോൾ അഭ്യർത്ഥനയിലും max_hold_seconds സജ്ജീകരിച്ചാൽ, ആ കോളിനായി ഓരോ കോളിനുമുള്ള മൂല്യം ഉപയോഗിക്കും.
അടുത്ത ഘട്ടങ്ങൾ
എല്ലാ റിക്വസ്റ്റ് ഫീൽഡുകളും പിശക് കോഡുകളും.
പൂർത്തിയായ ഔട്ട്ബൗണ്ട് കോളുകൾ നിങ്ങളുടെ സിസ്റ്റത്തിലേക്ക് സ്ട്രീം ചെയ്യുക.
ബാലൻസ് കാരണം ഔട്ട്ബൗണ്ട് ഒരിക്കലും പരാജയപ്പെടാതിരിക്കാൻ ഓട്ടോ-റീലോഡ് ഉപയോഗിക്കുക.
പ്രൊഡക്ഷനുമുമ്പ് നിങ്ങളുടെ ഔട്ട്ബൗണ്ട് ഏജന്റ് ഡ്രൈ-റൺ ചെയ്യുക.