നിങ്ങളുടെ സ്വന്തം നമ്പറുകൾ കൊണ്ടുവരൂ (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"
  }'

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

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