📱 Telegram Bildirim Sistemi

1

Telegram Bot Oluştur

BotFather ile kendi bot'unuzu oluşturun ve API token alın

🤖

1.1

Telegram'da BotFather'ı Aç

Telegram uygulamasını açın ve arama çubuğuna yazın:

@BotFather

💡 Doğru BotFather'ı seçtiğinizden emin olun (mavi onay tiki olmalı)

1.2

Yeni Bot Oluştur

BotFather ile konuşmayı başlatın:

Siz: /start

BotFather: Merhaba! Ben BotFather...

Siz: /newbot

1.3

Bot İsmi ve Username Belirle

BotFather şu soruları soracak:

BotFather: Alright, a new bot. How are we going to call it?

Siz: iXtif Assistant

👆 Bot'unuzun görünen adı (istediğinizi yazabilirsiniz)

BotFather: Good. Now let's choose a username for your bot.

Siz: iXtifBot

👆 Bot'un unique username'i (mutlaka "bot" ile bitmeli)

⚠️ Username Kuralları:

• Mutlaka bot ile bitmeli
• Sadece harfler, rakamlar ve alt çizgi (_)
• Minimum 5 karakter
• Örnek: MuzibuBot, ixtif_assistant_bot

1.4

Bot Token'ı Kopyala ✅

BotFather size Bot Token verecek:

BotFather: Done! Congratulations on your new bot.

Use this token to access the HTTP API:

1234567890:ABCdefGHIjklMNOpqrsTUVwxyz12345678

🔒 ÇOK ÖNEMLİ!

• Bu token'ı GİZLİ tutun!
• Token ile bot'unuzu kontrol edebilirler
• Kimseyle paylaşmayın!
• Güvenli bir yere (örn: parola yöneticisi) kaydedin

2

Bildirim Grubu Oluştur

Bot'un bildirim göndereceği Telegram grubu oluşturun

👥

2.1

Yeni Grup Oluştur

1 Telegram'ı açın
2 Menü → "Yeni Grup" (New Group)
3 Grup adı verin (örn: "iXtif Bildirimler")
4 Kendinizi ekleyin (veya ekip arkadaşlarınızı)

💡 İpucu: Grup adını açıklayıcı yapın. Örnek: "Müşteri İletişim Bildirimleri", "AI Chat Leads"

2.2

Bot'u Gruba Ekle

1 Oluşturduğunuz grubu açın
2 Grup adına tıklayın → "Üye Ekle" (Add Members)
3
Bot username'inizi aratın:
@iXtifBot
4 Bot'u seçin ve ekleyin

2.3

Bot'u Başlat ✅

Grup sohbetinde bot'a mesaj gönderin:

/start

Bu, bot'un grupta mesaj gönderme yetkisini aktifleştirir.

2.4

Bot'u Admin Yap (Opsiyonel)

Daha güvenli çalışma için bot'u admin yapabilirsiniz:

1. Grup → Grup Adı → "Yöneticiler" (Administrators)
2. "Yönetici Ekle" → Bot'u seçin
3. Sadece "Mesaj Gönderme" yetkisi verin

💡 Bu adım opsiyoneldir, bot normal üye olarak da çalışır.

3

Chat ID Al

Grubun benzersiz ID'sini bulun (Bot'un bildirimi nereye göndereceğini belirtir)

🆔

3.1

@userinfobot'u Gruba Ekle

1 Bildirim grubunuzu açın
2 Üye Ekle → Arama çubuğuna yazın:

@userinfobot

3 @userinfobot'u gruba ekleyin

3.2

Chat ID'yi Kopyala ✅

@userinfobot otomatik olarak grup bilgilerini gönderecek:

userinfobot:

Chat: iXtif Bildirimler

Type: supergroup

Id: -1002943373765

⚠️ DİKKAT!

• Chat ID eksi (-) işareti ile başlar
• Tüm ID'yi kopyalayın (eksi işareti dahil)
• Örnek: -1002943373765

3.3

@userinfobot'u Gruptan Çıkar

Chat ID'yi aldıktan sonra @userinfobot'a artık ihtiyacınız yok:

1. Grup → @userinfobot'a tıklayın
2. "Gruptan Çıkar" (Remove from Group)

4

Admin Panel'de Ayarla

Bot Token ve Chat ID'yi sitenizin admin panelinde kaydedin

⚙️

4.1

Admin Panel'e Giriş Yap

Sitenizin admin paneline giriş yapın:

URL Formatı:

https://[siteniz]/admin

Örnekler:

• https://ixtif.com/admin

• https://muzibu.com/admin

4.2

Bildirim Ayarları Sayfasını Aç

Admin panelde şu yolu takip edin:

Ayarlar → Bildirim Ayarları

veya direkt URL:

https://[siteniz]/admin/settingmanagement/values/11

4.3

Telegram Ayarlarını Doldur ✅

Formda şu alanları doldurun:

Telegram Bildirimlerini Aktifleştir

Telegram Bot Token *

Adım 1.4'te BotFather'dan aldığınız token

Telegram Chat ID *

Adım 3.2'de @userinfobot'tan aldığınız ID (eksi işareti ile)

💡 İpuçları:

• Token ve ID'yi kopyala-yapıştır yapın (hata yapmayın)
• Checkbox'ı işaretlemeyi unutmayın (aktifleştirmek için)
• Kaydet butonuna basmadan sayfayı kapatmayın

5

Test Et ve Doğrula

Kurulumun başarılı olduğunu test edin

🧪

🌐

Yöntem 1: Frontend'den Test (En Gerçekçi)

1
Sitenizin ana sayfasını açın
https://ixtif.com
2 AI Chat widget'ını açın (sağ altta 💬 butonu)
3
Bot ile konuşun ve telefon numarası verin:

Siz: Merhaba, ürünler hakkında bilgi alabilir miyim?

Bot: Tabii! Size nasıl yardımcı olabilirim?

Siz: Telefon numaramı bırakayım: 0555 123 4567

Bot: Teşekkürler! En kısa sürede sizi arayacağız.
4
Telegram grubunu kontrol edin:

✅ Başarılı! Şu mesajı görmelisiniz:

📞 YENİ TELEFON NUMARASI TOPLANDI!

Telefon: 0555 123 45 67

Konuşma ID: 2345

Mesaj Sayısı: 4

━━━━━━━━━━━━━━━━━━━━

İlk Mesaj: Merhaba, ürünler hakkında...

⚡

Yöntem 2: Tinker ile Hızlı Test (Geliştiriciler İçin)

SSH ile sunucuya bağlanın ve şu komutu çalıştırın:

php artisan tinker

$service = new \Modules\AI\App\Services\TelegramNotificationService();
$result = $service->testConnection();
print_r($result);

✅ Başarılı Output:

Array (
    [success] => 1
    [message] => Telegram bağlantısı başarılı!
    [response] => Array (
        [ok] => 1
        [result] => Array (
            [message_id] => 60
            [text] => 🔔 Telegram Bildirim Testi...
        )
    )
)

🚨

Bildirim Gelmedi mi? Sorun Giderme

1️⃣ Ayarları Kontrol Et

• Checkbox işaretli mi? (Telegram Bildirimlerini Aktifleştir)
• Bot Token doğru mu? (BotFather'dan aldığınız)
• Chat ID doğru mu? (Eksi işareti var mı?)
• Kaydet butonuna bastınız mı?

2️⃣ Bot Durumunu Kontrol Et

• Bot grupta mı? (Üye listesinden kontrol edin)
• Bot'a /start yazdınız mı?
• Bot admin ise mesaj gönderme yetkisi var mı?

3️⃣ Log Kontrolü (Geliştiriciler)

tail -n 100 storage/logs/laravel.log | grep Telegram

4️⃣ Hâlâ Çalışmıyor mu?

Detaylı troubleshooting için:

📚 readme/telegram-tenant-setup.md

🎉

Tebrikler! Kurulum Tamamlandı!

Artık AI chatbot'unuz telefon numarası topladığında Telegram'dan anında bildirim alacaksınız!

⚡

Anında Bildirim

🔒

Güvenli & Özel

🎯

Tenant Bazlı

❓ Sıkça Sorulan Sorular

Her tenant için ayrı bot gerekli mi?

Evet! Her tenant kendi bot'unu ve grup'unu oluşturmalı. Bu sayede bildirimler karışmaz ve her tenant kendi bildirimlerini alır.

Bot token'ı paylaşırsam ne olur?

Bot token'ınızı kimseyle paylaşmayın! Token ile bot'unuzu kontrol edebilirler ve sizin adınıza mesaj gönderebilirler.

Chat ID eksi işareti ile başlamalı mı?

Evet! Grup chat ID'leri eksi (-) işareti ile başlar. Eğer eksi yoksa muhtemelen kişisel chat ID'sidir. Bildirimleri gruba göndermek için mutlaka eksi işareti olmalı.

Birden fazla gruba bildirim gönderebilir miyim?

Şu anda sistem tek chat ID destekliyor. Ancak birden fazla kişiyi aynı gruba ekleyerek hepsi bildirim alabilir.

Ayarları değiştirmek için ne yapmalıyım?

Admin Panel → Ayarlar → Bildirim Ayarları sayfasından istediğiniz zaman değiştirebilirsiniz. Değişiklik anında aktif olur.

Kurulum Adımları