Developer cookbook

Kendi numaralarınızı getirin (VoIP, API)

Twilio veya Telnyx

Demo numaraları prototip oluşturmak için uygundur, ancak üretim trafiğinde kendi VoIP sağlayıcınız üzerinden sahip olduğunuz numaraları kullanmalısınız. Bu kılavuz, üç adımlı akışı açıklar: kimlik bilgilerini test edin → bağlantı oluşturun → numaraları içe aktarın → doğrulayın.

Desteklenen sağlayıcılar#

1. Kimlik bilgilerini test edin#

Kalıcı bir VoIP bağlantısı oluşturmadan önce, çalıştıklarını doğrulamak için sağlayıcı kimlik bilgilerini test edin. Bu işlem, kimlik bilgilerinin test için iki kez ücretlendirilmemesi amacıyla oluşturma adımına ileteceğiniz bir verification_evidence_id döndürür.

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
  }
}

Herhangi bir kontrol başarısız olursa, yanıt status değeri fail olur ve checks hangi adımın başarısız olduğunu gösterir. Sağlayıcı tarafındaki yapılandırmayı (trunk ataması, IP izin listesi, giden arama yetkilendirmesi) düzeltin ve yeniden deneyin.

2. Bağlantıyı oluşturun#

Az önce aldığınız verification_evidence_id değerini iletin:

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

Yanıt, status="connected" durumundaki bir VoipConnection nesnesidir. Kimlik bilgileri sunucu tarafında saklanır ve sonraki GET isteklerinde hiçbir zaman düz metin olarak döndürülmez — değiştirmek için yeni bir test çalıştırın ve yeni kanıtla PATCH isteği gönderin.

3. Numaraları listeleyin ve içe aktarın#

Kimlik bilgilerinize görünür olan ve henüz bir ThunderPhone kuruluşunda bulunmayan numaraları inceleyin:

curl https://api.thunderphone.com/v1/voip-connections/5/available-numbers \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

Ardından istediğiniz numaraları içe aktarın:

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

Her içe aktarma, kuruluşunuzda source="voip" ve status="provisioning" değerlerine sahip bir telefon numarası kaynağına dönüşür.

4. İçe aktarılan her numarayı doğrulayın#

İçe aktarma, numarayı kullanılabilir olarak kaydeder; çağrıları gerçekten bu numara üzerinden yönlendirmek için gidiş-dönüş doğrulaması gerekir (gelen arama kontrolü + giden arama yetkilendirme testi).

curl -X POST https://api.thunderphone.com/v1/phone-numbers/{id}/verify-voip \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

Başarılı olduğunda voip_verification_status değeri verified olur ve numara status="active" durumuna geçer. Başarısız olduğunda yanıt, neyin başarısız olduğunu açıklar — sorunu düzeltin (genellikle sağlayıcı panosunda eksik bir trunk atamasıdır) ve yeniden çağırın.

5. Ajanları atayın ve çağrı alın#

Numara doğrulandıktan sonra, gelen / giden ajanları demo numarasında olduğu gibi atarsınız. Bkz. Gelen çağrıları yönetin ve Giden çağrılar yapın.

Kimlik bilgilerini yenileme#

Sağlayıcı anahtarı yenilendiğinde, önce test edip ardından güncelleme akışını yeniden çalıştırın:

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

Bağlantı yerinde kalır — numaraları yeniden içe aktarmanıza gerek yoktur.

Sonraki adımlar#