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.