Thông báo hàng loạt (Broadcasts)

Broadcasts cho phép bạn đẩy thông báo đến tất cả khách cùng lúc — lý tưởng cho thông báo, khuyến mãi, hoặc nhắc nhở định kỳ. Khác với tin nhắn hội thoại riêng lẻ, broadcasts là một-đến-nhiều và có thể lên lịch cho thời điểm tương lai hoặc đặt lặp lại tự động.

Các Trường Thông Tin

Trường	Bắt buộc	Mô tả
Tiêu đề	✅	Nhãn nội bộ để nhận dạng broadcast
Nội dung	✅	Nội dung tin nhắn khách sẽ nhận
Ngôn ngữ	✅	Ngôn ngữ đích cho tin nhắn (mặc định: Tiếng Anh)
Trạng thái	✅	draft — chưa gửi; active — sẵn sàng gửi
Gửi lúc	❌	Thời gian gửi theo lịch (để trống để gửi ngay)
Lặp lại	❌	Bật để kích hoạt gửi định kỳ

Vòng Đời Trạng Thái

draft → active → sent

• Broadcasts Draft được lưu nhưng chưa gửi.
• Broadcasts Active sẽ được gửi vào thời điểm publishAt đã lên lịch (hoặc ngay lập tức qua “Gửi ngay”).
• Sau khi gửi, bản ghi broadcast được cập nhật với timestamp đã gửi.

Lên Lịch Broadcast

1. Nhấn Tạo Broadcast.
2. Điền Tiêu đề và Nội dung.
3. Chọn Ngôn ngữ đích.
4. Đặt Trạng thái thành active.
5. Chọn ngày và giờ Gửi lúc bằng bộ chọn ngày-giờ.
6. Nhấn Lưu.

Hệ thống sẽ gửi broadcast vào thời điểm đã lên lịch.

Mẹo

Để trống Gửi lúc và nhấn Gửi ngay từ danh sách để gửi ngay lập tức.

Broadcasts Định Kỳ

Bật Lặp lại để kích hoạt gửi định kỳ. Hai tùy chọn tần suất:

Hàng ngày

Gửi mỗi ngày vào một thời điểm cụ thể.

Cài đặt	Mô tả
Tần suất	daily
Giờ	Thời gian trong ngày để gửi (ví dụ: 09:00)
Kết thúc lúc	Ngày hết hạn tùy chọn — dừng lặp lại sau ngày này

Hàng tuần

Gửi vào các ngày được chọn trong tuần.

Cài đặt	Mô tả
Tần suất	weekly
Giờ	Thời gian trong ngày để gửi
Ngày	Nút bật tắt cho CN, T2, T3, T4, T5, T6, T7
Kết thúc lúc	Ngày hết hạn tùy chọn

Ví dụ: Tin nhắn “Chào buổi sáng” vào mỗi Thứ Hai và Thứ Sáu lúc 08:00 đến hết ngày 31/12.

Thao Tác Với Broadcast Hiện Có

Thao tác	Mô tả
Sửa	Chỉnh sửa broadcast (chỉ cho draft hoặc chưa gửi)
Gửi ngay	Kích hoạt broadcast ngay lập tức, bỏ qua lịch
Xóa	Xóa vĩnh viễn bản ghi broadcast

Nhắm Mục Tiêu Theo Ngôn Ngữ

Trường Ngôn ngữ xác định khách nào nhận broadcast. Broadcasts được khớp với cuộc hội thoại/khách dựa trên primaryLanguage đã phát hiện. Nếu đặt thành Tiếng Anh (en), chỉ khách có cuộc hội thoại được gắn cờ là tiếng Anh sẽ nhận được.

---

Tin Nhắn Chào Mừng (Welcome Messages)

Welcome Messages là những tin nhắn tự động gửi đến khách ngay khi họ quét mã QR và mở cuộc hội thoại mới. Khác với broadcast theo lịch (gửi đến tất cả cuộc hội thoại đang mở vào một thời điểm định sẵn), welcome message chỉ kích hoạt khi cuộc hội thoại mới được tạo — đảm bảo mỗi khách lần đầu tiên đến đều nhận được lời chào mà không cần thao tác thủ công.

Welcome Messages được quản lý ngay trên trang Broadcasts, trong một panel riêng phía trên danh sách broadcast.

Cách Hoạt Động

Khách quét QR → Cuộc hội thoại mới được tạo → Toàn bộ Welcome Message đang Active được chèn → Khách thấy ngay

1. Admin tạo một hoặc nhiều welcome message trong Broadcasts → Tin nhắn chào mừng.
2. Khi khách quét mã QR, hệ thống khởi tạo cuộc hội thoại mới.
3. Tất cả welcome message có trạng thái Active được tự động chèn vào đầu cuộc hội thoại dưới dạng tin nhắn hệ thống.
4. Khách thấy các tin nhắn ngay khi mở cửa sổ chat.

Ghi chú

Welcome message chỉ gửi khi cuộc hội thoại mới được tạo (lần quét QR đầu tiên trong phiên). Khách quay lại đã có cuộc hội thoại mở sẽ không nhận lại.

Các Trường Welcome Message

Trường	Bắt buộc	Mô tả
Tiêu đề nội bộ	✅	Nhãn dành cho admin — không hiển thị cho khách
Nội dung tin nhắn	✅	Văn bản khách sẽ nhìn thấy khi quét QR lần đầu
Ngôn ngữ	❌	Tất cả ngôn ngữ gửi cho mọi người; mã cụ thể (vd: vi) dành cho tương lai
Trạng thái	✅	Đang hoạt động — tự động gửi; Không hoạt động — tạm dừng

Tạo Welcome Message

1. Trong trang Broadcasts, nhấn Tạo tin nhắn chào mừng.
2. Nhập Tiêu đề nội bộ (ví dụ: “Chào mừng chung - Tiếng Việt”).
3. Viết Nội dung tin nhắn khách sẽ đọc.
4. Chọn Ngôn ngữ — chọn Tất cả ngôn ngữ để tiếp cận mọi khách.
5. Đặt Trạng thái thành Đang hoạt động.
6. Nhấn Lưu.

Từ thời điểm đó, tin nhắn sẽ được gửi tự động đến tất cả cuộc hội thoại mới.

Quản Lý Welcome Message Hiện Có

Panel Tin nhắn chào mừng hiển thị toàn bộ danh sách cùng trạng thái hiện tại. Các thao tác:

Thao tác	Biểu tượng	Mô tả
Bật/Tắt trạng thái	👁 / 👁‍🗨	Chuyển đổi Active ↔ Inactive mà không xóa
Sửa	✏️	Chỉnh sửa tiêu đề, nội dung, ngôn ngữ, hoặc trạng thái
Xóa	🗑	Xóa vĩnh viễn welcome message

Nhiều Welcome Message Cùng Lúc

Hệ thống hỗ trợ nhiều welcome message đang Active đồng thời. Tất cả tin nhắn đang hoạt động sẽ được gửi theo thứ tự Sort Order tăng dần, sau đó theo ngày tạo. Điều này cho phép:

• Gửi lời chào bằng nhiều ngôn ngữ cùng lúc.
• Kết hợp tin nhắn “chào mừng” với thông báo “menu/shop sẵn sàng”.
• Tạm dừng hoặc kích hoạt lại tin nhắn theo mùa mà không cần xóa.

Ví dụ: Hai tin nhắn đang Active — một lời chào và một nhắc nhở về shop:

Thứ tự	Tiêu đề	Nội dung	Trạng thái
0	Chào mừng chung	”Xin chào! Chúng tôi có thể giúp gì cho bạn?”	Đang hoạt động
1	Nhắc nhở Shop	”Menu của chúng tôi đã sẵn sàng — nhấn biểu tượng giỏ hàng để xem.”	Đang hoạt động

Cả hai tin nhắn xuất hiện liên tiếp trong chat của khách, theo đúng thứ tự.

Hành Vi Trường Ngôn Ngữ

Cài đặt ngôn ngữ	Hành vi
Tất cả ngôn ngữ	Gửi đến mọi khách mới bất kể ngôn ngữ phát hiện
en, vi, ko, v.v.	Hiện tại lưu để tham khảo; toàn bộ tin nhắn active đều gửi cho mọi khách

Mẹo

Dùng Tất cả ngôn ngữ để đảm bảo mọi khách đều nhận được tin nhắn chào mừng, bất kể trình duyệt hay ngôn ngữ hội thoại của họ.

---

Yêu Cầu Vai Trò

Tạo và quản lý broadcasts và welcome messages yêu cầu tối thiểu vai trò Manager (level 50).