Bildirim Kanalları

KLog Server, sistem bildirimlerini ve log uyarılarını e-posta dışında Telegram, Slack, Microsoft Teams, Google Chat veya WhatsApp üzerinden de gönderebilir. Bir kanal, "Ayarlar" > "Bildirim Kanalları" bölümünde bir kez tanımlandıktan sonra, "Tercihler" > "Bildirimler" ve "Log Uyarıları" kurallarında e-postaya ek veya alternatif alıcı olarak seçilebilir.

• Genel Bakış
• Kanal Ekleme
• Telegram
• Slack
• Microsoft Teams
• Google Chat
• WhatsApp
• Kanalı Test Etme
• Kanalı Düzenleme
• Kanalı Silme
• Bildirim Kurallarında Kullanım

Genel Bakış

Tanımlanan kanallar "Ayarlar" > "Bildirim Kanalları" bölümünde bir liste halinde görüntülenir; her kanal için Test Gönder, Düzenle ve Sil işlemleri buradaki açılır menüden yapılır.

Kanal Ekleme

Bir kanal eklemek için genel adımlar:

1. "Ayarlar" > "Bildirim Kanalları" bölümüne gidiniz.
2. "Kanal Ekle" butonuna tıklayınız.
3. "Kanal Adı" alanına, bu kanalı kural düzenleme sayfalarında tanımak için kullanılacak bir isim giriniz (örn. "IT Ekibi").
4. "Tür" listesinden kanal türünü seçiniz. Aşağıdaki alanlar seçilen türe göre değişir; her tür için gereken bilgiler ilgili alt başlıkta açıklanmıştır.
5. Gerekli alanları doldurup "Ekle" butonuna basınız.

Telegram

1. Telegram uygulamasında @BotFather ile bir sohbet başlatınız.
2. /newbot komutunu gönderiniz.
3. Botunuz için bir görünen ad (örn. "KLog Server Bildirimleri") giriniz.
4. Botunuz için "bot" ile biten benzersiz bir kullanıcı adı giriniz (örn. klogserver_bot).
5. BotFather bir API token'ı döndürür (örn. 123456789:AAExampleTokenHere); bu değeri kopyalayıp "Bot Token" alanına gireceksiniz.
6. Botu, bildirimlerin gönderilmesini istediğiniz kişi, grup veya kanala ekleyiniz. Gruba eklerken, mesaj gönderebilmesi için gerekirse botu yönetici yapınız.
7. Bot eklendikten sonra o sohbete herhangi bir mesaj gönderiniz (chat ID'nin bir sonraki adımda görünebilmesi için gereklidir).
8. Tarayıcıdan https://api.telegram.org/bot<token>/getUpdates adresine gidiniz (<token> yerine kendi bot token'ınızı yazınız).
9. Dönen yanıtta "chat":{"id": ...} alanındaki sayısal değeri bulunuz (gruplar için genellikle negatif bir sayıdır, örn. -1001234567890) ve "Chat ID" alanına giriniz.
10. KLog Server'da "Ayarlar" > "Bildirim Kanalları" > "Kanal Ekle" bölümünde Tür olarak "Telegram" seçip Bot Token ve Chat ID alanlarını doldurunuz, ardından "Ekle" butonuna basınız.

Slack

1. api.slack.com/apps adresine gidip Slack hesabınızla oturum açınız.
2. "Create New App" butonuna tıklayıp "From scratch" seçeneğini seçiniz.
3. Uygulamaya bir isim veriniz (örn. "KLog Server Bildirimleri") ve bildirimlerin gönderileceği çalışma alanını (workspace) seçiniz, ardından "Create App" butonuna basınız.
4. Sol menüden "Incoming Webhooks" bölümüne gidiniz.
5. "Activate Incoming Webhooks" anahtarını açınız.
6. Sayfanın altındaki "Add New Webhook to Workspace" butonuna tıklayınız.
7. Bildirimlerin gönderileceği kanalı seçip izni onaylayınız.
8. Oluşturulan Webhook URL'sini (https://hooks.slack.com/services/... biçiminde) kopyalayınız.
9. KLog Server'da "Ayarlar" > "Bildirim Kanalları" > "Kanal Ekle" bölümünde Tür olarak "Slack" seçip Webhook URL alanına bu adresi yapıştırınız, ardından "Ekle" butonuna basınız.

Microsoft Teams

1. Bildirimlerin gönderileceği Teams kanalına gidiniz.
2. Kanal başlığının yanındaki "•••" (Daha fazla seçenek) simgesine tıklayıp "Workflows" seçeneğini seçiniz.
3. Açılan pencerede "Bir webhook isteği alındığında bir kanala gönder" şablonunu arayıp seçiniz.
4. Gerekiyorsa Microsoft hesabınızla oturum açınız.
5. Workflow için bir isim giriniz, hedef takım ve kanalın doğru seçili olduğunu kontrol edip "Sonraki" ile devam ediniz.
6. "Workflow'u oluştur" butonuna tıklayınız.
7. Oluşturma tamamlandığında gösterilen Webhook URL'sini kopyalayıp "Bitti" butonuna basınız.
8. KLog Server'da "Ayarlar" > "Bildirim Kanalları" > "Kanal Ekle" bölümünde Tür olarak "Microsoft Teams" seçip Webhook URL alanına bu adresi yapıştırınız, ardından "Ekle" butonuna basınız.

Google Chat

1. Google Chat'te bildirimlerin gönderileceği alana (space) gidiniz.
2. Alan adının yanındaki oka tıklayıp "Uygulamalar ve Entegrasyonlar" (Apps & integrations) seçeneğini seçiniz.
3. "Webhookler ekle" (Add webhooks) seçeneğine tıklayınız.
4. Webhook için bir isim ve isteğe bağlı bir avatar URL'si giriniz.
5. "Kaydet" butonuna basınız.
6. Oluşturulan Webhook URL'sini kopyalayınız.
7. KLog Server'da "Ayarlar" > "Bildirim Kanalları" > "Kanal Ekle" bölümünde Tür olarak "Google Chat" seçip Webhook URL alanına bu adresi yapıştırınız, ardından "Ekle" butonuna basınız.

WhatsApp

WhatsApp, Meta Cloud API üzerinden çalışır ve bir Meta Business hesabı ile WhatsApp Business hesabı gerektirir. KLog Server'ın gönderdiği bildirimler her zaman işletme tarafından başlatılan mesajlardır (bir kullanıcı yanıtına karşılık değildir); bu nedenle Meta, serbest metin yerine önceden onaylanmış bir şablon mesajı kullanılmasını zorunlu kılar.

1. developers.facebook.com üzerinden bir Meta Geliştirici hesabı oluşturunuz (yoksa).
2. Meta for Developers panelinde "Uygulama Oluştur" ile yeni bir uygulama oluşturup ürün olarak "WhatsApp" ekleyiniz.
3. WhatsApp ürününün "API Kurulumu" (API Setup) sayfasında gösterilen "Phone number ID" değerini not ediniz (gönderen numaranın kendisi değil) — bu değeri "Phone Number ID" alanına gireceksiniz.
4. "Mesaj Şablonları" (Message Templates) bölümüne gidip yeni bir şablon oluşturunuz:
   • Kategori: Utility
   • Dil: kullanacağınız dil (örn. Türkçe için tr)
   • Gövde metni tam olarak aşağıdaki gibi üç değişken içermelidir:

   ⚠️ {{1}}
   
   {{2}}
   
   {{3}}

5. Şablonu onay için gönderiniz; Meta'nın onayı genellikle birkaç dakika ile birkaç saat arasında sürer.
6. Şablon onaylandıktan sonra tam adını ve dil kodunu not ediniz (örn. tr veya en_US) — bu değerler "Şablon Adı" ve "Şablon Dili" alanlarına, onaylanan şablonla birebir eşleşecek şekilde girilmelidir.
7. Kalıcı bir erişim jetonu için Meta Business Manager'da "İş Ayarları" > "Kullanıcılar" > "Sistem Kullanıcıları" (System Users) bölümünden yeni bir sistem kullanıcısı oluşturunuz, WhatsApp uygulamanıza tam denetim yetkisi atayınız ve whatsapp_business_messaging izniyle bir erişim jetonu oluşturunuz — bu değeri "Access Token" alanına gireceksiniz.
8. Bildirimlerin gönderileceği alıcı numarasını not ediniz: ülke koduyla birlikte, başında + veya 0 olmadan (örn. Türkiye için 90 ile başlar) — "Alıcı Numarası" alanına gireceksiniz.
9. KLog Server'da "Ayarlar" > "Bildirim Kanalları" > "Kanal Ekle" bölümünde Tür olarak "WhatsApp" seçip Phone Number ID, Access Token, Alıcı Numarası, Şablon Adı ve Şablon Dili alanlarını doldurunuz, ardından "Ekle" butonuna basınız.

Kanalı Test Etme

1. "Ayarlar" > "Bildirim Kanalları" bölümüne gidiniz.
2. Test etmek istediğiniz kanalın açılır menüsünden "Test Gönder" seçeneğine tıklayınız.
3. Açılan pencerede gönderim sonucu (başarılı veya hata mesajı) görüntülenir.

Kanalı Düzenleme

1. "Ayarlar" > "Bildirim Kanalları" bölümüne gidiniz.
2. Düzenlemek istediğiniz kanalın açılır menüsünden "Düzenle" seçeneğine tıklayınız.
3. Gerekli alanları güncelleyip "Güncelle" butonuna basınız.

Kanalı Silme

1. "Ayarlar" > "Bildirim Kanalları" bölümüne gidiniz.
2. Silmek istediğiniz kanalın açılır menüsünden "Sil" seçeneğine tıklayıp onaylayınız.

Bildirim Kurallarında Kullanım

Tanımlanan kanallar, "Tercihler" > "Bildirimler" bölümündeki kurallarda ve Log Uyarıları kurallarında e-postaya ek veya alternatif alıcı olarak seçilebilir.