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

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

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

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

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

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

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-ന്റെ പൂളിൽ നിന്ന് ഒരു ഡെമോ നമ്പർ പ്രൊവിഷൻ ചെയ്യുക:

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-ഉം ഉൾപ്പെടും. ഡെമോ നമ്പറുകൾ 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 കൂടി സജ്ജീകരിക്കാം, അങ്ങനെ നമ്പർ ഔട്ട്ബൗണ്ട് കോളുകൾക്കും തയ്യാറാകും.

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

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

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

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.

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