Followup Template Groups

URL

/master/followup-template-groups

Fungsi utama

Halaman ini dipakai untuk mengelola group rangkaian template follow up (drip sequence) di CRM Marketing.

Sederhananya, 1 group = 1 paket alur follow up, misalnya:

• Freebie 8 hari
• Demo freebie v1
• Roadmap nurturing
• Setelah closing (retention)

Nanti, template follow up yang dikirim per hari, per step, per stage, akan “nempel” ke salah satu group ini.

---

Kenapa halaman ini penting

Di CRM Web Builder, lead bisa pindah stage (Awareness, Consideration, dst). Saat pindah stage, alur follow up yang aktif juga harus ikut pindah.

Supaya rapi, kamu butuh “wadah” untuk mengelompokkan banyak template menjadi satu alur, wadah itulah Followup Template Group.

---

Struktur halaman

Halaman ini sudah mengikuti struktur layout global Web Builder:

• header.php
• sidebar.php
• topbar.php
• footer.php

Di dalam kontennya, ada 3 bagian utama:

1. Header halaman

• Judul, deskripsi singkat
• Tombol Kembali
• Tombol Tambah Group (membuka modal)

2. Filter

• Input pencarian (contoh: freebie, demo, roadmap)
• Tombol Cari dan Reset

3. Tabel monitoring
   Menampilkan daftar group yang sudah dibuat, beserta ringkasan info penting:

• Nama group
• Group key
• Default jam kirim
• Timezone
• Status aktif atau nonaktif

Jika data kosong, akan tampil “Belum ada data”.

---

Modal “Tambah Followup Template Group”

Saat klik Tambah Group, muncul modal berisi field:

• Nama Group
  • Nama yang enak dibaca manusia
  • Contoh: “Freebie 8 Hari”, “Demo Freebie v1”
• Group Key
  • Identitas teknis, sebaiknya stabil, jangan sering diubah
  • Contoh: freebie8, demo_freebie_v1
• Deskripsi
  • Penjelasan singkat untuk apa group ini
• Default Jam Kirim
  • Opsional, dipakai kalau scheduling butuh jam default
  • Contoh: 09:00
• Timezone
  • Opsional, dipakai kalau scheduling mempertimbangkan zona waktu
  • Contoh: Asia/Makassar
• Aktif
  • Jika nonaktif, group dianggap tidak dipakai untuk flow baru

---

Database yang dipakai

Halaman ini langsung membaca dan menulis ke tabel berikut (nama tabel harus fix, tanpa kandidat):

1) tb_followup_template_groups

Ini tabel utama untuk group.

Kolom penting (berdasarkan struktur yang kamu tunjukkan):

• id_group (PK, varchar(32))
• group_key (unik secara logis, dipakai sebagai identitas teknis)
• group_name
• description
• default_send_time (time, opsional)
• timezone_name (varchar, opsional)
• is_active (tinyint 0/1)
• created_at, created_by
• updated_at, updated_by

---

Relasi ke template follow up

Group ini dipakai untuk mengelompokkan isi template follow up di tabel template, umumnya dengan salah satu pola ini:

• tb_followup_templates.template_group menyimpan nilai group_key
• atau versi skema lain yang menyimpan relasi ke id_group

Yang penting secara konsep:

• Group Key atau ID Group adalah pengikat antara group dan daftar template di dalamnya.

---

Hal yang normal, dan kenapa bisa “Belum ada data”

Kalau tabel tampil kosong, kemungkinan paling umum:

1. Memang belum ada record di tb_followup_template_groups, walaupun tabelnya sudah ada.
2. Data ada, tapi query di halaman memfilter is_active=1 (kalau ada filter seperti itu), dan semua data kebetulan nonaktif.
3. Koneksi DB mengarah ke database berbeda (jarang, tapi bisa terjadi kalau file koneksi beda environment).

Cara cek paling cepat:

• Jalankan SELECT COUNT(*) FROM tb_followup_template_groups;
• Kalau hasilnya 0, berarti memang belum ada seed data untuk group.

---

Checklist uji fungsional (biar yakin halaman ini sudah beres)

1. List data

• Tambah 1 group, pastikan langsung muncul di tabel
• Pastikan kolom default jam, timezone, status tampil benar

2. Search

• Cari dengan keyword dari group_name atau group_key, pastikan hasil terfilter

3. Create

• Coba simpan dengan field wajib kosong, harus ditolak
• Coba duplikasi group_key, harus ditolak (idealnya unique)

4. Toggle aktif

• Nonaktifkan group, pastikan status berubah
• Pastikan group nonaktif tidak kepakai saat bikin flow baru (logic di modul berikutnya)

5. Edit

• Edit nama, deskripsi, jam, timezone
• Pastikan updated_at dan updated_by berubah

6. Delete (kalau ada)

• Kalau sudah ada template yang pakai group tersebut, idealnya delete ditolak, supaya data tidak putus

---

Output yang diharapkan dari halaman ini

Setelah halaman ini diisi, kamu akan punya daftar “paket follow up” yang siap dipakai oleh modul berikutnya, yaitu:

• halaman pengelolaan Followup Templates per group (isi konten harian, step, stage, channel)
• automation engine (queue, log, schedule) yang mengirim berdasarkan group aktif