Tài liệu

Tham chiếu

Ghi danh người vào chiến dịch

Ghi danh tối đa 5000 người CRM vào một chiến dịch (enroll_campaign). Cùng luật như campaigns.add_people (vẫn là tên gọi khác): người đã ở chiến dịch khác, đã từ chối hoặc không có tài khoản liên hệ được sẽ bị bỏ qua kèm lý do; không bao giờ tự chạy một chiến dịch đang tạm dừng hay còn nháp.

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

Ghi danh tối đa 5000 người CRM vào một chiến dịch (enroll_campaign). Cùng luật như campaigns.add_people (vẫn là tên gọi khác): người đã ở chiến dịch khác, đã từ chối hoặc không có tài khoản liên hệ được sẽ bị bỏ qua kèm lý do; không bao giờ tự chạy một chiến dịch đang tạm dừng hay còn nháp.

Thông tin

Tên Giá trị
Mã enrollments.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 Không
Vai trò thành viên được phép owner, manager
Trong app Chiến dịch → Người nhận → Thêm

Trường vào

Trường Kiểu Bắt buộc Mô tả
campaignId uuid Có
personIds uuid[] Có

Ví dụ gọi

curl -X POST https://tlg.builera.app/api/public/v2/ops/enrollments.create \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"campaignId":"00000000-0000-0000-0000-000000000000","personIds":[]}'

Trường ra (data)

Trường Kiểu Bắt buộc
draft đúng/sai Có
added số Có
excluded số Có
ok true Có

Ví dụ trả về

{
  "data": {
    "draft": true,
    "added": 1,
    "excluded": 1,
    "ok": true
  }
}

Dùng qua MCP

Tool enrollments_create có tên sẵn trong profile: Vận hành realtime (realtime), Thiết lập tự chạy (setup), Tìm khách (prospecting), Báo cáo (reports), Quản trị (admin), Đầy đủ (full). Ở 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