உங்கள் சொந்த எண்களைப் பயன்படுத்துங்கள் (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"
  }'

இணைப்பு அப்படியே இருக்கும் — எண்களை மீண்டும் இறக்குமதி செய்ய வேண்டியதில்லை.

அடுத்த படிகள்