Tài liệu

Tham chiếu

Xem trước chiến dịch

Kiểm tra chạy khô trước khi bắt đầu: tài khoản gửi, tệp người nhận, cửa an toàn, các tin đầu.

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

Kiểm tra chạy khô trước khi bắt đầu: tài khoản gửi, tệp người nhận, cửa an toàn, các tin đầu.

Thông tin

Tên Giá trị
Mã campaigns.preview
Scope cần campaigns.write
Mức Chỉ đọc
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 Chiến dịch → Xem trước

Trường vào

Trường Kiểu Bắt buộc Mô tả
id uuid Có

Ví dụ gọi

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

Trường ra (data)

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

Ví dụ trả về

{
  "data": {
    "ok": true,
    "preview": {
      "total": 1,
      "eligible": 1,
      "capped": true,
      "excluded": {
        "suppressed": 1,
        "other_owner": 1,
        "other_campaign": 1,
        "privacy": 1,
        "unreachable": 1,
        "never_talked": 1,
        "bot": 1,
        "own_account": 1
      },
      "senders": [
        {
          "id": "00000000-0000-4000-8000-000000000000",
          "label": "text",
          "ok": true,
          "reason": "text",
          "perDay": 1,
          "week": 1,
          "free": true,
          "people": 1
        }
      ],
      "days": 1,
      "estimate": "text",
      "samples": [
        {
          "personId": "00000000-0000-4000-8000-000000000000",
          "name": "text",
          "username": "text",
          "accountLabel": "text",
          "text": "text"
        }
      ],
      "issues": [
        {
          "blockId": "00000000-0000-4000-8000-000000000000",
          "message": "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: "campaigns.preview". Tên tool khi được liệt kê: campaigns_preview.

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

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