ಹೊರಹೋಗುವ ಕರೆಗಳನ್ನು ಮಾಡಿ (API)

ನಿಮ್ಮ ಸ್ವಂತ ಕೋಡ್‌ನಿಂದ AI-ಚಾಲಿತ ಹೊರಹೋಗುವ ಕರೆಯನ್ನು ಪ್ರಾರಂಭಿಸಿ — ಸಮೀಕ್ಷೆ, ಅನುಸರಣೆ, ಅಥವಾ ದೃಢೀಕರಣ ಹರಿವುಗಳಿಗಾಗಿ.

ಹೊರಹೋಗುವ ಕರೆ ಮಾಡುವುದರಿಂದ ನೀವು ಗಮ್ಯಸ್ಥಾನ ಸಂಖ್ಯೆಯನ್ನು ಮತ್ತು ಏಜೆಂಟ್ ಕಾನ್ಫಿಗರೇಶನ್ ಅನ್ನು ThunderPhone ಗೆ ನೀಡಬಹುದು ಹಾಗೂ AI ನಿಮ್ಮ ಪರವಾಗಿ ಕರೆಯನ್ನು ಮಾಡುತ್ತದೆ. ಸಾಮಾನ್ಯ ಬಳಕೆಯ ಸಂದರ್ಭಗಳು:

• ಅಪಾಯಿಂಟ್‌ಮೆಂಟ್ ದೃಢೀಕರಣಗಳು
• ಸಮೀಕ್ಷೆ ಮರುಕರೆಗಳು
• ಮಿಸ್ಡ್ ಕಾಲ್‌ನ ನಂತರದ "ಎರಡನೇ ಪ್ರಯತ್ನ" ಅನುಸರಣೆಗಳು
• ಡಿಸ್ಪ್ಯಾಚ್ ಶೈಲಿಯ ಅಧಿಸೂಚನೆಗಳು

ಪೂರ್ವಾಪೇಕ್ಷಿತಗಳು#

1. VoIP ಸಂಖ್ಯೆಯನ್ನು ಒದಗಿಸಿ

   ಹೊರಹೋಗುವ ಕರೆ ಮಾಡಲು ನೀವು from_number ಅನ್ನು VoIP ಸಂಪರ್ಕದ ಮೂಲಕ ಹೊಂದಿರಬೇಕು. ThunderPhone ಸಂಖ್ಯೆಗಳು ಒಳಬರುವ ಕರೆಗಳಿಗೆ ಮಾತ್ರ. ನಿಮ್ಮ ಸ್ವಂತ ಸಂಖ್ಯೆಗಳನ್ನು ಒದಗಿಸಿ ನೋಡಿ.

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

   ಹೊರಹೋಗುವ ಕರೆಗಳಿಗೆ ಹೊಂದುವ prompt ಸಾಮಾನ್ಯವಾಗಿ ಏಜೆಂಟ್ ತನ್ನನ್ನು ಮತ್ತು ತನ್ನ ಉದ್ದೇಶವನ್ನು ಪರಿಚಯಿಸುವುದರೊಂದಿಗೆ ಪ್ರಾರಂಭವಾಗುತ್ತದೆ — "ಹಾಯ್, ನಾಳೆ ಮಧ್ಯಾಹ್ನ 3 ಗಂಟೆಗೆ ಇರುವ ನಿಮ್ಮ ಅಪಾಯಿಂಟ್‌ಮೆಂಟ್ ದೃಢೀಕರಿಸಲು Acme ನಿಂದ ಕರೆ ಮಾಡುತ್ತಿದ್ದೇನೆ…" outbound_speak_order ಅನ್ನು agent_first ಗೆ ಹೊಂದಿಸಿ (ಇದು ಡೀಫಾಲ್ಟ್).

3. ಧನಾತ್ಮಕ ಬ್ಯಾಲೆನ್ಸ್ ಉಳಿಸಿಕೊಳ್ಳಿ

   ಬ್ಯಾಲೆನ್ಸ್ ≤ $0.00 ಆಗಿದ್ದರೆ ಹೊರಹೋಗುವ ಕರೆಗಳು 402 Payment Required ಅನ್ನು ಹಿಂತಿರುಗಿಸುತ್ತವೆ. POST /v1/billing/top-up ಮೂಲಕ ಹಣ ಸೇರಿಸಿ ಅಥವಾ ಸ್ವಯಂ ಮರುಲೋಡ್ ಸಕ್ರಿಯಗೊಳಿಸಿ.

ಉಳಿಸಿದ ಏಜೆಂಟ್‌ನೊಂದಿಗೆ ಕರೆ ಮಾಡಿ#

ಅತ್ಯಂತ ಸರಳ ಮಾರ್ಗ — id ಮೂಲಕ ಏಜೆಂಟ್ ಅನ್ನು ಉಲ್ಲೇಖಿಸಿ:

curl -X POST https://api.thunderphone.com/v1/call \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from_number": "+15551234567",
    "to_number":   "+14155550199",
    "agent_id":    12
  }'

ಪ್ರತಿಕ್ರಿಯೆ:

{ "call_id": 987654321, "status": "initiated" }

ಇನ್‌ಲೈನ್ ಕಾನ್ಫಿಗ್‌ನೊಂದಿಗೆ ಕರೆ ಮಾಡಿ#

ಏಜೆಂಟ್ ಆಗಿ ಉಳಿಸಲು ಯೋಗ್ಯವಲ್ಲದ ಒಂದು ಬಾರಿಯ prompt ಬೇಕಾದರೆ, ಬದಲಿಗೆ config ಅನ್ನು ಕಳುಹಿಸಿ. ಇದರ ಆಕಾರವು call.incoming ವೆಬ್‌ಹುಕ್ ನ ಪ್ರತಿಕ್ರಿಯೆ ಸ್ಕೀಮಾಗೆ ಹೊಂದಿಕೆಯಾಗುತ್ತದೆ:

curl -X POST https://api.thunderphone.com/v1/call \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from_number": "+15551234567",
    "to_number":   "+14155550199",
    "config": {
      "prompt":  "You are confirming Jane Doe appointment for 3pm tomorrow…",
      "voice":   "john",
      "product": "spark"
    }
  }'

ಕರೆಯನ್ನು ಅನುಸರಿಸಿ#

ಸಮಾನಾಂತರವಾಗಿ, telephony.complete ವೆಬ್‌ಹುಕ್ ಗೆ ಚಂದಾದಾರರಾಗಿ — ಕರೆ ಮುಗಿದಿದೆ ಎಂದು ತಿಳಿಯಲು ಇದು ಅತ್ಯಂತ ವೇಗವಾದ ವಿಧಾನವಾಗಿದೆ. ನೀವು ಒಳಬರುವ ವೆಬ್‌ಹುಕ್‌ಗಳನ್ನು ಸ್ವೀಕರಿಸಲು ಸಾಧ್ಯವಾಗದಿದ್ದರೆ, ಪ್ರತಿ ಕೆಲವು ಸೆಕೆಂಡುಗಳಿಗೊಮ್ಮೆ GET /v1/calls/{call_id} ಅನ್ನು ಪರಿಶೀಲಿಸಿ; ಕರೆ ಮುಗಿದ ನಂತರ ದಾಖಲೆಯು end_reason, duration_seconds, ಮತ್ತು ರೆಕಾರ್ಡಿಂಗ್ URL ಅನ್ನು ಒಳಗೊಂಡಿರುತ್ತದೆ.

ನಿರ್ವಹಿಸಬೇಕಾದ ವೈಫಲ್ಯ ವಿಧಾನಗಳು#

ಹೋಲ್ಡ್ ಸಮಯವನ್ನು ನಿಯಂತ್ರಿಸುವುದು#

ಕರೆ ಸ್ವೀಕರಿಸುವವರು ಪ್ರತಿಕ್ರಿಯಿಸಲು ನಿಧಾನವಾಗಿರುವುದರಿಂದ ದೀರ್ಘವಾಗುವ ಹೊರಹೋಗುವ ಕರೆಗಳಿಗೆ (IVR ಟ್ರೀಗಳು, ಸರದಿಗಳು) max_hold_seconds ಮೂಲಕ ಮಿತಿಯನ್ನು ಹೊಂದಿಸಬಹುದು:

{
  "from_number": "+15551234567",
  "to_number":   "+14155550199",
  "agent_id":    12,
  "max_hold_seconds": 120
}

ಕಳೆದ N ಸೆಕೆಂಡುಗಳಲ್ಲಿ ಯಾವುದೇ ಮಾನವ ಧ್ವನಿ ಸ್ವೀಕರಿಸದಿದ್ದರೆ ಏಜೆಂಟ್ ಕರೆಯನ್ನು ಕೊನೆಗೊಳಿಸುತ್ತದೆ. ಡೀಫಾಲ್ಟ್ 900 (15 ನಿಮಿಷಗಳು).

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