Tài liệu

Tham chiếu

Áp gói theo kế hoạch

Áp đúng một kế hoạch từ packs_plan (expectedAccounts = số tài khoản của kế hoạch). Bị từ chối với revision_conflict khi gói hoặc tài khoản đã đổi từ lúc lập kế hoạch, plan_expired sau 15 phút, plan_used nếu đã áp. Báo kết quả từng tài khoản. Hơn 20 tài khoản phải được người dùng xác nhận.

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

Áp đúng một kế hoạch từ packs_plan (expectedAccounts = số tài khoản của kế hoạch). Bị từ chối với revision_conflict khi gói hoặc tài khoản đã đổi từ lúc lập kế hoạch, plan_expired sau 15 phút, plan_used nếu đã áp. Báo kết quả từng tài khoản. Hơn 20 tài khoản phải được người dùng xác nhận.

Thông tin

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

Trường vào

Trường Kiểu Bắt buộc Mô tả
planId uuid Có
expectedAccounts số nguyên Có

Ví dụ gọi

curl -X POST https://tlg.builera.app/api/public/v2/ops/packs.apply \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: <mã riêng mỗi việc>" \
  -d '{"planId":"00000000-0000-0000-0000-000000000000","expectedAccounts":1}'

Trường ra (data)

Trường Kiểu Bắt buộc
ok true Có
results đối tượng[] Có

Ví dụ trả về

{
  "data": {
    "ok": true,
    "results": [
      {
        "accountId": "00000000-0000-4000-8000-000000000000",
        "name": "text",
        "ok": true,
        "error": "text",
        "changed": 1
      }
    ]
  }
}

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.apply". Tên tool khi được liệt kê: packs_apply.

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

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