Thông báo & Lập lịch

Quick Reference

• Who: Tất cả vai trò (subscribe), Owner/Admin (quản lý channels)
• Where: Cài đặt → Tab Subscriptions / Dashboard → Schedule
• Time: ~2 phút per subscription
• Prerequisites: Ít nhất 1 notification channel đã verified

Prerequisites

• [ ] Đã đăng nhập hệ thống
• [ ] Ít nhất 1 notification channel đã verified (xem Cài đặt)

Loại Subscriptions

Loại	Mô tả	Nơi tạo
Insight Subscription	Nhận kết quả insight định kỳ	Settings → Subscriptions tab
Dashboard Subscription	Nhận snapshot dashboard định kỳ	Dashboard → Menu → Schedule

---

Phần 1: Insight Subscription

Step 1: Mở Subscriptions

1. Vào Cài đặt → tab Subscriptions
2. Danh sách subscriptions hiện tại hiện ra

Step 2: Tạo Subscription mới

1. Click Thêm Subscription

2. Điền thông tin:

   Field	Required	Options	Mô tả
   Insight	Yes	Chọn từ catalog	Insight muốn nhận
   Channel	Yes	Chọn channel đã verified	Nơi nhận (Telegram/Email/Lark)
   Lịch gửi	Yes	daily / weekly / monthly	Tần suất
   Granularity	Yes	day / week / month	Mức thời gian dữ liệu
   Country	No	VN, TH, ID...	Filter theo quốc gia

3. Click Tạo

TIP

Khuyến nghị: Subscribe insight "Tổng quan doanh số" (O1-01) daily qua Telegram → nhận báo cáo mỗi sáng.

Step 3: Quản lý Subscriptions

Hành động	Cách làm
Bật/Tắt	Toggle switch is_active
Xoá	Click icon xoá
Sửa	Xoá + tạo lại (không hỗ trợ edit inline)

---

Phần 2: Dashboard Subscription (Scheduled Reports)

Step 1: Mở Schedule Dialog

1. Vào Dashboard → chọn dashboard
2. Click menu ⋯ → Schedule

Step 2: Tạo Schedule

Field	Required	Options	Mô tả
Lịch gửi	Yes	daily / weekly / monthly	Tần suất
Giờ gửi	Yes	HH:mm (UTC)	VD: 08:00 = 8h sáng UTC
Ngày tuần	weekly only	0=CN, 1=T2...6=T7	Ngày gửi trong tuần
Ngày tháng	monthly only	1-31	Ngày gửi trong tháng
Kênh	Yes	Multi-select channels	Gửi tới nhiều kênh cùng lúc

INFO

Dashboard subscription gửi snapshot toàn bộ widgets tại thời điểm trigger. Dữ liệu widget live_insight sẽ được refresh trước khi gửi.

---

Phần 3: Delivery Logs

Xem Logs

1. Vào Cài đặt → tab Delivery Logs
2. Danh sách các lần gửi hiện ra:

Column	Mô tả
Insight/Dashboard	Tên nguồn dữ liệu
Channel	Kênh gửi (Telegram/Email/Lark)
Thời gian	Timestamp gửi
Status	success hoặc failed
Error	Chi tiết lỗi (nếu failed)

Xử lý Lỗi trong Logs

Error phổ biến	Nguyên nhân	Giải pháp
SMTP connection refused	Email server down	Kiểm tra email config
Telegram bot blocked	User block bot	Unblock bot trong Telegram
Webhook URL expired	Lark webhook hết hạn	Tạo webhook mới
Insight execution failed	Query lỗi hoặc data empty	Kiểm tra insight source

Expected Results

• Subscription tạo trong 1-2 giây
• Delivery chạy đúng schedule
• Logs cập nhật realtime sau mỗi lần gửi

Troubleshooting

Không nhận được thông báo

Cause: Channel chưa verified, subscription inactive, hoặc schedule chưa tới.

Solution:

1. Kiểm tra subscription is_active = true
2. Kiểm tra channel is_verified = true → test lại
3. Kiểm tra delivery logs cho error cụ thể
4. Đợi tới thời gian schedule tiếp theo

Delivery log hiện "failed"

Cause: Xem cột Error để biết nguyên nhân cụ thể.

Solution:

1. SMTP error → kiểm tra email server, thử test channel
2. Telegram error → kiểm tra bot token + chat_id, thử test
3. Insight error → insight source có thể đã thay đổi

FAQ

Q: Có thể gửi cùng lúc Telegram + Email không?

A: Insight Subscription chỉ hỗ trợ 1 channel per subscription. Tạo 2 subscriptions cùng insight, mỗi cái chọn 1 channel khác nhau. Dashboard Subscription hỗ trợ multi-channel trong 1 subscription.

Q: Schedule time là timezone nào?

A: UTC. VD: 08:00 UTC = 15:00 Vietnam (GMT+7).

Related

• Cài đặt — Setup notification channels trước
• Dashboards — Schedule dashboard reports
• Insight Catalog — Chọn insight để subscribe
• API: CRUD /api/v1/notifications/subscriptions — Xem API