നിങ്ങളുടെ സ്വന്തം നമ്പറുകൾ ഉപയോഗിക്കുക (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 ട്രങ്കുകളും സൂക്ഷിക്കുന്നു. അതിനാൽ പാരന്റ് അക്കൗണ്ട് ഉപയോഗിച്ച് സൃഷ്ടിച്ച കണക്ഷന് പാരന്റിന്റെ സ്വന്തം നമ്പറുകൾ മാത്രമേ കാണാൻ കഴിയൂ. നിലവിലുള്ള ഒരു കണക്ഷനെ പിന്നീട് മറ്റൊരു സബ് അക്കൗണ്ടിലേക്ക് മാറ്റാനും കഴിയില്ല (കണക്ഷന്റെ 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 org-ൽ ഇല്ലാത്തതുമായ നമ്പറുകൾ പരിശോധിക്കുക:

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

ഓരോ ഇമ്പോർട്ടും നിങ്ങളുടെ org-ൽ number_type="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"-ലേക്ക് പ്രവേശിക്കുകയും ചെയ്യും. നിങ്ങളുടെ സ്വന്തം Telnyx അക്കൗണ്ടിലുള്ള ഒരു നമ്പറിന്റെ ടെസ്റ്റ് കോൾ പരാജയപ്പെട്ടാലും അല്ലെങ്കിൽ ഔട്ട്‌ബൗണ്ട് ഇതുവരെ സജ്ജീകരിച്ചിട്ടില്ലെങ്കിലും, അത് ഇൻബൗണ്ട് കോളുകൾ സ്വീകരിച്ചുകൊണ്ടിരിക്കും: voip_verification_status unverified ആയി സജ്ജീകരിച്ച 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"
  }'

കണക്ഷൻ അതേപടി നിലനിൽക്കും — നമ്പറുകൾ വീണ്ടും ഇറക്കുമതി ചെയ്യേണ്ടതില്ല.

അടുത്ത ഘട്ടങ്ങൾ#