---
sourceType: official-guide
sourceTypeMatchedRule: fallback
slug: OA/extension/advanced/app-config-json
title: app-config.json
---
# app-config.json

![](/assets/OA/img/extension/app-config-structure.png)

`app-config.json` là file được sử dụng để thiết lập cấu hình cơ bản cho extension.

## Cấu trúc

### Cấu hình Zones

Phần `zones` trong `app-config.json` chứa các cài đặt cho mỗi zone (block/action) mà extension sử dụng.

| Tham số | Kiểu dữ liệu | Mô tả |
|---------|------------|-------|
| `zones` | JSON | • Các khóa là tên của các zone (block/action) được sử dụng bởi tiện ích mở rộng   • Chỉ những zone được khai báo và có `zones.enable = true` mới được hiển thị |
| `zones.zone_name.enable` | boolean | • Kích hoạt/vô hiệu zone cụ thể |
| `zones.zone_name.roles` | mảng | • Thiết lập khả năng hiển thị của zone dựa trên vai trò quản lý admin OA   • Chỉ áp dụng cho các zone `admin-*`   • Nếu trống, zone sẽ hiển thị với tất cả các role admin của OA |


### Mô tả role admin của OA

Để biết thêm thông tin về quyền hạn của các vai trò, hãy truy cập [Quản lý Admin Zalo OA](https://oa.zalo.me/home/documents/guides/quan-ly-admin-oa_83).

| Tên vai trò       | Mô tả |
|-------------------|-------|
| CUSTOMER_SERVICE | Chăm sóc khách hàng |
| ADVERTISER       | Nhân viên quảng cáo |
| INSIGHT_ANALYST  | Nhà phân tích |
| AGENCY           | Quản lý gói và liên kết |
| MANAGER          | Quản trị viên |
| MODERATOR        | Quản lý nội dung |

## Mẫu cấu hình

```json
{
    "app": {
        "title": "ProjectName"
    },
    "debug": false,
    "zones": {
        "admin-dashboard-primary-area-block": {
            "enable": true
        },
        "admin-profile-config-action": {
            "enable": true
        },
        "user-profile-config-block": {
            "enable": true
        },
        "admin-chat-message-profile-block": {
            "enable": true,
            "roles": [
                "MANAGER",
                "MODERATOR"
            ]
        },
        "admin-chat-message-toolbar-action": {
            "enable": true,
            "roles": [
                "MANAGER",
                "MODERATOR"
            ]
        }
    },
    "listCSS": [],
    "listSyncJS": [],
    "listAsyncJS": []
}