Bildirimler ve Webhook'lar

Mevcut bildirim tipleri, throttle politikaları, kullanıcı ve workspace fanout.

Bildirim sistemi nedir?

Qando, önemli olaylar için in-app bildirimler üretir. Panel sağ üstte bell icon ile erişilir; ayrıca /notifications sayfası tüm geçmişi gösterir.

Bildirim tipleri

Mevcut tipler:

Tip	Açıklama	Tetik
ORDER_NEW	Yeni sipariş geldi (aggregate)	Sipariş sync
PUSH_SUCCESS	Ürün push başarılı	Push job tamamlandı
PUSH_FAILED	Ürün push başarısız	Push job hata
CLAIM_NEW	Yeni iade talebi	İade sync
CONNECTION_ERROR	Pazaryeri bağlantı hatası (60dk throttle)	Sync veya test hatası
LOW_STOCK	Düşük stok eşiği aşıldı (24h throttle)	Stok çıkışı
PRODUCT_MATCHED	Otomatik ürün eşleşmesi yapıldı	Ürün sync
QUESTION_NEW	Yeni müşteri sorusu	AI Inbox sync
INVITATION_ACCEPTED	Davet kabul edildi	Davet akışı
TRIAL_EXPIRING	Trial 3 gün içinde bitiyor	Günlük cron
PLAN_EXPIRING	Plan bitiyor / ödeme başarısız	Faturalandırma cron

Aggregate (toplu) bildirim mantığı

Sipariş sync veya iade sync sırasında birden fazla yeni kayıt gelirse:

❌ Eski sistemler: her kayıt için bir bildirim → spam
✅ Qando: tek bildirim, "3 yeni sipariş geldi" formatında

Bu sayede gün boyu yüksek satış olan günler bile bildirim sayısı yönetilebilir kalır.

Throttle (kısıtlama)

Belirli tipler throttle uygulanır — kısa sürede aynı olay tekrar bildirim üretmez:

Tip	Throttle
CONNECTION_ERROR	60 dakika (aynı bağlantı için)
LOW_STOCK	24 saat (aynı varyant için)

Bu sayede tekrar tekrar gelen "bağlantı hata veriyor" bildirimleriyle spam'lenmezsiniz.

Workspace fanout

Bazı tipler tüm workspace üyelerine gönderilir:

INVITATION_ACCEPTED (tüm OWNER'lar)
TRIAL_EXPIRING (tüm OWNER'lar)
PLAN_EXPIRING (tüm OWNER'lar)

Diğerleri sadece ilgili kullanıcıya:

ORDER_NEW → workspace OWNER + STAFF (bildirim açıksa)
PUSH_FAILED → push'u yapan kullanıcı
QUESTION_NEW → AI Inbox'a erişimi olanlar

Bildirim tercihleri

Ayarlar > Bildirim Tercihleri sayfasından her bildirim tipini açıp kapatabilirsiniz:

E-posta kanalı
In-app (bell icon)
(Roadmap) Telegram, SMS

Webhook (HTTP callback)

Şu an Qando dış webhook sunmaz — yani sizin sunucunuza HTTP POST göndermez.

Eğer dış sistemde olayları yakalamak istiyorsanız:

API polling yapın (her N dakikada /notifications/recent çekin)
Roadmap: Webhook desteği eklenecek; outbound POST + signed payload

Notification API endpoint'leri

GET /api/notifications?status=all|unread&page=1&size=20
GET /api/notifications/unread-count
POST /api/notifications/:id/read
POST /api/notifications/mark-all-read

unread-count 60 saniyelik polling için optimize edilmiş — bell icon bunun ile sayıyı günceller.

Bildirim payload'u

{
  "id": "uuid",
  "type": "ORDER_NEW",
  "title": "3 yeni sipariş",
  "body": "Trendyol'dan 3 yeni sipariş geldi",
  "icon": "shopping-cart",
  "color": "primary",
  "url": "/orders?status=NEW",
  "metadata": { "connectionId": "...", "count": 3 },
  "createdAt": "2026-05-23T10:00:00Z",
  "readAt": null
}

Yaygın sorunlar

Bildirim gelmiyor → Tercihler kapalı olabilir; Ayarlar > Bildirim Tercihleri
Aynı bildirim defalarca → Throttle çalışmıyor; muhtemelen cache problemi, destek
E-posta bildirimi gelmiyor → SMTP ayarları sorunu; destek