Giriş
Sistem olaylarına dayalı otomatik bildirimler ve mesajlar tetikleyin.
🎯 Bu modül ne yapar?
Events modülü, sisteminizde bir şey olduğunda tetiklenen otomatik bildirimler ayarlamanıza olanak tanır - örneğin, bir ürün yeniden stoklandığında e-posta göndermek veya bir sipariş gönderildiğinde push bildirimi almak.
Bunu, bildirim otomasyon sisteminiz olarak düşünün - tetikleyiciyi (ne oluyor) ve eylemi (kimin bilgilendirileceği ve nasıl) tanımlarsınız.
📖 Basit Açıklama
Bir çevrimiçi mağaza işletiyorsunuz ve kullanıcıları bilgilendirmek istiyorsunuz:
- 📦 Sipariş verildi → Onay e-postası gönder
- 🚚 Sipariş gönderildi → Takip bilgileriyle push bildirimi gönder
- ✅ Ürün yeniden stokta → Uyarı talep eden kullanıcılara bildirim gönder
- 💳 Ödeme alındı → Makbuz e-postası gönder
- 🎉 Yeni kampanya → Abonelere pazarlama e-postası gönder
- ⚠️ Şifre değiştirildi → Güvenlik uyarısı gönder
Her bildirimi manuel olarak kodlamak yerine:
- ✅ OneEntry admin panelinde olayları yapılandırın
- ✅ Tetikleyicileri tanımlayın (ne oluyor)
- ✅ Eylemleri ayarlayın (gönderilecek bildirimler)
- ✅ Olay başına mesajları özelleştirin
- ✅ Teslimat ve etkileşimi takip edin
Gerçek dünya örneği:
Events Modülü Olmadan (manuel):
- Kullanıcı kaydoldu → E-posta göndermek için kod yaz ❌
- Ürün yeniden stoklandı → Kullanıcıları bilgilendirmek için kod yaz ❌
- Her olay özel kod gerektiriyor ❌
Events Modülü ile (otomatik):
- "Kullanıcı Kayıtlı" olayını yapılandır → Otomatik hoş geldin e-postası gönder ✅
- "Ürün Yeniden Stokta" olayını yapılandır → Otomatik bekleme listesini bilgilendir ✅
- Tüm olaylar tek bir yerde yönetiliyor ✅
✨ Temel Kavramlar
Olay Nedir?
Bir olay, sisteminizde bildirimleri tetikleyebilecek bir şeydir:
- Tetikleyici - Olayı başlatan eylem (örneğin, "sipariş verildi")
- Bildirim - Kullanıcıların aldığı şey (e-posta, push, socket mesajı)
- Alıcılar - Kimin bilgilendirileceği (belirli kullanıcılar, tüm kullanıcılar, yöneticiler)
- Şablon - Mesaj içeriği
Olay Türleri
OneEntry, farklı tetikleyici türlerini destekler:
| Tetikleyici Türü | Ne Zaman Tetiklenir | Örnek |
|---|---|---|
| Durum Değişikliği | Varlık durumu değiştiğinde | Ürün: Stokta Yok → Stokta |
| Varlık Oluşturuldu | Yeni öğe eklendi | Yeni sipariş, yeni kullanıcı kaydı |
| Varlık Güncellendi | Öğenin değiştiği | Profil güncellendi, sipariş durumu değişti |
| Özel Tetikleyici | Koddan manuel tetikleme | Bülten gönderildi, kampanya başlatıldı |
Bildirim Kanalları
Kullanıcıları bilgilendirmenin üç yolu:
| Kanal | Açıklama | En İyi Kullanım Alanı |
|---|---|---|
| E-posta | E-posta mesajları gönder | Sipariş onayları, makbuzlar, bültenler |
| Push Bildirimi | Mobil/tarayıcı uyarıları | Gerçek zamanlı güncellemeler, acil uyarılar |
| Socket.IO | Gerçek zamanlı websocket mesajları | Canlı güncellemeler, sohbet, anlık senkronizasyon |
Olay Akışı
1. Bir şey olur (Tetikleyici)
↓
2. Olay tetikleyiciyi algılar
↓
3. Olay koşulları kontrol eder (varsa)
↓
4. Olay bildirimleri gönderir
↓
5. Kullanıcılar mesajı alır
📋 Bilmeniz Gerekenler
Yaygın Olay Tetikleyicileri
Kurabileceğiniz tipik olaylar:
E-ticaret:
- Sipariş verildi
- Sipariş gönderildi
- Sipariş teslim edildi
- Ödeme alındı
- Ürün yeniden stokta
- Fiyat düşüşü uyarısı
Kullanıcı Yönetimi:
- Kullanıcı kaydoldu
- E-posta doğrulandı
- Şifre değiştirildi
- Profil güncellendi
- Hesap silindi
İçerik:
- Yeni makale yayımlandı
- Yorum eklendi
- İçerik onaylandı
- Abonelik yenilendi
Şablon Değişkenleri
Bildirim şablonlarında yer tutucular kullanın
📊 Hızlı Referans Tablosu - Yaygın Yöntemler
| Yöntem | Ne Yapar |
|---|---|
| getAllSubscriptions() | Tüm abonelikleri alır |
| subscribeByMarker() | Belirli bir olaya işaretle abone olur |
| unsubscribeByMarker() | Belirli bir olaydan işaretle aboneliği iptal eder |
Not: Olaylar OneEntry admin panelinde yapılandırılır. SDK yalnızca okunabilir - olay bilgilerini almak için kullanın, olay oluşturmak için değil.
❓ Sıkça Sorulan Sorular (SSS)
Olayları nasıl oluşturur veya düzenlerim?
Olaylar OneEntry admin panelinde yönetilir:
- OneEntry admin paneline giriş yapın
- Olaylar bölümüne gidin
- Olayları oluşturun veya düzenleyin
- Tetikleyicileri, kanalları ve şablonları yapılandırın
- Olayı etkinleştirin
SDK yalnızca okunabilir - olay bilgilerini almak için kullanın, olay oluşturmak için değil.
Push Bildirimi ile Socket.IO arasındaki fark nedir?
Push Bildirimi - Cihaza gönderilir (uygulama kapalıyken bile çalışır)
-
Bildirim merkezinde görünür
-
Kullanıcı uygulamayı açmak için dokunabilir
-
En iyi kullanım alanı: Önemli uyarılar, hatırlatmalar
-
Socket.IO - Gerçek zamanlı websocket mesajı (yalnızca uygulama açıkken)
- Bağlı istemcilere anında teslimat
- Yenileme olmadan canlı güncellemeler
- En iyi kullanım alanı: Canlı veriler, sohbet, işbirliği
Kodumdan bir olayı manuel olarak tetikleyebilir miyim?
SDK manuel tetiklemeleri desteklemez. Olaylar, OneEntry'deki yapılandırılmış tetikleyicilere dayalı olarak otomatik olarak tetiklenir.
E-posta şablonlarını özelleştirebilir miyim?
Evet! OneEntry admin panelinde:
- HTML e-posta şablonları
- Özel stil
- Çok dilli destek
- Etkinleştirmeden önce test etme
Bir olay gönderilemezse ne olur?
OneEntry, yeniden denemeleri ve günlüğe almayı yönetir:
- Başarısız e-postalar yeniden deneme için sıraya alınır
- Başarısız push bildirimleri kaydedilir
- Admin panelinde olay günlüklerini kontrol edin
- Yedekleme seçeneklerini yapılandırın
Bildirimlerde zengin içerik kullanabilir miyim?
- E-posta - Tam HTML desteği (görseller, bağlantılar, stil)
- Push Bildirimi - Başlık + gövde metni + isteğe bağlı görsel
- Socket.IO - Herhangi bir JSON veri yapısı
Olay ile Form gönderimi arasındaki fark nedir?
- Olaylar - Sistem tetiklemeli otomatik bildirimler
- Formlar - Kullanıcı tarafından gönderilen verileri toplarsınız
Örnek:
- Olay: "Kullanıcı kaydoldu" → Otomatik hoş geldin e-postası gönder
- Form: Kullanıcı iletişim formunu doldurur → Siz başvuruyu alırsınız
💡 Önemli Notlar
📬 Bildirim Kanalları
Platform OneEntry'de, "Events" modülü aracılığıyla sisteminizin kullanıcılarıyla etkileşim kurmanın üç yolu vardır:
- 📧 E-posta - Zengin HTML içeriğiyle e-posta mesajları gönderin
- 📱 Push Bildirimi - Mobil/tarayıcıya gerçek zamanlı uyarılar gönderin
- 🔌 Socket.IO - Bağlı istemcilere anlık websocket mesajları gönderin
Olaylar SDK'da Sadece Okunur
Unutmayın: SDK, olayları okumak için, oluşturmak için değildir.
Olay İsimlendirme Konvansiyonu
Açık, tanımlayıcı işaretçiler kullanın:
✅ İyi işaretçiler:
- order_confirmed
- product_back_in_stock
- user_registered
- payment_failed
- password_reset_requested
❌ Kötü işaretçiler:
- event1
- notification
- email_event
- test
🎓 En İyi Uygulamalar
- Tanımlayıcı olay işaretçileri kullanın
- Olayları etkinleştirmeden önce test edin
- Değişkenler için yedek değerler sağlayın
- Olay günlüklerini düzenli olarak izleyin
- Kullanılmayan olayları devre dışı bırakın
- Uygun kanalları kullanın (makbuzlar için e-posta, acil durumlar için push)
- Olay mesajlarını yerelleştirin
- Eksik/devre dışı olayları nazikçe yönetin
Modülün kullanıcı arayüzü hakkında daha fazla bilgi https://doc.oneentry.cloud/docs/events/introduction
Events modülünün tanımı
const { Events } = defineOneEntry( "your-project-url", { "token": "your-app-token" });
🔗 İlgili Belgeler
- Users Modülü - Bildirim alan kullanıcıları yönetin
- Forms Modülü - Form verilerini toplamak ile otomatik tetiklenen olaylar
- Admins Modülü - Olayları yapılandıranları yönetin