---
title: "folder.updated — Thư mục đổi"
locale: vi
url: https://tlg.builera.app/docs/reference/events/folder.updated
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# folder.updated — Thư mục đổi

Tên, biểu tượng, màu, bộ lọc hoặc danh sách chat của một thư mục đổi; `changed` nêu phần đổi.

Tên, biểu tượng, màu, bộ lọc hoặc danh sách chat của một thư mục đổi; `changed` nêu phần đổi.

Từ bản web 2.1.0, máy chạy —.

| Tên | Giá trị |
| --- | --- |
| Mã | `folder.updated` |
| Nhóm | Thư mục chat |
| Trạng thái | Đăng ký được |
| Scope cần để nhận | `messages.read` |
| Gắn với một tài khoản | Có |
| Chỉ kết nối gây ra sự kiện mới nhận | Không |
| Bộ lọc áp dụng | — |
| Trường bị bỏ ở chế độ nội dung `thin` | `folder.title` |
| Trường do người ngoài viết (không tin cậy) | `folder.title` |

## JSON Schema

[https://tlg.builera.app/schemas/events/folder.updated/2.json](https://tlg.builera.app/schemas/events/folder.updated/2.json)

## Payload mẫu (đúng như `webhooks.test` gửi)

```json
{
  "specversion": "1.0",
  "id": "evt_01JDOCSSAMPLE",
  "source": "https://tlg.builera.app/ws/07c2e5e1-c42f-4212-851b-c55b6dd7989d",
  "type": "folder.updated",
  "time": "2026-10-21T13:45:00.123Z",
  "datacontenttype": "application/json",
  "dataschema": "https://tlg.builera.app/schemas/events/folder.updated/2.json",
  "platform": "telegram",
  "workspaceid": "07c2e5e1-c42f-4212-851b-c55b6dd7989d",
  "accountid": "1a7d2c40-5b1e-4e7a-9d3f-6c2b8e1f0a11",
  "seq": "000000000000000",
  "schemaversion": "2",
  "correlationid": null,
  "causationid": null,
  "test": true,
  "replay": false,
  "data": {
    "account": {
      "id": "1a7d2c40-5b1e-4e7a-9d3f-6c2b8e1f0a11",
      "label": "Sale 1",
      "username": "sale_demo_1",
      "tg_user_id": "100200300"
    },
    "folder": {
      "id": "2c4e6a8b-0d1f-4a3c-9e5b-7d9f1b3d5f7a",
      "tg_folder_id": 3,
      "kind": "filter",
      "title": "Khách mới",
      "emoticon": "⭐",
      "color": 2,
      "position": 0,
      "filters": {
        "contacts": false,
        "non_contacts": true,
        "groups": false,
        "broadcasts": false,
        "bots": false,
        "exclude_muted": true,
        "exclude_read": false,
        "exclude_archived": true
      },
      "chats": {
        "pinned": 1,
        "included": 4,
        "excluded": 0
      }
    },
    "changed": [
      "title",
      "chats"
    ],
    "untrusted_fields": [
      "folder.title"
    ]
  }
}
```