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

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

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

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

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

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

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 ನಿಮಿಷಗಳು) ಆಗಿದೆ.

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