Bir CRM projesinde "hatırlatma" özelliği genellikle en kolay iş gibi görünür. Görev oluşturulurken bir tarih seçilir, o tarih gelince danışmana bildirim gider. Kâğıt üzerinde bu kadar. Gerçekte ise ilk haftalarda şu şikâyetler gelir: "Randevu ertelendi ama eski saatten hatırlatma geldi", "Aynı bildirimi üç kez aldım", "Gece yarısı WhatsApp'ıma hatırlatma düştü", "Sunucu yeniden başlatıldı, o saatteki hatırlatmaların hiçbiri gitmedi". Bu şikâyetlerin hiçbiri arayüz sorunu değildir; hepsi zamanlanmış işlerin nasıl modellendiğiyle ilgilidir.

Ben Koray Yalçın; lead yönetimi, CRM ve pazarlama otomasyonu altyapıları kuruyorum, ağırlıklı olarak gayrimenkul ve PropTech tarafında. Satış ofislerinde hatırlatmanın değeri çok somuttur: ziyaret randevusu, geri arama görevi, kapora takibi, sözleşme imza günü. Bir hatırlatmanın kaçması, çoğu zaman bir müşterinin unutulması demektir. Bu yazıda reminder'ı "bir tarih alanı + cron" olarak değil, kendi veri modeli, durum makinesi ve teslim garantisi olan küçük bir alt sistem olarak ele alacağım.

Hatırlatma, görevin bir alanı değildir

En yaygın tasarım, görev tablosuna remind_at timestamp alanı eklemek ve her dakika çalışan bir işle remind_at <= now() olan kayıtları taramaktır. Bu yaklaşım üç noktada kırılır:

  1. Bir görevin birden fazla hatırlatması olabilir. Randevudan bir gün önce müşteriye teyit mesajı, iki saat önce danışmana bildirim, randevu saatinde gelmediyse yöneticiye uyarı. Tek alan bunu taşıyamaz.
  2. Hatırlatmanın kendi yaşam döngüsü vardır. Planlandı, gönderiliyor, gönderildi, iptal edildi, başarısız oldu. Bu durumlar görevin durumundan bağımsızdır; görev açıkken hatırlatma gönderilmiş olabilir.
  3. Geçmiş kaybolur. Alan güncellendiğinde önceki planın ne olduğu, gönderilip gönderilmediği bilinmez. "Bu danışmana hatırlatma gitti mi?" sorusu cevapsız kalır.

Bu yüzden hatırlatmayı ayrı bir tablo olarak modellemek gerekir: her satır, belirli bir alıcıya, belirli bir kanaldan, belirli bir anda gönderilecek tek bir bildirimi temsil eder.

CREATE TABLE reminder ( id bigserial PRIMARY KEY, subject_type text NOT NULL, -- 'task', 'appointment', 'deal' subject_id bigint NOT NULL, rule_code text NOT NULL, -- 'appt_minus_24h', 'callback_due' recipient_type text NOT NULL, -- 'user', 'contact' recipient_id bigint NOT NULL, channel text NOT NULL, -- 'push', 'email', 'whatsapp', 'sms' due_at timestamptz NOT NULL, -- her zaman UTC olarak saklanır status text NOT NULL DEFAULT 'scheduled' CHECK (status IN ('scheduled','sending','sent','cancelled','failed','skipped')), attempts int NOT NULL DEFAULT 0, locked_until timestamptz, subject_version int NOT NULL, -- planlandığı andaki kaynak sürümü dedupe_key text NOT NULL, last_error text, sent_at timestamptz, created_at timestamptz NOT NULL DEFAULT now(), UNIQUE (dedupe_key) ); CREATE INDEX reminder_due_idx ON reminder (due_at) WHERE status = 'scheduled'; 

Buradaki iki alan özellikle önemlidir. subject_version, hatırlatmanın hangi randevu sürümüne göre planlandığını tutar; randevu değiştiğinde eski hatırlatmayı tanımamızı sağlar. dedupe_key ise aynı hatırlatmanın iki kez oluşturulmasını veritabanı düzeyinde engeller. Tipik bir anahtar appointment:4812:appt_minus_24h:contact:whatsapp:v3 gibi görünür.

Kurallar veri olmalı, kod içine gömülmemeli

"Randevudan 24 saat önce müşteriye, 2 saat önce danışmana" gibi kuralları koda yazmak ilk başta pratik gelir. Ama satış müdürü bir gün "lansman projesinde 3 saat önce olsun" dediğinde deploy gerekir. Kuralları bir tabloda tutmak hem esneklik verir hem de hangi kuralın hangi hatırlatmayı ürettiğini izlenebilir kılar.

CREATE TABLE reminder_rule ( code text PRIMARY KEY, subject_type text NOT NULL, anchor_field text NOT NULL, -- 'starts_at', 'due_at' offset_minutes int NOT NULL, -- negatif: öncesi, pozitif: sonrası recipient_role text NOT NULL, -- 'owner', 'contact', 'manager' channel text NOT NULL, respect_quiet boolean NOT NULL DEFAULT true, needs_consent boolean NOT NULL DEFAULT false, active boolean NOT NULL DEFAULT true ); 

needs_consent alanı, müşteriye giden hatırlatmalarda kritik bir ayrım yapar. Danışmana giden iç bildirim bir iş aracıdır; müşteriye giden randevu teyit mesajı ise kanal ve içerik türüne göre izin kontrolüne tabi olabilir. Bu kararı her geliştiricinin kafasına bırakmak yerine kural düzeyinde işaretlemek daha güvenlidir. (Bu bir teknik tasarım notudur, hukuki görüş değildir; hangi mesajın hangi izne tabi olduğunu hukuk danışmanınızla netleştirin.)

Saat dilimi: UTC'de sakla, yerel saatte hesapla

Hatırlatma hatalarının büyük kısmı saat dilimi kaynaklıdır. Kuzey Kıbrıs'taki bir projede çalışan danışman, Londra'da yaşayan bir alıcı ve İstanbul'daki bir çağrı merkezi aynı randevuya bakabilir. Kural basittir:

  • Anlık zamanları (starts_at, due_at) her zaman timestamptz olarak, UTC'de saklayın.
  • Alıcının saat dilimini (Europe/Istanbul, Asia/Famagusta, Europe/London) ayrı bir alanda IANA adıyla tutun; "+03:00" gibi sabit ofset tutmayın, çünkü yaz saati uygulanan bölgelerde ofset yıl içinde değişir.
  • "Sabah 09:00'da hatırlat" gibi duvar saati kurallarını, alıcının saat diliminde hesaplayıp sonra UTC'ye çevirin.

Bir duvar saati kuralının yanlış hesaplanması şöyle görünür: sunucu UTC'de çalışır, geliştirici "ertesi gün 09:00" hesaplar ve Londra'daki alıcıya yerel saatle 09:00 yerine kışın 09:00, yazın 10:00'da mesaj gider. PostgreSQL'de doğru hesaplama şöyledir:

-- Alıcının yerel saatinde "randevudan önceki gün 09:00" SELECT ((date_trunc('day', a.starts_at AT TIME ZONE c.tz) - interval '1 day') + time '09:00') AT TIME ZONE c.tz AS due_at_utc FROM appointment a JOIN contact c ON c.id = a.contact_id WHERE a.id = $1; 

AT TIME ZONE ifadesinin iki yönlü kullanımı burada önemlidir: önce UTC anı yerel duvar saatine çevrilir, gün ve saat yerel olarak hesaplanır, sonra tekrar UTC anına dönülür. Yaz saati geçiş gecelerinde var olmayan veya iki kez yaşanan saatler olabilir; hatırlatmaları 02:00–03:00 aralığına planlamaktan kaçınmak bu kenar durumları pratikte ortadan kaldırır.

Sessiz saatler ve iş takvimi

Teknik olarak doğru zamanda giden bir hatırlatma, insan açısından yanlış zamanda gidebilir. Gece 23:40'ta müşteriye "yarınki randevunuzu hatırlatırız" mesajı göndermek, mesajın amacını boşa çıkarır. Bu yüzden müşteriye giden kanallarda sessiz saat penceresi tanımlamak ve kuralı respect_quiet = true olan hatırlatmaları bu pencerenin dışına kaydırmak gerekir.

Kaydırma yönü bir karar konusudur. Randevudan önceki hatırlatma sessiz saate denk gelirse genellikle öne çekilir (akşam 21:00'e), çünkü sabaha kaydırmak randevuya çok yakın kalabilir. Geri arama görevinde ise sonraya kaydırmak (sabah 09:00) daha doğaldır. Bu yönü de kural tablosunda tutmak mantıklıdır.

from datetime import datetime, time, timedelta from zoneinfo import ZoneInfo QUIET_START = time(21, 30) QUIET_END = time(9, 0) def shift_out_of_quiet(due_utc: datetime, tz_name: str, direction: str) -> datetime: tz = ZoneInfo(tz_name) local = due_utc.astimezone(tz) t = local.time() in_quiet = t >= QUIET_START or t < QUIET_END if not in_quiet: return due_utc if direction == "earlier": day = local.date() if t >= QUIET_START else local.date() - timedelta(days=1) target = datetime.combine(day, time(21, 0), tz) else: day = local.date() if t < QUIET_END else local.date() + timedelta(days=1) target = datetime.combine(day, QUIET_END, tz) return target.astimezone(ZoneInfo("UTC")) 

Danışmana giden iç bildirimlerde ise sessiz saat yerine iş takvimi devreye girer: izinli veya vardiya dışı danışmana gidecek bildirim, nöbetçi danışmana ya da ekip kuyruğuna yönlendirilebilir. Bunu hatırlatma servisinin içinde değil, alıcı çözümleme adımında yapmak sorumlulukları ayrık tutar.

Kaynak değişince: iptal ve yeniden planlama

Randevular ertelenir, görevler yeniden atanır, fırsatlar kaybedilir. Hatırlatma sisteminin en kritik özelliği, kaynak değiştiğinde eski hatırlatmaları güvenilir biçimde geçersiz kılmasıdır. Bunun iki yolu vardır ve ben ikisini birlikte kullanıyorum.

Birinci yol: değişiklik anında yeniden planlama. Randevu güncellendiğinde, aynı transaction içinde o randevunun scheduled durumdaki hatırlatmaları iptal edilir ve yeni sürüm için yenileri oluşturulur.

BEGIN; UPDATE appointment SET starts_at = $2, version = version + 1 WHERE id = $1 RETURNING version; -- örneğin 4 UPDATE reminder SET status = 'cancelled', last_error = 'subject_changed' WHERE subject_type = 'appointment' AND subject_id = $1 AND status = 'scheduled'; INSERT INTO reminder (subject_type, subject_id, rule_code, recipient_type, recipient_id, channel, due_at, subject_version, dedupe_key) SELECT 'appointment', $1, r.code, rc.recipient_type, rc.recipient_id, r.channel, compute_due_at(r.code, $1), 4, format('appointment:%s:%s:%s:%s:%s:v4', $1, r.code, rc.recipient_type, rc.recipient_id, r.channel) FROM reminder_rule r CROSS JOIN LATERAL resolve_recipient('appointment', $1, r.recipient_role) rc WHERE r.subject_type = 'appointment' AND r.active ON CONFLICT (dedupe_key) DO NOTHING; COMMIT; 

Burada resolve_recipient rolü (sahip, müşteri, yönetici) somut alıcıya çeviren, compute_due_at ise kuralın çapa alanı ve ofsetinden UTC vade anını hesaplayan yardımcı fonksiyonlardır.

İkinci yol: gönderim anında son kontrol. Birinci yol bazen atlanır: bir entegrasyon randevuyu doğrudan güncelleyebilir, bir toplu işlem tetikleyiciyi baypas edebilir. Bu yüzden işçi, göndermeden hemen önce kaynağın güncel sürümüne bakar. reminder.subject_version ile kaynağın version alanı eşleşmiyorsa veya kaynak artık geçerli değilse (randevu iptal, görev tamamlandı, fırsat kapandı), hatırlatma gönderilmez ve skipped olarak işaretlenir. Bu "son kontrol" deseni, eski saatten hatırlatma gitmesi şikâyetini neredeyse tamamen bitirir.

İşçi: kilitleme, en az bir kez teslim ve tekilleştirme

Hatırlatmaları gönderen işçi, birden fazla kopya halinde çalışabilmeli ve yeniden başlatıldığında iş kaybetmemelidir. PostgreSQL'de FOR UPDATE SKIP LOCKED bunun için yeterli ve sade bir araçtır:

WITH picked AS ( SELECT id FROM reminder WHERE status = 'scheduled' AND due_at <= now() ORDER BY due_at LIMIT 100 FOR UPDATE SKIP LOCKED ) UPDATE reminder r SET status = 'sending', locked_until = now() + interval '2 minutes', attempts = attempts + 1 FROM picked WHERE r.id = picked.id RETURNING r.*; 

İşçi, kilitli kaydı gönderir ve sonucu yazar: başarılıysa sent ve sent_at, geçici hatada tekrar scheduled ve ileri bir due_at (artan bekleme ile), kalıcı hatada failed. sending durumunda kalıp locked_until süresi dolmuş kayıtlar, işçinin çöktüğü anlamına gelir; ayrı bir süpürme işi bunları tekrar scheduled durumuna alır.

Burada dürüst olmak gerekir: bu yapı "tam bir kez" değil, "en az bir kez" teslim sağlar. İşçi bildirimi gönderip sonucu yazamadan çökerse, kayıt yeniden kuyruğa döner ve bildirim ikinci kez gidebilir. Bunu azaltmanın yolu, dış sağlayıcıya her gönderimde hatırlatma kimliğinden türetilmiş bir idempotency anahtarı vermek ve sağlayıcının bunu desteklediği yerlerde kullanmaktır. Desteklemeyen kanallarda, sent yazımını gönderimden hemen sonra ve kısa bir transaction ile yapmak riski küçültür. Danışman için ikinci bir push bildirimi rahatsız edicidir ama zararsızdır; müşteriye ikinci WhatsApp mesajı ise itibar meselesidir. Bu yüzden müşteri kanallarında yeniden deneme sayısını daha düşük tutuyorum.

Geç kalmış hatırlatmalar: göndermek mi, atlamak mı?

Sistem bir saat kapalı kaldıysa, o bir saatte vadesi gelmiş hatırlatmalar ne olacak? Hepsini sistem açılınca arka arkaya göndermek, çoğu zaman yanlış karardır. "Randevunuz 2 saat sonra" mesajı randevu saati geçtikten sonra giderse hem anlamsız hem de kafa karıştırıcıdır.

Bu yüzden her kurala bir geçerlilik penceresi ekliyorum: hatırlatma due_at anından en fazla ne kadar geç gönderilebilir? Randevu öncesi hatırlatmalar için bu pencere kısadır ve randevu başlangıcını asla geçemez. Geri arama görevi gibi iç bildirimlerde daha uzun olabilir, çünkü geç gelen bir "bu görevi unuttun" uyarısı hâlâ değerlidir. Penceresi geçmiş hatırlatmalar skipped olarak işaretlenir ve gerekçe kaydedilir; böylece kesinti sonrası hangi bildirimlerin hiç gitmediği bir sorguyla raporlanabilir.

İzleme: hatırlatmanın gitmediğini ilk kim fark eder?

Hatırlatma sistemi sessizce bozulur. Bildirim gitmediğinde kimse hata mesajı görmez; sadece bir müşteri aranmaz. Bu yüzden izleme, sistemin vazgeçilmez parçasıdır. Benim minimum izleme setim şunlardır:

  • Gecikme: scheduled durumda ve due_at anı beş dakikadan fazla geçmiş kayıt sayısı. Sıfırdan büyükse işçi ya durmuş ya da yetişemiyordur.
  • Takılı kayıtlar: sending durumunda ve locked_until geçmiş kayıtlar.
  • Kanal bazlı başarısızlık oranı: Belirli bir kanalda failed oranının ani yükselişi genellikle sağlayıcı tarafında bir değişiklik, süresi dolmuş bir token veya şablon onayı sorunudur.
  • Atlanan oranı: skipped kayıtlarının gerekçeye göre dağılımı. subject_changed normaldir; window_expired artıyorsa kapasite sorunu vardır.
SELECT channel, count(*) FILTER (WHERE status = 'sent') AS sent, count(*) FILTER (WHERE status = 'failed') AS failed, count(*) FILTER (WHERE status = 'skipped') AS skipped, count(*) FILTER (WHERE status = 'scheduled' AND due_at < now() - interval '5 minutes') AS late FROM reminder WHERE due_at >= now() - interval '24 hours' GROUP BY channel; 

Bu sorgunun sonucu bir panoya konup eşiklere uyarı bağlandığında, "hatırlatma gelmedi" şikâyeti müşteriden değil izleme sisteminden gelir.

Gayrimenkul satış ofisinden varsayımsal bir örnek

Bir lansman projesinde ziyaret randevusu cumartesi 11:00 için alınmış olsun. Kurallar: müşteriye bir gün önce akşam WhatsApp teyidi, danışmana iki saat önce push bildirimi, randevu saatinden 20 dakika sonra "müşteri geldi mi?" görevi. Müşteri cuma öğleden sonra randevuyu pazar 14:00'e taşımak ister. Danışman CRM'de saati değiştirir; aynı transaction içinde eski üç hatırlatma iptal edilir, sürüm 2 için üç yeni hatırlatma oluşur. Bu sırada bir entegrasyon, eski sürümle çalışan bir takvim senkronu tetiklese bile, işçi göndermeden önce sürüm kontrolü yaptığı için eski saatten hiçbir mesaj gitmez. Pazar sabahı danışman izinli olduğu için iç bildirim, alıcı çözümleme adımında nöbetçi danışmana yönlenir. Bu senaryonun hiçbir adımında özel bir kod yolu yoktur; hepsi model, kural tablosu ve son kontrolden doğar.

Sık yapılan hatalar

  • Hatırlatmayı görev tablosunda tek bir tarih alanı olarak tutmak.
  • Sunucu saatine veya sabit ofsete güvenmek; IANA saat dilimi kullanmamak.
  • Randevu değişince eski hatırlatmaları iptal etmemek ya da yalnızca uygulama katmanında iptal edip entegrasyon yollarını unutmak.
  • Kesinti sonrası birikmiş hatırlatmaları geçerlilik penceresine bakmadan topluca göndermek.
  • Müşteri kanallarında iç bildirimlerle aynı yeniden deneme politikasını kullanmak.
  • Hatırlatmanın gidip gitmediğini ölçmemek.

Sık Sorulan Sorular

Cron yerine bir mesaj kuyruğunun gecikmeli mesaj özelliğini kullanmak daha iyi değil mi?
Gecikmeli mesajlar işe yarar ama iptal ve yeniden planlama zorlaşır; kuyruktaki bir mesajı bulup silmek çoğu sistemde zahmetlidir. Veritabanındaki hatırlatma tablosu doğruluk kaynağı olarak kalırsa, kuyruk yalnızca "şimdi gönder" işlerini taşıyan bir taşıma katmanı olur. Ben bu ayrımı korumayı tercih ediyorum.

Tekrarlayan hatırlatmalar (her pazartesi pipeline gözden geçirme gibi) nasıl modellenmeli?
Tekrar kuralını ayrı bir tabloda tutup, önümüzdeki kısa bir dönem için somut hatırlatma satırlarını önceden üretmek en sade yöntemdir. Sonsuz bir seriyi tek satırda tutup her seferinde hesaplamak, iptal ve istisna yönetimini zorlaştırır.

Danışman hatırlatmayı "ertele" derse ne olur?
Mevcut satır cancelled olur ve yeni due_at ile yeni bir satır oluşur; erteleme bir aktivite olarak da kaydedilir. Böylece hangi görevlerin sürekli ertelendiği raporlanabilir; bu, danışman koçluğu için değerli bir sinyaldir.

Müşteriye giden hatırlatmalarda izin kontrolü nerede yapılmalı?
Hem planlama anında hem gönderim anında. Planlama anında izin yoksa satır oluşturulmayabilir; ama izin iki an arasında geri çekilmiş olabilir, bu yüzden gönderim öncesi kontrol şarttır. Bu bir teknik öneridir, hukuki görüş değildir.

Küçük bir ekip için bu yapı fazla karmaşık değil mi?
Tablo, kural tablosu ve tek bir işçi, birkaç günlük iştir ve sonradan eklemek çok daha pahalıdır. Basitleştirilecekse önce kanal sayısını azaltın; modelden ve son kontrolden vazgeçmeyin.

Kapanış

Reminder, CRM'in en görünmez ama en çok güven ilişkisi kuran parçasıdır. Danışman, sistemin kendisine doğru anda haber vereceğine güvendiğinde kendi not defterini, telefon alarmlarını ve "aklımda tutarım" alışkanlığını bırakır. Bu güven, hatırlatmayı bir tarih alanı olarak değil; kendi tablosu, kuralları, saat dilimi disiplini, iptal mantığı, teslim garantisi ve izlemesi olan bir alt sistem olarak kurduğunuzda oluşur. Ben yeni bir satış ofisi kurulumunda hatırlatma servisini görev ve randevu modeliyle aynı sprintte tasarlıyorum; çünkü sonradan eklendiğinde ilk kaybedilen şey, sistemin kendisine duyulan güven oluyor.