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

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

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

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

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

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

ഒരു ഏജന്റിൽ കോൾ നിയന്ത്രിക്കുന്ന prompt, വോയ്‌സ്, ഉൽപ്പന്ന ടിയർ എന്നിവ ഉൾപ്പെടുന്നു. ഏജന്റിൽ max_call_duration_seconds, ring_duration_seconds പോലുള്ള കോൾ പരിധികളും നിങ്ങൾക്ക് സജ്ജീകരിക്കാം. പുതിയ ഏജന്റുകൾക്ക് ഒരു സമയ മേഖലയും ആവശ്യമാണ്. എല്ലാ കോൺഫിഗറേഷൻ ഫീൽഡുകൾക്കും ഏജന്റുകൾ കാണുക; ഏറ്റവും കുറഞ്ഞ ക്രമീകരണം ഇതാണ്:

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": "spark"
  }'

തിരികെ ലഭിക്കുന്ന 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 തിരികെ നൽകാനാകും.

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.

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

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