ਆਪਣੇ ਨੰਬਰ ਲਿਆਓ (VoIP, API)

Twilio ਜਾਂ Telnyx — ਜਾਂ ਕਿਸੇ ਵੀ 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 ਕਨੈਕਸ਼ਨ ਉਸ ਇਕਲੌਤੇ Twilio ਅਕਾਊਂਟ ਨਾਲ ਬੱਝਿਆ ਹੁੰਦਾ ਹੈ ਜਿਸਦਾ Account SID ਅਤੇ Auth Token ਇਸ ਕੋਲ ਹੁੰਦਾ ਹੈ। Twilio ਹਰ ਸਬਅਕਾਊਂਟ ਅੰਦਰ ਫ਼ੋਨ ਨੰਬਰ ਅਤੇ SIP ਟਰੰਕ ਰੱਖਦਾ ਹੈ, ਇਸ ਲਈ ਪੇਰੈਂਟ ਅਕਾਊਂਟ ਨਾਲ ਬਣਿਆ ਕਨੈਕਸ਼ਨ ਸਿਰਫ਼ ਪੇਰੈਂਟ ਦੇ ਆਪਣੇ ਨੰਬਰ ਹੀ ਦੇਖਦਾ ਹੈ, ਅਤੇ ਮੌਜੂਦਾ ਕਨੈਕਸ਼ਨ ਨੂੰ ਬਾਅਦ ਵਿੱਚ ਕਿਸੇ ਹੋਰ ਸਬਅਕਾਊਂਟ 'ਤੇ ਬਦਲਿਆ ਨਹੀਂ ਜਾ ਸਕਦਾ (ਅੱਪਡੇਟ ਰੱਦ ਹੋ ਜਾਂਦਾ ਹੈ ਕਿਉਂਕਿ ਕਨੈਕਸ਼ਨ ਦਾ 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 ਰਾਹੀਂ ਕਦੇ ਵਾਪਸ ਨਹੀਂ ਕੀਤੇ ਜਾਂਦੇ। ਫਿਰ ਹਰੇਕ ਨਵਾਂ ਕਨੈਕਸ਼ਨ ਨੰਬਰਾਂ ਨੂੰ ਬਿਲਕੁਲ ਉਸੇ ਤਰ੍ਹਾਂ ਇੰਪੋਰਟ ਅਤੇ ਤਸਦੀਕ ਕਰਦਾ ਹੈ ਜਿਵੇਂ ਹੱਥੋਂ ਬਣਾਇਆ ਕਨੈਕਸ਼ਨ ਕਰਦਾ ਹੈ।

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. ਹਰ ਇੰਪੋਰਟ ਕੀਤੇ ਨੰਬਰ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ#

ਇੰਪੋਰਟ ਕਰਨ ਨਾਲ ਨੰਬਰ ਉਪਲਬਧ ਵਜੋਂ ਰਜਿਸਟਰ ਹੋ ਜਾਂਦਾ ਹੈ; ਅਸਲ ਵਿੱਚ ਇਸ ਰਾਹੀਂ ਕਾਲਾਂ ਰੂਟ ਕਰਨ ਲਈ ਪੁਸ਼ਟੀ ਲੋੜੀਂਦੀ ਹੈ। ਪ੍ਰੋਵਾਈਡਰ ਕਨੈਕਸ਼ਨਾਂ (Twilio, Telnyx) ਲਈ ਇਹ ਪ੍ਰੋਵਾਈਡਰ ਕ੍ਰੈਡੈਂਸ਼ਲਾਂ ਅਤੇ SIP ਰੀਚੇਬਿਲਿਟੀ ਦੀ ਦੁਬਾਰਾ ਜਾਂਚ ਕਰਦਾ ਹੈ। ਮੈਨੂਅਲ 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" ਵਿੱਚ ਦਾਖਲ ਹੋ ਜਾਂਦਾ ਹੈ। ਅਸਫਲ ਹੋਣ 'ਤੇ, ਜਵਾਬ ਸਪਸ਼ਟ ਕਰਦਾ ਹੈ ਕਿ ਕੀ ਅਸਫਲ ਹੋਇਆ — ਮੈਨੂਅਲ ਟਰੰਕ ਲਈ ਇਹ ਕੈਰੀਅਰ ਦਾ SIP ਜਵਾਬ ਹੁੰਦਾ ਹੈ, ਉਦਾਹਰਨ ਲਈ "ThunderPhone ਦੇ ਕ੍ਰੈਡੈਂਸ਼ਲ ਅਸਵੀਕਾਰ ਕੀਤੇ (SIP 401)" ਜਾਂ "ਕਾਲ ਰੂਟ ਨਹੀਂ ਹੋ ਸਕੀ (SIP 404)" — ਇਸ ਨੂੰ ਠੀਕ ਕਰੋ (ਕ੍ਰੈਡੈਂਸ਼ਲ, ਮਨਜ਼ੂਰਸ਼ੁਦਾ ਸਰੋਤ 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"
  }'

ਕਨੈਕਸ਼ਨ ਜਿਉਂ ਦਾ ਤਿਉਂ ਰਹਿੰਦਾ ਹੈ — ਨੰਬਰਾਂ ਨੂੰ ਦੁਬਾਰਾ ਇੰਪੋਰਟ ਕਰਨ ਦੀ ਲੋੜ ਨਹੀਂ ਹੈ।

ਅਗਲੇ ਕਦਮ#