---
title: "Công việc, hàng đợi và trạng thái"
locale: vi
url: https://tlg.builera.app/docs/concepts/jobs-and-states
verified: 2026-10-24
app_version: "2.0"
---

# Công việc, hàng đợi và trạng thái

Hiểu thứ tự thực hiện, lý do giữ việc, kết quả chưa rõ và điều kiện chạy lại công việc.


Một yêu cầu được nhận chưa có nghĩa Telegram đã thực hiện. Các thao tác cần máy chạy được đưa thành công việc, chờ cổng giao việc và được ghi kết quả khi hoàn tất.

Bạn nên phân biệt trạng thái của công việc với trạng thái tài khoản và với lần gọi API đã tạo ra nó.

## Đọc các trạng thái

| Trạng thái | Ý nghĩa |
|---|---|
| `queued` | Đang chờ được xét giao |
| `held` | Đang bị giữ vì một điều kiện chưa đạt |
| `claimed` | Máy đã nhận và đang thực hiện |
| `done` | Hoàn tất thành công |
| `failed` | Kết thúc với lỗi |
| `unknown` | Chưa rõ hành động đã xảy ra trên Telegram hay chưa |
| `expired` | Đã hết hạn |
| `cancelled` | Đã bị huỷ |

Khi máy báo “chưa xác minh được”, công việc chuyển sang `unknown` — trong ứng dụng hiện là **Chưa rõ**.

Một việc `held` không bị xoá. Nếu chờ thời gian, hệ thống có mốc xem xét lại; nếu chờ sự thật thay đổi như phiên, proxy hoặc người nhận, hết thời gian đơn thuần không làm việc tự được phép chạy.

## Các làn ưu tiên

Có **5 làn**:

| Làn | Công việc tiêu biểu |
|---|---|
| `control` | Đăng nhập, đăng xuất, phục hồi phiên |
| `direct` | Trả lời khách và thao tác trực tiếp trong một hội thoại |
| `drip` | Bước tiếp theo của chuỗi hoặc chiến dịch đang chạy |
| `broadcast` | Tiếp cận đầu tiên, lời mời, gửi chủ động |
| `background` | Đồng bộ, lịch sử, tìm kiếm, quét, nuôi và bảo trì |

Để được xem là trả lời (làn `direct`), tin đến gần nhất từ người đó phải trong **72 giờ**.

Máy chủ của ứng dụng quyết định làn từ dữ kiện nó đang giữ. Bên gọi không tự nâng được độ ưu tiên, và công việc không tự lên làn chỉ vì chờ lâu.

## Thứ tự trong một hội thoại

Trong cùng hội thoại, việc vào trước làm trước — được giữ trước khi xét làn. Một việc ưu tiên hơn không vượt qua việc trước đó trong cùng hội thoại.

Một việc có kết quả **Chưa rõ** giữ các việc tiếp theo của hội thoại đó lại. Điều này ngăn chuỗi tin tiếp tục khi hệ thống chưa biết tin trước đã đi hay chưa.

## Chưa rõ và đối soát

**Chưa rõ** không đồng nghĩa thất bại. Telegram có thể đã thực hiện nhưng phản hồi chưa về.

Hệ thống không tự gửi lại trong trường hợp này. Lượt vẫn được tính. Khi biên nhận đến muộn, hệ thống kiểm tra đúng tài khoản, đúng lần thực hiện và dữ kiện khớp rồi mới xác nhận đã gửi — một lần, không tính lượt lần hai.

Cửa sổ nhận biên nhận muộn là **24 giờ** tính từ lúc công việc kết thúc. Đây không phải lời hứa mọi việc sẽ tự rõ sau 24 giờ, và cũng không phải mốc cho phép gửi lại. Xem [Gửi chưa rõ kết quả](https://tlg.builera.app/docs/troubleshooting/unverified-send).

## Thử lại và chạy lại thủ công

Hành động có tác động (gửi, mời, sửa…) không tự thử lại. Việc chỉ đọc được thử lại khi gặp lỗi tạm thời, tối đa **3 lần**. Khoảng chờ nền là **60 giây**, và không bao giờ ngắn hơn thời gian FLOOD_WAIT hoặc SLOWMODE Telegram yêu cầu.

> [!WARNING]
> Chạy lại một việc có tác động có thể tạo tác động trùng. Chỉ xác nhận sau khi kiểm tra kết quả thực tế.

**Chạy lại** (`jobs.redrive`) chỉ nhận việc **Lỗi** hoặc **Hết hạn**. Nó từ chối việc Chưa rõ, việc còn mở, việc đã xong hoặc đã huỷ. Tin nhắn, đăng nhập và việc do chiến dịch hoặc lịch nuôi quản lý có đường xử lý riêng. Bản chạy lại là một việc mới gắn với việc gốc; việc gốc không bị sửa.

## Liên quan

- [Nhật ký](https://tlg.builera.app/docs/guides/logs)
- [Điều tra công việc thất bại](https://tlg.builera.app/docs/agent-playbooks/investigate-failed-job)
- [Gửi chưa rõ kết quả](https://tlg.builera.app/docs/troubleshooting/unverified-send)
- [Thao tác jobs.redrive](https://tlg.builera.app/docs/reference/rest/jobs.redrive)