Otomatik Kayıt (Enrollment)

Bir kadans, kaydolan (enroll edilen) kişi olmadan hiçbir şey yapmaz. Purvisor AI’da bir kişiyi kadansa sokmanın üç yolu var: elle (Kontaklar veya Kadans ekranından seçerek), Meta Lead Ads tetikli (form doldurulunca otomatik) ve kural bazlı (bir davranış — sıcak lead, itiraz, aşama değişimi — gerçekleşince otomatik). Hangi yoldan girerse girsin, kayıt (enrollment) aynı kaydı tutar: hangi adımda, kaç temas, ne zaman durdu, neden durdu.

Kayıt (enrollment) nedir?

Bir kişi bir kadansa kaydedildiğinde, arka planda bir CadenceEnrollment kaydı oluşur — kişi + kadans eşleşmesi başına tek kayıt (aynı kişi aynı kadansa iki kez kaydedilemez; veritabanı bunu cadenceId + contactId üzerinde benzersiz kısıtlamayla zorlar). Bu kayıt şunları tutar:

Her adım çalıştığında (veya atlandığında) ayrı bir CadenceStepLog satırı yazılır — adım, kanal, durum (executed/failed/skipped), çalıştırılma zamanı ve sonuç. Kişi kartındaki kadans ilerleme kutusu bu iki kaydı birleştirip gösterir.

📸 [Ekran görüntüsü: Kişi detayında Kadans İlerleme kutusu — adım/adım zaman çizelgesi + “X/Y adım” yüzdesi]

1) Elle kayıt

En doğrudan yol: Kadans detay ekranında Kişi Ekle’ye tıkla, bir veya birden çok kişi seç, kaydet.

POST /api/cadences/{id}/enrollments
{ "contactIds": ["101", "102", "103"] }

{ "enrolled": 2, "skipped": 1, "total": 3 }

Elle kaydı geri almak da elle yapılır: kişi kartından Durdur’a bas — bu, stopReason: "manual" ile kaydı stopped yapar (aşağıdaki durdurma nedenleri tablosuna bak).

2) Meta Lead Ads tetikli kayıt

Bir Facebook/Instagram Lead Ads formu doldurulduğunda, Purvisor lead’i kontak olarak oluşturduktan hemen sonra kadansa da kaydedebilir — elle hiçbir şey yapman gerekmez. Bu, Meta Lead Ads Entegrasyonu kurulumundaki form → kadans eşleştirmesinden gelir.

Kayıt sırası şöyle işler:

Form dolduruldu → lead webhook'la Purvisor'a düşer
        ↓
Kontak oluşturulur (veya aynı telefon aktifse güncellenir — mükerrer önlenir)
        ↓
Hedef kadans belirlenir:
  1. Öncelik: form/entegrasyon eşleştirmesindeki kadans
  2. Yoksa: hesabındaki varsayılan aktif kadans (şablon olmayan, en son oluşturulan)
        ↓
Kadans aktifse ve en az bir adımı varsa → otomatik kayıt açılır (status: active)

Aynı mekanizma kampanya bağlantılı kadanslar için de geçerli: bir kampanyada “Kadans Bağla” (cadenceEnabled) açıksa, kampanyadaki bir kişi ilk arama tamamlandıktan sonra otomatik olarak bağlı kadansa kaydedilir — böylece “kampanyada arandı ama açmadı” kişiler otomatik takibe düşer.

3) Kural bazlı otomatik kayıt

Takip Kuralları altında, bir tetikleyici gerçekleştiğinde aksiyon olarak “Kadansa Kaydet” (enroll_in_cadence) seçebilirsin. Kural her tetiklendiğinde, hedef kişi ilgili kadansa otomatik kaydedilir — kadansa manuel girmene gerek kalmaz.

Kadansa-kaydet aksiyonunu tetikleyebilecek başlıca kural tipleri:

Her kural, aynı kişi için bir kez çalışır (tekrar tetiklenip aynı kişiyi ikinci kez kaydetmez) — bir yürütme kaydı bunu garanti eder. Kadansta zaten aktif bir kaydı varsa, kural onu ikinci kez kaydetmeye çalışmaz (mevcut kaydı döndürür).

İlgili aksiyonu kurarken bir segment filtresi de tanımlayabilirsin — örneğin sadece belirli pipeline aşamalarındaki veya belirli lead skoru üzerindeki kişileri kadansa al. Detay: Takip Kuralları

Adım adım ilerleme nasıl izlenir?

Kadans çalıştıkça (dakikada bir kontrol eden zamanlayıcı ile) her adım şu durumlardan birine geçer:

İlerleme yüzdesi basitçe currentStepOrder / totalSteps oranıdır. Bir adım atlandığında da currentStepOrder ilerler — atlanan adım “kaybedilmiş” sayılmaz, sıradaki adıma geçilir.

Bir adım ne zaman atlanır?

Zamanlama neden ertelenir?

Adım “atlanmaz” ama planlanan saatte de çalışmayabilir — şu kontrollerden biri uymazsa bir sonraki uygun ana ertelenir (durum değişmez, sadece nextStepAt ileri alınır): kadansın altın saatler kısıtı (varsayılan 08:00–11:00 ve 16:00–18:00), adımın tercih edilen saat aralığı, adımın tercih edilen günleri ve her zaman uygulanan mesai saatleri penceresi (varsayılan 09:00–19:00, Pazartesi–Cumartesi, Türkiye saatiyle).

Durdurma nedenleri (stopReason)

Bir kayıt stopped veya completed olduğunda stopReason alanı neden bittiğini gösterir. Kodda kullanılan değerler:

İyi uygulamalar

• Aynı kişiyi birden çok kadansa sokma — sistem aynı kadansa ikinci kaydı engeller ama farklı kadanslara aynı anda kayıt mümkündür; bu genelde çakışan aramalara yol açar. Bir kişi için tek aktif kadans yeterlidir.
• Kural bazlı kaydı segment filtresiyle daraltır — “her arama tamamlandığında kadansa al” gibi geniş bir kural, ilgisiz kişileri de kadansa sokabilir. (Bkz. Takip Kuralları)
• Kadansı pasife almadan önce aktif kayıtları kontrol et — pasife alınan bir kadanstaki tüm aktif kayıtlar cadence_inactive nedeniyle otomatik durur.
• KVKK — kadans kaydı otomatik arama/SMS/WhatsApp/e-posta temaslarını tetikler; kişinin açık rızası bu temas kanallarını da kapsamalı. Kişi “durdur/iptal” derse elle durdurmayı (veya bir takip kuralıyla otomatik durdurmayı) ihmal etme.

Sorun giderme

İlgili