Tài liệu

Tham chiếu

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ó.

Xem MarkdownTrang này sinh tự động từ mã nguồn mỗi lần phát hành.

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

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ề

{
  "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.

Trang này có hữu ích không?

Kiểm lại lần cuối: 24/10/2026 · bản 2.0