ನಿಮ್ಮ ಸ್ವಂತ ಸಂಖ್ಯೆಗಳನ್ನು ಬಳಸಿ (VoIP, API)

ಡೆಮೊ ಸಂಖ್ಯೆಗಳು ಪ್ರೋಟೋಟೈಪಿಂಗ್‌ಗೆ ಸೂಕ್ತವಾಗಿವೆ, ಆದರೆ ಪ್ರೊಡಕ್ಷನ್ ಟ್ರಾಫಿಕ್‌ಗಾಗಿ ನಿಮ್ಮ ಸ್ವಂತ VoIP ಪೂರೈಕೆದಾರರ ಮೂಲಕ ನೀವು ಹೊಂದಿರುವ ಸಂಖ್ಯೆಗಳನ್ನು ಬಳಸಬೇಕು. ಈ ಮಾರ್ಗದರ್ಶಿ ಮೂರು-ಹಂತದ ಫ್ಲೋವನ್ನು ವಿವರಿಸುತ್ತದೆ: ರುಜುವಾತುಗಳನ್ನು ಪರೀಕ್ಷಿಸಿ → ಸಂಪರ್ಕವನ್ನು ರಚಿಸಿ → ಸಂಖ್ಯೆಗಳನ್ನು ಆಮದು ಮಾಡಿ → ಪರಿಶೀಲಿಸಿ.

ಬೆಂಬಲಿತ ಪೂರೈಕೆದಾರರು

1. ರುಜುವಾತುಗಳನ್ನು ಪರೀಕ್ಷಿಸಿ

ನೀವು ಶಾಶ್ವತ VoIP ಸಂಪರ್ಕವನ್ನು ರಚಿಸುವ ಮೊದಲು, ಅವು ಕಾರ್ಯನಿರ್ವಹಿಸುತ್ತವೆ ಎಂಬುದನ್ನು ದೃಢೀಕರಿಸಲು ಪೂರೈಕೆದಾರರ ರುಜುವಾತುಗಳನ್ನು ಪರಿಶೀಲಿಸಿ. ಇದು verification_evidence_id ಅನ್ನು ಹಿಂತಿರುಗಿಸುತ್ತದೆ; ಪರೀಕ್ಷೆಗಾಗಿ ರುಜುವಾತುಗಳಿಗೆ ಎರಡು ಬಾರಿ ಶುಲ್ಕ ವಿಧಿಸದಂತೆ ಇದನ್ನು ರಚನೆ ಹಂತಕ್ಕೆ ಕಳುಹಿಸಿ.

curl -X POST https://api.thunderphone.com/v1/voip-connections/test \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider":    "telnyx",
    "credentials": { "apiKey": "KEY...", "connectionId": "123456" },
    "sip_config":  { "domain": "acme.sip.telnyx.com" }
  }'

{
  "status": "pass",
  "verification_evidence_id": "b9a2...",
  "suggested_connection_name": "Telnyx: Acme Main (+15550001234)",
  "checks": {
    "credentials_valid": true,
    "inbound_reachable": true,
    "outbound_authorized": true
  }
}

ಯಾವುದೇ ಪರಿಶೀಲನೆ ವಿಫಲವಾದರೆ, ಪ್ರತಿಕ್ರಿಯೆಯ status fail ಆಗಿರುತ್ತದೆ ಮತ್ತು ಯಾವ ಹಂತವು ವಿಫಲವಾಯಿತು ಎಂಬುದನ್ನು checks ತೋರಿಸುತ್ತದೆ. ಪೂರೈಕೆದಾರ-ಬದಿಯ ಕಾನ್ಫಿಗ್ ಅನ್ನು ಸರಿಪಡಿಸಿ (ಟ್ರಂಕ್ ನಿಯೋಜನೆ, IP ಅಲೋಲಿಸ್ಟ್, ಔಟ್‌ಬೌಂಡ್ ದೃಢೀಕರಣ) ಮತ್ತು ಮರುಪ್ರಯತ್ನಿಸಿ.

2. ಸಂಪರ್ಕವನ್ನು ರಚಿಸಿ

ನೀವು ಈಗ ಪಡೆದ verification_evidence_id ಅನ್ನು ಕಳುಹಿಸಿ:

curl -X POST https://api.thunderphone.com/v1/voip-connections \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name":         "Acme Telnyx Main",
    "provider":     "telnyx",
    "setup_method": "api_key",
    "credentials":  { "apiKey": "KEY...", "connectionId": "123456" },
    "sip_config":   { "domain": "acme.sip.telnyx.com" },
    "verification_evidence_id": "b9a2..."
  }'

ಪ್ರತಿಕ್ರಿಯೆಯು status="connected" ಸ್ಥಿತಿಯಲ್ಲಿರುವ VoipConnection ಆಬ್ಜೆಕ್ಟ್ ಆಗಿರುತ್ತದೆ. ರುಜುವಾತುಗಳನ್ನು ಸರ್ವರ್-ಬದಿಯಲ್ಲಿ ಸಂಗ್ರಹಿಸಲಾಗುತ್ತದೆ ಮತ್ತು ನಂತರದ GET ವಿನಂತಿಗಳಿಂದ ಅವುಗಳನ್ನು ಎಂದಿಗೂ ಸರಳ ಪಠ್ಯದಲ್ಲಿ ಹಿಂತಿರುಗಿಸಲಾಗುವುದಿಲ್ಲ — ರೊಟೇಟ್ ಮಾಡಲು, ಹೊಸ ಸಾಕ್ಷ್ಯದೊಂದಿಗೆ ಹೊಸ test ಅನ್ನು ಚಲಾಯಿಸಿ ಮತ್ತು PATCH ಮಾಡಿ.

3. ಸಂಖ್ಯೆಗಳನ್ನು ಪಟ್ಟಿ ಮಾಡಿ ಮತ್ತು ಆಮದು ಮಾಡಿ

ನಿಮ್ಮ ರುಜುವಾತುಗಳಿಗೆ ಗೋಚರವಾಗಿರುವ ಮತ್ತು ಈಗಾಗಲೇ ThunderPhone ಆರ್ಗ್‌ನಲ್ಲಿ ಇಲ್ಲದ ಸಂಖ್ಯೆಗಳನ್ನು ಪರಿಶೀಲಿಸಿ:

curl https://api.thunderphone.com/v1/voip-connections/5/available-numbers \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

ನಂತರ ನಿಮಗೆ ಬೇಕಾದವುಗಳನ್ನು ಆಮದು ಮಾಡಿ:

curl -X POST https://api.thunderphone.com/v1/voip-connections/5/import-numbers \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"numbers": ["+15550001234", "+15550009999"]}'

ಪ್ರತಿಯೊಂದು ಆಮದು ನಿಮ್ಮ ಆರ್ಗ್‌ನಲ್ಲಿ source="voip" ಮತ್ತು status="provisioning" ಹೊಂದಿರುವ ಫೋನ್ ಸಂಖ್ಯೆ ಸಂಪನ್ಮೂಲ ಆಗುತ್ತದೆ.

4. ಆಮದು ಮಾಡಿದ ಪ್ರತಿಯೊಂದು ಸಂಖ್ಯೆಯನ್ನು ಪರಿಶೀಲಿಸಿ

ಆಮದು ಮಾಡುವುದರಿಂದ ಸಂಖ್ಯೆಯು ಲಭ್ಯವಿದೆ ಎಂದು ನೋಂದಾಯಿಸಲಾಗುತ್ತದೆ; ಅದರ ಮೂಲಕ ಕರೆಗಳನ್ನು ನಿಜವಾಗಿ ರೂಟ್ ಮಾಡಲು ರೌಂಡ್-ಟ್ರಿಪ್ ಪರಿಶೀಲನೆ ಅಗತ್ಯವಿದೆ (ಒಳಬರುವ ಡಯಲ್-ಇನ್ ಪರಿಶೀಲನೆ + ಹೊರಹೋಗುವ ದೃಢೀಕರಣ ಪ್ರೋಬ್).

curl -X POST https://api.thunderphone.com/v1/phone-numbers/{id}/verify-voip \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

ಯಶಸ್ವಿಯಾದಾಗ, voip_verification_status verified ಗೆ ಬದಲಾಗುತ್ತದೆ ಮತ್ತು ಸಂಖ್ಯೆಯು status="active" ಗೆ ಪ್ರವೇಶಿಸುತ್ತದೆ. ವಿಫಲವಾದಾಗ, ಪ್ರತಿಕ್ರಿಯೆಯು ಏನು ವಿಫಲವಾಯಿತು ಎಂಬುದನ್ನು ಸ್ಪಷ್ಟವಾಗಿ ತಿಳಿಸುತ್ತದೆ — ಅದನ್ನು ಸರಿಪಡಿಸಿ (ಸಾಮಾನ್ಯವಾಗಿ ಒದಗಿಸುವವರ ಡ್ಯಾಶ್‌ಬೋರ್ಡ್‌ನಲ್ಲಿ ಟ್ರಂಕ್ ನಿಯೋಜನೆ ಕಾಣೆಯಾಗಿರುತ್ತದೆ) ಮತ್ತು ಮತ್ತೆ ಕರೆ ಮಾಡಿ.

5. ಏಜೆಂಟ್‌ಗಳನ್ನು ನಿಯೋಜಿಸಿ ಮತ್ತು ಕರೆ ಸ್ವೀಕರಿಸಿ

ಸಂಖ್ಯೆ ಪರಿಶೀಲನೆಯಾದ ನಂತರ, ಡೆಮೋ ಸಂಖ್ಯೆಗೆ ಮಾಡುವ ರೀತಿಯಲ್ಲಿಯೇ ಒಳಬರುವ / ಹೊರಹೋಗುವ ಏಜೆಂಟ್‌ಗಳನ್ನು ನಿಯೋಜಿಸಿ. ಒಳಬರುವ ಕರೆಗಳನ್ನು ನಿರ್ವಹಿಸಿ ಮತ್ತು ಹೊರಹೋಗುವ ಕರೆಗಳನ್ನು ಮಾಡಿ ನೋಡಿ.

ರುಜುವಾತುಗಳನ್ನು ಬದಲಾಯಿಸುವುದು

ಒದಗಿಸುವವರ ಕೀ ಬದಲಾದಾಗ, ಪರೀಕ್ಷಿಸಿ-ನಂತರ-ನವೀಕರಿಸುವ ಪ್ರಕ್ರಿಯೆಯನ್ನು ಮತ್ತೆ ಚಲಾಯಿಸಿ:

# 1. Test the new credentials
curl -X POST https://api.thunderphone.com/v1/voip-connections/test ...

# 2. PATCH the connection with the new evidence
curl -X PATCH https://api.thunderphone.com/v1/voip-connections/{id} \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "credentials": { "apiKey": "NEW_KEY..." },
    "verification_evidence_id": "fresh-evidence-id"
  }'

ಸಂಪರ್ಕವು ಹಾಗೆಯೇ ಉಳಿಯುತ್ತದೆ — ಸಂಖ್ಯೆಗಳನ್ನು ಮರು-ಆಮದು ಮಾಡುವ ಅಗತ್ಯವಿಲ್ಲ.

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