---
title: "Lập kế hoạch áp gói"
locale: vi
url: https://tlg.builera.app/docs/reference/rest/packs.plan
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# Lập kế hoạch áp gói

Lập kế hoạch áp một gói cho tài khoản (accountIds và/hoặc nhãn): thay đổi từng trường theo tài khoản và cảnh báo (đang tạm dừng, chưa có phiên, tuần đầu chế độ safe chặn người lạ, lịch không bao giờ mở, gói khác, đã sửa tay), các mục workspace sẽ thêm. Không đổi gì. Trả plan_id có hiệu lực 15 phút; sau đó gọi packs_apply với nó.

Lập kế hoạch áp một gói cho tài khoản (accountIds và/hoặc nhãn): thay đổi từng trường theo tài khoản và cảnh báo (đang tạm dừng, chưa có phiên, tuần đầu chế độ safe chặn người lạ, lịch không bao giờ mở, gói khác, đã sửa tay), các mục workspace sẽ thêm. Không đổi gì. Trả plan_id có hiệu lực 15 phút; sau đó gọi packs_apply với nó.

## Thông tin

| Tên | Giá trị |
| --- | --- |
| Mã | `packs.plan` |
| Scope cần | `automation.write` |
| Mức | Ghi |
| Có thể cần xác nhận | Không |
| Kiểu chạy | Trả kết quả ngay |
| Cần `Idempotency-Key` | Không |
| Vai trò thành viên được phép | `owner`, `manager` |
| Trong app | Tự động hoá → Gói cấu hình → Áp cho tài khoản → Xem trước |

## Trường vào

| Trường | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- |
| `packId` | `uuid` | Có |   |
| `accountIds` | `uuid[]` | Không |   |
| `tags` | `chữ[]` | Không |   |

## Ví dụ gọi

```bash
curl -X POST https://tlg.builera.app/api/public/v2/ops/packs.plan \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"packId":"00000000-0000-0000-0000-000000000000"}'
```

## Trường ra (`data`)

| Trường | Kiểu | Bắt buộc |
| --- | --- | --- |
| `ok` | `true` | Có |
| `plan` | `null \| chữ \| số \| đối tượng \| any[] \| đúng/sai` | Có |

## Ví dụ trả về

```json
{
  "data": {
    "ok": true,
    "plan": "text"
  }
}
```

## Dùng qua MCP

Không có tên sẵn trong profile nào: gọi `tools_describe` rồi `tools_run` với `code: "packs.plan"`. Tên tool khi được liệt kê: `packs_plan`.