Twilio ve SIP Trunk Bağlama (Gelişmiş)

Panelde Telefon Numaraları → Numara Ekle dediğinde önüne iki kart çıkar: Twilio ve SIP Trunk. İkisi de aynı hedefe gider — asistanının arayabileceği/cevaplayabileceği bir numara — ama arka planda tamamen farklı iki şey olur: biri bir üçüncü parti hesabı doğrular, diğeri LiveKit üzerinde gerçek zamanlı bir outbound SIP trunk kurar. Bu sayfa o iki yolu alan alan, hata hata anlatır. Genel kavramlar ve gelen/giden ayrımı için önce Telefon Numarası (SIP) sayfasına bak — burası onun ileri seviye devamı.

İki yol, tek karar

Nasıl çalışır (mimari)

Panel → Telefon Numaraları → Numara Ekle → Sağlayıcı seç
                                  │
                  ┌───────────────┴───────────────┐
                  │                                │
              Twilio                          SIP Trunk
                  │                                │
   POST /api/phone-numbers/twilio      POST /api/phone-numbers/sip
                  │                                │
   Twilio API'ye Account SID/Auth       LiveKit SipClient
   Token doğrulanır (gerçek zamanlı)    .createSipOutboundTrunk()
                  │                                │
   Termination bilgisi verildiyse       LiveKit'te trunk oluşur
   LiveKit'te outbound trunk kurulur    → sipTrunkId döner
                  │                                │
   PhoneNumber kaydı (provider:                    │
   twilio; trunk kurulduysa                        │
   sip_trunk_id dolu, yoksa boş)                   │
                  │                                │
                  │                    PhoneNumber kaydı (her numara
                  │                    için ayrı satır, provider:
                  │                    livekit_sip, aynı sipTrunkId)

Yol 1: Twilio hesabı bağlama

Panelin arka planda gönderdiği istek, teknik referans için:

POST /api/phone-numbers/twilio
{
  "accountSid": "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "authToken": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "phoneNumber": "+15551234567",
  "friendlyName": "US Ana Hat",
  "terminationUri": "ornek.pstn.twilio.com",
  "sipUsername": "credential-list-kullanicisi",
  "sipPassword": "xxxxxxxxxxxx",
  "transport": "tls",
  "regionCode": "US"
}

terminationUri / sipUsername / sipPassword üçlüsünü hiç göndermezsen istek yine başarılı olur — ama dönen numara yalnızca SMS içindir.

Yol 2: SIP Trunk oluşturma (LiveKit outbound trunk)

SIP trunk yolu, üçüncü bir servisi (Twilio gibi) doğrulamaz — doğrudan Purvisor’ın gerçek zamanlı ses altyapısı olan LiveKit üzerinde bir outbound SIP trunk yaratır. Bu, “Purvisor buradan çıkış yapıp arama başlatabilir” demenin teknik karşılığıdır; gelen aramaları kapsamaz (bkz. Gelen Aramalar).

Panelin gönderdiği istek:

POST /api/phone-numbers/sip
{
  "trunkName": "netgsm-trunk",
  "address": "sip.netgsm.com.tr",
  "transport": "udp",
  "numbers": "+905XXXXXXXXX, +905YYYYYYYYY",
  "username": "8503XXXXXX",
  "password": "xxxxxxxxxxxx",
  "friendlyName": "NetGSM Ana Hat",
  "regionCode": "TR"
}

Transport seçimi: UDP / TCP / TLS

Transport, SIP sinyalinin ağ üzerinde nasıl taşınacağını belirler — LiveKit’in SIPTransport enum’una şöyle eşlenir: UDP = 0, TCP = 1, TLS = 2.

• UDP (varsayılan) — en yaygın, çoğu operatörün beklediği seçenek. Bilmiyorsan buradan başla.
• TCP — bağlantı temelli, UDP ile sorun yaşarsan dene.
• TLS — şifreli sinyalleşme; sağlayıcın özellikle istiyorsa veya güvenlik gereksinimin varsa seç.

Sağlayıcın hangisini istediğini belirtmiyorsa UDP ile başla; arama kurulamıyorsa sağlayıcı desteğine transport’u sor.

Birden çok numara, tek trunk

numbers alanına yazdığın numaralar (virgülle ayrılmış) tek bir SIP trunk’ı paylaşır — aynı kullanıcı adı/şifre ile aynı sağlayıcıya çıkarlar ama panelde ayrı ayrı numaralar olarak görünür, her birine ayrı asistan/kampanya atayabilirsin. Operatörden birden fazla DID (numara) aldıysan tek seferde ekleyebilirsin.

Numarayı yönetme: aktif/pasif, silme, asistana bağlama

• Aktif/pasif — numara kartında Aktif/Pasif rozetini görürsün ve pasif numaralar aramada kullanılmaz; ancak panelde şu an bunu değiştiren bir düğme yok, durum yalnızca API’den (PATCH /api/phone-numbers/{id} → isActive) değiştirilebiliyor.
• Düzenleme — panelde “Düzenle” ile değiştirebildiğin iki alan var: Görünen Ad ve Asistana Bağla (gelen çağrı). Numaranın kendisi, sağlayıcı ve trunk bilgileri düzenlenemez.
• Silme — panelden “Sil” dediğinde numara kalıcı silinmez, soft-delete uygulanır (kayıt gizlenir, iz kaybolmaz).
• Asistana bağlama (inbound) — bir numarayı belirli bir asistana bağlayabilirsin; bu numaraya gelen çağrılar o asistana düşer. Sadece kendi asistanına bağlayabilirsin, backend sahiplik kontrolü yapar. Detay: Gelen Aramalar.

Hangisini seçmeliyim?

• “SIP trunk kurulumu karmaşık görünüyor” — haklı endişe, ama tek seferlik bir işlem. Kurulduktan sonra numara yönetimi (asistana bağlama, aktif/pasif) Twilio numarasından farksız; panelde aynı listede görünür.
• Türkiye’de yerel/toplu hat istiyorsan (çağrı merkezi, çok numaralı kampanya) SIP trunk genelde maliyet ve esneklik açısından daha uygun.
• Zaten Twilio kullanıyorsan veya uluslararası bir numaraya ihtiyacın varsa Twilio yolu daha az adımda biter — kredi kartı/kota yönetimi Twilio tarafında kalır. Ama unutma: Twilio yolunda da arama yapmak için Elastic SIP Termination kurulumu gerekir; “daha az adım” demek “SIP’siz” demek değil.
• Sadece SMS gönderecekseniz Twilio yolunu Termination bilgisi vermeden kullanabilirsin — numara kaydedilir, arama yapamaz.

Sorun giderme

İlgili