ഇൻബൗണ്ട് കോളുകൾ കൈകാര്യം ചെയ്യുക (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-ന്റെ പൂളിൽ നിന്ന് ഒരു 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 കൂടി സെറ്റ് ചെയ്യാം, അതുവഴി നമ്പർ ഔട്ട്ബൗണ്ട് കോളുകൾക്കും സജ്ജമാകും.

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.

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