Files
loyalty-agent-service/docs/knowledge-cards/marketing/marketing_message.md

4.8 KiB

card_id, title, domain, related_cards, tags
card_id title domain related_cards tags
marketing/marketing_message Mẫu thông báo (Marketing Message) marketing
campaign/campaign_rule
catalogue/item_master
Message
SMS
Email
Push Notification
OMR-type

Mẫu thông báo (Marketing Message)

Mô tả ngắn

Marketing Message là module quản lý và định nghĩa các thông báo gửi đến khách hàng mục tiêu qua nhiều kênh giao tiếp (Channels) khác nhau như SMS, Email, và Push Notification. Hệ thống hỗ trợ tạo thông báo từ nội dung chữ thuần (text) hoặc HTML template, kết hợp các tham số động (message parameters) để cá nhân hoá nội dung.

Thuật ngữ liên quan

  • Channel: Kênh giao tiếp, ví dụ: SMS, Email, Push Notification.
  • Richer Push / Carousel Push: Các định dạng thông báo Push trên ứng dụng có hỗ trợ đính kèm một ảnh (Richer) hoặc nhiều ảnh vuốt ngang (Carousel).
  • Message Parameter: Tham số động có thể kéo/thả vào nội dung (VD: Tên khách hàng, Số dư điểm) để cá nhân hóa khi gửi.

Cấu trúc dữ liệu (Data Schema)

1. SMS Message

Field Description Type
Message ID / Description Mã định danh duy nhất và mô tả thông báo. Character
SMS Type Loại SMS: Promotion/Marketing hoặc Transaction. Drop-down
Effective Date (From-To) Thời gian hiệu lực của mẫu thông báo. Date
SMS Brand Name Tên hiển thị người gửi SMS (Sender). Drop-down
Message Nội dung Unicode, không hỗ trợ hình ảnh/đính kèm. Cho phép chèn Message Parameters. Character
Send Sample Nút test thông báo qua SĐT thực tế. Button

2. Email Message

Field Description Type
Email Type Loại Email: Promotion/Marketing hoặc Transaction. Drop-down
Use type Chọn cách tạo: Viết trực tiếp (Use message) hoặc Upload HTML (Upload template). Checkbox
Sender Name / From email Tên hiển thị người gửi và Email gốc đã cấu hình. Character
Subject / Preview Text Tiêu đề Email và văn bản Preheader (hiển thị tóm tắt trên hộp thư). Character
Message / Upload file Nội dung soạn thảo HTML hoặc file HTML được upload. Character/File

3. Push Notification

Field Description Type
Notification Type Loại Push: Promotion/Marketing hoặc Transaction. Drop-down
Message Title Tiêu đề chính hiển thị trên thông báo. Character
Image type Tùy chọn ảnh: Single (Không ảnh), Richer (1 ảnh), Carousel (Nhiều ảnh). Drop-down
Upload Image / Link URL Hình ảnh đính kèm và đường link điều hướng khi click. File/Character
Send Sample Nút gửi test bằng cách nhập số CIF để xác định thiết bị nhận. Button

Cách hoạt động (How It Works)

  • Cá nhân hóa nội dung: Người dùng soạn thông báo có thể kéo thả các Message Parameters (như {{CustomerName}}) vào nội dung. Khi gửi, hệ thống thay thế tham số bằng thông tin thật của khách hàng.
  • Kiểm thử thông báo (Send Sample): Hỗ trợ test hiển thị trước khi áp dụng:
    • SMS: Nhập số điện thoại.
    • Email: Nhập địa chỉ Email.
    • Push: Nhập CIF Number để hệ thống dò Registration Token của thiết bị.
  • Upload Template: Với kênh Email, người dùng có thể upload file thiết kế dạng HTML có sẵn và chỉnh sửa trực tiếp. Với kênh Push, hỗ trợ đính kèm hình ảnh và URL điều hướng.

Mối quan hệ với modules khác

  • Campaign Rule: Các rule kịch bản chiến dịch (campaign/campaign_rule) sử dụng mẫu thông báo này để gửi tự động cho khách hàng khi họ thoả điều kiện thưởng.
  • Item Master: Mẫu thông báo cũng có thể được dùng trong luồng đổi quà (catalogue/item_master) để gửi xác nhận đổi quà thành công.

Ví dụ thực tế

Tạo mẫu Email thông báo đổi điểm:

  1. Marketer tạo Message mới chọn kênh Email, loại Transaction.
  2. Thiết lập Sender là CSKH Loyalty, Subject là Xác nhận đổi quà thành công.
  3. Trong nội dung, nhập: Chào {{Customer_Name}}, bạn đã đổi thành công {{Item_Name}}. Số dư hiện tại là {{Pool_Balance}} điểm.
  4. Chọn Send Sample, nhập email của chính mình để test. Hệ thống gửi email preview về hộp thư.
  5. Sau khi lưu, mẫu này được gắn vào Item Master hoặc Campaign Rule để tự động kích hoạt.