Tham chiếu

Tạo / sửa lịch việc

Một lịch lặp — { kind: weekly, times: ["08:00"], days: [1..5] } hoặc { kind: every, hours: N } theo múi giờ riêng của từng tài khoản — chạy một chuỗi bước cho các tài khoản / nhãn được chọn. Các bước giống sequences_run nhưng trường tài khoản được điền theo từng tài khoản (chỉ thao tác theo tài khoản, không nguy hiểm, chờ và chờ sự kiện). Khung giờ nằm ngoài giờ chạy của tài khoản bị bỏ qua khi tài khoản theo lịch. Cập nhật cần expectedRevision.

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

Thông tin

Tên	Giá trị
Mã	`routines.save`
Scope cần	`automation.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	Tự động hoá → Lịch việc → Lưu

Trường vào

Trường	Kiểu	Bắt buộc
`id`	`uuid`	Không
`name`	`chữ`	Có
`enabled`	`đúng/sai`	Không
`schedule`	`đối tượng`	Có
`target`	`đối tượng`	Có
`steps`	`đối tượng[]`	Có
`expectedRevision`	`số nguyên`	Không

Ví dụ gọi

curl -X POST https://tlg.builera.app/api/public/v2/ops/routines.save \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"…","schedule":"…","target":"…","steps":[]}'

Trường ra (`data`)

Trường	Kiểu	Bắt buộc
`ok`	`true`	Có
`id`	`chữ`	Có
`revision`	`null \| số`	Có

Ví dụ trả về

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

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: "routines.save". Tên tool khi được liệt kê: routines_save.

Tạo / sửa lịch việc

#Thông tin

#Trường vào

#Ví dụ gọi

#Trường ra (data)