Tài liệu

Tham chiếu

Tạo chiến dịch

Tạo chiến dịch nháp (tìm khách hoặc nuôi), tuỳ chọn từ một mẫu và kèm người.

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

Tạo chiến dịch nháp (tìm khách hoặc nuôi), tuỳ chọn từ một mẫu và kèm người.

Thông tin

Tên Giá trị
Mã campaigns.create
Scope cần campaigns.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 Có
Vai trò thành viên được phép owner, manager
Trong app Chiến dịch → Tạo

Trường vào

Trường Kiểu Bắt buộc Mô tả
name chữ Có
goal "outreach" | "nurture" Có
template "soft_open" | "after_purchase" | "invite_channel" Không
personIds uuid[] Không

Ví dụ gọi

curl -X POST https://tlg.builera.app/api/public/v2/ops/campaigns.create \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: <mã riêng mỗi việc>" \
  -d '{"name":"…","goal":"outreach"}'

Trường ra (data)

Trường Kiểu Bắt buộc
ok true Có
id chữ Có

Ví dụ trả về

{
  "data": {
    "ok": true,
    "id": "00000000-0000-4000-8000-000000000000"
  }
}

Dùng qua MCP

Tool campaigns_create có tên sẵn trong profile: Thiết lập tự chạy (setup). Ở profile khác, tìm bằng tools_search rồi chạy bằng tools_run.

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

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