మీ స్వంత నంబర్‌లను తీసుకురండి (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"
  }'

కనెక్షన్ అలాగే ఉంటుంది — నంబర్‌లను మళ్లీ దిగుమతి చేయాల్సిన అవసరం లేదు.

తదుపరి దశలు