Tài liệu

Tham chiếu

Đổi giai đoạn khách

Chuyển một người sang một giai đoạn quy trình.

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

Chuyển một người sang một giai đoạn quy trình.

Thông tin

Tên Giá trị
Mã people.set_stage
Scope cần crm.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, agent
Trong app Khách hàng → hồ sơ

Trường vào

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

Ví dụ gọi

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

Trường ra (data)

Trường Kiểu Bắt buộc
ok true Có
changed đúng/sai Có

Ví dụ trả về

{
  "data": {
    "ok": true,
    "changed": true
  }
}

Dùng qua MCP

Tool people_set_stage có tên sẵn trong profile: Tìm khách (prospecting). Ở 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