EntegrasyonlarTelefon Numarası (SIP)

Telefon Numarası (SIP)

Purvisor’ın arama yapabilmesi (outbound) veya arama alabilmesi (inbound) için bir telefon numarasının bağlı olması gerekir. Numara bir SIP trunk üzerinden gelir — Türkiye’de tipik olarak Netgsm, uluslararası için Twilio. SIP trunk, telefon şebekesi ile Purvisor’ın gerçek zamanlı medya altyapısı (LiveKit) arasındaki köprüdür.

Bu adım, Purvisor’la yapacağın hemen her şeyin önkoşuludur: test araması, kampanya, Meta lead otomatik araması, kadans “arama” adımı — hepsi bağlı bir numara ister. “Telefon numarası bulunamadı” hatası alıyorsan, çözüm bu sayfada.

Kavramlar (kısaca)

  • SIP trunk: Operatörünün (Netgsm/Twilio) sana verdiği, sesli çağrıları IP üzerinden taşıyan “hat”. Bir kullanıcı adı/şifre veya kimlik bilgisi ve bir sunucu adresi (host) ile tanımlanır.
  • Inbound (gelen): Müşteri senin numaranı arar → operatör çağrıyı SIP trunk üzerinden Purvisor’a iletir → inbound asistan açar.
  • Outbound (giden): Purvisor bir kontağı arar → çağrı SIP trunk üzerinden operatöre, oradan müşteriye gider; arayan numara olarak senin numaran görünür.
  • E.164: Telefon numaralarının uluslararası formatı — +90 5XX XXX XX XX gibi, başında + ve ülke kodu. Purvisor kontak numaralarını bu formatta bekler.

Ön koşullar

  • Operatörünüzden SIP trunk hizmeti — kimlik bilgileri ve trunk adresi. Twilio kullanıyorsan bu, hesabındaki Elastic SIP Trunking → Termination yapılandırmasıdır; Account SID + Auth Token tek başına arama için yetmez.
  • En az bir telefon numarası (operatörden alınmış veya taşınmış).
  • (Inbound için) Operatör tarafında o numaranın gelen çağrılarının bu SIP trunk’a yönlendirilmiş olması.

Kurulum

SIP trunk bilgilerini hazırla

Operatöründen şunları al:

Netgsm için (tipik):

  • SIP kullanıcı adı / hat no
  • SIP şifresi
  • SIP sunucu adresi (host)
  • Numara(lar)

Twilio için (tipik):

  • Elastic SIP Trunk (Termination URI, Origination ayarları)
  • Credential list (kullanıcı adı/şifre) veya IP ACL
  • Satın alınmış numara(lar)

Panelde numara ekle

Telefon Numaraları → Numara Ekle dediğinde önce iki sağlayıcı kartı çıkar — Twilio ve SIP Trunk — sonra seçtiğine göre farklı bir form açılır:

YolDoldurduğun alanlarSonuç
SIP Trunk (Netgsm ve benzeri)Bölge, Trunk Adı, SIP Address, Transport, Telefon Numaraları (virgülle çok numara), Username, Password, Görünen AdLiveKit’te outbound SIP trunk oluşturulur ve her numara için ayrı kayıt açılır — numara doğrudan arama yapabilir
TwilioBölge, Account SID, Auth Token, Telefon Numarası, Görünen Ad + (arama için) Termination SIP URI, SIP Kullanıcı Adı, SIP Şifre, TransportTwilio hesabın doğrulanır; Termination bilgilerini de girdiysen LiveKit trunk’ı kurulur
⚠️

Twilio yolunda sadece Account SID + Auth Token girersen numara kaydedilir ama arama yapamaz — panel bunu hem ekleme sonrası bir uyarı ekranında hem de numara kartında “Bu numarayla arama yapılamaz” bandıyla söyler. Arama için Twilio konsolundaki Elastic SIP Trunking → Termination bilgilerini de girmen gerekir.

Trunk’ın LiveKit tarafında oluşturulması bu formun kendi işidir — ayrı bir teknik adım yok. SIP Trunk formunu gönderdiğinde trunk anında kurulmaya çalışılır; sağlayıcı bilgileri hatalıysa kayıt hiç oluşmaz ve hata anında döner. Alan alan anlatım için: Twilio ve SIP Trunk Bağlama (Gelişmiş).

📸 [Ekran görüntüsü: Telefon Numaraları sayfası — “Numara Ekle” formu]

Numarayı asistanlara/kampanyalara ata

Eklenen numara, kampanya oluştururken “telefon numarası” alanında seçilebilir hale gelir; otomatik lead aramaları ve kadans “arama” adımları da kullanıcının aktif numarasını kullanır. Bir hesapta birden çok numara olabilir (farklı operatörler/bölgeler için).

Test et

  • Outbound test: Kendini bir kontak olarak ekle → tek kişilik bir kampanya veya test araması başlat → telefonun çalmalı, arayan numara olarak bağladığın numara görünmeli.
  • Inbound test: (Inbound asistanın varsa) bağladığın numarayı başka bir telefondan ara → inbound asistan açmalı.

Gelen/giden ayrımı

  • Sadece outbound kullanacaksan (kampanyalar, lead aramaları, kadans aramaları), operatör tarafında özel bir gelen yönlendirme şart değil — numara “arayan kimlik” olarak yeterli.
  • Inbound da istiyorsan, operatör tarafında o numaranın gelen çağrılarının SIP trunk’a yönlendirilmesi gerekir; ardından Purvisor’da o numarayı bir inbound asistana bağlarsın.

İyi uygulamalar

  • Aramalarda gerçek, doğrulanabilir bir numara kullan — gizli/anonim numara hem açılma oranını düşürür hem operatör politikalarına takılabilir.
  • Bölgeye uygun numara seç — Türkiye’deki müşterileri Türk numarasından aramak, açılma oranını ve güveni artırır.
  • Numara durumunu izle — operatör hattı askıya alınırsa aramalar sessizce başarısız olur; panelde numara aktif/pasif durumunu ve son arama sonuçlarını takip et.
  • E.164’e sadık kal — CSV import ederken telefon sütununu +90... formatına çevir; eksik/yanlış formatlı numaralar aranamaz.

Sorun giderme

BelirtiOlası neden / çözüm
”Telefon numarası bulunamadı” hatasıHesabında aktif bir numara yok, ya da seçilen numara silinmiş → Telefon Numaraları’ndan numara ekle veya kampanya/kadans ayarında başka bir numara seç.
”Kampanya numarasına bağlı bir SIP trunk bulunamadı”Numaranın sip_trunk_id’si yok — genelde Twilio numarası Elastic SIP Termination bilgileri verilmeden eklendiğinde olur. Numara kartında “Bu numarayla arama yapılamaz” bandı da görünür; numarayı silip Termination bilgileriyle tekrar ekle.
Arama hiç çalmadıSIP trunk kimlik bilgileri yanlış; operatör hattı pasif; kontak numarası E.164 değil.
Arama çalıyor ama hemen kapanıyorSIP trunk medya (RTP) ayarı / codec uyumsuzluğu → trunk yapılandırmasını operatörle doğrula.
Arayan numara yanlış / gizli görünüyorOutbound caller ID ayarı yapılmamış → numara kaydında doğru numarayı arayan kimlik olarak ayarla; operatörde caller ID izinli olsun.
Inbound aramalar gelmiyorOperatörde gelen yönlendirme SIP trunk’a kurulmamış veya numara bir inbound asistana bağlanmamış.
Mesai dışı arama yapılmadı(Otomatik aramalar) mesai penceresi kuralı devrede → ayar değil, beklenen davranış.

İlgili

Faz 2’de eklenecek: Kampanya Oluşturma.