6.6+6.7. Gửi tin hàng loạt (Broadcast) · Tệp khách hàng — Chi tiết
Đi từng bước wizard Soạn Broadcast, trang chi tiết Broadcast, và Tạo/Import Tệp khách hàng. Tổng quan tại 6. Marketing.
Broadcast = gửi một lần một nội dung tới cả một tệp KH. Khác với Mục tiêu (kết bạn + bám đuổi nhiều bước).
A. Wizard "Tạo Broadcast mới" (4 bước)
Vào Marketing › Gửi tin hàng loạt → + Soạn broadcast. Thanh tiến trình: 1 Đối tượng → 2 Nội dung → 3 Lịch gửi → 4 Xem trước & Gửi. Panel phải luôn hiện tóm tắt Đối tượng + cảnh báo "Skip n KH (không Zalo / bị chặn / chưa kết bạn)".
Bước 1 — Đối tượng

Chọn 1 trong 4 cách lấy danh sách KH để gửi:
- Tệp KH — chọn một tệp có sẵn (chỉ hiện tệp đang processing/done).
- Nhãn CRM — lấy theo nhãn khách hàng.
- Mẫu có sẵn — danh sách dựng sẵn.
- Bộ lọc — lọc động theo điều kiện.
Bấm Đếm KH để xem số lượng, rồi Tiếp tục →.
Bước 2 — Nội dung

- Chọn Khối nội dung tin nhắn: broadcast dùng lại Khối loại
send_messageđã có. Chưa có khối → vào Khối nội dung tạo trước. - Chọn khối ở ô — chọn khối — → Tiếp tục →.
Bước 3 — Lịch gửi

- Nick gửi tin: tích các nick được phép gửi (worker ưu tiên nick tương tác gần nhất với KH). Mỗi nick hiện hạn mức
Tin n/300. - Phase 2 — Tìm SĐT chưa kết bạn: Tắt (mặc định) chỉ gửi cho KH đã là bạn (KH chưa bạn → skip) / Bật tự lookup SĐT + gửi vào tab Người lạ (cap 30/nick/ngày).
- Khi nào gửi?: Gửi ngay hoặc Hẹn lịch 1 lần (chọn ngày + giờ).
- Tiếp tục →.
Bước 4 — Xem trước & Gửi

Kiểm tra lần cuối — Đặt tên broadcast, và bảng tóm tắt: Đối tượng (tệp), Sẽ nhận tin (số KH), Khối nội dung, Lịch gửi, Window (vd 6:00 → 22:00 VN), Throttle (vd 3–10s/KH · cap 300/nick). Bấm Lưu & Gửi ngay.
🛑 Lưu & Gửi ngay sẽ gửi tin thật hàng loạt tới khách. Khi chỉ xem hướng dẫn, hãy lưu ở trạng thái Nháp/Hẹn lịch hoặc bấm Huỷ — đừng bấm Gửi ngay.
B. Trang chi tiết một Broadcast
Bấm vào một dòng broadcast trong danh sách để mở trang chi tiết:

- Tiêu đề + trạng thái (vd Nháp), người tạo, thời gian. Nút Kích hoạt / Xoá.
- 3 tab: Tổng quan · Người nhận · Lịch sử gửi.
- Thẻ số: Tổng KH (sau dedup + skip), Đã gửi (tiến độ server), KH đã nhận (tick xám), KH đã xem (tick xanh), Lỗi (chặn/lỗi nick), Chờ gửi (trong queue).
- Khối Đối tượng (điều kiện lọc) và Nội dung (khối + bản xem trước tin).
C. Tệp khách hàng (/marketing/lists)
Tệp KH nguồn dùng cho Mục tiêu / Broadcast / Campaign. Paste/Excel/Lead Ads (FB·TikTok·Google·Zalo) đổ về tệp tự động theo #mã trong tên chiến dịch.

- Thẻ tổng: Tổng tệp · Lead Ads · Paste/File · SĐT trong các tệp · SĐT có Zalo.
- Lọc Đang dùng · Lưu trữ · Tất cả. Tìm theo tên tệp.
- Bảng mỗi tệp: Tên tệp, Số khách, Nguồn (Paste/Excel/Lead Ads), Mã đồng bộ, Chia sẻ, Cập nhật, Hợp lệ / Trùng / Có Zalo, Tiến độ, Trạng thái (Hoàn tất…), nút gửi/tải.
Tạo tệp (và Import Excel/CSV/Lead Ads)
Bấm Tạo tệp (góc phải) → popup "Tạo tệp khách hàng mới":

- Tên tệp (để trống → auto đặt theo ngày giờ) + Icon.
- 4 nguồn nhập (tab): Paste danh sách · Upload Excel · Upload CSV · Lead Ads.
- Với Paste: dán danh sách SĐT (mỗi dòng 1 SĐT, có thể kèm tên —
SĐT trước, tên sau). Hệ thống tự nhận diện, dedup, lookup Zalo; prefixp:/tel:được strip tự động. - Bấm Tạo tệp → hệ thống async lookup UID Zalo qua zalo-pool (không chặn UI).
Để Import CSV/Excel dùng đúng popup này (chọn tab Upload Excel/CSV). Nút Import CSV ở góc trên cũng mở cùng luồng.
Chi tiết một tệp
Bấm vào một tệp để xem danh sách SĐT chi tiết (/marketing/lists/:id):

- Header: tên tệp, tổng SĐT, nguồn Paste. Nút Tạo Mục tiêu từ tệp này, Quét lại Zalo, Export CSV.
- Thẻ: Tổng SĐT · SĐT hợp lệ · Trùng · Trong vùng phủ · Đã có CRM.
- Bảng từng SĐT: Phone, Tên (nếu có), trạng thái Có Zalo / No — đối soát trước khi gửi.
⬅️ 6b. Luồng · Khối · Mẫu · ➡️ 7. Cài đặt · 🏠 Mục lục