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

Prototipleme için demo numaraları 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 et → bağlantı oluştur → numaraları içe aktar → doğrula.

Pano, bu akışın tamamının rehberli bir sürümünü Bağlantılar → VoIP (/dashboard/voip-connections) altında sunar: hesap oluşturma ve API anahtarlarında yol gösteren bir Telnyx rehberli kurulumu, mevcut hesabı bağlama akışı ve yapay zeka kurulum kılavuzu oluşturucusuna sahip manuel SIP formu.

Desteklenen sağlayıcılar

Sağlayıcı	`provider` kimliği	Notlar
Twilio	`twilio`	API anahtarı + gizli anahtar
Telnyx	`telnyx`	API anahtarı; rehberli ilk kurulum kullanılabilir (`setup_method: guided_telnyx`)
SignalWire	`signalwire`	Yakında — bugün Manuel SIP ile bağlanın
Vonage	`vonage`	Yakında — bugün Manuel SIP ile bağlanın
Manuel SIP	`manual`	Herhangi bir SIP trunk’ı — kendi yapılandırmanızı getirin

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 yoklayın. Bu işlem, oluşturma adımına ileteceğiniz bir verification_evidence_id döndürür; böylece kimlik bilgileri test için iki kez ücretlendirilmez.

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

Response

{
  "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 denetim 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" durumunda bir VoipConnection nesnesidir. Kimlik bilgileri sunucu tarafında depolanır ve sonraki GET isteklerinde asla 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 bilgilerinizle görülebilen 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 çift yönlü doğrulama (gelen arama kontrolü + giden arama yetkilendirme yoklaması) gerekir.

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çıkça belirtir — sorunu giderin (genellikle sağlayıcı panosunda eksik bir trunk atamasıdır) ve çağrıyı yeniden yapın.

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

Numara doğrulandıktan sonra, gelen / giden ajanları demo numarasıyla aynı şekilde atayabilirsiniz. Bkz. Gelen çağrıları yönetin ve Giden aramalar yapın.

Kimlik bilgilerini yenileme

Bir 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ız gerekmez.

Sonraki adımlar

VoIP bağlantıları referansı

Bağlantı, kanıt ve içe aktarma yanıtlarındaki tüm alanlar.

Telefon numaraları referansı

Ajan atayın, kuruluşlar arasında aktarın, numaraları serbest bırakın.

Giden aramalar yapın

Numara artık size ait olduğuna göre, giden aramalar yapmaya başlayın.

Getting Started

Using the dashboard

Connect tools & data

Analyze & improve

Team & account

Developer cookbook

Operations

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

Desteklenen sağlayıcılar

1. Kimlik bilgilerini test edin

2. Bağlantıyı oluşturun

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

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

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

Kimlik bilgilerini yenileme

Sonraki adımlar

VoIP bağlantıları referansı

Telefon numaraları referansı

Giden aramalar yapın

​Desteklenen sağlayıcılar

​1. Kimlik bilgilerini test edin

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

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

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

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

​Kimlik bilgilerini yenileme

​Sonraki adımlar

VoIP bağlantıları referansı

Telefon numaraları referansı

Giden aramalar yapın

Desteklenen sağlayıcılar

1. Kimlik bilgilerini test edin

2. Bağlantıyı oluşturun

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

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

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

Kimlik bilgilerini yenileme

Sonraki adımlar