8.7. THUỘC TÍNH | Documentation | SmaxAI Docs

8.7. THUỘC TÍNH

4 phút đọc

Cập nhật: 8 tháng 5, 2026

Thuộc tính là công cụ mạnh mẽ giúp bạn xây dựng "hồ sơ chi tiết" cho từng khách hàng trên SmaxAi. Thay vì chỉ nhắn tin chung chung, bạn có thể lưu trữ thông tin riêng biệt của mỗi người để cá nhân hóa kịch bản chăm sóc, từ đó tăng tỷ lệ chuyển đổi đơn hàng.

1. Ứng dụng thực tế của Thuộc tính

Để hiểu rõ hơn về sức mạnh của Thuộc tính, hãy xem các ví dụ thực tế sau:

Cá nhân hóa lời chào: Thay vì chào "Chào bạn", bạn dùng thuộc tính {{facebook.name}} để chào "Chào anh Nam", tạo cảm giác thân thiện và chuyên nghiệp.
Phân loại khách hàng (Segmentation): Bạn tạo thuộc tính tùy chỉnh Hạng_Khách_Hàng với các giá trị: VIP, Tiềm năng, Đã mua. Khi đó, bạn có thể gửi tin nhắn khuyến mãi đặc biệt chỉ dành riêng cho nhóm "VIP".
Tư vấn đúng nhu cầu: Với shop mỹ phẩm, bạn tạo thuộc tính Loại_Da (Da dầu, Da khô, Da nhạy cảm). Khi khách hàng chọn loại da, SmaxAi sẽ lưu lại và tự động gợi ý sản phẩm phù hợp nhất cho lần tương tác sau.
Theo dõi hành trình: Tạo thuộc tính Ngày_Hết_Hạn_Sản_Phẩm để hệ thống tự động nhắc khách hàng mua lại sản phẩm đúng thời điểm.

2. Phân loại thuộc tính

SmaxAi chia thuộc tính thành hai nhóm chính: Thuộc tính hệ thống (có sẵn) và Thuộc tính tùy chỉnh (do bạn tạo).

2.1. Thuộc tính hệ thống

Đây là các thông tin mà SmaxAi tự động thu thập được từ Facebook khi khách hàng tương tác với Fanpage của bạn.

Lưu ý: Các thuộc tính này được hệ thống quản lý tự động nên bạn không thể chỉnh sửa tên hoặc xóa bỏ.

Một số thuộc tính hệ thống phổ biến:

Tên thuộc tính	Mô tả
`id`	ID định danh khách hàng trên SmaxAi
`name`	Tên của khách hàng
`phone`	Số điện thoại của khách hàng
`email`	Email của khách hàng
`gender`	Giới tính khách hàng
`facebook.name`	Tên hiển thị trên Facebook
`facebook.first_name`	Tên (First name) Facebook
`facebook.last_name`	Họ (Last name) Facebook
`facebook.picture`	Ảnh đại diện Facebook
`last_content_by_user`	Nội dung tin nhắn cuối cùng khách gửi cho trang
`last_inbox_updated`	Thời gian cập nhật tin nhắn cuối cùng
`facebook.campaign_name`	Tên chiến dịch quảng cáo mang khách đến
`facebook.adset_name`	Tên nhóm quảng cáo mang khách đến

2.2. Thuộc tính tùy chỉnh

Thuộc tính tùy chỉnh là những thông tin riêng biệt mà bạn muốn thu thập thêm từ khách hàng (ví dụ: Địa chỉ, Size áo, Sở thích, Mã giảm giá...).

2.2.1. Cách tạo thuộc tính mới

Bước 1: Truy cập tab Tùy chỉnh, sau đó chọn Tạo mới thuộc tính.

Bước 2: Đặt tên cho thuộc tính và chọn kiểu dữ liệu phù hợp, sau đó nhấn Lưu.

Hướng dẫn chọn kiểu dữ liệu:

Text (Văn bản): Dùng cho thông tin dạng chữ, địa chỉ, hoặc số điện thoại (Xem lưu ý bên dưới).
Number (Số): Dùng cho các giá trị tính toán như: Số điểm tích lũy, Số lượng sản phẩm.
Date (Thời gian): Dùng cho ngày sinh, ngày hẹn, ngày hết hạn.
List (Danh sách): Dùng cho các lựa chọn cố định (Ví dụ: Trạng thái đơn hàng: Đang xử lý, Đang giao, Đã nhận).

⚠️ Lưu ý quan trọng về kiểu dữ liệu:

Với số điện thoại: Bạn NÊN chọn kiểu Text. Nếu chọn kiểu Number, hệ thống sẽ tự động xóa số 0 ở đầu (Ví dụ: 0987... sẽ trở thành 987...).
Với ngày tháng: Kiểu Date trả về định dạng chuẩn quốc tế UTC. Nếu bạn muốn lưu ngày tháng theo định dạng Việt Nam (DD/MM/YYYY) bằng hàm TIMENOW, hãy chọn kiểu dữ liệu là Text.