---
title: "Chạy thử lịch việc ngay"
locale: vi
url: https://tlg.builera.app/docs/reference/rest/routines.run_now
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# Chạy thử lịch việc ngay

Bắt đầu ngay một lượt cho mọi tài khoản của lịch việc (cửa an toàn vẫn quyết định từng hành động). Trả kết quả theo từng tài khoản.

Bắt đầu ngay một lượt cho mọi tài khoản của lịch việc (cửa an toàn vẫn quyết định từng hành động). Trả kết quả theo từng tài khoản.

## Thông tin

| Tên | Giá trị |
| --- | --- |
| Mã | `routines.run_now` |
| 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` | Có |
| Vai trò thành viên được phép | `owner`, `manager` |
| Trong app | Tự động hoá → Lịch việc → Chạy thử ngay |

## Trường vào

| Trường | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- |
| `id` | `uuid` | Có |   |

## Ví dụ gọi

```bash
curl -X POST https://tlg.builera.app/api/public/v2/ops/routines.run_now \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: <mã riêng mỗi việc>" \
  -d '{"id":"00000000-0000-0000-0000-000000000000"}'
```

## Trường ra (`data`)

| Trường | Kiểu | Bắt buộc |
| --- | --- | --- |
| `ok` | `true` | Có |
| `outcomes` | `đối tượng[]` | Có |

## Ví dụ trả về

```json
{
  "data": {
    "ok": true,
    "outcomes": [
      {
        "accountId": "00000000-0000-4000-8000-000000000000",
        "status": "started",
        "detail": "text",
        "sequenceId": "00000000-0000-4000-8000-000000000000"
      }
    ]
  }
}
```

## 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.run_now"`. Tên tool khi được liệt kê: `routines_run_now`.