Perfex CRM and TelegramBot Notification Module

✨ Temel Özellikler

• 🤖 Telegram Bot Entegrasyonu: Resmi Bot API'sini kullanarak özel Telegram Botunuzu Perfex CRM'ye birkaç dakika içinde bağlayın.
• 📩 Gerçek Zamanlı Bildirimler: Müşteri adayları, faturalar, görevler, projeler, biletler ve daha fazlası gibi CRM etkinlikleri için anında Telegram mesajları alın.
• 👥 Kullanıcı ve Grup Desteği: Bireylere, departmanlara veya Telegram gruplarına/kanallarına bildirim gönderin.
• ⚙️ Özel Tetikleme Kuralları: Hangi olayların Telegram uyarısını tetikleyeceğini yapılandırın (örneğin, "yeni görev atandı" veya "faturanın vadesi geçmiş").
• 📊 Mesaj Şablonları: CRM verileri için dinamik yer tutucularla özel mesaj formatlarını tanımlayın.
• 🧩 İki Yönlü Senkronizasyon (isteğe bağlı): Yöneticilerin, görevleri tamamlandı olarak işaretlemek veya bilet durumunu değiştirmek (etkinse) için Telegram'dan yanıt vermesine izin verin.
• 🔔 Çoklu Botlar: Farklı CRM departmanları veya müşterileri için birden fazla Telegram botu desteği.
• 🧠 Günlük ve Geçmiş: Denetim için gönderilen tüm Telegram mesajlarını CRM günlük modülünde görüntüleyin.
• 🌍 Çok Dilde Hazır: Kolay yerelleştirme için çeviri dosyaları dahildir.
• 💼 Sorunsuz Kullanıcı Arayüzü Entegrasyonu: Perfex CRM'nin bildirim ayarları paneline yeni bir "Telegram" sekmesi ekler.

⚙️ Teknik Yığın

• Çerçeve: Laravel (Perfex CRM Çekirdek Çerçevesi)
• Dil: PHP 7.4+ / 8.x
• Veritabanı: MySQL / MariaDB
• Ön Uç: Bootstrap, jQuery (yönetici kullanıcı arayüzü için)
• API Entegrasyonu: Resmi Telegram Bot API'si (https://api.telegram.org/bot<token>/sendMessage)
• Sunucu Gereksinimleri: cURL etkin, giden HTTPS erişimi

Perfex CRM v2.9+ ile tamamen uyumludur ve hem kendi kendine barındırılan hem de bulut dağıtımlarıyla çalışır.

🧩 Kurulum Kılavuzu

1. Modül Yükleme: TelegramBot_Notification klasörünü Perfex CRM kurulumunuzdaki /modules/ içine yerleştirin.
2. Etkinleştirin: CRM yönetici panelinizde oturum açın → Kurulum → Modüller → “TelegramBot Bildirimi”ni etkinleştirin.
3. Telegram Botu Oluşturun: Telegram'ı açın, @BotFather ile sohbet edin ve jeton almak için yeni bir bot oluşturun.
4. Ayarları Yapılandırın: Perfex'te Kurulum → Telegram Entegrasyonu'na gidin ve bot jetonunuzu ve varsayılan sohbet kimliğinizi yapıştırın.
5. Bağlantıyı Test Et: API bağlantısını onaylamak için bir test mesajı gönderin.
6. Kuralları Özelleştir: Hangi CRM olaylarının (görevler, faturalar vb.) Telegram mesajlarını tetikleyeceğini seçin.

Kod düzenlemeye gerek yok; doğrudan Perfex uyumlu bir modül olarak kurulur.

📦 Teslimatlar

• ✅ TelegramBot Bildirim modülünün tam PHP kaynak kodu
• ✅ Kurulum ve konfigürasyon belgeleri
• ✅ Örnek mesaj şablonları ve otomasyon komut dosyaları
• ✅ SQL geçiş dosyaları (otomatik olarak yüklenir)
• ✅ Eğitim/test amaçlı kullanıma yönelik GPL yeniden dağıtım bildirimi

📱 Desteklenen Platformlar

• ✔️ Perfex CRM Web Uygulaması (v2.9+)
• ✔️ Telegram Mobil Uygulaması (Android/iOS)
• ✔️ Telegram Masaüstü / Web
• ✔️ SaaS veya kendi kendine barındırılan Perfex ortamları

API odaklı olduğundan, bildirimler tüm Telegram istemcilerinde küresel olarak çalışır; belirli işletim sistemlerine bağımlılık yoktur.

🧠 Notlar

Lisans Türü: Ticari olmayan, eğitimsel ve geliştirme amaçlı kullanım için GPL (GNU Genel Kamu Lisansı) kapsamında yayımlanmıştır.

Özelleştirme İpuçları:

• /views/templates/telegram/ içindeki mesaj şablonlarını marka tonunuza uyacak şekilde değiştirin.
• Anında güncellemeler için yoklama yerine Telegram Bot Webhook'ları kullanın (isteğe bağlı).
• Birleşik olay tabanlı otomasyon için diğer Perfex modülleriyle birleştirin.
• Bot belirtecinizi ortam değişkenleriyle (.env dosyası) güvence altına alın.

SEO Güvencesi: "Perfex CRM Telegram entegrasyonu", "Perfex bildirim modülü" ve "Telegram CRM bot PHP eklentisi" gibi terimler için sıralamaya göre tasarlanmış yapılandırılmış HTML.

👨‍💻 Orijinal Geliştirici Kredisi

İlk olarak CodeCanyon'da bir Perfex CRM modülü yazarı tarafından “Perfex CRM ve TelegramBot Bildirim Modülü” başlığı altında geliştirilmiştir.

Ticari lisanslama, sürekli güncellemeler ve resmi destek için orijinal geliştiricinin CodeCanyon sayfasını ziyaret edin.

Atıf: "Perfex CRM ve TelegramBot Bildirim Modülü - orijinal olarak resmi PerfexCRM modülü yazarı tarafından geliştirilmiştir. Eğitim amaçlı ve ticari olmayan testler için burada GPL altında paylaşılmıştır."

🔒 Sorumluluk reddi beyanı

Şeffaflık Bildirimi: Bu modül yalnızca eğitim, öğrenim ve ticari olmayan testler için GPL lisansı altında dağıtılmaktadır. Perfex CRM markasının, kod tabanının veya ilgili varlıkların mülkiyetini talep etmiyoruz. Tüm hakları ilgili yazarlarına aittir.

Eğer ihtiyacınız varsa:

• Ticari dağıtım hakları,
• Devam eden modül güncellemeleri ve geliştirici desteği,
• Premium Perfex eklentileriyle entegrasyon,

Lütfen lisanslı bir kopyayı doğrudan resmi CodeCanyon geliştiricisinden satın alın.

Bu GPL sürümünü kullanarak GPLv3'ün şartlarına ve geçerli telif hakkı yasalarına uymayı kabul edersiniz.