ಒಳಬರುವ ಕರೆಗಳನ್ನು ನಿರ್ವಹಿಸಿ (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 ನೊಂದಿಗೆ ತಿರಸ್ಕರಿಸುತ್ತದೆ.

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.

ನಿಮ್ಮ ಏಜೆಂಟ್‌ನಲ್ಲಿ ಎಕ್ಸ್‌ಟ್ರಾಕ್ಷನ್ ಕ್ಷೇತ್ರಗಳನ್ನು ಸಂರಚಿಸಿದ್ದರೆ, ಪೂರ್ಣಗೊಂಡ ಕರೆ ಪೇಲೋಡ್‌ನಲ್ಲಿ ರಚನಾತ್ಮಕವಾಗಿ ಎಕ್ಸ್‌ಟ್ರಾಕ್ಟ್ ಮಾಡಿದ ಡೇಟಾವೂ ಇರಬಹುದು.

ಮುಂದಿನ ಹಂತಗಳು#