> For the complete documentation index, see [llms.txt](https://tailieu.smax.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tailieu.smax.ai/extend-modules/table-ranking.md).

# Table Ranking

{% hint style="warning" %}
Module Table Ranking (Bảng xếp hạng) giúp bạn tạo ra 1 bảng xếp hạng để gắn vào chatbot

Ví dụ: bảng xếp hạng kết quả trò chơi xếp hình
{% endhint %}

## Hướng dẫn tạo bảng xếp hạng mới

Để tạo bảng xếp hạng mới, chọn **Tạo mới** trong module Bảng xếp hạng

<figure><img src="https://1875681896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsr3EiPwgSuzEXI3u1tC1%2Fuploads%2F2vbkkCURyHUfroXg3T49%2Fimage.png?alt=media&amp;token=a4e6c3ce-7526-44fe-9cf7-abadc75a3c4e" alt=""><figcaption></figcaption></figure>

Tại đây, bạn có thể chỉnh sửa các thông tin:

* Tiêu đề của bảng xếp hạng
* Logo
* Màu sắc
* Cách cập nhật điểm:
  * Ghi đè: Luôn lấy điểm gần nhất để lưu vào bảng dữ liệu. Ví dụ khách hàng chơi game 3 lượt với điểm lần lượt là 5 -9 - 6 thì bot sẽ lấy điểm 6 là điểm mới nhất để lưu
  * Cộng dồn: Cộng dồn điểm qua mỗi lần lưu. Với ví dụ trên, khách hàng sẽ được 5 + 9 + 6 = 20 điểm
  * Lấy điểm tốt hơn: Luôn lấy điểm tốt nhất để lưu. Với ví dụ trên, khách hàng sẽ được 9 điểm
* Số người được xếp hạng: Ví dụ chọn 1000 thì chỉ hiển thị 1000 người có điểm cao nhất trong bảng xếp hạng
* Số người trong một trang: Mỗi trang sẽ hiển thị bao nhiêu người, ví dụ bạn chọn 1000 người xếp hạng và mỗi trang có 20 người thì bảng xếp hạng sẽ chia làm 50 trang, mỗi trang 20 người

<figure><img src="https://1875681896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsr3EiPwgSuzEXI3u1tC1%2Fuploads%2F2XqBkjf89IMVnQxAeUHT%2Fimage.png?alt=media&amp;token=06d2be41-d30d-49fb-8394-82958f3d8439" alt=""><figcaption></figcaption></figure>

Thiết lập cho các cột điểm: Bạn có thể tạo ra các cột để lưu số điểm của người chơi vào bảng xếp hạng, ví dụ trong ảnh dưới tạo ra 2 cột điểm là lượt tag (viral game ai tag bạn bè vào bài viết nhiều nhất) hoặc Thời gian (ai hoàn thành minigame puzzle nhanh nhất)

* Tên: Tên của cột điểm
* Loại: Điểm hoặc thời gian
* Các sắp xếp: Lớn đến nhỏ hoặc nhỏ đến lớn

Lưu ý: Nếu bạn có nhiều cột thì hệ thống sẽ ưu tiên sắp xếp thứ hạng theo cột đầu tiên

<figure><img src="https://1875681896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsr3EiPwgSuzEXI3u1tC1%2Fuploads%2FKaHxzfBqfQ88GkLYBUH6%2Fimage.png?alt=media&amp;token=fee56455-1ac7-4a2b-80e4-4b4ff0ebeba0" alt=""><figcaption></figcaption></figure>

Phần Thiết lập huy hiệu giúp bạn chỉnh sửa icon của các vị trí top trong bảng xếp hạng

<figure><img src="https://1875681896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsr3EiPwgSuzEXI3u1tC1%2Fuploads%2FUcuKVUiE0HNBwzbMJcDJ%2Fimage.png?alt=media&amp;token=31b22f72-1588-4b09-bb61-65e85508b932" alt=""><figcaption></figcaption></figure>

Sau khi tạo xong, chọn Lưu để lưu lại bảng xếp hạng

## Gắn vào chatbot

Để gắn Bảng xếp hạng vào chatbot, bạn cần gắn bảng xếp hạng vào 1 button của thẻ Messenger Text hoặc Messenger Gallery, sau đó chọn Webview ⇒ Bảng Xếp hạng và chọn bảng xếp hạng vừa tạo

<figure><img src="https://1875681896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsr3EiPwgSuzEXI3u1tC1%2Fuploads%2FX9Vl4nGFgtTakC1UoKtH%2Fimage.png?alt=media&amp;token=90f16b0d-0aa1-4eeb-9833-1a084d6d0a0d" alt=""><figcaption></figcaption></figure>

## Thêm điểm vào bảng xếp hạng

Ví dụ bạn tạo 1 bảng xếp hạng để xếp hạng số lượt tag của khách hàng vào 1 bài viết

Trong phần trigger comment, tích chọn Lưu số tag trong bình luận vào thuộc tính luottag

<figure><img src="https://1875681896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsr3EiPwgSuzEXI3u1tC1%2Fuploads%2FFqq5VXye1mIqnTUgsDWh%2Fimage.png?alt=media&amp;token=7d40c4b6-cbc5-4c23-9119-aeb2ec0142ce" alt=""><figcaption></figcaption></figure>

Sau đó trong block phản hồi comment, sử dụng thẻ Table Ranking với action là Cập nhật điểm

Bạn cần chọn attribute lưu lượt tag vào cột Lượt tag, điểm của khách hàng sẽ tăng dựa theo  cách cập nhật điểm (Cộng dồn, Ghi đè hoặc Lấy điểm tốt nhất) mà bạn đã setup trong bảng xếp hạng

<figure><img src="https://1875681896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsr3EiPwgSuzEXI3u1tC1%2Fuploads%2FXzUp5VGz6r3lDltu04rs%2Fimage.png?alt=media&amp;token=c459f66f-6158-48f6-bef4-efc5ad90fe3b" alt=""><figcaption></figcaption></figure>