Mesajlaşma Sağlayıcıları

Bir senaryo e-posta ya da SMS gönderecekse mesajı Selwise hazırlar, ama gönderimi sizin kendi sağlayıcı hesabınız yapar: sizin gönderen adresinizden, sizin kotanızdan. Bu sayfa, sağlayıcıyı bağlamayı, test etmeyi, gönderim sınırlarını ve bastırma listesinin nasıl beslendiğini anlatır. Bağlantı takibi (UTM) ve tarayıcı bildirimleri aynı ekrandadır ama kendi sayfalarında anlatılır: Bağlantı Takibi, Tarayıcı Bildirimleri.

Panelde nerede

Sol menüde Ayarlar → Mesajlaşma Sağlayıcıları (Settings → Messaging Providers), adres /dashboard/settings/messaging.

• Ekran Mesajlaşma modülüne bağlıdır. Hesabınızda bu modül yoksa menüde satır görünmez; hesap yöneticinize başvurun.
• Ekranı görmek için mesajlaşma görüntüleme yetkisi, bağlamak, düzenlemek, test etmek ve sınır ayarlamak için mesajlaşma yönetme yetkisi gerekir. Yetkisi olmayan kişi listeyi görür ama düğmeleri göremez.
• Sağlayıcılar kanal başınadır. Üstteki kanal seçicide bir kanal seçili değilse ekran "Choose a channel" (Bir kanal seçin) der.
• Sayfa yukarıdan aşağıya şunları içerir: sağlayıcı listesi, İYS kartı, Browser notifications (Tarayıcı bildirimleri), Link tracking (UTM) (Bağlantı takibi) ve How often one shopper may hear from you (Bir kişi sizden ne sıklıkta haber alsın).

Sağlayıcı türleri ve alanları

Connect a provider (Sağlayıcı bağla) düğmesi bir pencere açar. Önce Provider (Sağlayıcı) seçilir; alt kısımdaki alanlar seçilen türe göre oluşur. Parola, API anahtarı ve benzeri gizli alanlar bir kez kaydedildikten sonra ekrana geri gelmez; düzenlerken boş bırakırsanız kayıtlı değer korunur.

Tür	Kanal	Kimlik bilgisi alanları	Gönderen alanları
SMTP	E-posta	Host, Port, TLS on connect (port 465), Username, Password	Gönderen adresi, gönderen adı, yanıt adresi
SendGrid	E-posta	API key (SG. ile başlar). Anahtar SendGrid hesabınızda API anahtarları sayfasından alınır	Gönderen adresi, gönderen adı, yanıt adresi
Resend	E-posta	API key (re_ ile başlar)	Gönderen adresi, gönderen adı, yanıt adresi
Netgsm	SMS	Subscriber number (abone numarası, 850…), parola, Approved sender name (onaylı mesaj başlığı)	Ayrı gönderen alanı yoktur
İleti Merkezi	SMS	API key, API hash, Approved sender name	Ayrı gönderen alanı yoktur
Twilio	SMS	Account SID (AC…), Auth token, From number (+1… gibi E.164 numara)	Ayrı gönderen alanı yoktur

Türkçe arayüzde alan adları şöyle basılır: Sunucu, Port, Bağlanırken TLS (port 465), Kullanıcı adı, Parola, API anahtarı, Abone numarası, Onaylı gönderici adı, API hash, Hesap SID, Kimlik jetonu, Gönderen numara.

Netgsm, İleti Merkezi ve Twilio'da gönderen adı bir onaylı başlıktır; sağlayıcınız onaylamadığı bir başlığı reddeder, bu yüzden ortak "gönderen adresi" kutusu yerine kimlik bilgisinin parçası olarak istenir. Her kimlik bilgisi alanının yanında nereden alınacağını gösteren bir "Bunu nereden bulurum?" bağlantısı vardır.

Ortak alanlar

Alan	Açıklama
Name (Ad)	Listede göreceğiniz ad, en çok 120 karakter. Aynı kanalda iki sağlayıcı aynı adı taşıyamaz; çakışırsa kutunun altında "zaten var" uyarısı çıkar
Sender address (Gönderen adresi)	Yalnızca e-posta türlerinde zorunlu. Sağlayıcınızda doğrulanmış olmalı
Sender name (Gönderen adı)	Alıcının gelen kutusunda gördüğü ad, en çok 120 karakter
Reply-to (Yanıt adresi)	Alıcı "yanıtla" dediğinde gidilecek adres; boş bırakılabilir. Düzenlerken boşaltırsanız adres silinir
Rate limit (per minute) (Hız sınırı)	1 ile 6000 arası tam sayı, varsayılan 60. Aşağıdaki "Hız sınırı gerçekte ne yapar" bölümüne bakın

Tür, sağlayıcı oluşturulduktan sonra değiştirilemez; kimlik bilgisi alanları türe göre farklı olduğu için başka türe geçmek yeniden bağlamak demektir.

Doğrulama ve test

Bir sağlayıcı doğrulanmadan senaryo tarafından kullanılamaz. Satırdaki durum rozeti bunu söyler:

Rozet	Anlamı
Never tested (Hiç test edilmedi)	Her sağlayıcı bu durumda başlar. Bu bir hata değildir; sıradaki adım satırdaki Test connection düğmesidir
Verified (Doğrulandı)	Bağlantı testi ya da test gönderimi başarılı oldu
Failed (Başarısız)	Son test başarısız. Rozetin üzerine gelince sağlayıcının kendi hata cümlesi görünür
Inactive (Pasif)	Sağlayıcı devre dışı bırakılmış. Panelde pasifleştirme düğmesi yoktur; durum yalnızca API ile verilir

Satırdaki düğmeler:

• Test connection (Bağlantıyı test et): sağlayıcıya kimlik doğrulaması yapar, hiçbir mesaj göndermez. Dakikada en çok 10 kez basılabilir.
• Send me a test (Bana test gönder): e-posta sağlayıcısında oturum açmış kullanıcının e-posta adresine gerçek bir mesaj gönderir; alıcı seçilemez. SMS sağlayıcısında bir telefon numarası sorulur (uluslararası biçimde, +905321112233) ve test mesajı oraya gider; numara denetim kaydına maskelenerek yazılır. Başarılı olursa sağlayıcı da doğrulanmış sayılır. Dakikada en çok 5 kez basılabilir.
• Edit (Düzenle): alanları değiştirir. Kimlik bilgisini değiştirirseniz doğrulama silinir; yeniden test etmeniz gerekir. Çalışan bir anahtar, yerine yazdığınızın çalıştığını kanıtlamaz.
• Yıldız simgesi, Make default (Varsayılan yap): yalnızca doğrulanmış ve henüz varsayılan olmayan sağlayıcıda görünür.
• Çöp kutusu, Disconnect (Bağlantıyı kes): onay sormadan siler.

Varsayılan sağlayıcı

E-posta ve SMS için ayrı birer varsayılan vardır. Bir kanalda bağladığınız ilk sağlayıcı kendiliğinden varsayılan olur. Varsayılanı silerseniz o kanalda kalan en eski sağlayıcı varsayılan olur; böylece "varsayılanı kullan" diyen hiçbir senaryo adımı sağlayıcısız kalmaz. Başka birini varsayılan yapmak için önce onun doğrulanmış olması gerekir.

Hız sınırı gerçekte ne yapar

Ekranda alanın açıklaması "dakikada göndereceğimiz mesaj sayısı"dır. Gönderim işçisi her dakika bir tur çalışır ve bir turda sağlayıcı başına bu sınırın tamamını gönderir; ancak bir tur kanal başına en çok 100 kayıt alır. Yani varsayılan 60 değeri dakikada 60 mesajdır; 100'ün üstündeki değerler pratikte dakikada 100 mesaj demektir. Sınırı aşan kayıtlar atlanmaz, bir sonraki tura kalır ve deneme hakkından düşmez. Büyük bir kuyruğun boşalması bu yüzden beklediğinizden uzun sürebilir.

Mesaj gönderilirken kontrol edilenler

Her mesaj gönderim anında yeniden denetlenir; kuyrukta beklerken biri izni geri çekmiş olabilir. Gönderilmeyen mesaj, senaryo raporunda şu nedenlerden biriyle atlandı sayılır:

Rapordaki neden	Anlamı
İzin yok (consent_missing)	Kişinin pazarlama izni yok ya da geri çekildi. Bkz. İletişim Listesi
Ulaşılamadı (not_reachable)	Kişinin bu kanalda kayıtlı adresi yok
Bastırma listesinde (suppressed)	Adres bastırma listesinde. Bkz. Bastırma Listesi
İYS kaydı yok (iys_missing)	İYS kuralı gönderimi durdurdu. Bkz. İYS Entegrasyonu
Gösterim sınırı (frequency_cap)	Kişi başına günlük ya da haftalık tavan doldu
Doğrulanmış sağlayıcı yok (provider_unavailable)	Kanalda doğrulanmış, etkin bir sağlayıcı yok
Abonelikten çıkma bağlantısı kurulamadı (misconfigured)	Sunucu tarafında genel API adresi (API_PUBLIC_URL) tanımlı değil; bkz. aşağıdaki bölüm
Zamanında geri dönmedi (ttl_expired)	Mesaj, adımın bekleme süresi içinde gönderilemedi ve süresi doldu

Gönderim sırasında hata olursa:

• Geçici hata (sağlayıcı yanıt vermiyor, hız sınırı): en çok 4 deneme yapılır.
• Kalıcı hata (adres geçersiz): adres bastırma listesine Kullanılabilir bir adres değil nedeniyle eklenir ve mesaj başarısız sayılır.
• Zaman aşımı: sağlayıcıdan cevap gelmemesi gönderilmiş sayılır ve tekrar denenmez; aynı mesajın iki kez gitmesi, hiç gitmemesinden kötü kabul edilir. Rapor bunu "başarısız" olarak gösterir.

Çalışma dışı kalan bir sağlayıcıya art arda istek atmamak için bir devre kesici vardır: sağlayıcı sürekli hata veriyorsa gönderim duraklar ve sağlayıcı düzelince kendiliğinden devam eder.

Gönderim sınırları

Kartın başlığı How often one shopper may hear from you (Bir kişi sizden ne sıklıkta haber alsın). Yalnızca mesajlaşma yönetme yetkisi olanlara görünür ve kanalın tamamı için geçerlidir.

Alan	Aralık	Anlamı
Per day (Günde)	1 ile 100	Bir kişiye son 24 saatte teslim edilmiş mesaj sayısı bu değere ulaştıysa yenisi atlanır
Per week (Haftada)	1 ile 500	Aynısı son 7 gün için

• Boş bırakmak "sınır yok" demektir, sıfır demek değildir. 0 ya da negatif sayı yazarsanız kutunun altında hata görürsünüz; sessizce "sınır yok" olarak kaydedilmez.
• Sayım, teslim edilmiş mesajlar üzerinden, kişi (iletişim kaydı) ve mesaj kanalı başınadır: e-posta ve SMS ayrı sayılır. Tarayıcı bildirimleri kendi sayımını tarayıcı üzerinden yapar. Bu kanaldaki tüm senaryolar birlikte sayılır.
• Sınırı aşan mesaj bekletilmez, atlanır. Pencere ilerlediğinde kişi ya satın almış ya unutmuş olur; geç boşalan bir kuyruk da hepsini birden gönderir.
• E-posta, SMS ve web push adımlarındaki Respect frequency caps (Türkçe arayüzde Gösterim sınırlarına uy) ayarı kapalıysa o adım bu sınıra bakmaz.
• Sayım okunamazsa tur sınırsız gönderime geçmez, bekler.

Bağlantı takibi UTM

Mesajlardaki mağaza bağlantılarına eklenen UTM etiketlerinin kanal ayarı bu karttadır. Alanlar, kurallar ve Selwise'ın kendi sw_sc parametresi: Bağlantı Takibi (UTM).

Tarayıcı bildirimleri

Tarayıcı bildirimleri bir sağlayıcıya bağlanmaz; anahtar çifti, selwise-sw.js dosyası, izin kartı ve aboneliklerin yaşam döngüsü ayrı sayfada: Tarayıcı Bildirimleri.

Abonelikten çıkma bağlantısı

Her e-posta mesajı alt bilgisinde ve List-Unsubscribe başlığında (tek tıkla çıkış, RFC 8058) bir bağlantı taşır. Bağlantı bir önceki mesajdan haftalar sonra da çalışır, çünkü kişiye özel ve türetilmiş bir anahtar kullanır. Alışverişçi bağlantıya tıklayınca izin geri çekilir; açılan sayfada Changed your mind? Resubscribe düğmesi vardır. Aynı kişinin bastırma listesinde ayrıca bir kaydı varsa (geri dönüş, spam) yeniden abone olmak onu kaldırmaz.

SMS mesajlarında Selwise abonelikten çıkma bağlantısı eklemez; "çıkış" satırını sağlayıcınız İYS yükümlülüğü kapsamında ekler. Bu yüzden metne kendiniz yazmayın, alışverişçi iki kez görür.

Teslimat olayları

Sağlayıcının bildirdiği geri dönüşler ve spam şikâyetleri bastırma listesini besler. Selwise bu olayları sağlayıcıdan bir webhook ile alır ve imzayı doğrulayamazsa olayı çöpe atar; böylece adresi bilen biri listenizi bastıramaz.

Sağlayıcı	Olaylar	Durum
SendGrid	teslim edildi, açıldı, tıklandı, geri döndü (sert, engellendi, ertelendi), spam şikâyeti	İmza anahtarı sunucuda tanımlıysa
Resend	teslim edildi, açıldı, tıklandı, geri döndü, geç teslim, şikâyet	İmza sırrı sunucuda tanımlıysa
SMTP	Yok	Geri dönüşler iade adresine posta olarak gelir; Selwise bunu işlemez
Netgsm, İleti Merkezi, Twilio	Yok	Teslim raporları geri çağrı değil sorgudur; bastırma listesi yalnızca gönderimin kendi bildirdiği kalıcı hatalarla dolar

Panelde webhook adresi gösterilmez ve imza anahtarı panelden girilmez; bunu Selwise ekibi sunucu tarafında yapılandırır. Geliştirici notu: olaylar POST /api/v1/public/messaging/SITE_KEY/PROVIDER_ID/events adresine gelir, imza yoksa ya da geçersizse sessizce düşürülür, cevap her zaman 200'dür.

Geri dönüşlerin liste üzerindeki sonucu, adresin bastırılma nedenleri ve listeden çıkarma kuralları için bkz. Bastırma Listesi.

İYS kartı

Kart, bu kanalın İYS bağlantısını Open İYS settings (İYS ayarlarını aç) düğmesiyle açar. Alanların tamamı İYS Entegrasyonu sayfasında anlatılır.

Neden boş, neden gri

Gördüğünüz	Neden
Sol menüde satır yok	Hesapta Mesajlaşma modülü yok
"Choose a channel"	Üstte kanal seçili değil
"No provider connected"	Kanalda henüz sağlayıcı yok; senaryo yine de sayfa üstü teslimat bırakabilir ya da kendi uç noktanızı çağırabilir, ama e-posta ya da SMS gönderemez
Make default yıldızı yok	Sağlayıcı zaten varsayılan ya da henüz doğrulanmamış
Düğmeler yok	Mesajlaşma yönetme yetkiniz yok
Sending limits kartı yok	Aynı yetki; kart yalnızca yönetme yetkisi olanlara çizilir
Tarayıcı bildirimi kartında "Uygulama kanalının bildirim gönderecek tarayıcısı yok"	Seçili kanal bir uygulama kanalı