> For the complete documentation index, see [llms.txt](https://apidocs.nhanh.vn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidocs.nhanh.vn/v3/vpage/conversation/conversation_tags.md).

# Nhãn hội thoại

* Lấy danh sách nhãn hội thoại đang hoạt động.
* **Chú ý**:
  * Hiện Vpage có 2 chế độ, Open API chỉ hỗ trợ chế độ nhãn theo doanh nghiệp, không hỗ trợ chế độ nhãn theo từng page. Khuyến cáo bạn nên dùng chế độ tag theo doanh nghiệp.
  * Toàn bộ các tính năng mới trên Vpage, đều phát triển xoay quanh chế độ tag theo doanh nghiệp, chế độ theo từng page sẽ bị loại bỏ trong tương lai.

## Enable business tags

* Nếu bạn đang dùng chế độ nhãn theo từng page, bạn cần chuyển đổi sang chế độ nhãn theo doanh nghiệp để sử dụng API. Các bước thao tác:
* **Bước 1**: Đăng nhập Vpage, vào trang Cài đặt > Nhãn hội thoại.
* **Bước 2**: Chuyển sang tab **Theo doanh nghiệp**: Tạo 1 nhóm cấu hình và thêm các page vào nhóm này.
* **Bước 3**: Chuyển sang tab **Theo từng page**: Chọn toàn bộ các tag cũ > chọn Sao chép nhãn > Sao chép sang nhóm, và chọn Nhóm vừa tạo. Đợi hệ thống copy xong, thì bạn đã chuyển thành công sang chế độ theo doanh nghiệp.
* Logic: Nếu bạn có tạo nhóm cấu hình theo doanh nghiệp, và gắn page vào nhóm đó, thì page sẽ theo chế độ tag theo doanh nghiệp, nếu không gắn với nhóm nào, thì sẽ theo chế độ tag theo từng page.
* **Chú ý**:
  * Sau khi thay đổi chế độ theo doanh nghiệp, bạn cần báo toàn bộ nhân viên đăng nhập lại Vpage để tải chế độ tags mới.
  * Toàn bộ tags cũ ở chế độ thep từng page, sẽ được tự động chuyển đổi sang chế độ theo doanh nghiệp theo chế độ gom các tag trùng tên với nhau thành 1 tag chung.
  * Khi bạn xem hội thoại cũ, tìm theo tags cũ, hệ thống sẽ vẫn hỗ trợ tìm kiếm và hiển thị như cũ.
  * Khi bạn gọi Open API, toàn bộ tag cũ sẽ được tự động chuyển đổi sang tagId mới theo chế độ theo doanh nghiệp.

## Request

* Xem sample Postman [tại đây](https://www.postman.com/nhanh-vn/vpage-open-nhanh-vn/request/ylv8hdc/conversation-tags?tab=body).

```curl
curl --location 'https://vpage.open.nhanh.vn/v3.0/conversation/tags?appId={{appId}}&businessId={{businessId}}' \
--header 'Authorization: {{accessToken}}' \
--header 'Content-Type: application/json' \
--data '{
    "filters": { },
    "paginator": {
        "size": 50, 
        "sort": {"createdAt": "desc"}
    }
}'
```

### Filters

### Paginator

| Key  | Type  | Description                                                |
| ---- | ----- | ---------------------------------------------------------- |
| size | int   | Số lượng bản ghi trên 1 trang. Tối đa không quá 50         |
| next | array | Mảng dữ liệu next (được trả về từ trang trước đó - nếu có) |

## Response

* Xem cấu trúc chung [tại đây](/v3/readme.md#response).

### Failed response

* Xem các mã lỗi chung [tại đây](/v3/readme.md#failed-response).

### Successful response

```json
{
    "code": 1,
    "paginator": {
        "next": [
            1,
            1753951251
        ]
    },
    "data": [
        {
            "id": "Iwq_QJcBXzy4YYO3c6ov",
            "name": "Ordered",
            "status": 1,
            "color": "#ffffff",
            "backgroundColor": "#2e3191",
            "order": 1,
            "createdAt": 1749137978,
            "shortcut": ""
        },
        {
            "id": "lArCQJcBXzy4YYO3AqrN",
            "name": "Hello",
            "status": 1,
            "color": "#ffffff",
            "backgroundColor": "#2e3191",
            "order": 1,
            "createdAt": 1749138145,
            "shortcut": ""
        }
    ]
}
```