WhatsApp Ayarları

Yaklaşık 9 dk okuma

Alarm bildirimleri, e-posta ve SMS'e ek olarak WhatsApp ile de gönderilebilir. WhatsApp sağlayıcısı Ayarlar > WhatsApp Ayarları sayfasından tanımlanır. Sayfayı Editor yetkisine sahip kullanıcılar ve SystemAdmin grubu açabilir.

WhatsApp mesajları Meta'da onaylanmış bir mesaj şablonuyla gönderilir; alarm bilgileri şablonun değişkenlerine yerleşir, serbest metin gönderilmez. Mesajlar yalnız WhatsApp iznini vermiş kullanıcılara gider. SMS'te olduğu gibi mesajlar önce kalıcı bir gönderim kuyruğuna yazılır, bildirim servisi kuyruktaki mesajları sağlayıcıya iletir; sağlayıcının yavaş cevap vermesi alarm işlemeyi geciktirmez.

WhatsApp tek alarm kanalı olamaz

WhatsApp bildirimi internet bağlantısına, Meta altyapısına ve üçüncü taraf hesap durumuna bağlıdır; teslim garanti edilmez ve gecikebilir. WhatsApp hiçbir zaman tek alarm kanalı olarak kullanılmamalıdır. E-posta veya SMS bildirimi her zaman etkin kalmalıdır.

Bu uyarı ayar sayfasının üstünde de gösterilir. Bildirim tanımlarında WhatsApp yalnız ek kanal olarak seçilebilir; bkz. Bildirimler.

Lisans

WhatsApp gönderimi lisansta ayrı bir haktır. Hak yoksa ayarlar hazırlanabilir, ancak ne alarm mesajı ne de test mesajı gönderilir.

Kurulu lisans	WhatsApp
Standard ve Professional (güncel lisans modeli)	Pakete dahildir; yeni lisans dosyası gerekmez.
Starter (güncel lisans modeli)	Ek modül olarak lisansa eklenir.
Eski lisans modelleri	Yoktur. Lisansın güncellenmesi için 2WinScada ekibine başvurun.

Kurulu lisans WhatsApp hakkını içermiyorsa sayfanın üstünde Kurulu lisans WhatsApp bildirimlerini içermiyor. ile başlayan bilgi bandı görünür. Lisans uyumu ve WhatsApp ek modüllü lisansların hangi sürümlerde çalıştığı için bkz. Lisans.

Devreye almadan önce

1. Veritabanı ve servisler: 2WinScada 2.10.0 veya üzerine Setup ile güncellenmiş olmalı ve bildirim servisi çalışıyor olmalıdır (bkz. Sürüm Yükseltme).

2. Giden internet erişimi: Bildirim servisinin çalıştığı sunucudan graph.facebook.com adresine HTTPS (TCP 443) çıkışı açık olmalıdır. Gelen bağlantı gerekmez. Tesis ağında doğrudan internet yoksa çıkış DMZ veya kurumsal proxy üzerinden sağlanır. Bkz. İnternet ve Ağ Erişimi.

3. Meta hesabı: Doğrulanmış bir Meta Business hesabı ve WhatsApp Business telefon numarası gerekir. Erişim için Meta'da süresi dolmayan bir System User erişim belirteci (token) oluşturulur.

4. Mesaj şablonu: Meta'da Utility kategorisinde, scada_alarm_v1 adlı ve tr dilli bir şablon oluşturulup onaylatılır. Şablon gövdesi beş değişkeni bu sırayla içermelidir:

2WinScada alarm bildirimi
Tesis: {{1}}
Önem: {{2}}
Cihaz: {{3}}
Alarm: {{4}}
Zaman: {{5}}
Bu mesaj otomatik gönderilmiştir. Ayrıntılar için SCADA ekranını kontrol edin.

Değişkenler şöyle doldurulur:

Değişken	İçerik
{{1}}	Tesis adı ayarı
{{2}}	Alarmın önemi: Uyarı veya Hata
{{3}}	Alarmın bağlı olduğu cihazın adı
{{4}}	Alarm açıklaması
{{5}}	Alarm zamanı (gg.aa.yyyy ss:dd:ss biçiminde)

Değişkenlerdeki satır sonları ve sekmeler tek boşluğa çevrilir. 120 karakteri aşan değer kısaltılır ve sonuna … eklenir; boş değerin yerine - yazılır. Proses değerleri mesaja eklenmez.

SCADA, şablonun Meta'da onaylı olup olmadığını denetleyemez. Şablon adı, dili ve değişken sayısı test mesajıyla doğrulanır.

Ayar alanları

WhatsApp sağlayıcı ayarları kartındaki alanlar:

Alan	Açıklama
WhatsApp bildirimlerini etkinleştir	Kapalıyken alarmlar için WhatsApp mesajı oluşturulmaz.
Sağlayıcı	Mesajların gönderileceği hizmet. Gönderim için yalnız Meta Cloud API kullanılabilir (aşağıya bakın).
Tesis adı	Her mesajda tesis olarak gösterilen ad; 1–60 karakter. WhatsApp etkinken zorunludur.
Varsayılan ülke kodu	Ülke kodu olmadan yazılmış numaralara eklenen kod. Varsayılan +90.
Şablon adı	Meta'da onaylı şablonun adı; yalnız küçük harf, rakam ve alt çizgi. Varsayılan scada_alarm_v1.
Şablon dili	Onaylı şablonun dil kodu; 2–15 karakter. Varsayılan tr.
Zaman aşımı (saniye)	Sağlayıcıdan cevap için en fazla beklenecek süre; 1–120 saniye. Varsayılan 30.
Tekrar deneme sayısı	Geçici hatalarda yapılacak tekrar sayısı; 0–10. Varsayılan 3.
Tekrar deneme gecikmesi (saniye)	Tekrar denemeler arasındaki temel süre; 1–3600 saniye. Varsayılan 60. Denemeler bu sürenin 1, 5 ve 15 katı sonra yapılır.

Şablon adı ve dili Meta'da onaylanan değerlerle birebir aynı olmalıdır.

Sağlayıcı alanları

Meta Cloud API seçildiğinde sağlayıcı kartında şu alanlar bulunur. Yıldızla (*) işaretli alanlar WhatsApp etkinken zorunludur.

Alan	Açıklama
Telefon numarası kimliği (Phone number ID)*	Meta panelindeki WhatsApp telefon numarası kimliği.
İşletme hesabı kimliği	Meta panelindeki WhatsApp Business hesap kimliği.
Erişim belirteci (Access token)*	System User erişim belirteci.
API temel adresi	Boş bırakılırsa https://graph.facebook.com kullanılır. Girilirse https:// ile başlayan tam adres olmalıdır.
API sürümü	Boş bırakılırsa v21.0 kullanılır. Meta eski API sürümlerini emekliye ayırdığında bu alandan güncellenir.

Erişim belirteci şifrelenerek saklanır ve sayfaya hiçbir zaman geri gönderilmez. Kayıtlı belirteç varsa alanın altında Korunan bir değer kayıtlı. Korumak için boş bırakın. yazar. Değiştirmek için yeni değeri girin; silmek için Kayıtlı değeri sil düğmesine basıp ayarları kaydedin.

Gönderim için yalnız Meta Cloud API desteklenir. Listedeki diğer sağlayıcılar seçildiğinde WhatsApp etkinken ayarlar kaydedilemez.

Sağlayıcı değiştirme

Farklı bir sağlayıcı seçip kaydettiğinizde önceki sağlayıcının kayıtlı bilgileri silinir.

Değişiklikleri kaydetmek için Ayarları kaydet düğmesine basın. Kaydetmek lisans hakkı gerektirmez.

Kullanım ve eşikler

Meta, şablon mesajlarını ücretlendirir. Ürün ücret bilgisi göstermez; güncel tarife için Meta'ya bakın. Kullanım ve eşikler kartı sağlayıcının kabul ettiği mesaj sayısını ve uyarı eşiklerini gösterir:

• bugün kabul edilen ve son 30 günde kabul edilen sayılar, ilgili eşikle birlikte (sayı / eşik) gösterilir. Test mesajları sayılmaz.
• Günlük uyarı eşiği (varsayılan 200) veya 30 günlük uyarı eşiği (varsayılan 3000) değerine ulaşılınca kartta uyarı bandı görünür ve bildirim servisi günde bir kez uyarı günlüğü yazar. Gönderim durmaz.
• Günlük kesin limit isteğe bağlıdır; varsayılanı kapalıdır. Kapatmak için alanı boş bırakın. Limit dolduktan sonra o gün oluşan WhatsApp mesajları gönderilmez; geçmişte Doğrulama başarısız durumunda, Günlük WhatsApp limiti doldu hata koduyla görünür. E-posta ve SMS etkilenmez.

Sayaçlar alınamazsa Kullanım sayaçları alınamadı. Bildirim Servisi bağlantısını kontrol edin. yazar.

Şablon ön izlemesi

Şablon ön izlemesi kartı, gönderilecek mesajın görünümünü örnek bir alarmla gösterir. Önem, Cihaz ve Alarm alanları doldurulup Ön izlemeyi yenile düğmesine basılır; boş bırakılan alanlar için örnek değer kullanılır. Ön izleme, kaydedilmemiş tesis adı ve dil ile hazırlanır; satır sonları ve uzun değerler gerçek mesajdaki gibi temizlenir.

Alıcı izni

WhatsApp mesajı yalnız WhatsApp izni kayıtlı olan ve izin verdiği numara güncel telefon numarasıyla aynı olan kullanıcılara gönderilir. İzin iki yolla kaydedilir:

• Kullanıcının kendisi: Hesabım sayfasındaki WhatsApp alarm bildirimleri bölümünde izin metnini okuyup kabul eder ve istediği zaman geri çeker. Bkz. Hesabım.
• Yönetici: Kullanıcılar tablosundaki WhatsApp düğmesiyle, ıslak imzalı form veya yazılı onayın referansını girerek izni kaydeder ya da geri çeker. Bkz. Kullanıcı ve Grup Yönetimi.

İzin kaydı için kullanıcının geçerli bir cep telefonu numarası kayıtlı olmalıdır.

• Telefon numarası değişince izin geçersiz olur ve durumu İzin yeniden gerekli olarak görünür. Yeni numara için izin yeniden alınmalıdır.
• İzin geri çekildiğinde henüz gönderilmemiş mesajlar gönderilmez; geçmişte İptal edildi olarak görünür.
• İzni olmayan alıcılar sessizce atlanmaz. Bu alıcılar için Bildirim Geçmişi'nde Doğrulama başarısız durumunda bir kayıt açılır; hata kodu Alıcının WhatsApp izni yok veya İzinden sonra telefon numarası değişti olur.

Kullanıcılar tablosundaki WhatsApp izni sütunu ve Hesabım sayfasındaki bölüm yalnız kurulu lisans WhatsApp hakkını içerdiğinde görünür.

Test mesajı

Test mesajı kartı, kayıtlı ayarların gerçek bir gönderimle denenmesini sağlar:

1. Sağlayıcı bilgilerini girin, WhatsApp bildirimlerini etkinleştir kutusunu işaretleyin ve Ayarları kaydet düğmesine basın.
2. Test telefonu alanına WhatsApp kullanan bir numara yazın. Alan yalnız rakam, +, parantez ve boşluk kabul eder.
3. Test mesajını kuyruğa al düğmesine basın.
4. Kartta kuyruğa alınan, geçersiz ve tekrar eden mesaj sayısı ile varsa uyarılar gösterilir.
5. Sonucu Arşiv > Bildirim Geçmişi ekranında Kanal olarak WhatsApp seçerek izleyin (bkz. Bildirim Geçmişi).

• Test mesajı onaylı şablonu örnek alarm değerleriyle kullanır. Test için alıcı izni gerekmez.
• Varsayılan ülke kodu +90 iken yalnız Türkiye cep telefonu numaraları kabul edilir (ör. +90 5XX XXX XX XX). Geçersiz numarada Geçerli bir cep telefonu numarası girin. uyarısı görünür.
• Düğme yalnız WhatsApp bildirimlerini etkinleştir işaretliyken ve gönderime hazır bir sağlayıcı seçiliyken etkindir.
• Test mesajı lisans hakkı gerektirir ve sağlayıcı tarafından ücretlendirilebilir.

Kartta görülebilecek uyarılar:

Uyarı	Anlamı
Kayıtlı ayarlarda WhatsApp bildirimleri kapalı.	Etkinleştirme kutusu işaretli ama ayarlar kaydedilmemiş. Önce Ayarları kaydet düğmesine basın.
Kurulu lisans WhatsApp mesajlarına izin vermiyor.	Lisans WhatsApp hakkını içermiyor.

Kabul edildi ne demektir

Mesaj Meta'ya iletildiğinde kaydın durumu Kabul edildi olur. Bu, Meta'nın isteği kabul ettiğini gösterir; mesajın telefona ulaştığını göstermez. Meta teslim ve okundu bilgisini yalnız SCADA sunucusuna dışarıdan gelen bir bağlantıyla (webhook) bildirir. SCADA sunucusuna dışarıdan bağlantı açılmadığı için bu bilgi gelmez ve WhatsApp kayıtlarının son durumu Kabul edildi olarak kalır.

Hata kodları

Başarısız gönderimlerde Bildirim Geçmişi'ndeki Hata kodu sütununda Meta'nın hata kodu Meta:<kod> biçiminde görünür.

Hata kodu	Anlamı	Yapılacak
Meta:190	Erişim belirteci geçersiz veya süresi dolmuş.	Yeni bir System User erişim belirteci girin.
Meta:132001 ve şablon hataları	Şablon bulunamadı veya değişkenler uyuşmuyor.	Şablon adı, Şablon dili ve şablonun Meta'daki onay durumunu kontrol edin. Tekrar denenmez.
Meta:130429 ve hız sınırı hataları	Hız sınırı veya geçici hata.	Otomatik tekrar denenir. Hata sürerse Meta hesabının durumunu kontrol edin.
Meta:131026 ve alıcı hataları	Alıcı WhatsApp kullanmıyor veya ulaşılamıyor ya da hesap kısıtlı.	Alıcının numarasını ve Meta hesabının mesajlaşma sınırlarını kontrol edin. Tekrar denenmez.
Meta:131042	Meta hesabının ödeme yöntemiyle ilgili sorun.	Meta hesabındaki ödeme bilgilerini kontrol edin.
Sağlayıcı kullanılamıyor	Mesaj kuyruktayken WhatsApp kapatıldı veya sağlayıcı değiştirildi.	Ayarları kontrol edin.
Lisans izin vermiyor	Mesaj gönderilmeden önce lisans WhatsApp hakkını kaybetti; kayıt Lisans nedeniyle askıda durumundadır.	Lisansı kontrol edin. Bu kayıtlar yeniden gönderilmez.

Ağ hatası, zaman aşımı ve geçici sağlayıcı hataları Tekrar deneme sayısı kadar yeniden denenir; denemeler bitince kayıt Başarısız olur. İnternet kesintisi alarm işlemeyi ve e-posta/SMS gönderimini etkilemez.

Lisans nedeniyle askıdaki WhatsApp mesajları

Lisans WhatsApp hakkını kaybederse gönderilmemiş WhatsApp mesajları Lisans nedeniyle askıda durumuna alınır. SMS'ten farklı olarak askıdaki WhatsApp mesajları yeniden kuyruğa alınamaz: gecikmiş bir alarm mesajı işletme açısından değer taşımaz ve ücret doğurur. Bu kayıtlar yalnız geçmişte kalır ve 30 gün sonra silinir.

Geçmiş ve saklama süresi

• WhatsApp gönderim geçmişi e-posta ve SMS gibi 30 gün saklanır; daha eski kayıtlar otomatik silinir.
• Geçmişte telefon numaraları maskelenmiş gösterilir.
• Servis günlüklerine tam telefon numarası, mesaj içeriği veya erişim belirteci yazılmaz.

Yedekleme

WhatsApp yapılandırması yedekte iki ayrı modüldür (bkz. Yedekleme ve Geri Yükleme):

• WhatsApp Ayarları: Sağlayıcı ayarları ve erişim belirteci.
• WhatsApp Alıcı İzinleri: Kullanıcıların izin kayıtları. Bu modül Kullanıcılar modülüne bağlıdır.

Erişim belirteci yedekte yer alır; yedek paketini gizli bilgi gibi saklayın. Başka bir kurulumda geri yüklemeden sonra test mesajı gönderin; başarısız olursa belirteci yeniden girin. Bildirim tanımlarındaki WhatsApp seçimi Bildirimler modülüyle taşınır. WhatsApp'tan önceki sürümlerde alınmış yedekler WhatsApp kapalı olarak geri yüklenir.

Kişisel verilerin korunması

Telefon numarası ve alarm bilgisi kişisel veridir. Meta bu veriyi yurt dışında işleyebilir. Yurt dışına aktarımın hukuki dayanağını ve aydınlatma ile izin metnini veri sorumlusu olarak işletme kendi hukuk birimiyle belirler. Ürün bunun için izin kaydı, maskeli geçmiş, 30 günlük saklama ve izni geri çekme araçlarını sağlar.

Bu not hukuki görüş değildir.

Sorun giderme

Belirti	Olası neden ve çözüm
WhatsApp ayarları yüklenemedi.	Oturumu ve yetkinizi kontrol edin; sayfayı yenileyin.
WhatsApp ayarları kaydedilemedi.	Tesis adı, Şablon adı, Şablon dili ve sağlayıcının zorunlu alanlarını kontrol edin. API temel adresi girildiyse https:// ile başlamalıdır.
WhatsApp test mesajı kuyruğa alınamadı.	Bildirim servisinin çalıştığını kontrol edin.
Hiç WhatsApp kaydı oluşmuyor	WhatsApp bildirimlerini etkinleştir ayarını, lisansın WhatsApp hakkını (hak yoksa kayıt açılmaz), bildirim tanımındaki WhatsApp seçimini ve bildirime kullanıcı eklendiğini kontrol edin.
Kayıt Doğrulama başarısız durumunda	Hata kodu sütununa bakın: alıcının izni yoksa veya numarası değiştiyse izni yeniden alın; numara geçersizse kullanıcı kaydındaki telefon numarasını düzeltin.
Kayıt Kabul edildi ama mesaj gelmedi	Alıcının numarasında WhatsApp kullanıldığını ve Meta hesabının mesajlaşma sınırlarını kontrol edin. Teslim bilgisi SCADA'ya gelmez.