ಒಳಬರುವ ಕರೆಗಳನ್ನು ನಿರ್ವಹಿಸಿ (API)

ನಿಮ್ಮ ಟರ್ಮಿನಲ್‌ನಿಂದಲೇ, AI ಮೂಲಕ ಫೋನ್‌ಗೆ ಉತ್ತರಿಸುವ ಪ್ರಮಾಣಿತ ಹರಿವು. ನೀವು:

1. prompt ಮತ್ತು ಧ್ವನಿಯೊಂದಿಗೆ ಏಜೆಂಟ್ ರಚಿಸಿ.
2. ಫೋನ್ ಸಂಖ್ಯೆಯನ್ನು ಪ್ರೊವಿಷನ್ ಮಾಡಿ (ಅಥವಾ ನಿಮ್ಮದನ್ನು ತನ್ನಿ) ಮತ್ತು ಏಜೆಂಟ್ ಅನ್ನು ಅದರ ಒಳಬರುವ ಕರೆ ಹ್ಯಾಂಡ್ಲರ್ ಆಗಿ ನಿಯೋಜಿಸಿ.
3. ಸಂಖ್ಯೆಗೆ ಕರೆ ಮಾಡಿ. ಕರೆ ಲಾಗ್, ಟ್ರಾನ್ಸ್‌ಕ್ರಿಪ್ಟ್ ಮತ್ತು ರೆಕಾರ್ಡಿಂಗ್ ಅನ್ನು ಗಮನಿಸಿ.

ಒಟ್ಟು API ಕರೆಗಳು: ನಾಲ್ಕು. ಒಟ್ಟು ಸಮಯ: 5 ನಿಮಿಷಗಳಿಗಿಂತ ಕಡಿಮೆ.

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.

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