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

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