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) 🔶 EE
🔶 Tính năng Enterprise — dành cho đối tượng doanh nghiệp (bên mình tối ưu riêng), nên bản Community không có phần này.
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 🔶 EE
🔶 Tính năng Enterprise — dành cho đối tượng doanh nghiệp (bên mình tối ưu riêng), nên bản Community không có phần này.
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