ThunderPhone v3 ಈಗ ಲೈವ್ ಆಗಿದೆ.ನೀವೇ ನೇರವಾಗಿ ಆರಂಭಿಸಿ — 2¢/ನಿಮಿಷದಿಂದ.ಘೋಷಣೆ ಓದಿ

Developer cookbook

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

ಪೂರ್ಣ ಪ್ರಕ್ರಿಯೆ: ಏಜೆಂಟ್ ಅನ್ನು ಕಾನ್ಫಿಗರ್ ಮಾಡಿ, ಅದನ್ನು ಫೋನ್ ಸಂಖ್ಯೆಗೆ ನಿಯೋಜಿಸಿ, ಕರೆಯನ್ನು ಸ್ವೀಕರಿಸಿ ಮತ್ತು ಟ್ರಾನ್ಸ್ಕ್ರಿಪ್ಟ್ ಅನ್ನು ಪರಿಶೀಲಿಸಿ.

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

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

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

1. ಏಜೆಂಟ್ ರಚಿಸಿ

ಏಜೆಂಟ್‌ನಲ್ಲಿ ಕರೆಯನ್ನು ನಿರ್ವಹಿಸುವ prompt, ಧ್ವನಿ ಮತ್ತು ಉತ್ಪನ್ನ ಶ್ರೇಣಿ ಒಳಗೊಂಡಿರುತ್ತವೆ. ನೀವು ಏಜೆಂಟ್‌ನಲ್ಲಿ max_call_duration_seconds ಮತ್ತು ring_duration_seconds ನಂತಹ ಕರೆ ಮಿತಿಗಳನ್ನೂ ಹೊಂದಿಸಬಹುದು. ಹೊರಹೋಗುವ ಕರೆಗಳಿಗಾಗಿ, ಕರೆಯನ್ನು ಮುಕ್ತಾಯಿಸುವ ಮೊದಲು ಏಜೆಂಟ್ ಹೋಲ್ಡ್‌ನಲ್ಲಿ ಎಷ್ಟು ಸಮಯ ಕಾಯಬೇಕು ಎಂಬುದನ್ನು ಮಿತಿಗೊಳಿಸಲು max_hold_seconds ಅನ್ನೂ ಹೊಂದಿಸಬಹುದು. Bolt ಏಜೆಂಟ್‌ಗಳು ಅವು ಹೇಗೆ ಆಲಿಸುತ್ತವೆ ಮತ್ತು ಪ್ರತಿಕ್ರಿಯಿಸುತ್ತವೆ ಎಂಬುದನ್ನು ನಿಯಂತ್ರಿಸಲು audio_tier, endpointing, ಮತ್ತು intelligence ಅನ್ನೂ ಬೆಂಬಲಿಸುತ್ತವೆ: intelligence ಗೆ core ಅಥವಾ pro, ಮತ್ತು audio_tier (ಕೇಳುವಿಕೆ) ಗೆ lite, standard, plus ಅಥವಾ max ಇರುತ್ತವೆ (Max ಸಾಮಾನ್ಯವಾಗಿ ಲಭ್ಯವಿರುವುದಿಲ್ಲ). ಹಳೆಯ ಮೌಲ್ಯಗಳಾದ (intelligence ಗೆ lite ಮತ್ತು standard; ಕೇಳುವಿಕೆಗೆ lean, hearing, ಮತ್ತು deep_hearing) ಇನ್ನೂ ಸ್ವೀಕರಿಸಲಾಗುತ್ತವೆ. ಪೂರ್ಣ ಡ್ಯುಪ್ಲೆಕ್ಸ್ ಏಜೆಂಟ್‌ಗಳು ಬೆಂಬಲಿತ ಭಾಷೆಗಳಾದ್ಯಂತ ಒಂದೇ ಧ್ವನಿಯನ್ನು ಉಳಿಸಿಕೊಳ್ಳುತ್ತವೆ, ಆದ್ದರಿಂದ ಆ ಕರೆಗಳಿಗೆ ಭಾಷೆ-ಆಧಾರಿತ ಧ್ವನಿ ಬದಲಾವಣೆ ಅನ್ವಯಿಸುವುದಿಲ್ಲ. ಏಜೆಂಟ್‌ಗಳು ಪೂರ್ವರೆಕಾರ್ಡ್ ಮಾಡಿದ ಪರಿಚಯವನ್ನು ಪ್ಲೇ ಮಾಡಲು ಮತ್ತು ಏಜೆಂಟ್ ಮಾತನಾಡುವ ಮೊದಲು ಗರಿಷ್ಠ ಎರಡು ರಿಂಗ್‌ಗಳನ್ನು ನೀಡಲು intro_clip ಮತ್ತು intro_ring_count ಅನ್ನೂ ಬೆಂಬಲಿಸುತ್ತವೆ. ಹೊಸ ಏಜೆಂಟ್ ಗಳಿಗೆ ಸಮಯ ವಲಯವೂ ಅಗತ್ಯ. ನಿಮ್ಮ ಏಜೆಂಟ್ ಬಹುಭಾಷಿಯಾಗಿದ್ದರೆ, ಭಾಷೆಗಳನ್ನು ಬದಲಿಸುವ ಮೊದಲು ಕೇಳಬೇಕೇ ಅಥವಾ ಕರೆಮಾಡುವವರ ಭಾಷೆಯನ್ನು ಅನುಸರಿಸಬೇಕೇ ಎಂಬುದನ್ನು ನಿಯಂತ್ರಿಸಲು language_switching ಅನ್ನು ಹೊಂದಿಸಬಹುದು. ನಿರ್ದಿಷ್ಟ ಪದಗಳನ್ನು ಏಜೆಂಟ್ ಹೇಗೆ ಉಚ್ಚರಿಸುತ್ತದೆ ಮತ್ತು ಯಾವ ಪದಗಳನ್ನು ಆಲಿಸುತ್ತದೆ ಎಂಬುದನ್ನು ನಿಯಂತ್ರಿಸಲು words ಅನ್ನೂ ಹೊಂದಿಸಬಹುದು. ಪ್ರತಿ ಕಾನ್ಫಿಗರೇಶನ್ ಕ್ಷೇತ್ರಕ್ಕಾಗಿ ಏಜೆಂಟ್ ವಿವರಗಳು ನೋಡಿ; ಕನಿಷ್ಠ ಅಗತ್ಯವಿರುವುದು:

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": "bolt"
  }'

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

ನಿಗದಿತ inbound_agent_id ಬದಲಿಗೆ ನೀವು ಕಾನ್ಫಿಗ್ ವೆಬ್‌ಹುಕ್ ಮೂಲಕ ಒಳಬರುವ ಕರೆಗಳನ್ನು ಮಾರ್ಗಗೊಳಿಸಿದರೆ, ಆ ವೆಬ್‌ಹುಕ್ ಈಗ agent_id ಮತ್ತು variables ಜೊತೆಗೆ ಪ್ರತಿ ಕರೆಗೆ timezone ಅನ್ನು ಹಿಂತಿರುಗಿಸಬಹುದು. Bolt ಏಜೆಂಟ್‌ಗಳಿಗಾಗಿ, API ರೈಟ್‌ಗಳಲ್ಲಿ ಏಜೆಂಟ್‌ನಲ್ಲಿ audio_tier, endpointing, ಮತ್ತು intelligence ಅನ್ನೂ ನೀವು ಹೊಂದಿಸಬಹುದು. API ಇನ್ನೂ ಹಳೆಯ eagerness ಹೆಸರನ್ನು endpointing ಗೆ ಉಪನಾಮವಾಗಿ ಸ್ವೀಕರಿಸುತ್ತದೆ. ನಿಮ್ಮ ಏಜೆಂಟ್ trigger="call_start" ಹೊಂದಿರುವ API ಸಂಪರ್ಕಗಳನ್ನು ಬಳಸಿದರೆ, ThunderPhone ಪ್ರತಿ ಫೋನ್ ಕರೆಯ ಆರಂಭದಲ್ಲಿ, ಶುಭಾಶಯಕ್ಕೂ ಮೊದಲು, ಅವುಗಳ ಉಳಿಸಿದ call_start_arguments ಬಳಸಿ ಆ ಸಾಧನಗಳನ್ನು ಒಮ್ಮೆ ಚಲಾಯಿಸಬಹುದು.

ನಿಮ್ಮ ಹೊರಹೋಗುವ ಕರೆಗಳಿಗೆ ಕಾಲ್‌ಬ್ಯಾಕ್‌ಗಳು

ಯಾರಾದರೂ ಕಳೆದ 30 ದಿನಗಳಲ್ಲಿ ಅವರಿಗೆ ಕರೆ ಮಾಡಿದ ಸಂಖ್ಯೆಗೆ ಮರಳಿ ಕರೆ ಮಾಡಿದಾಗ, ಉತ್ತರಿಸುವ ಏಜೆಂಟ್‌ಗೆ ಆ ಕರೆಯ ಕುರಿತು ಸಂಕ್ಷಿಪ್ತ ಹಿನ್ನೆಲೆ ಟಿಪ್ಪಣಿ ಸಿಗುತ್ತದೆ: ಅದನ್ನು ಯಾವಾಗ ಮಾಡಲಾಯಿತು, ಯಾವ ಏಜೆಂಟ್ ಮಾಡಿದರು ಮತ್ತು ಏನಾಯಿತು (ಉತ್ತರ ಇಲ್ಲ, ಧ್ವನಿಮೇಲ್ ಅಥವಾ ಸಂಭಾಷಣೆ). ಒಳಬರುವ ಏಜೆಂಟ್ ಇಲ್ಲದ ಸಂಖ್ಯೆಯು ಇದೇ ವಿವರಗಳನ್ನು ನಿಮ್ಮ ಕಾನ್ಫಿಗ್ ವೆಬ್‌ಹುಕ್‌ಗೆ returning_call ಆಗಿ ಕಳುಹಿಸುತ್ತದೆ. ಆ ಸಂಖ್ಯೆಗೆ ವೆಬ್‌ಹುಕ್ ಇಲ್ಲದಿದ್ದರೆ, ಅಥವಾ ವೆಬ್‌ಹುಕ್ ಸಮಯ ಮೀರಿದರೆ ಅಥವಾ ತಲುಪಲು ಸಾಧ್ಯವಾಗದಿದ್ದರೆ, ಕರೆ ಕೊನೆಗೊಳ್ಳುವ ಬದಲು ಹಿಂದಿನ ಕರೆಯನ್ನು ಮಾಡಿದ ಏಜೆಂಟ್‌ಗೆ ಹೋಗುತ್ತದೆ. ಕಾಲರ್ ID ನಕಲಿ ಆಗಿರಬಹುದು, ಆದ್ದರಿಂದ ನಿರ್ವಾಹಕರು ಸಂಸ್ಥೆ → ಸಾಮಾನ್ಯ → ಕಾಲ್‌ಬ್ಯಾಕ್‌ಗಳ ಅಡಿಯಲ್ಲಿ ಹಿಂದಿನ ಕರೆಯ ವಿವರಗಳನ್ನು ಹಂಚಿಕೊಳ್ಳಿ ಅನ್ನು ಆನ್ ಮಾಡಿದರೆ ಮಾತ್ರ ಹಿಂದಿನ ಕರೆಯ ಸಾರಾಂಶ ಮತ್ತು ವೇರಿಯಬಲ್‌ಗಳನ್ನು ಹಂಚಿಕೊಳ್ಳಲಾಗುತ್ತದೆ. ಕಾಲ್‌ಬ್ಯಾಕ್‌ಗಳನ್ನು ನೋಡಿ.

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.

ನಿಮ್ಮ ಏಜೆಂಟ್‌ಗೆ ಹೊರತೆಗೆಯುವಿಕೆ ಕ್ಷೇತ್ರಗಳನ್ನು ಕಾನ್ಫಿಗರ್ ಮಾಡಿದ್ದರೆ, ಪೂರ್ಣಗೊಂಡ ಕರೆಯ ಪೇಲೋಡ್ ರಚನಾತ್ಮಕವಾಗಿ ಹೊರತೆಗೆದ ಡೇಟಾವನ್ನೂ ಒಳಗೊಂಡಿರಬಹುದು. ಏಜೆಂಟ್ ಆ ಸೆಟ್ಟಿಂಗ್ ಅನ್ನು ಅತಿಕ್ರಮಿಸದಿದ್ದರೆ, ಕರೆ ಸಾರಾಂಶಗಳನ್ನು ನಿಮ್ಮ ಸಂಸ್ಥೆ ThunderPhone ನಲ್ಲಿ ಬಳಸುವ ಭಾಷೆಯಲ್ಲಿ ಬರೆಯಲಾಗುತ್ತದೆ.


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

ಪ್ರತಿ ಕರೆಯ ಡೈನಾಮಿಕ್ ಸಂರಚನೆ

ಫೋನ್ ಸಂಖ್ಯೆಯ ಆಧಾರದ ಮೇಲೆ ಅಥವಾ ವೆಬ್‌ಹುಕ್‌ನಲ್ಲಿನ ಕಸ್ಟಮ್ ತರ್ಕದ ಆಧಾರದ ಮೇಲೆ ಪ್ರತಿ ಕರೆಗಾರನಿಗೆ ವಿಭಿನ್ನ ಏಜೆಂಟ್ ಆಯ್ಕೆಮಾಡಿ.

ಟೂಲ್ ಏಕೀಕರಣಗಳನ್ನು ಸೇರಿಸಿ

ಸಂಭಾಷಣೆಯ ಮಧ್ಯೆ ನಿಮ್ಮ APIಗಳನ್ನು ಕರೆಯಲು ಏಜೆಂಟ್‌ಗೆ ಅನುಮತಿಸಿ.

ಕರೆಗಳನ್ನು ವರ್ಗಾಯಿಸಿ

ಕರೆಗಾರರನ್ನು ನೇರವಾಗಿ ರೂಟ್ ಮಾಡಿ ಅಥವಾ ಸಂಪರ್ಕಿಸುವ ಮೊದಲು ಗಮ್ಯಸ್ಥಾನವನ್ನು ಪರಿಶೀಲಿಸಿ.

call.complete ವೆಬ್‌ಹುಕ್‌ಗಳನ್ನು ಸ್ವೀಕರಿಸಿ

ಪೂರ್ಣಗೊಂಡ ಪ್ರತಿಯೊಂದು ಕರೆಯನ್ನು ನಿಮ್ಮ CRM / ಅನಾಲಿಟಿಕ್ಸ್ ಪೈಪ್‌ಲೈನ್‌ಗೆ ಸ್ಟ್ರೀಮ್ ಮಾಡಿ.

AI ಗ್ರೇಡಿಂಗ್ ಮತ್ತು ಸಮಸ್ಯೆ ವರದಿಗಳು

ಪ್ರತಿಯೊಂದು ಕರೆಯನ್ನು ಸ್ವಯಂಚಾಲಿತವಾಗಿ ಸ್ಕೋರ್ ಮಾಡಿ ಮತ್ತು ಗುರುತಿಸಲಾದ ಕರೆಗಳನ್ನು ಪರಿಶೀಲನೆಗೆ ರೂಟ್ ಮಾಡಿ.