ThunderPhone v3 ഇപ്പോൾ ലൈവാണ്.സ്വയം തുടങ്ങാം — 2¢/മിനിറ്റ് മുതൽ.പ്രഖ്യാപനം വായിക്കുക

Developer cookbook

ഇൻബൗണ്ട് കോളുകൾ കൈകാര്യം ചെയ്യുക (API)

ആരംഭം മുതൽ അവസാനം വരെ: ഒരു ഏജന്റിനെ കോൺഫിഗർ ചെയ്യുക, അതിനെ ഒരു ഫോൺ നമ്പറിലേക്ക് നിയോഗിക്കുക, ഒരു കോൾ സ്വീകരിക്കുക, ട്രാൻസ്ക്രിപ്റ്റ് പരിശോധിക്കുക.

നിങ്ങളുടെ ടെർമിനലിൽ നിന്ന്, പ്രമാണിതമായ "AI ഉപയോഗിച്ച് ഫോൺ എടുക്കുക" പ്രവാഹം. നിങ്ങൾ:

  1. ഒരു prompt-ഉം ശബ്ദവുമുള്ള ഏജന്റ് സൃഷ്ടിക്കും.
  2. ഒരു ഫോൺ നമ്പർ പ്രൊവിഷൻ ചെയ്യുക (അല്ലെങ്കിൽ കൊണ്ടുവരുക), അതിന്റെ ഇൻബൗണ്ട് ഹാൻഡ്‌ലറായി ഏജന്റിനെ നിയോഗിക്കുക.
  3. നമ്പറിലേക്ക് വിളിക്കുക. കോൾ ലോഗ്, ട്രാൻസ്ക്രിപ്റ്റ്, റെക്കോർഡിംഗ് എന്നിവ നിരീക്ഷിക്കുക.

ആകെ API കോളുകൾ: നാല്. ആകെ സമയം: അഞ്ച് മിനിറ്റിൽ താഴെ.

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

ഒരു ഏജന്റ് കോളിനെ പ്രവർത്തിപ്പിക്കുന്ന prompt, വോയ്‌സ്, ഉൽപ്പന്ന ടിയർ എന്നിവ സംയോജിപ്പിക്കുന്നു. ഏജന്റിൽ max_call_duration_seconds , ring_duration_seconds എന്നിവ പോലുള്ള കോൾ പരിധികളും നിങ്ങൾക്ക് സജ്ജീകരിക്കാം. ഔട്ട്‌ബൗണ്ട് കോളുകൾക്കായി, കോൾ അവസാനിപ്പിക്കുന്നതിന് മുമ്പ് ഏജന്റ് ഹോൾഡിൽ എത്ര സമയം കാത്തിരിക്കണമെന്ന് പരിമിതപ്പെടുത്താൻ max_hold_seconds സജ്ജീകരിക്കാനും കഴിയും. Bolt ഏജന്റുകൾ, അവർ എങ്ങനെ കേൾക്കുകയും പ്രതികരിക്കുകയും ചെയ്യണമെന്ന് നിയന്ത്രിക്കാൻ audio_tier, endpointing, intelligence എന്നിവയും പിന്തുണയ്ക്കുന്നു: intelligence എന്നത് core അല്ലെങ്കിൽ pro ആണ്, audio_tier (Hearing) എന്നത് lite, standard, plus അല്ലെങ്കിൽ max ആണ് (Max പൊതുവായി ലഭ്യമല്ല). പഴയ മൂല്യങ്ങളായ (intelligence-നുള്ള lite, standard; hearing-നുള്ള lean, hearing, deep_hearing) എന്നിവയും ഇപ്പോഴും സ്വീകരിക്കുന്നു. ഫുൾ ഡ്യൂപ്ലക്സ് ഏജന്റുകൾ പിന്തുണയ്ക്കുന്ന ഭാഷകളിലുടനീളം ഒരേ വോയ്‌സ് നിലനിർത്തുന്നു, അതിനാൽ ഓരോ ഭാഷയ്ക്കുമുള്ള വോയ്‌സ് മാറ്റം ആ കോളുകൾക്ക് ബാധകമല്ല. മുൻകൂട്ടി റെക്കോർഡ് ചെയ്ത ആമുഖവും ഏജന്റ് സംസാരിക്കുന്നതിന് മുമ്പ് പരമാവധി രണ്ട് റിങ്ങുകളും പ്ലേ ചെയ്യാൻ ഏജന്റുകൾ intro_clip, intro_ring_count എന്നിവയും പിന്തുണയ്ക്കുന്നു. പുതിയ ഏജന്റുകൾക്ക് ഒരു സമയ മേഖലയും ആവശ്യമാണ്. നിങ്ങളുടെ ഏജന്റ് ബഹുഭാഷാ ഏജന്റാണെങ്കിൽ, ഭാഷകൾ മാറുന്നതിന് മുമ്പ് അത് ചോദിക്കണോ അതോ കോളറുടെ ഭാഷ പിന്തുടരണോ എന്ന് നിയന്ത്രിക്കാൻ language_switching സജ്ജീകരിക്കാം. നിർദ്ദിഷ്ട പദങ്ങൾ അത് എങ്ങനെ ഉച്ചരിക്കണമെന്നും ഏതൊക്കെ പദങ്ങൾ ശ്രദ്ധിച്ച് കേൾക്കണമെന്നും നിയന്ത്രിക്കാൻ ഏജന്റിൽ words സജ്ജീകരിക്കാനും കഴിയും. എല്ലാ കോൺഫിഗറേഷൻ ഫീൽഡുകൾക്കും Agents കാണുക; ഏറ്റവും കുറഞ്ഞത് ഇവയാണ്:

curl -X POST https://api.thunderphone.com/v1/agents \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name":    "Acme Support",
    "prompt":  "You are a friendly support agent for Acme. Help callers with orders and returns. Keep answers short.",
    "voice":   "john",
    "product": "bolt"
  }'

തിരികെ ലഭിക്കുന്ന id സംരക്ഷിക്കുക — ഘട്ടം 2-ൽ നിങ്ങൾക്കത് ആവശ്യമാണ്.

2. ഒരു ഫോൺ നമ്പർ നേടുക

നിങ്ങൾക്ക് വിളിച്ചുനോക്കാൻ എന്തെങ്കിലും മാത്രം ആവശ്യമാണെങ്കിൽ, ThunderPhone-ന്റെ പൂളിൽ നിന്ന് ഒരു ThunderPhone നമ്പർ നേടുക:

curl -X POST https://api.thunderphone.com/v1/phone-numbers \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"area_code": "415"}'

പ്രതികരണത്തിൽ E.164 ഫോർമാറ്റിലുള്ള ഒരു id-യും ഒരു number-ഉം ഉൾപ്പെടും. ThunderPhone നമ്പറുകൾ status="provisioning"-ൽ ആരംഭിച്ച് ഏതാനും സെക്കൻഡുകൾക്കുള്ളിൽ active ആകും — ഈ മാറ്റം നിരീക്ഷിക്കണമെങ്കിൽ GET /v1/phone-numbers/{id} പോൾ ചെയ്യുക.

3. ഏജന്റിനെ നിയോഗിക്കുക

ഘട്ടം 1-ലെ ഏജന്റിനെ നമ്പറിന്റെ ഇൻബൗണ്ട് ദിശയുമായി ബന്ധിപ്പിക്കുക:

curl -X PATCH https://api.thunderphone.com/v1/phone-numbers/{phone_id} \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"inbound_agent_id": 12}'

അത്രമാത്രം — നമ്പർ ലൈവാണ്. നിങ്ങളുടെ ഓർഗനൈസേഷനായി ഔട്ട്ബൗണ്ട് കോളിങ് അംഗീകരിച്ച ശേഷം, അതേ PATCH-ൽ outbound_agent_id സജ്ജീകരിക്കാനും നിങ്ങൾക്ക് കഴിയും. അതുവരെ, API ആ നിയോഗം 400 ഉപയോഗിച്ച് നിരസിക്കും.

നിശ്ചിത inbound_agent_id ഉപയോഗിക്കുന്നതിന് പകരം നിങ്ങൾ config webhook വഴി ഇൻബൗണ്ട് കോളുകൾ റൂട്ട് ചെയ്യുകയാണെങ്കിൽ, ആ webhook-ന് ഇപ്പോൾ ഓരോ കോളിനും agent_id, variables എന്നിവയ്‌ക്കൊപ്പം timezone മടക്കി നൽകാനാകും. Bolt ഏജന്റുകൾക്കായി, API റൈറ്റുകളിൽ ഏജന്റിൽ audio_tier, endpointing, intelligence എന്നിവയും സജ്ജമാക്കാം. endpointing-ന്റെ അപരനാമമായി പഴയ eagerness പേര് API ഇപ്പോഴും സ്വീകരിക്കുന്നു. നിങ്ങളുടെ ഏജന്റ് trigger="call_start" ഉള്ള API കണക്ഷനുകൾ ഉപയോഗിക്കുന്നുവെങ്കിൽ, സംരക്ഷിച്ചിരിക്കുന്ന call_start_arguments ഉപയോഗിച്ച്, അഭിവാദനത്തിന് മുമ്പ് ഓരോ ഫോൺ കോളിന്റെയും തുടക്കത്തിൽ ThunderPhone-ന് ആ ടൂളുകൾ ഒരിക്കൽ പ്രവർത്തിപ്പിക്കാനാകും.

നിങ്ങളുടെ ഔട്ട്‌ബൗണ്ട് കോളുകളിലേക്കുള്ള കോൾബാക്കുകൾ

കഴിഞ്ഞ 30 ദിവസത്തിനുള്ളിൽ അവരെ വിളിച്ച ഒരു നമ്പറിലേക്ക് ആരെങ്കിലും തിരികെ വിളിക്കുമ്പോൾ, കോൾ എടുക്കുന്ന ഏജന്റിന് ആ കോളിനെക്കുറിച്ചുള്ള ഒരു ഹ്രസ്വ പശ്ചാത്തല കുറിപ്പ് ലഭിക്കും: അത് എപ്പോൾ നടത്തി, ഏത് ഏജന്റാണ് നടത്തിയത്, എന്താണ് സംഭവിച്ചത് (മറുപടി ലഭിച്ചില്ല, വോയ്‌സ്‌മെയിൽ, അല്ലെങ്കിൽ ഒരു സംഭാഷണം). ഇൻബൗണ്ട് ഏജന്റ് ഇല്ലാത്ത ഒരു നമ്പർ ഇതേ വിവരങ്ങൾ നിങ്ങളുടെ config webhook-ലേക്ക് returning_call ആയി അയയ്ക്കും. ആ നമ്പറിന് webhook ഇല്ലെങ്കിലോ, webhook സമയപരിധി കവിയുകയോ എത്തിച്ചേരാൻ കഴിയാതിരിക്കുകയോ ചെയ്താൽ, കോൾ അവസാനിപ്പിക്കുന്നതിനുപകരം മുമ്പത്തെ കോൾ നടത്തിയ ഏജന്റിലേക്കാണ് കോൾ പോകുക. Caller ID വ്യാജമാക്കാൻ കഴിയുന്നതിനാൽ, ഒരു അഡ്മിൻ സംഘടന → പൊതുവായത് → കോൾബാക്കുകൾ എന്നതിലെ മുമ്പത്തെ കോളിന്റെ വിവരങ്ങൾ പങ്കിടുക പ്രവർത്തനക്ഷമമാക്കിയാൽ മാത്രമേ മുമ്പത്തെ കോളിന്റെ സംഗ്രഹവും വേരിയബിളുകളും പങ്കിടൂ. കോൾബാക്കുകൾ കാണുക.

4. ഒരു കോൾ സ്വീകരിക്കുക

നിങ്ങളുടെ ഫോണിൽ നിന്ന് നമ്പറിലേക്ക് വിളിക്കുക. ഏജന്റ് കോൾ എടുക്കുകയും നിങ്ങളുടെ prompt അനുസരിച്ച് സ്വയം പരിചയപ്പെടുത്തുകയും സംഭാഷണം ആരംഭിക്കുകയും ചെയ്യും.

കോൾ പുരോഗമിക്കുന്നതിനിടെ, അത് GET /v1/calls-ൽ status="in_progress" ഉപയോഗിച്ച് ദൃശ്യമാകും. കോൾ അവസാനിക്കുമ്പോൾ, റെക്കോർഡ് end_reason, duration_seconds, billable_minutes, കൂടാതെ (ഒടുവിൽ) ഒരു റെക്കോർഡിംഗ് URL-ഉം AI ഗ്രേഡും ഉപയോഗിച്ച് അപ്‌ഡേറ്റ് ചെയ്യും.

ഇൻബൗണ്ട് കോളുകൾ നിങ്ങളുടെ സ്ഥാപനത്തിന്റെ ഒരേസമയം കൈകാര്യം ചെയ്യാവുന്ന കോൾ പരിധിയിൽ ഉൾപ്പെടും (ഡിഫോൾട്ടായി പുരോഗതിയിലുള്ള 20 കോളുകൾ, ഔട്ട്ബൗണ്ട്, വെബ്, ടെസ്റ്റ് കോളുകളുമായി പങ്കിടുന്നത്). പരിധിയിലെത്തുന്ന ഒരു കോൾ ഏജന്റ് മറുപടി നൽകുന്നതിന് മുമ്പ് നിരസിക്കുകയും വിച്ഛേദിക്കുകയും ചെയ്യും, അതിന് ബിൽ ഈടാക്കില്ല, കൂടാതെ concurrent_call_limit_reached എന്ന അവസാന കാരണം ഉപയോഗിച്ച് പരാജയപ്പെട്ട കോളായി രേഖപ്പെടുത്തുകയും ചെയ്യും. നിങ്ങൾക്ക് കൂടുതൽ പരിധി ആവശ്യമുണ്ടെങ്കിൽ support@thunderphone.com-ലേക്ക് ഇമെയിൽ അയയ്ക്കുക.

5. ഫലങ്ങൾ പരിശോധിക്കുക

സമീപകാല കോളുകളുടെ പട്ടിക നേടുക:

curl 'https://api.thunderphone.com/v1/calls?limit=5' \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

ട്രാൻസ്ക്രിപ്റ്റ് നേടുക:

curl https://api.thunderphone.com/v1/calls/{call_id}/transcript \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

റെക്കോർഡിംഗ് URL (ഹ്രസ്വകാലത്തേക്ക് സാധുവായ, സൈൻ ചെയ്‌തത്):

curl https://api.thunderphone.com/v1/calls/{call_id}/audio \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

നിങ്ങൾ telephony.complete വെബ്ഹുക്കിലേക്ക് സബ്‌സ്‌ക്രൈബ് ചെയ്തിട്ടുണ്ടെങ്കിൽ, നിങ്ങളുടെ സെർവറിലേക്കുള്ള POST ആയി അതേ ഡാറ്റ ലഭിക്കും — കാണുക call.complete.

നിങ്ങളുടെ ഏജന്റിൽ എക്സ്ട്രാക്ഷൻ ഫീൽഡുകൾ കോൺഫിഗർ ചെയ്തിട്ടുണ്ടെങ്കിൽ, പൂർത്തിയായ കോൾ പേലോഡിൽ ഘടനാപരമായി എക്സ്ട്രാക്റ്റ് ചെയ്ത ഡാറ്റയും ഉൾപ്പെടാം. ഏജന്റ് ആ ക്രമീകരണം ഓവർറൈഡ് ചെയ്യുന്നില്ലെങ്കിൽ, കോൾ സംഗ്രഹങ്ങൾ നിങ്ങളുടെ സ്ഥാപനം ThunderPhone-ൽ ഉപയോഗിക്കുന്ന ഭാഷയിൽ എഴുതപ്പെടും.


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

ഓരോ കോളിനും ഡൈനാമിക് കോൺഫിഗറേഷൻ

ഫോൺ നമ്പർ അല്ലെങ്കിൽ വെബ്ഹുക്കിലെ കസ്റ്റം ലോജിക് അടിസ്ഥാനമാക്കി ഓരോ കോളർക്കും വ്യത്യസ്ത ഏജന്റിനെ തിരഞ്ഞെടുക്കുക.

ടൂൾ ഇന്റഗ്രേഷനുകൾ ചേർക്കുക

സംഭാഷണത്തിനിടയിൽ ഏജന്റിനെ നിങ്ങളുടെ API-കൾ വിളിക്കാൻ അനുവദിക്കുക.

കോളുകൾ ട്രാൻസ്ഫർ ചെയ്യുക

കോളർമാരെ നേരിട്ട് റൂട്ട് ചെയ്യുക അല്ലെങ്കിൽ കണക്റ്റ് ചെയ്യുന്നതിന് മുമ്പ് ലക്ഷ്യസ്ഥാനം പരിശോധിക്കുക.

call.complete വെബ്ഹുക്കുകൾ സ്വീകരിക്കുക

പൂർത്തിയായ ഓരോ കോളും നിങ്ങളുടെ CRM / അനലിറ്റിക്സ് പൈപ്പ്‌ലൈനിലേക്ക് സ്ട്രീം ചെയ്യുക.

AI ഗ്രേഡിംഗും പ്രശ്ന റിപ്പോർട്ടുകളും

ഓരോ കോളും സ്വയമേവ വിലയിരുത്തി, അടയാളപ്പെടുത്തിയവ അവലോകനത്തിനായി റൂട്ട് ചെയ്യുക.