---
title: "Scope & vai trò"
locale: vi
url: https://tlg.builera.app/docs/reference/scopes
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# Scope & vai trò

Các nhóm việc (scope), mẫu quyền nhanh, profile MCP và cách giới hạn theo vai trò.

Kết nối chỉ làm được việc có scope tương ứng, trong giới hạn vai trò của nó (không vượt người tạo) và trên các tài khoản được giao.

## Scope

| Mã | Mô tả | Số thao tác |
| --- | --- | --- |
| `accounts.read` | Xem tài khoản | 22 |
| `accounts.settings` | Cài đặt tài khoản (giờ chạy, hạn mức, nhãn) | 8 |
| `accounts.manage` | Tạo / đăng nhập / đăng xuất / gỡ tài khoản | 9 |
| `messages.read` | Đọc hội thoại và tin nhắn | 23 |
| `messages.send` | Gửi tin, đánh dấu đã đọc, đang gõ | 23 |
| `messages.manage` | Sửa / xoá / chuyển tiếp / ghim tin | 9 |
| `chats.manage` | Trạng thái hội thoại, giao người, thẻ, ghi chú, mẫu trả lời | 6 |
| `contacts.write` | Tìm người, lưu danh bạ, tạo nhóm chat | 7 |
| `groups.join` | Vào / rời nhóm | 2 |
| `groups.admin` | Quản trị nhóm | 35 |
| `groups.scan` | Quét thành viên nhóm | 2 |
| `profile.write` | Sửa hồ sơ Telegram | 6 |
| `crm.read` | Xem khách và danh sách | 11 |
| `crm.write` | Sửa khách, giai đoạn, thẻ, danh sách, nhập khách | 17 |
| `crm.export` | Xuất dữ liệu khách | 1 |
| `crm.erase` | Xoá hẳn dữ liệu một người | 1 |
| `campaigns.write` | Tạo / sửa chiến dịch | 13 |
| `campaigns.run` | Chạy / dừng chiến dịch | 5 |
| `nurture.write` | Nuôi tài khoản, lịch giờ | 8 |
| `discovery.write` | Tìm nhóm, từ khoá, tín hiệu | 7 |
| `automation.write` | Gói cấu hình, lịch việc, luật tự động | 10 |
| `stats.read` | Xem thống kê và hạn mức | 4 |
| `audit.read` | Xem nhật ký và cảnh báo | 5 |
| `infra.manage` | Máy chạy, proxy | 18 |
| `members.manage` | Thành viên và lời mời | 7 |
| `integrations.manage` | Khoá API, mọi webhook của workspace, kết nối khác | 8 |
| `webhooks.read` | Xem webhook của chính kết nối, lần gửi, danh mục sự kiện | 8 |
| `webhooks.manage` | Tạo / sửa / gửi thử / cứu webhook của chính kết nối | 11 |
| `bots.manage` | Tạo / sửa / xoá bot của tài khoản (qua BotFather) | 7 |

`integrations.manage` bao gồm `webhooks.read` và `webhooks.manage`.

## Mẫu quyền nhanh

| Tên | Vai trò | Scope |
| --- | --- | --- |
| Chỉ đọc (`read`) | `viewer` | `accounts.read`, `messages.read`, `crm.read`, `stats.read`, `audit.read` |
| Vận hành (`operate`) | `agent` | `accounts.read`, `messages.read`, `crm.read`, `stats.read`, `audit.read`, `messages.send`, `messages.manage`, `chats.manage`, `contacts.write`, `crm.write`, `webhooks.read`, `webhooks.manage` |
| Thiết lập (`setup`) | `manager` | `accounts.read`, `messages.read`, `crm.read`, `stats.read`, `audit.read`, `accounts.settings`, `campaigns.write`, `campaigns.run`, `nurture.write`, `discovery.write`, `automation.write`, `groups.join`, `groups.scan`, `webhooks.read`, `webhooks.manage` |
| Toàn quyền (`full`) | `manager` | * |

## Profile

| Mã | Tên | Tool có tên |
| --- | --- | --- |
| `realtime` | Vận hành realtime | 35 |
| `setup` | Thiết lập tự chạy | 35 |
| `prospecting` | Tìm khách | 35 |
| `reports` | Báo cáo | 35 |
| `admin` | Quản trị | 35 |
| `full` | Đầy đủ | 35 |