तुमचे स्वतःचे क्रमांक आणा (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"
  }'

कनेक्शन तिथेच राहते — नंबर पुन्हा आयात करण्याची गरज नाही.

पुढील पायऱ्या