Karel, Yeastar, 3CX, Asterisk üzerine GalagoAI eklemek: SIP trunk + AI analiz

Yeni bir santrale geçmek istemiyorsunuz — mevcut Karel'iniz, Yeastar'ınız, 3CX'iniz veya Asterisk/FreePBX'iniz iyi çalışıyor. Sadece numara desteği ve AI çağrı analizi eklemek istiyorsunuz. Bu rehberde GalagoAI'nın 4 popüler santral platformuna nasıl entegre olduğunu adım adım gösteriyoruz.

İki entegrasyon kanalı

GalagoAI mevcut santralınızla iki şekilde çalışır:

1. AI Çağrı Analizi (Profesyonel paket) — Asterisk/3CX/FreePBX'ten ses kayıtlarını bize webhook + S3 üzerinden gönderin, biz transkript + skor + raporu API ile size geri dönelim.
2. Full Bulut Geçiş (Kurumsal paket) — Mevcut sistemi tutarken paralel bir bulut santral kurar, kademeli geçişi planlarız. Eski numaralarınız taşınır, eski kayıtlarınız arşivlenir.

Karel DS200 / NetXT entegrasyonu

Karel'in popüler PBX'leri (DS200, NetXT, Aragon serisi) SIP trunk desteğiyle gelir. Web UI üzerinden:

1. Yapılandırma → SIP Trunk Yönetimi → Yeni SIP Trunk
2. Sağlayıcı adı: GalagoAI
3. Sunucu adresi: sip.galagoai.com
4. Kullanıcı/şifre: GalagoAI panelinden alın
5. Kayıt türü: Register, NAT: Evet (sunucu Mersin'de)
6. Trunk testi yap → Kayıt başarılı olunca CLI'ya bağla

Yeastar S20 / S50 / S100 entegrasyonu

Yeastar'ın S serisi VoIP gateway'leri SIP trunk desteğiyle gelir. Yeastar Web UI:

1. Trunks → Add → VoIP Trunk → Register Trunk
2. Provider Name: GalagoAI
3. Hostname/IP: sip.galagoai.com
4. Username/Password: GalagoAI panelinden
5. Domain: galagoai.com, Outbound Proxy: empty
6. Save & Apply, sonra Inbound Routes → DID için bu trunk seç

3CX entegrasyonu (v18+)

3CX'in modern sürümlerinde 'Generic SIP Trunk' template'i var. Adımlar:

1. 3CX Management Console → SIP Trunks → Add SIP Trunk
2. Template: Generic SIP Trunk → Country: Turkey
3. Provider Name: GalagoAI
4. SBC IP: sip.galagoai.com
5. Authentication: Register via 1-To-1 / IP-Based (paneldeki credentials'a göre)
6. DID Numbers: 0850 veya coğrafi numaranızı ekleyin
7. Save & Apply, dial-out rule oluştur

Asterisk / FreePBX / Issabel

Asterisk-tabanlı sistemlerde sip.conf veya pjsip.conf'a trunk eklenir. PJSIP (modern) örnek:

[galagoai-trunk]
type=endpoint
transport=transport-udp
context=from-trunk
disallow=all
allow=alaw
allow=ulaw
outbound_auth=galagoai-auth
aors=galagoai-aor
from_user=YOUR_USER
from_domain=sip.galagoai.com

[galagoai-auth]
type=auth
auth_type=userpass
username=YOUR_USER
password=YOUR_SECRET

[galagoai-aor]
type=aor
contact=sip:sip.galagoai.com:5060

[galagoai-reg]
type=registration
outbound_auth=galagoai-auth
server_uri=sip:sip.galagoai.com
client_uri=sip:[email protected]

FreePBX/Issabel kullanıyorsanız Web UI üzerinden Connectivity → Trunks → Add SIP (chan_pjsip) Trunk → yukarıdaki bilgileri girin, NAT settings: Yes (server Mersin'de).

AI çağrı analizi entegrasyonu

Kayıtlarınızı GalagoAI'ya analiz için göndermenin 2 yolu:

1. Webhook + URL — Asterisk/3CX'in 'recording finished' event'inde webhook tetikleyin, biz ses dosyasını URL'den çekeriz. POST /api/v2/calls/analyze endpoint'imiz dokumante.
2. S3 push — kayıtlarınızı kendi S3 bucket'ınıza yazıyorsanız, bucket'a Read erişimi verin, biz periyodik olarak yeni kayıtları çekeriz.

Her iki yolda da analiz sonucu (transkript + memnuniyet skoru + sentiment + kategori + flagged terms) callback URL'inize POST edilir. JSON formatlı, kolay parse edilir.

Sık karşılaşılan sorunlar (FAQ)

Tek yönlü ses sorunu

Karel DS200 ve bazı Yeastar S20'lerde varsayılan NAT settings nedeniyle gelen aramada arayan sesi duyamaz. Çözüm: SIP trunk ayarlarında 'NAT Aware' ve 'Force RPort' aktif etmek. Detay rehber: yardım merkezimizde 'tek-yonlu-ses-sorunu' makalesi.

Çağrı düşmesi (cache/timeout)

3CX'te 'Session Timer' default 1800 saniye. Uzun çağrılarda kopma olursa bu değeri 3600+ yapın, ayrıca Asterisk için sip.conf 'session-timers=accept'.

DID gelmiyor

DID number SIP INVITE'ında 'To: ' header'ında gelir. Karel/3CX'te bazı şablonlar 'From' kullanır — Inbound Route ayarlarında 'Match by' parametresini 'To User' yapın.