Tự động hóa
Tự động hóa chạy chỉ dẫn theo lịch và đưa kết quả vào chat.
Cấu trúc
Có tên, chỉ dẫn, tối đa năm trigger, mô hình tùy chọn, đích và thông báo. Chat session tạo chat; Work task tạo Work. Lỗi vào thông báo. Dữ liệu được mã hóa.
Trigger: once, hourly, daily, weekly, monthly, yearly.
Thực thi
Scheduler chạy mỗi phút với lease. Khi đến hạn, ghi run, enqueue automation.run.v1, cập nhật next_run_at bằng compare-and-set.
Nếu server tắt, lần gần nhất chạy một lần. Pause xóa lịch; resume tính lại. Run stalled nếu không bắt đầu trong 30 phút.
Work kiểm tra quyền khi chạy và có thể trả work-access-denied.
Routine đại lý
workTaskId liên kết task hiện có trong panel đại lý. Task thiếu trả work-task-missing; bận trả work-task-busy.
Trigger webhook
Ngoài lịch, một tự động hóa còn có thể được hệ thống bên ngoài kích hoạt — CI pipeline, dịch vụ cron, nhà thông minh. Trong hộp thoại sửa tự động hóa, Webhook trigger → Enable sinh secret riêng cho tự động hóa đó; chỉ SHA-256 được lưu nên bản rõ chỉ hiện đúng một lần. Xoay secret vô hiệu hóa secret cũ ngay lập tức, còn tắt webhook thì đóng lại endpoint.
Hệ thống bên ngoài kích hoạt tự động hóa bằng:
curl -X POST https://your-host/api/automations/<automationId>/webhook \
-H "Authorization: Bearer lwh_..."
(X-Libre-Webhook-Secret: lwh_... dùng được như header thay thế.) Phản hồi là 202 kèm id của run đã vào hàng đợi — cùng đường chạy thủ công với Run now, nên run kết thúc, thông báo và vào lịch sử y hệt. So sánh secret theo thời gian hằng; tự động hóa không tồn tại và secret sai trả lời giống hệt nhau (không lộ id tự động hóa), còn tự động hóa đang tạm dừng trả 409: khác với Run now của chủ sở hữu, người gọi bên ngoài không thể kích hoạt xuyên qua trạng thái tạm dừng.
API
Mọi endpoint trừ lệnh kích hoạt webhook đều cần xác thực và chỉ tác động lên tự động hóa của chính người gọi; lệnh kích hoạt webhook xác thực bằng secret riêng của tự động hóa.
| Phương thức | Đường dẫn | Mục đích |
|---|---|---|
GET | /api/automations | Danh sách |
POST | /api/automations | Tạo |
GET | /api/automations/occurrences?from=&to= | Sự kiện |
GET | /api/automations/runs | Lịch sử |
GET | /api/automations/runs/summary | Tóm tắt |
POST | /api/automations/runs/seen | Đã xem |
GET | /api/automations/:automationId | Đọc |
PUT | /api/automations/:automationId | Sửa |
DELETE | /api/automations/:automationId | Xóa |
POST | /api/automations/:automationId/pause | Dừng |
POST | /api/automations/:automationId/resume | Tiếp |
POST | /api/automations/:automationId/run | Chạy |
POST | /api/automations/:automationId/webhook | Kích hoạt bằng secret (202) |
POST | /api/automations/:automationId/webhook-secret | Tạo/xoay secret |
DELETE | /api/automations/:automationId/webhook-secret | Tắt webhook |
Tối đa 50 tự động hóa, tên 200 ký tự, chỉ dẫn 20.000.