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

Twilio ಅಥವಾ Telnyx, ಅಥವಾ SignalWire, Vonage, Plivo ಮತ್ತು ಇತರೆ ಯಾವುದೇ SIP ಟ್ರಂಕ್‌ಗಳನ್ನು SIP ಮೂಲಕ ಸಂಪರ್ಕಿಸಿ, ನೀವು ಈಗಾಗಲೇ ಹೊಂದಿರುವ ಫೋನ್ ಸಂಖ್ಯೆಗಳನ್ನು ಆಮದು ಮಾಡಿ, ಮತ್ತು ThunderPhone ಏಜೆಂಟ್‌ಗಳು ಅವುಗಳಲ್ಲಿ ಕರೆಗಳಿಗೆ ಉತ್ತರಿಸಲು ಹಾಗೂ ಕರೆಗಳನ್ನು ಮಾಡಲು ಅನುಮತಿಸಿ.

ಅನುಮೋದಿತ ThunderPhone ಸಂಖ್ಯೆಗಳು ಹೊರಹೋಗುವ ಕರೆಗಳನ್ನು ಮಾಡಬಹುದು ಮತ್ತು ಕ್ಯಾಂಪೇನ್‌ಗಳನ್ನು ನಡೆಸಬಹುದು. ನಿಮ್ಮ ಸ್ವಂತ 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 ಮಾಡಿ.

Twilio ಉಪಖಾತೆಗಳು#

Twilio ಸಂಪರ್ಕವು ತನ್ನಲ್ಲಿರುವ Account SID ಮತ್ತು Auth Token ಗೆ ಸೇರಿದ ಏಕೈಕ Twilio ಖಾತೆಗೆ ಬಂಧಿತವಾಗಿರುತ್ತದೆ. Twilio ಪ್ರತಿ ಉಪಖಾತೆಯೊಳಗೆ ಫೋನ್ ಸಂಖ್ಯೆಗಳು ಮತ್ತು SIP ಟ್ರಂಕ್‌ಗಳನ್ನು ಇಡುತ್ತದೆ, ಆದ್ದರಿಂದ ಮೂಲ ಖಾತೆಯೊಂದಿಗೆ ಮಾಡಿದ ಸಂಪರ್ಕವು ಮೂಲ ಖಾತೆಯ ಸ್ವಂತ ಸಂಖ್ಯೆಗಳನ್ನು ಮಾತ್ರ ನೋಡುತ್ತದೆ ಮತ್ತು ಅಸ್ತಿತ್ವದಲ್ಲಿರುವ ಸಂಪರ್ಕವನ್ನು ನಂತರ ಬೇರೆ ಉಪಖಾತೆಗೆ ಬದಲಾಯಿಸಲು ಸಾಧ್ಯವಿಲ್ಲ.

ಉಪಖಾತೆಗಳಲ್ಲಿರುವ ಸಂಖ್ಯೆಗಳನ್ನು ತಲುಪಲು, ಪ್ರತಿ ಉಪಖಾತೆಗೆ ಒಂದೊಂದು ಸಂಪರ್ಕವನ್ನು ರಚಿಸಿ. ಡ್ಯಾಶ್‌ಬೋರ್ಡ್ ಇದನ್ನು ನಿಮಗಾಗಿ ಮಾಡುತ್ತದೆ: ಸಕ್ರಿಯ ಉಪಖಾತೆಗಳನ್ನು ಹೊಂದಿರುವ ಪೋಷಕ ಖಾತೆಯನ್ನು ನೀವು ಸಂಪರ್ಕಿಸಿದಾಗ, ಸೆಟಪ್ ಡೈಲಾಗ್ ಅವುಗಳನ್ನು ಪಟ್ಟಿ ಮಾಡುತ್ತದೆ, ನಿಮಗೆ ಬೇಕಾದವುಗಳನ್ನು ನೀವು ಟಿಕ್ ಮಾಡುತ್ತೀರಿ ಮತ್ತು ThunderPhone ಪ್ರತಿಯೊಂದರಲ್ಲೂ ಸಂಪರ್ಕವನ್ನು (ಮತ್ತು SIP ಟ್ರಂಕ್ ಅನ್ನು) ರಚಿಸುತ್ತದೆ. ಇದೇ ಫ್ಲೋ API ಮೂಲಕವೂ ಲಭ್ಯವಿದೆ:

# Discover active subaccounts visible to the parent credentials
curl -X POST https://api.thunderphone.com/v1/voip-connections/twilio/subaccounts \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"credentials": {"accountSid": "ACparent...", "authToken": "..."}}'

{
  "discovery_id": "7c1e...",
  "parent": { "sid": "ACparent...", "friendly_name": "Acme" },
  "subaccounts": [
    { "sid": "ACsupport...", "friendly_name": "Acme Support", "already_connected": false, "connection_id": null },
    { "sid": "ACsales...",   "friendly_name": "Acme Sales",   "already_connected": true,  "connection_id": 5 }
  ]
}

# Create a connection for each selected subaccount
curl -X POST https://api.thunderphone.com/v1/voip-connections/twilio/subaccounts/connect \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"discovery_id": "7c1e...", "subaccount_sids": ["ACsupport..."]}'

ಪ್ರತಿಕ್ರಿಯೆಯು ಪ್ರತಿ ಉಪಖಾತೆಗೆ ಒಂದು ಸಾಲನ್ನು ಹೊಂದಿರುತ್ತದೆ; ಇದರಲ್ಲಿ status ಆಗಿ created, skipped (ಈಗಾಗಲೇ ಸಂಪರ್ಕಗೊಂಡಿದೆ) ಅಥವಾ failed ಮತ್ತು ನೀವು ಕ್ರಮ ಕೈಗೊಳ್ಳಬಹುದಾದ error ಇರುತ್ತದೆ. ಸಾಲುಗಳು ಸ್ವತಂತ್ರವಾಗಿರುತ್ತವೆ, ಆದ್ದರಿಂದ ಒಂದು ಉಪಖಾತೆಯಲ್ಲಿನ ವೈಫಲ್ಯವು ಇತರವುಗಳನ್ನು ಎಂದಿಗೂ ತಡೆಯುವುದಿಲ್ಲ, ಮತ್ತು discovery_id 30 ನಿಮಿಷಗಳವರೆಗೆ ಮಾನ್ಯವಾಗಿರುತ್ತದೆ; ಆದ್ದರಿಂದ ವಿಫಲವಾದ ಸಾಲನ್ನು ಸರಳವಾಗಿ ಮರುಪ್ರಯತ್ನಿಸಬಹುದು. ಉಪಖಾತೆ ಟೋಕನ್‌ಗಳನ್ನು ಹುಡುಕಾಟದ ಸಮಯದಲ್ಲಿ Twilio ನಿಂದ ಓದಿ ಹೊಸ ಸಂಪರ್ಕದಲ್ಲಿ ಸಂಗ್ರಹಿಸಲಾಗುತ್ತದೆ; ಅವುಗಳನ್ನು API ಎಂದಿಗೂ ಹಿಂತಿರುಗಿಸುವುದಿಲ್ಲ. ನಂತರ ಪ್ರತಿಯೊಂದು ಹೊಸ ಸಂಪರ್ಕವು ನೀವು ಕೈಯಾರೆ ರಚಿಸಿದ ಸಂಪರ್ಕದಂತೆಯೇ ಸಂಖ್ಯೆಗಳನ್ನು ಆಮದು ಮಾಡಿ ಪರಿಶೀಲಿಸುತ್ತದೆ. ಪ್ರತಿ ಹೊಸ ಸಂಪರ್ಕದ SIP ಟ್ರಂಕ್‌ಗಾಗಿ ಕರೆ ವರ್ಗಾವಣೆಯನ್ನೂ ಸಕ್ರಿಯಗೊಳಿಸಲು "enable_transfers": true ಸೇರಿಸಿ; ಅಲ್ಲಿನ ವೈಫಲ್ಯವನ್ನು ಆ ಸಂಪರ್ಕದ test_result.transfer_enable_error ನಲ್ಲಿ ವರದಿ ಮಾಡಲಾಗುತ್ತದೆ ಮತ್ತು ಅದು ಸಾಲನ್ನು ವಿಫಲಗೊಳಿಸುವುದಿಲ್ಲ.

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"]}'

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

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

ಆಮದು ಮಾಡುವುದರಿಂದ ಸಂಖ್ಯೆಯು ಲಭ್ಯವಿದೆ ಎಂದು ನೋಂದಾಯಿಸಲಾಗುತ್ತದೆ; ಅದರ ಮೂಲಕ ಕರೆಗಳನ್ನು ನಿಜವಾಗಿ ಮಾರ್ಗಗೊಳಿಸಲು ಪರಿಶೀಲನೆ ಅಗತ್ಯವಿದೆ. ಪೂರೈಕೆದಾರ ಸಂಪರ್ಕಗಳಿಗೆ (Twilio, Telnyx), ಇದು ಪೂರೈಕೆದಾರರ ರುಜುವಾತುಗಳು ಮತ್ತು SIP ತಲುಪುವಿಕೆಯನ್ನು ಮರುಪರಿಶೀಲಿಸುತ್ತದೆ. ಹಸ್ತಚಾಲಿತ SIP ಸಂಪರ್ಕಕ್ಕಾಗಿ, ಇದು ಮೊದಲು ಲೂಪ್‌ಬ್ಯಾಕ್ ಸ್ವಯಂ ಕರೆಯನ್ನು ಪ್ರಯತ್ನಿಸುತ್ತದೆ: ThunderPhone ಸಂಖ್ಯೆಯಿಂದ ಸಣ್ಣ ಪರೀಕ್ಷಾ ಕರೆಯನ್ನು ಮಾಡುತ್ತದೆ, ನಿಮ್ಮ SIP ಟ್ರಂಕ್ ಮೂಲಕ, ಅದೇ ಸಂಖ್ಯೆಗೆ ಮರಳಿ. ಅದು ಒಳಬರುವ ಮಾರ್ಗವನ್ನು ಪರಿಶೀಲಿಸದಿದ್ದರೆ, ಅದು ಸಂಖ್ಯೆಯಿಂದ ಸಣ್ಣ ಪರೀಕ್ಷಾ ಕರೆಯನ್ನು ಮಾಡುವುದಕ್ಕೆ, ನಿಮ್ಮ SIP ಟ್ರಂಕ್ ಮೂಲಕ, ThunderPhone ಸಂಖ್ಯೆಗೆ ಹಿಂತಿರುಗುತ್ತದೆ. ಈ ಪರೀಕ್ಷೆಗಳು ಟ್ರಂಕ್‌ನ ಬಳಕೆದಾರಹೆಸರು, ಪಾಸ್‌ವರ್ಡ್, ಸಾರಿಗೆ, ಹೊರಹೋಗುವ ಮಾರ್ಗಗೊಳಿಸುವಿಕೆ ಮತ್ತು ಒಳಬರುವ ವಿತರಣೆಯನ್ನು ಪರಿಶೀಲಿಸುತ್ತವೆ. ನಿಮ್ಮ ಕ್ಯಾರಿಯರ್ ಈ ಕರೆಗಳಿಗೆ ಇತರ ಕರೆಗಳಂತೆಯೇ ಶುಲ್ಕ ವಿಧಿಸುತ್ತದೆ.

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" ಸ್ಥಿತಿ ದೊರೆಯುತ್ತದೆ. ನಿಮ್ಮ ಸ್ವಂತ Telnyx ಖಾತೆಯಲ್ಲಿರುವ ಸಂಖ್ಯೆ, ಅದರ ಪರೀಕ್ಷಾ ಕರೆ ವಿಫಲವಾದಾಗ ಅಥವಾ ಹೊರಹೋಗುವ ಕರೆಗಳ ವ್ಯವಸ್ಥೆ ಇನ್ನೂ ಆಗಿರದಿದ್ದಾಗಲೂ ಒಳಬರುವ ಕರೆಗಳನ್ನು ಸ್ವೀಕರಿಸುತ್ತಲೇ ಇರುತ್ತದೆ: ಅದು voip_verification_status ಅನ್ನು unverified ಎಂದು ಹೊಂದಿಸಿ status="active" ಆಗುತ್ತದೆ, ಮತ್ತು ಪ್ರತಿಕ್ರಿಯೆಯು ಏಕೆ ಎಂಬುದನ್ನು ತಿಳಿಸುತ್ತದೆ. ವಿಫಲವಾದಾಗ, ಪ್ರತಿಕ್ರಿಯೆಯು ಏನು ವಿಫಲವಾಯಿತು ಎಂಬುದನ್ನು ಸ್ಪಷ್ಟವಾಗಿ ವಿವರಿಸುತ್ತದೆ — ಹಸ್ತಚಾಲಿತ ಟ್ರಂಕ್‌ಗೆ ಅದು ವಾಹಕದ SIP ಉತ್ತರವಾಗಿರುತ್ತದೆ, ಉದಾಹರಣೆಗೆ "ThunderPhone ನ ರುಜುವಾತುಗಳನ್ನು ತಿರಸ್ಕರಿಸಲಾಗಿದೆ (SIP 401)" ಅಥವಾ "ಕರೆಯನ್ನು ಮಾರ್ಗಗೊಳಿಸಲು ಸಾಧ್ಯವಾಗಲಿಲ್ಲ (SIP 404)" — ಅದನ್ನು ಸರಿಪಡಿಸಿ (ರುಜುವಾತುಗಳು, ಅನುಮತಿಸಲಾದ ಮೂಲ IPಗಳು, ಪೂರೈಕೆದಾರರ ಡ್ಯಾಶ್‌ಬೋರ್ಡ್‌ನಲ್ಲಿ ಇಲ್ಲದ ಟ್ರಂಕ್ ನಿಯೋಜನೆ) ಮತ್ತು ಮತ್ತೆ ಕರೆ ಮಾಡಿ.

ಅನುಮತಿಪಟ್ಟಿಯಲ್ಲಿರುವ ಹಸ್ತಚಾಲಿತ SIP ಸಂಪರ್ಕಕ್ಕಾಗಿ, ಆ ಅನುಮತಿಸಿದ ಮೂಲ IPಗಳು ನಿಜವಾದ ಒಳಬರುವ ಕರೆಯನ್ನು ತಡೆಯುವಂತಿದ್ದರೆ ಒಳಬರುವ-ಕರೆ ಪರೀಕ್ಷೆಯೂ ವಿಫಲವಾಗುತ್ತದೆ.

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

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

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

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

# 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"
  }'

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

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