# Thuộc tính

{% hint style="info" %}
Cài đặt Thuộc tính giúp bạn quản lý các thuộc tính của khách hàng trên SmaxAi
{% endhint %}

## 1\_ Định nghĩa thuộc tính

{% hint style="warning" %}
Thuộc tính là nơi lưu trữ các dữ liệu của khách hàng trên SmaxAi
{% endhint %}

Ví dụ:

Thuộc tính <mark style="color:purple;">**{{facebook.name}}**</mark> lưu trữ tên Facebook của khách hàng

Thuộc tính <mark style="color:purple;">**{{phone}}**</mark> lưu trữ số điện thoại của khách hàng

Thuộc tính <mark style="color:purple;">**{{email}}**</mark> lưu trữ email của khách hàng

## 2\_ Phân loại thuộc tính

### 2.1\_ Thuộc tính hệ thống

Thuộc tính hệ thống là các thuộc tính được hệ thống tự động tạo ra từ việc quét dữ liệu khách hàng trên Facebook, ví dụ tên, giới tính, ngày tương tác,... Các thuộc tính này không thể bị chỉnh sửa

<figure><img src="/files/oYUnPUYckfd9tcsmSWMJ" alt=""><figcaption></figcaption></figure>

Một số thuộc tính hệ thống thường dùng:

| Tên thuộc tính          | Mô tả                                                                |
| ----------------------- | -------------------------------------------------------------------- |
| id                      | ID của khách hàng được tạo ra từ SmaxAi                              |
| name                    | Tên của khách hàng                                                   |
| pid                     | ID của khách hàng được tạo ra trên Messenger khi tương tác với trang |
| page\_pid               | ID của trang Facebook                                                |
| picture                 | Ảnh đại diện của khách hàng                                          |
| gender                  | Giới tính khách hàng                                                 |
| phone                   | Số điện thoại của khách hàng                                         |
| phones                  | Danh sách toàn bộ số điện thoại khách hàng đã nhắn cho trang         |
| email                   | Email của khách hàng                                                 |
| emails                  | Danh sách toàn bộ email khách hàng đã nhắn cho trang                 |
| timezone                | Múi giờ tài khoản Facebook của khách hàng                            |
| last\_content\_by\_user | Tin nhắn cuối cùng của khách hàng nhắn cho trang                     |
| last\_content\_by\_page | Tin nhắn cuối cùng của trang nhắn cho khách hàng                     |
| last\_inbox\_udpated    | Thời gian tin nhắn cuối cùng trong hội thoại được gửi đi             |
| facebook.page\_id       | ID trang Facebook                                                    |
| facebook.page\_name     | Tên trang Facebook                                                   |
| facebook.page\_picture  | Ảnh đại diện trang Facebook                                          |
| facebook.id             | ID khách hàng trên Messenger                                         |
| facebook.name           | Tên Facebook khách hàng                                              |
| facebook.first\_name    |                                                                      |
| facebook.last\_name     |                                                                      |
| facebook.picture        | Ảnh đại diện Facebook                                                |
| facebook.campaign\_id   | ID chiến dịch quảng cáo                                              |
| facebook.campaign\_name | Tên chiến dịch quảng cáo                                             |
| facebook.adset\_id      | ID nhóm quảng cáo                                                    |
| facebook.adset\_name    | Tên nhóm quảng cáo                                                   |
| facebook.ad\_id         | ID quảng cáo                                                         |
| facebook.ad\_name       | Tên quảng cáo                                                        |
| facebook.post\_id       | ID bài viết                                                          |
| facebook.post\_content  | Nội dung bài viết                                                    |
| facebook.post\_hashtag  | Hashtag trên bài viết                                                |
| zalo.oa\_id             | ID của Zalo OA                                                       |
| zalo.oa\_name           | Tên của Zalo OA                                                      |
| zalo.oa\_picture        | Ảnh đại diện của Zalo OA                                             |
| zalo.id                 | ID khách hàng trên Zalo                                              |
| zalo.name               | Tên khách hàng trên Zalo                                             |
| zalo.picture            | Ảnh đại điện khách hàng trên Zalo                                    |

### 2.2\_ Thuộc tính tùy chỉnh

{% hint style="warning" %}
Thuộc tính tùy chỉnh là các thuộc tính do bạn tự tạo ra
{% endhint %}

<figure><img src="/files/cWr0fpgUC8VDHg94tuzc" alt=""><figcaption></figcaption></figure>

#### 2.2.1\_ Tạo thuộc tính mới

Để tạo thuộc tính tùy chỉnh mới, bạn chọn tab <mark style="color:orange;">**Tùy chỉnh**</mark>, sau đó chọn <mark style="color:orange;">**Tạo mới thuộc tính**</mark>

<figure><img src="/files/9nmqlydJJd8RpFnnfGKq" alt=""><figcaption></figcaption></figure>

Trong cửa sổ hiện lên, đặt tên cho thuộc tính và chọn kiểu dữ liệu, sau đó chọn <mark style="color:orange;">**Lưu**</mark> để tạo thuộc tính

Các loại dữ liệu của thuộc tính:

* Text: Văn bản
* List: Danh sách
* Number: Số
* Date: Thời gian

Một số lưu ý về loại dữ liệu:

{% hint style="danger" %}

* Thuộc tính dạng <mark style="color:orange;">**Number**</mark> sẽ tự động bỏ số 0 ở đầu giá trị, ví dụ nếu bạn lưu số điện thoại là 0987654321 vào thuộc tính có dạng number thì giá trị cuối cùng sẽ là 987654321
* Thuộc tính dạng <mark style="color:orange;">**Date**</mark> sẽ trả về giá trị thời gian theo định dạng chuẩn UTC (ví dụ 2024-05-31T03:44:47.823Z), nếu bạn muốn tạo thuộc tính thời gian tùy chỉnh như DD/MM/YYYY bằng hàm <mark style="color:orange;">**TIMENOW**</mark>, bạn nên đặt loại dữ liệu của thuộc tính là <mark style="color:orange;">**Text**</mark>
  {% endhint %}

<figure><img src="/files/tQLIEIco4l2HtE8Vv4sn" alt=""><figcaption></figcaption></figure>

#### 2.2.2\_ Chỉnh sửa thuộc tính

{% hint style="warning" %}
Lưu ý chỉ có thể thay đổi loại dữ liệu thuộc tính, không thể thay đổi tên
{% endhint %}

Để chỉnh sửa thuộc tính tùy chỉnh trên SmaxAi, bạn chọn biểu tượng chỉnh sửa bên cạnh thuộc tính

<figure><img src="/files/lzBUB8G4G44CKLhU6Cej" alt=""><figcaption></figcaption></figure>

Sau đó chọn loại dữ liệu thuộc tính muốn thay đổi và chọn <mark style="color:orange;">**Lưu**</mark>

<figure><img src="/files/Wlz02UiUSII82Sz6FkLx" alt=""><figcaption></figcaption></figure>

Bạn có thể xóa thuộc tính bằng cách chọn biểu tượng thùng rác cạnh thuộc tính muốn xóa

<figure><img src="/files/gEKlthlqdQb9Ha9620jB" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tailieu.smax.ai/module-cai-dat/thuoc-tinh.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.