Open in

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

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

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

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

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

ಹೊರಹೋಗುವ ಕರೆಗಳಿಗೆ ಸಕ್ರಿಯಗೊಳಿಸಿದ ಸಂಖ್ಯೆಯನ್ನು ಆಯ್ಕೆಮಾಡಿ
ನೀವು ಹೊಂದಿರುವ ಸಂಖ್ಯೆಯನ್ನು VoIP ಸಂಪರ್ಕದ ಮೂಲಕ ಬಳಸಿ, ಅಥವಾ ಫೋನ್ ಸಂಖ್ಯೆಗಳ ಪುಟದಿಂದ ನಿಮ್ಮ ThunderPhone ಸಂಖ್ಯೆಗಳನ್ನು ಹೊರಹೋಗುವ ಕರೆಗಳಿಗೆ ಬಳಸಲು ಅನುಮತಿ ವಿನಂತಿಸಿ. ThunderPhone ಸಂಖ್ಯೆಗಳು ಆರಂಭದಲ್ಲಿ ಒಳಬರುವ ಕರೆಗಳಿಗೆ ಮಾತ್ರ ಸಕ್ರಿಯವಾಗಿರುತ್ತವೆ. ThunderPhone ಪ್ರತಿಯೊಂದು ವಿನಂತಿಯನ್ನು ಕೈಯಾರೆ ಪರಿಶೀಲಿಸುತ್ತದೆ; ಅನುಮೋದನೆಯಾದ ನಂತರ, ಆ ಸಂಖ್ಯೆಗಳು ಅನುಮೋದಿತ ದೈನಂದಿನ ಮಿತಿಯವರೆಗೆ ಕರೆಗಳನ್ನು ಮಾಡಬಹುದು (00:00 UTCಕ್ಕೆ ಮರುಹೊಂದಿಸಲಾಗುತ್ತದೆ) ಮತ್ತು ಕ್ಯಾಂಪೇನ್‌ಗಳನ್ನು ನಡೆಸಬಹುದು, ಹಾಗೂ ನೀವು ಹೆಚ್ಚಿನ ಮಿತಿಯನ್ನು ಕೇಳಬಹುದು. ಗ್ರಾಹಕರ VoIP ಸಂಖ್ಯೆಗಳಿಗೆ ದೈನಂದಿನ ಮಿತಿ ಇರುವುದಿಲ್ಲ, ಆದ್ದರಿಂದ ಹೊರಹೋಗುವ ಕರೆಗಳಿಗೆ ಅವುಗಳನ್ನು ನಾವು ಶಿಫಾರಸು ಮಾಡುತ್ತೇವೆ. ನೋಡಿ ನಿಮ್ಮ ಸ್ವಂತ ಸಂಖ್ಯೆಗಳನ್ನು ಬಳಸಿ.
ಏಜೆಂಟ್ ರಚಿಸಿ
ಹೊರಹೋಗುವ ಕರೆಗಳಿಗೆ ಹೊಂದುವ prompt ಸಾಮಾನ್ಯವಾಗಿ ಏಜೆಂಟ್ ತನ್ನನ್ನು ಮತ್ತು ತನ್ನ ಉದ್ದೇಶವನ್ನು ಪರಿಚಯಿಸಿಕೊಳ್ಳುವುದರೊಂದಿಗೆ ಪ್ರಾರಂಭವಾಗುತ್ತದೆ — "ನಮಸ್ಕಾರ, ನಾಳೆ ಮಧ್ಯಾಹ್ನ 3 ಗಂಟೆಗೆ ಇರುವ ನಿಮ್ಮ ಅಪಾಯಿಂಟ್‌ಮೆಂಟ್‌ನ್ನು ದೃಢೀಕರಿಸಲು Acme ಕರೆ ಮಾಡುತ್ತಿದೆ…" outbound_speak_order ಅನ್ನು agent_first ಗೆ ಹೊಂದಿಸಿ (ಇದು ಡೀಫಾಲ್ಟ್).
ಧನಾತ್ಮಕ ಬ್ಯಾಲೆನ್ಸ್ ಉಳಿಸಿಕೊಳ್ಳಿ
ಬ್ಯಾಲೆನ್ಸ್ ≤ $0.00 ಆಗಿದ್ದರೆ ಹೊರಹೋಗುವ ಕರೆಗಳು 402 Payment Required ಅನ್ನು ಹಿಂತಿರುಗಿಸುತ್ತವೆ. ಡ್ಯಾಶ್‌ಬೋರ್ಡ್‌ನಲ್ಲಿ ಸಂಸ್ಥೆ → ಬಿಲ್ಲಿಂಗ್ ಸೆಟ್ಟಿಂಗ್‌ಗಳು ಅಡಿಯಲ್ಲಿ ಹಣ ಸೇರಿಸಿ ಅಥವಾ ಸ್ವಯಂಚಾಲಿತ ಮರುಲೋಡ್ ಸಕ್ರಿಯಗೊಳಿಸಿ. ನಿಮ್ಮ sk_live_ ಕೀ GET /v1/billing ಮೂಲಕ ಬ್ಯಾಲೆನ್ಸ್ ಪರಿಶೀಲಿಸಬಹುದು, ಆದರೆ ಹಣ ಸೇರಿಸಲು ಅಥವಾ ಸ್ವಯಂಚಾಲಿತ ಮರುಲೋಡ್ ಬದಲಾಯಿಸಲು ಸಾಧ್ಯವಿಲ್ಲ.

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

ಅತ್ಯಂತ ಸರಳ ವಿಧಾನ — 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":   "+14155552671",
    "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":   "+14155552671",
    "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 ಅನ್ನು ಒಳಗೊಂಡಿರುತ್ತದೆ.

ಕರೆ ನಂತರ ರಚನಾತ್ಮಕ ಡೇಟಾವನ್ನು ಹೊರತೆಗೆಯುವಂತೆ ನಿಮ್ಮ ಏಜೆಂಟ್ ಅನ್ನು ಹೊಂದಿಸಿದ್ದರೆ, ಅಂತಿಮಗೊಳಿಸುವಿಕೆ ಪೂರ್ಣಗೊಂಡ ಬಳಿಕ ಆ ಡೇಟಾವನ್ನು ಪ್ರತ್ಯೇಕವಾಗಿ ತಲುಪಿಸಲಾಗುತ್ತದೆ.

ಉಳಿಸಿದ ಏಜೆಂಟ್‌ಗೆ ಪ್ರತಿ-ಕರೆ ಚರಗಳನ್ನು ರವಾನಿಸಿ

ಉಳಿಸಿದ ಏಜೆಂಟ್‌ಗಳು prompt ಪಠ್ಯದಲ್ಲಿ {{name}} ಅಥವಾ {{name|there}} ನಂತಹ ಪ್ಲೇಸ್‌ಹೋಲ್ಡರ್‌ಗಳನ್ನು ಬಳಸಬಹುದು. ನೀವು agent_id ಜೊತೆಗೆ ಹೊರಹೋಗುವ ಕರೆಯನ್ನು ಇರಿಸಿದಾಗ, ಆ ಕರೆಗಾಗಿ ಮೌಲ್ಯಗಳೊಂದಿಗೆ variables ಅನ್ನು ರವಾನಿಸಿ:

{
  "from_number": "+[REDACTED_PHONE]",
  "to_number": "+[REDACTED_PHONE]",
  "agent_id": 12,
  "variables": {
    "name": "Jordan"
  }
}

ಪ್ಲೇಸ್‌ಹೋಲ್ಡರ್ ಹೆಸರಿನಿಂದ ಕೀ ಮಾಡಲಾದ ಸ್ಟ್ರಿಂಗ್ ಮೌಲ್ಯಗಳನ್ನು ಬಳಸಿ. ಈ ಚರಗಳು ಉಳಿಸಿದ ಏಜೆಂಟ್‌ಗಳಿಗೆ ಅನ್ವಯಿಸುತ್ತವೆ; ಈ ಮಾರ್ಗದರ್ಶಿಯ ಇನ್‌ಲೈನ್ config ಉದಾಹರಣೆಯು ಅವುಗಳನ್ನು ಬಳಸುವುದಿಲ್ಲ.

ನಿರ್ವಹಿಸಲು ಯೋಗ್ಯವಾದ ವಿಫಲತಾ ವಿಧಾನಗಳು

ದೋಷ	ಪರಿಹಾರ
`402 Payment Required`	ಬಾಕಿಯನ್ನು ತುಂಬಿಸಿ ಅಥವಾ ಸ್ವಯಂ-ಮರುಲೋಡ್ ಅನ್ನು ಸಕ್ರಿಯಗೊಳಿಸಿ
`400` ಜೊತೆಗೆ `code: destination_not_allowed`	ThunderPhone ಆ ಸಂಖ್ಯೆಗೆ ಕರೆ ಮಾಡುವುದಿಲ್ಲ: ಅಮಾನ್ಯ ಸಂಖ್ಯೆಗಳು, ತುರ್ತು ಸಂಖ್ಯೆಗಳು, ಪ್ರೀಮಿಯಂ-ದರ ಸಂಖ್ಯೆಗಳು, ಚಿಕ್ಕ ಕೋಡ್‌ಗಳು ಅಥವಾ ನಿರ್ಬಂಧ ವಿಧಿಸಲಾದ ದೇಶಗಳು. ThunderPhone ಸಂಖ್ಯೆಗಳಿಂದ ಸಾಮಾನ್ಯ US ಮತ್ತು ಕೆನಡಾದ ಸಂಖ್ಯೆಗಳಿಗೆ ಮಾತ್ರ ಕರೆ ಮಾಡಬಹುದು (ಪ್ರೀಮಿಯಂ-ದರ ಸಂಖ್ಯೆಗಳಿಗೆ ಅಲ್ಲ). `reason` ಯಾವುದು ಎಂಬುದನ್ನು ತಿಳಿಸುತ್ತದೆ; ನಿರ್ಬಂಧಿತ ಗಮ್ಯಸ್ಥಾನಗಳು ನೋಡಿ
ThunderPhone ಸಂಖ್ಯೆಗೆ `retryable: false` ಜೊತೆಗೆ `409`	`code` ಪ್ರಕಾರ ಕ್ರಮವಹಿಸಿ: ಫೋನ್ ಸಂಖ್ಯೆಗಳು ಪುಟದಲ್ಲಿ ಹೊರಹೋಗುವ ಕರೆ ಮಾಡುವುದಕ್ಕೆ ವಿನಂತಿಸಿ, ಬಾಕಿಯಿರುವ ಪರಿಶೀಲನೆಗಾಗಿ ಕಾಯಿರಿ, ಅಥವಾ ಮತ್ತೊಂದು ಅರ್ಹ ಸಂಖ್ಯೆಯನ್ನು ಬಳಸಿ
`429` ಜೊತೆಗೆ `code: platform_outbound_daily_limit_reached`	ಸಂಸ್ಥೆಯು ThunderPhone ಸಂಖ್ಯೆಗಳ ಮೂಲಕ ಇಂದಿನ ಹೊರಹೋಗುವ ಕರೆಗಳ ಮಿತಿಯನ್ನು ಬಳಸಿದೆ. `resets_at` (00:00 UTC) ವರೆಗೆ ಕಾಯಿರಿ, ಫೋನ್ ಸಂಖ್ಯೆಗಳು ಪುಟದಲ್ಲಿ ಹೆಚ್ಚಿನ ಮಿತಿಯನ್ನು ವಿನಂತಿಸಿ, ಅಥವಾ ನಿಮ್ಮ ಸ್ವಂತ VoIP ಸಂಪರ್ಕದ ಸಂಖ್ಯೆಯಿಂದ ಕರೆ ಮಾಡಿ
`429` ಜೊತೆಗೆ `code: concurrent_call_limit_reached`	ಸಂಸ್ಥೆಯಲ್ಲಿ ಅದರ ಏಕಕಾಲಿಕ ಕರೆ ಮಿತಿಯಷ್ಟು ಕರೆಗಳು ಪ್ರಗತಿಯಲ್ಲಿವೆ (ಪೂರ್ವನಿಯೋಜಿತವಾಗಿ 20, ಒಳಬರುವ, ಹೊರಹೋಗುವ, ವೆಬ್ ಮತ್ತು ಪರೀಕ್ಷಾ ಕರೆಗಳನ್ನು ಎಣಿಸಿ). `Retry-After` ಹೆಡರ್‌ನ ಸೆಕೆಂಡುಗಳ ನಂತರ ಅಥವಾ ಕರೆ ಮುಗಿದಾಗ ಮರುಪ್ರಯತ್ನಿಸಿ; ಮಿತಿಯನ್ನು ಹೆಚ್ಚಿಸಲು support@thunderphone.com ಗೆ ಇಮೇಲ್ ಮಾಡಿ
`429` ಜೊತೆಗೆ `code: same_number_too_soon`	ನೀವು 10 ಸೆಕೆಂಡುಗಳಿಗಿಂತ ಕಡಿಮೆ ಸಮಯದ ಹಿಂದೆ ಅದೇ `to_number` ಗೆ ಕರೆ ಮಾಡಿದ್ದೀರಿ. `Retry-After` ಹೆಡರ್‌ನ ಸೆಕೆಂಡುಗಳ ನಂತರ ಮರುಪ್ರಯತ್ನಿಸಿ
ಗ್ರಾಹಕ VoIP ಸಂಖ್ಯೆಗೆ `retryable: false` ಜೊತೆಗೆ `409`	`code` ಹೆಸರಿಸುವ ಸ್ಥಿತಿಯನ್ನು ಸರಿಪಡಿಸಿ; ಪರಿಶೀಲನೆ ವಿಫಲವಾದರೆ, `POST /v1/phone-numbers/{id}/verify-voip` ಅನ್ನು ಚಲಾಯಿಸಿ
`409` ಐಡೆಂಪೋಟೆನ್ಸಿ ಸಂಘರ್ಷ	ಮೂಲ ಸಾಮಾನ್ಯೀಕೃತ ವಿನಂತಿಯೊಂದಿಗೆ ಮಾತ್ರ ಕೀಯನ್ನು ಮರುಬಳಸಿ, ಅಥವಾ ಹೊಸ ಕೀಯನ್ನು ಕಳುಹಿಸಿ
`404 from_number is not registered to this organization`	`from_number` ನಿಮ್ಮ ಸಂಸ್ಥೆಯಲ್ಲಿನ ಸಕ್ರಿಯ ಫೋನ್ ಸಂಖ್ಯೆಗೆ ಹೊಂದಿಕೆಯಾಗುತ್ತದೆ ಎಂದು ಖಚಿತಪಡಿಸಿ. ಈಗಾಗಲೇ ಪ್ರೊವಿಷನಿಂಗ್ ಆಗುತ್ತಿರುವ, ವಿಫಲವಾದ, ಬಿಡುಗಡೆಗೊಳ್ಳುತ್ತಿರುವ ಅಥವಾ ಬಿಡುಗಡೆಗೊಂಡ ಸಂಖ್ಯೆಯೂ ಈ ಪ್ರತಿಕ್ರಿಯೆಯನ್ನು ಹಿಂತಿರುಗಿಸುತ್ತದೆ
`detail` ಕ್ಷೇತ್ರ ಮಾತ್ರ ಹೊಂದಿರುವ `500`	ಯಾವುದೇ ಹೊರಹೋಗುವ ಟ್ರಂಕ್ ಕಾನ್ಫಿಗರ್ ಮಾಡಲಾಗಿಲ್ಲ. ಬೆಂಬಲ ತಂಡವನ್ನು ಸಂಪರ್ಕಿಸಿ; ಇದು ನೀವು ಸರಿಪಡಿಸಬಹುದಾದ ಸಂಖ್ಯೆ-ಸ್ಥಿತಿಯ ಸಮಸ್ಯೆಯಲ್ಲ
`502 Bad Gateway`	ತಾತ್ಕಾಲಿಕ SIP / LiveKit ವೈಫಲ್ಯ; ಮರುಪ್ರಯತ್ನಿಸುವುದು ಸುರಕ್ಷಿತ

ಸಂಪೂರ್ಣ ಸ್ಥಿರ ಅರ್ಹತಾ-ಕೋಡ್ ಪಟ್ಟಿಗಾಗಿ ಮತ್ತು ಎರಡೂ 409 ಪ್ರತಿಕ್ರಿಯೆ ರೂಪಗಳಿಗಾಗಿ ಹೊರಹೋಗುವ ಕರೆಗಳ ಉಲ್ಲೇಖ ನೋಡಿ. ವಿನಂತಿಯನ್ನು ಸ್ವೀಕರಿಸಿದ ನಂತರ ಆದರೆ ಕರೆಯನ್ನು ಇರಿಸುವ ಮೊದಲು ಸಕ್ರಿಯ ಸಂಖ್ಯೆಯು ಅನರ್ಹವಾದರೆ, ಅಂತಿಮ ಪರಿಶೀಲನೆಯು ಮರುಪ್ರಯತ್ನಿಸಲಾಗದ 409 ಪೇಲೋಡ್ ಅನ್ನು ಹಿಂತಿರುಗಿಸುತ್ತದೆ.

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

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

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

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

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

ಹೊರಹೋಗುವ ಕರೆಗಳ ಉಲ್ಲೇಖ

ಪ್ರತಿ ವಿನಂತಿ ಕ್ಷೇತ್ರ ಮತ್ತು ದೋಷ ಕೋಡ್.

call.complete ಸ್ವೀಕರಿಸಿ

ಪೂರ್ಣಗೊಂಡ ಹೊರಹೋಗುವ ಕರೆಗಳನ್ನು ನಿಮ್ಮ ಸಿಸ್ಟಮ್‌ಗೆ ಸ್ಟ್ರೀಮ್ ಮಾಡಿ.

ಬಿಲ್ಲಿಂಗ್

ಬಾಕಿಯಿಂದ ಹೊರಹೋಗುವ ಕರೆ ಎಂದಿಗೂ ವಿಫಲವಾಗದಂತೆ ಸ್ವಯಂ-ಮರುಲೋಡ್ ಬಳಸಿ.

ಹೊರಹೋಗುವ ಏಜೆಂಟ್‌ಗಳನ್ನು ಪರೀಕ್ಷಿಸಿ

ಉತ್ಪಾದನೆಗೆ ಮುನ್ನ ನಿಮ್ಮ ಹೊರಹೋಗುವ ಏಜೆಂಟ್‌ನ ಡ್ರೈ-ರನ್ ಮಾಡಿ.