Telegram giới hạn tốc độ gửi tin nhắn của bot như thế nào?
Telegram giới hạn tốc độ gửi tin nhắn của bot theo từng khung: 30 tin/giây và 20 tin/phút mỗi nhóm; bài viết chỉ cách đọc lỗi 429, xếp hàng đợi và tối ưu gửi.

Vì sao Bot API có giới hạn tốc độ, và giới hạn đó nằm ở đâu
Khi vận hành một bot có lượng người dùng thực, câu hỏi Telegram giới hạn tốc độ gửi tin nhắn của bot như thế nào thường xuất hiện muộn hơn dự kiến. Hệ thống chạy ổn trong giai đoạn thử nghiệm vài chục người, rồi đột ngột trả về hàng loạt lỗi 429 Too Many Requests đúng vào ngày có chiến dịch thông báo lớn. Nguyên nhân gần như luôn giống nhau: giới hạn của Bot API là giới hạn theo cửa sổ thời gian, không phải theo tổng khối lượng. Vì vậy, một đoạn mã gửi song song hàng nghìn request sẽ bị chặn gần như tức thì, dù tổng số tin nhắn trong ngày vẫn nằm trong ngưỡng hợp lý.
Bot API bản chất là một lớp HTTP/JSON bao quanh hạ tầng nhắn tin của Telegram. Mỗi lần bot gọi sendMessage, sendPhoto hay editMessageText, Telegram phải xác thực token, kiểm tra quyền của bot trong chat đích, ghi dữ liệu và đẩy sự kiện tới các thiết bị của người nhận. Giới hạn tốc độ (rate limit — số request được chấp nhận trong một khoảng thời gian xác định) tồn tại để phục vụ ba mục tiêu cùng lúc: bảo vệ hạ tầng khỏi lưu lượng đột biến, ngăn bot bị lợi dụng làm công cụ spam, và bảo đảm chất lượng phân phối cho mọi bot khác đang chạy trên cùng nền tảng. Hiểu theo nghĩa đó, đây không phải một rào cản kỹ thuật tùy tiện mà là một hợp đồng ngầm: bot được phép gửi rất nhiều, miễn là gửi có nhịp.
Điều quan trọng là phân biệt ba tầng giới hạn khác nhau đang chồng lên nhau, vì cách xử lý của mỗi tầng rất khác nhau. Tầng thứ nhất là giới hạn trên một chat cụ thể: gửi dồn dập vào cùng một người dùng hay cùng một nhóm sẽ bị chặn sớm hơn nhiều so với gửi rải đều cho nhiều người. Tầng thứ hai là giới hạn toàn cục theo token bot, tức tổng thông lượng mà bot được phép phát ra. Tầng thứ ba là những giới hạn phụ thuộc ngữ cảnh: kích thước tin nhắn, số phần tử trong một album, tần suất chỉnh sửa, tần suất trả lời callback. Ba tầng này không cộng tuyến tính, nên một bot “chỉ gửi 10 tin/giây” vẫn có thể bị chặn nếu cả 10 tin đều vào cùng một nhóm trong cùng một giây.
Nguyên tắc làm việc: hãy thiết kế như thể giới hạn sẽ thấp hơn tài liệu công bố, và đo lại bằng chính lưu lượng của bạn. Tài liệu cho biết ngưỡng trần; hệ thống thực tế của bạn có thể chạm ngưỡng sớm hơn do độ trễ mạng, do retry đồng loạt, hoặc do nhiều tiến trình cùng dùng chung một token.
Các con số đang được Telegram công bố, và cách tự xác minh
Khi đã hiểu vì sao giới hạn tồn tại, bước tiếp theo là xác định những con số nào thực sự có căn cứ công khai. Phần lớn con số mà cộng đồng trích dẫn đến từ mục hỏi đáp chính thức của Bot API về việc “bot của tôi bị chạm giới hạn, làm sao tránh”. Ở thời điểm viết bài này, tài liệu nêu ba mốc đáng chú ý: không nên gửi quá khoảng một tin nhắn mỗi giây vào cùng một chat; không gửi quá khoảng 30 tin nhắn mỗi giây tới các người dùng khác nhau; và không gửi quá khoảng 20 tin nhắn mỗi phút vào cùng một nhóm. Đây là các ngưỡng được diễn đạt bằng “khoảng” và “không nên”, nghĩa là Telegram giữ quyền cho phép bùng nổ ngắn trong một số trường hợp nhưng không cam kết điều đó.
Vì tài liệu có thể được cập nhật bất kỳ lúc nào, cách làm đúng là xem đây như điểm khởi đầu chứ không phải hằng số. Quy trình xác minh có thể tái lập gồm bốn bước: mở trang tài liệu Bot API chính thức và đọc lại mục về giới hạn; ghi lại thời điểm tra cứu vào tài liệu nội bộ của nhóm; chạy một bài đo nhỏ trên bot staging với hai kịch bản (gửi tới nhiều chat khác nhau, và gửi dồn vào một nhóm); sau đó ghi lại mã lỗi và giá trị retry_after quan sát được. Kết quả đo trên staging thường đủ để chốt cấu hình hàng đợi cho production, miễn là bạn ghi rõ ngày đo và phiên bản Bot API tại thời điểm đó.
| Ngữ cảnh gửi | Ngưỡng tham chiếu | Nguồn / mức độ chắc chắn |
|---|---|---|
| Nhiều người dùng khác nhau | khoảng 30 tin/giây cho toàn bot | Tài liệu Bot API (mục broadcasting) |
| Cùng một nhóm hoặc siêu nhóm | khoảng 20 tin/phút | Tài liệu Bot API (mục broadcasting) |
| Cùng một chat riêng | khoảng 1 tin/giây | Khuyến nghị chính thức, diễn đạt mềm |
| Chỉnh sửa liên tục một tin nhắn | Không có ngưỡng công bố riêng | Quan sát thực nghiệm: bị chặn khi giãn cách quá ngắn |
| Kích thước nội dung | 4.096 ký tự mỗi tin, 1.024 ký tự chú thích media | Tài liệu Bot API |
Bảng trên cố tình để trống những ô mà cộng đồng hay truyền tai nhau nhưng không có căn cứ công khai, ví dụ “giới hạn 30 tin/giây áp dụng riêng cho từng nhóm” hay “bot được phép gửi 100 tin/phút vào nhóm nếu là admin”. Không có tuyên bố chính thức nào xác nhận những con số đó. Khi một tài liệu nội bộ trích dẫn một ngưỡng không tìm thấy trong tài liệu chính thức, hãy đánh dấu nó là giả thuyết làm việc và kiểm tra lại bằng bài đo trước khi đưa vào mã sản xuất.
Ba tầng giới hạn bạn phải mô hình hóa trong mã nguồn
Ba tầng dưới đây không hoạt động độc lập: một request có thể đồng thời bị chi phối bởi cả ba. Vì vậy, việc mô hình hóa trong mã nguồn cần bắt đầu từ việc nhận diện tầng nào đang chặn request, thay vì chỉ thêm một hàng đợi chung.
Tầng theo chat: chi phí của sự kiên nhẫn
Giới hạn theo chat là tầng dễ bị vi phạm nhất vì nó va chạm trực tiếp với logic nghiệp vụ. Một bot nhắc việc gửi ba thông báo cho cùng một người trong vòng hai giây — nhắc trước giờ họp, thông báo người phụ trách thay đổi, và xác nhận đã ghi nhận — sẽ tạo ra ba request liên tiếp vào cùng một chat. Cách xử lý đúng không phải là hạ thấp tần suất nghiệp vụ, mà là tách “ý định gửi” khỏi “thời điểm gửi”: nghiệp vụ đẩy ba sự kiện vào hàng đợi của chat đó, bộ điều phối rút ra theo nhịp cho phép, và nếu cần thì gộp ba sự kiện thành một tin nhắn duy nhất.
Lý do phải làm ở tầng hàng đợi thay vì thêm sleep rải rác trong mã: khi có nhiều worker chạy song song, mỗi worker chỉ biết nhịp của chính nó, còn Telegram thì đếm theo chat. Hai worker cùng gửi một chat với khoảng cách mỗi bên một giây sẽ tạo ra hai tin trong một giây và cùng bị chặn. Hàng đợi theo khóa chat, có một bộ đếm dùng chung (thường đặt trong Redis hoặc một dịch vụ trung gian), là cách duy nhất để mọi tiến trình nhìn thấy cùng một nhịp.
Khi nào không nên dùng cách này: với bot nội bộ chỉ phục vụ vài chục người và lưu lượng thấp, việc dựng hàng đợi phân tán là đầu tư quá mức. Trong trường hợp đó, một hàng đợi trong bộ nhớ với khóa theo chat là đủ, miễn là bạn chấp nhận mất hàng đợi khi tiến trình khởi động lại. Ranh giới nằm ở chỗ: nếu mất một thông báo không gây hậu quả nghiệp vụ, đừng dựng hạ tầng phức tạp; nếu mất thông báo là mất tiền, hãy dùng hàng đợi bền vững có ghi log.
Tầng toàn cục: trần thông lượng của cả token
Ngay cả khi mỗi chat đều được giãn cách hoàn hảo, tổng số request mỗi giây vẫn có trần. Với ngưỡng tham chiếu khoảng 30 tin/giây tới các người dùng khác nhau, một chiến dịch gửi cho 100.000 người sẽ cần tối thiểu khoảng 3.333 giây, tức gần 56 phút, nếu chạy đúng nhịp và không có request nào bị lỗi. Đây là phép chia đơn giản từ ngưỡng công bố, không phải kết quả đo hiệu năng; trong thực tế con số sẽ lớn hơn vì phải tính thời gian mạng, thời gian xử lý, và các lần retry.
Hệ quả thiết kế là thông lượng toàn cục phải được cấp phát có chủ đích. Nếu bạn để chiến dịch marketing chiếm toàn bộ 30 tin/giây, thì tin nhắn xác thực đăng nhập của người dùng mới sẽ phải xếp sau hàng trăm nghìn tin quảng cáo — một trải nghiệm tệ và đôi khi là lỗi nghiêm trọng. Cách phổ biến là chia ngân sách thông lượng thành các làn có ưu tiên: làn giao dịch (xác thực, cảnh báo bảo mật) được giữ một phần ngân sách cố định, làn thông báo dịch vụ dùng phần tiếp theo, làn broadcast dùng phần còn lại và có thể bị bóp lại khi các làn trên tăng tải.
Khi nào không nên chia làn: nếu bot chỉ có một loại thông điệp duy nhất, việc chia làn tạo thêm cấu hình mà không tạo thêm giá trị. Chỉ nên chia khi tồn tại ít nhất hai loại thông điệp có mức khẩn cấp khác nhau rõ rệt.
Tầng ngữ cảnh: kích thước, album, chỉnh sửa
Ba giới hạn ngữ cảnh hay bị bỏ qua là độ dài văn bản, số phần tử trong một album, và tần suất chỉnh sửa. Văn bản vượt 4.096 ký tự sẽ bị từ chối với lỗi 400 chứ không phải 429, nhưng hệ quả vận hành thì giống nhau: tin nhắn không tới nơi. Album (media group) nhận từ hai đến mười phần tử trong một request; gửi mười một ảnh sẽ phải tách thành hai request, và hai request đó lại tính vào nhịp của cùng một chat. Chỉnh sửa tin nhắn — cách phổ biến để làm đồng hồ đếm ngược hoặc cập nhật trạng thái — không có ngưỡng công bố riêng, nhưng quan sát thực nghiệm cho thấy nó cũng bị chặn khi giãn cách quá ngắn, và việc bị chặn có thể kéo theo hiệu ứng dây chuyền vì mỗi lần retry lại là một request mới.
Cách kiểm chứng định tính: dựng một bot thử, chỉnh sửa một tin nhắn theo chu kỳ cố định, giảm dần khoảng cách giữa các lần chỉnh sửa cho tới khi xuất hiện lỗi 429, và ghi lại khoảng cách cuối cùng còn thành công cùng thời điểm đo. Đừng biến con số thu được thành một hằng số trong mã nguồn; hãy dùng nó để chọn một khoảng cách an toàn có biên dự phòng, ví dụ gấp đôi hoặc gấp ba khoảng cách quan sát được.
Đọc phản hồi 429 đúng cách: retry_after và những gì không nên làm
Khi bị chặn, Bot API trả về một đối tượng lỗi có cấu trúc rõ ràng. Trường quan trọng nhất là parameters.retry_after, cho biết bot nên chờ bao nhiêu giây trước khi thử lại. Bỏ qua trường này là sai lầm phổ biến nhất: thử lại ngay lập tức không những không thành công mà còn có thể làm tình trạng tệ hơn, vì Telegram có thể coi đó là hành vi tiếp tục vượt ngưỡng và kéo dài thời gian chặn.
{
"ok": false,
"error_code": 429,
"description": "Too Many Requests: retry after 27",
"parameters": {
"retry_after": 27
}
}
Quy tắc xử lý nên được viết thành một hàm duy nhất dùng chung cho mọi lời gọi API, không rải rác trong từng nghiệp vụ. Hàm đó cần: đọc retry_after nếu có; cộng thêm một khoảng jitter ngẫu nhiên nhỏ để tránh hàng nghìn worker cùng thức dậy ở cùng một mili giây; đẩy request trở lại hàng đợi với thời điểm thực thi mới thay vì giữ worker ngủ; và ghi lại số lần đã retry cho cùng một thông điệp. Sau một số lần retry nhất định, thông điệp nên được chuyển sang hàng đợi chờ chết (dead-letter queue) để con người xem xét, thay vì tiếp tục đốt thông lượng vào một request có thể hỏng vĩnh viễn.
Điều không nên làm, và lý do: không nên dùng sleep cố định ngắn hơn retry_after với hy vọng “thử lại sớm biết đâu được”; không nên retry các lỗi 400 như sai định dạng hoặc chat không tồn tại, vì chúng sẽ không tự khỏi; không nên retry vô hạn với backoff tuyến tính vì tổng thời gian chờ sẽ hội tụ về một giá trị đủ lớn để làm nghẽn hàng đợi; và không nên nuốt lỗi rồi trả về thành công cho tầng nghiệp vụ, vì khi đó bạn mất khả năng đối soát số tin thực sự đã gửi.
Mẹo thực hành: hãy gắn một mã định danh duy nhất (idempotency key) cho mỗi thông điệp trước khi đưa vào hàng đợi. Khi retry, giữ nguyên mã đó và kiểm tra xem thông điệp đã được gửi thành công ở một nhánh khác chưa. Điều này quan trọng vì trong tình huống timeout, request có thể đã tới Telegram và tin nhắn đã được gửi, chỉ là phản hồi không về kịp — retry mù sẽ tạo tin nhắn trùng.
Đường dẫn thao tác ngắn nhất: từ BotFather tới nơi xem log
Trước khi nói về cấu hình, cần thống nhất điểm vào. Với bot mới, đường đi ngắn nhất là mở Telegram, tìm @BotFather, gõ /newbot, đặt tên hiển thị và tên người dùng kết thúc bằng bot. Token trả về chính là thứ duy nhất Bot API dùng để xác thực. Nếu đã có bot, dùng /mybots, chọn bot, rồi chọn mục lấy API Token; nếu nghi ngờ token bị lộ, dùng /revoke để tạo token mới và cập nhật lại toàn bộ biến môi trường. Đường dẫn trong BotFather là một cuộc hội thoại nên giống nhau trên Android, iOS và Desktop; khác biệt duy nhất là cách mở cuộc hội thoại đó.
Về phía ứng dụng, các vị trí sau hữu ích khi cần kiểm tra quyền của bot trong nhóm. Trên Android: mở nhóm, nhấn vào tên nhóm, chọn biểu tượng chỉnh sửa, vào mục Quản trị viên (Administrators) để xem bot đã được cấp quyền gửi tin chưa. Trên iOS: mở nhóm, nhấn tên nhóm, chọn Chỉnh sửa (Edit), rồi vào Quản trị viên. Trên Desktop: nhấp chuột phải vào nhóm trong danh sách, chọn Quản lý nhóm (Manage Group) và mở tab Quản trị viên. Tên mục và vị trí có thể thay đổi đôi chút giữa các phiên bản ứng dụng, nên nếu không thấy đúng nhãn, hãy tìm theo từ khóa “Administrators” hoặc “Quản trị viên” trong phần cài đặt nhóm.
Về phía API, ba lời gọi giúp chẩn đoán nhanh: getMe xác nhận token còn hiệu lực; getWebhookInfo cho biết webhook đang trỏ tới đâu, có lỗi gần nhất hay không, và còn bao nhiêu cập nhật đang chờ; getUpdates dùng để kiểm tra nhanh khi chưa cấu hình webhook, nhưng chỉ nên dùng ở môi trường phát triển vì hai cơ chế này không thể chạy song song trên cùng một token mà không gây mất cập nhật. Nhánh thất bại thường gặp: getMe trả về 401 nghĩa là token sai hoặc đã bị thu hồi; getWebhookInfo trả về last_error_message nghĩa là endpoint của bạn đang trả lỗi và Telegram sẽ tiếp tục thử lại, điều này có thể làm dồn ứ cập nhật.
Dự phòng khi không truy cập được BotFather: nếu bot do một tài khoản khác tạo và bạn không có quyền, cách duy nhất hợp lệ là yêu cầu chủ sở hữu chuyển token qua kênh bảo mật hoặc tạo bot mới. Không có cơ chế chính thức nào để “lấy lại” bot từ token của người khác, và việc cố tình làm vậy vi phạm điều khoản dịch vụ.
Thiết kế hàng đợi hai tầng: token bucket theo chat và theo bot
Mô hình đủ tốt cho hầu hết hệ thống là hai token bucket lồng nhau. Bucket thứ nhất đại diện cho trần toàn cục của bot; bucket thứ hai đại diện cho từng chat riêng lẻ. Một request chỉ được phát đi khi cả hai bucket đều còn token. Cách này xử lý đúng cả hai tình huống cực đoan: chiến dịch gửi rộng bị giới hạn bởi bucket toàn cục, còn một chat bị dội tin liên tục bị giới hạn bởi bucket của chính nó.
import time, random
class TokenBucket:
def __init__(self, capacity, refill_per_sec):
self.capacity = capacity
self.tokens = capacity
self.refill = refill_per_sec
self.updated = time.monotonic()
def try_take(self, n=1):
now = time.monotonic()
self.tokens = min(
self.capacity,
self.tokens + (now - self.updated) * self.refill
)
self.updated = now
if self.tokens >= n:
self.tokens -= n
return True
return False
# Vi du tham so: tran toan cuc thap hon tai lieu mot chut de co bien do
GLOBAL = TokenBucket(capacity=25, refill_per_sec=25)
PER_CHAT = {} # chat_id -> TokenBucket(capacity=1, refill_per_sec=0.8)
def can_send(chat_id):
bucket = PER_CHAT.setdefault(chat_id, TokenBucket(1, 0.8))
return bucket.try_take() and GLOBAL.try_take()
def backoff_seconds(attempt, retry_after=None):
if retry_after:
return retry_after + random.uniform(0, 1.5)
return min(60, (2 ** attempt) + random.uniform(0, 1))
Vì sao đặt trần toàn cục thấp hơn ngưỡng công bố: biên dự phòng hấp thụ ba nguồn sai lệch thường gặp — nhiều tiến trình dùng chung token nhưng tính toán độc lập, độ trễ mạng làm các request dồn lại thành cụm, và các lần retry chen vào cùng cửa sổ thời gian. Tham số trong ví dụ trên chỉ là minh họa cấu trúc, không phải khuyến nghị giá trị; hãy chọn theo bài đo của bạn.
Khi nào không nên dùng token bucket: nếu hệ thống của bạn chỉ gửi tin theo phản ứng trực tiếp từ người dùng (mỗi tin đến thì trả lời một tin), nhịp gửi tự nhiên đã thấp hơn ngưỡng và việc thêm bucket chỉ làm tăng độ phức tạp. Bucket trở nên cần thiết khi có bất kỳ nguồn gửi chủ động nào: nhắc hẹn, broadcast, đồng bộ dữ liệu, cảnh báo tự động.
Backoff có kỷ luật: jitter, trần chờ và hàng đợi chờ chết
Exponential backoff — chờ 1 giây, 2 giây, 4 giây, 8 giây — là kỹ thuật quen thuộc, nhưng nếu mọi worker đều chờ theo cùng một dãy thì chúng sẽ thức dậy cùng lúc và tạo ra một cú dội mới. Jitter (nhiễu ngẫu nhiên) phá vỡ sự đồng bộ đó. Một biến thể đơn giản và hiệu quả là chọn ngẫu nhiên trong khoảng từ 0 tới giá trị backoff hiện tại, thay vì luôn dùng đúng giá trị đó.
Cần một trần chờ tuyệt đối. Nếu retry_after trả về một giá trị rất lớn, việc giữ worker chờ hàng giờ là lãng phí; hãy đẩy thông điệp trở lại hàng đợi bền vững với thời điểm thực thi trong tương lai và giải phóng worker. Cũng cần một giới hạn số lần thử. Với lỗi 429, số lần thử có thể rộng rãi vì bản chất là tạm thời; với lỗi 400, số lần thử nên bằng không.
Hàng đợi chờ chết không phải thủ tục cho có. Nó là nơi bạn nhìn thấy vấn đề thay vì để chúng tan biến. Một thông điệp vào hàng chờ chết kèm theo chat đích, mã lỗi, số lần thử và thời điểm có thể được xử lý lại thủ công sau khi sửa nguyên nhân gốc — ví dụ khi bot bị gỡ khỏi nhóm, mọi thông điệp tới nhóm đó sẽ thất bại với lỗi 403 cho tới khi bot được thêm lại.
Cảnh báo: đừng tự động thử lại các thông điệp vào hàng chờ chết theo lịch định kỳ mà không kiểm tra nguyên nhân. Nếu bot đã bị người dùng chặn, mỗi lần thử lại là một request chắc chắn thất bại, tiêu tốn thông lượng mà lẽ ra dành cho người dùng đang hoạt động.
Ví dụ 1: bản tin cho 100.000 người đăng ký, 200 bài mỗi ngày
Hãy lấy một tình huống cụ thể để thấy giới hạn thay đổi quyết định kiến trúc như thế nào. Một cơ quan truyền thông vận hành bot với 100.000 người đăng ký nhận bản tin, xuất bản 200 bài mỗi ngày và muốn đẩy ngay lập tức cho toàn bộ danh sách. Phép tính từ ngưỡng tham chiếu 30 tin/giây cho kết quả: mỗi bài cần khoảng 3.333 giây để tới toàn bộ danh sách, tức gần 56 phút; 200 bài cần khoảng 185 giờ — nhiều hơn thời gian có trong một ngày. Nói cách khác, mô hình “gửi riêng từng tin cho từng người” không khả thi về mặt vật lý, bất kể mã nguồn được viết tốt đến đâu.
Cách xử lý đúng là đảo ngược mô hình phân phối: xuất bản bài lên một kênh, và để người dùng chủ động theo dõi kênh đó. Bot chỉ còn nhiệm vụ gửi một thông báo ngắn có liên kết tới bài mới, và ngay cả thông báo đó cũng nên được gộp theo lô, ví dụ một bản tổng hợp mỗi ngày thay vì 200 thông báo rời. Phép tính thay đổi hoàn toàn: 100.000 tin cho một bản tổng hợp vẫn cần khoảng 56 phút, nhưng chỉ một lần mỗi ngày, và có thể chia theo múi giờ hoặc theo nhóm người đăng ký để san tải.
Trường hợp này cũng chỉ ra một ranh giới quan trọng: nếu nhu cầu thực sự là “mọi người nhận mọi bài ngay lập tức”, thì Telegram không phải kênh phù hợp cho mục tiêu đó ở quy mô này. Việc cố đạt được bằng nhiều token bot hoặc nhiều tài khoản là hướng đi rủi ro, có thể bị coi là lạm dụng và vi phạm điều khoản, đồng thời khiến việc đối soát trở nên bất khả thi. Hãy chọn kênh phát sóng, RSS, email hoặc ứng dụng riêng cho nhu cầu đó.
Ví dụ 2: bot hỗ trợ trong nhóm 5.000 thành viên
Ở chiều ngược lại, một nhóm nhỏ lại bị giới hạn theo cách khác. Với ngưỡng tham chiếu khoảng 20 tin/phút cho cùng một nhóm, bot chỉ có thể phát ra trung bình một tin mỗi ba giây. Con số này nghe có vẻ thoải mái cho một nhóm trò chuyện, nhưng trở nên chật vật khi bot vừa phải trả lời câu hỏi của thành viên, vừa phải đăng bảng xếp hạng định kỳ, vừa phải gửi cảnh báo kiểm duyệt. Ba luồng nghiệp vụ độc lập cùng tranh nhau 20 suất mỗi phút sẽ nhanh chóng tạo ra tình trạng câu trả lời tới muộn vài phút.
Giải pháp thực dụng là ưu tiên theo giá trị tương tác. Tin trả lời trực tiếp cho một câu hỏi nên được cấp quyền ưu tiên cao nhất, chiếm phần lớn ngân sách; các tin định kỳ nên được gộp thành một bản tin duy nhất thay vì nhiều tin rời; cảnh báo kiểm duyệt có thể được chuyển sang chat riêng với quản trị viên thay vì đăng công khai trong nhóm — một thay đổi nhỏ về đích đến nhưng giải phóng đáng kể ngân sách cho nhóm chính. Đây là ví dụ điển hình của việc tối ưu bằng cách đổi nơi gửi trước khi nghĩ tới việc tăng tốc.
Khi nào không cần lo: nhóm dưới vài trăm người với bot chỉ trả lời khi được gọi tên gần như không bao giờ chạm ngưỡng 20 tin/phút. Việc dựng hàng đợi ưu tiên cho tình huống này là tối ưu hóa sớm và thường phản tác dụng vì làm tăng độ trễ phản hồi — điều người dùng cảm nhận rõ hơn nhiều so với một giới hạn họ không nhìn thấy.
Tối ưu trước khi xin thêm hạn mức: gộp tin, album, chỉnh sửa
Có một nguyên tắc đáng nhớ: mọi tối ưu về giới hạn tốc độ đều bắt đầu bằng việc giảm số request, không phải bằng việc gửi nhanh hơn. Bốn kỹ thuật dưới đây thường giảm được một phần đáng kể lưu lượng mà không mất thông tin.
- Gộp tin theo cửa sổ thời gian. Gom các sự kiện trong khoảng 2–5 giây thành một tin nhắn có nhiều dòng. Với bot thông báo trạng thái, cách này biến mười tin rời thành một tin, giảm mười lần số request.
- Dùng album cho nội dung nhiều ảnh. Một media group chứa tới mười ảnh chỉ tốn một request thay vì mười, và quan trọng hơn là không tạo ra mười lần chiếm nhịp của cùng một chat.
- Dùng chỉnh sửa cho nội dung thay đổi liên tục. Đồng hồ đếm ngược, thanh tiến trình, bảng trạng thái nên được cập nhật bằng cách chỉnh sửa một tin duy nhất thay vì gửi tin mới. Cần giãn cách hợp lý và có phương án dừng khi nội dung không còn thay đổi.
- Đưa nội dung dài ra ngoài. Nếu nội dung vượt 4.096 ký tự, thay vì tách thành nhiều tin, hãy đặt nội dung trên một trang và gửi liên kết kèm phần tóm tắt ngắn.
Điều đáng chú ý là các kỹ thuật này cũng cải thiện trải nghiệm đọc. Một tin nhắn gộp dễ theo dõi hơn mười tin rời rạc, và một album ảnh dễ xem hơn mười tin ảnh riêng lẻ. Đây là trường hợp hiếm hoi mà ràng buộc kỹ thuật và chất lượng sản phẩm cùng hướng.
Khi nào không nên gộp: nếu mỗi sự kiện đòi hỏi hành động riêng của người nhận — ví dụ mỗi tin là một yêu cầu phê duyệt cần bấm nút — thì gộp lại sẽ làm mất khả năng tương tác. Trong trường hợp đó, hãy giữ tin rời và chấp nhận chi phí request.
Webhook hay getUpdates: ảnh hưởng gián tiếp tới nhịp gửi
Lựa chọn cơ chế nhận cập nhật không trực tiếp thay đổi giới hạn gửi, nhưng ảnh hưởng mạnh tới việc bạn có chạm giới hạn hay không. Webhook đẩy cập nhật tới endpoint của bạn ngay khi có sự kiện, cho phép xử lý theo thời gian thực. getUpdates yêu cầu bot chủ động hỏi, và mỗi lần hỏi là một request; nếu vòng hỏi chạy quá nhanh, nó vừa tiêu tốn thông lượng vừa có thể bị chặn. Trong hệ thống có cả hai nguồn — nhận cập nhật và gửi tin — phần nhận cập nhật cũng nằm trong cùng ngân sách request của token.
Khuyến nghị thực tế: dùng webhook cho production, dùng getUpdates cho phát triển cục bộ, và đảm bảo hai môi trường dùng hai token khác nhau. Dùng chung token giữa hai môi trường là nguyên nhân kinh điển của hiện tượng “bot tự nhiên mất tin nhắn” — vì mỗi lần chuyển đổi giữa webhook và polling sẽ xóa hoặc bỏ qua các cập nhật đang chờ.
Với webhook, cần xử lý trường hợp endpoint chết. Telegram sẽ thử lại và giữ cập nhật trong một khoảng thời gian, nhưng nếu endpoint hỏng kéo dài, cập nhật sẽ bị bỏ. Kiểm tra getWebhookInfo định kỳ và đặt cảnh báo khi last_error_date thay đổi là cách phát hiện sớm. Khi nào không nên dùng webhook: môi trường phát triển không có địa chỉ công khai, hoặc hệ thống có yêu cầu tuân thủ cấm mở cổng vào từ internet — khi đó polling có kiểm soát nhịp là lựa chọn hợp lý.
Khi nào được phép gửi nhanh hơn: tùy chọn trả phí bằng Stars
Trong các phiên bản Bot API gần đây, Telegram bổ sung một cơ chế cho phép bot phát sóng với thông lượng cao hơn giới hạn thông thường, với điều kiện trả một khoản phí tính bằng Stars (đơn vị tiền tệ trong ứng dụng Telegram) cho mỗi tin nhắn. Cơ chế này xuất hiện dưới dạng một trường tùy chọn trong các lời gọi gửi tin. Vì đây là tính năng có thể thay đổi về điều kiện và giá, hãy xác minh lại trong tài liệu Bot API hiện hành trước khi đưa vào kế hoạch ngân sách, và ghi rõ ngày kiểm tra.
Về mặt quyết định, đây là bài toán chi phí chứ không phải bài toán kỹ thuật. Với một chiến dịch gửi cho lượng người nhận lớn trong khung thời gian hẹp — ví dụ thông báo kết quả một sự kiện diễn ra trong vài phút — việc trả phí để rút ngắn thời gian phát sóng từ hàng giờ xuống vài phút có thể hợp lý. Với thông báo định kỳ hằng ngày, việc chờ đúng nhịp miễn phí gần như luôn rẻ hơn.
Khi nào không nên dùng: khi nội dung không thực sự khẩn cấp, khi tỷ lệ người dùng chặn bot đang cao (trả tiền để gửi tới người không muốn nhận là lãng phí thuần túy), và khi chưa có cơ chế đo lường chính xác số tin thực sự được gửi thành công. Trong mọi trường hợp, hãy tính chi phí dựa trên số tin nhắn chứ không dựa trên số người đăng ký, vì hai con số này thường chênh nhau đáng kể.
Cộng tác nhóm: nhiều bot, phân quyền và một bảng điều khiển chung
Khi hệ thống lớn dần, một token thường được chia cho nhiều nhóm phát triển: nhóm nghiệp vụ viết nội dung, nhóm hạ tầng vận hành, nhóm chăm sóc khách hàng xử lý phản hồi. Nếu mỗi nhóm tự viết vòng lặp gửi riêng, ngân sách thông lượng bị tiêu tán và không ai biết tổng còn bao nhiêu. Cách tổ chức bền vững là biến việc gửi tin thành một dịch vụ nội bộ duy nhất: các nhóm đăng ký thông điệp qua một API nội bộ, dịch vụ đó giữ token, giữ hàng đợi, giữ ngân sách thông lượng và trả về mã theo dõi.
Về phân quyền, nguyên tắc đặc quyền tối thiểu áp dụng rất tự nhiên: chỉ dịch vụ gửi tin được giữ token; các dịch vụ khác không cần biết token. Điều này giảm rủi ro lộ token và đơn giản hóa việc xoay vòng token khi cần. Về quan sát, một bảng điều khiển chung nên hiển thị bốn chỉ số: số request mỗi giây theo làn, tỷ lệ lỗi 429 trên tổng request, độ dài hàng đợi theo làn, và tuổi của thông điệp cũ nhất còn chờ. Bốn chỉ số này đủ để trả lời câu hỏi vận hành thường gặp nhất: “hệ thống đang chậm vì tải hay vì bị chặn?”.
Một tình huống cộng tác hay gặp: hai nhóm cùng gửi vào một nhóm Telegram lớn, một nhóm gửi thông báo hệ thống, một nhóm gửi nội dung biên tập. Nếu không có cơ chế chia sẻ nhịp theo chat, hai nhóm sẽ liên tục đẩy nhau vượt ngưỡng và mỗi bên sẽ đổ lỗi cho bên kia khi thấy lỗi 429. Giải pháp là đưa khóa chat vào cùng một bộ đếm dùng chung, và ghi log kèm nhãn nguồn gửi để khi có sự cố, việc truy vết diễn ra trong vài phút thay vì vài giờ.
Khi nào không nên tập trung hóa: nếu tổ chức có yêu cầu cách ly nghiêm ngặt giữa các đơn vị, việc gộp mọi thứ vào một dịch vụ có thể vi phạm chính sách nội bộ. Khi đó, dùng nhiều bot riêng biệt với token riêng là hợp lý — không phải để lách giới hạn, mà để cách ly rủi ro và trách nhiệm.
Triển khai doanh nghiệp: SLO, ngân sách thông lượng và quan sát
Ở quy mô doanh nghiệp, câu hỏi không còn là “làm sao gửi được” mà là “cam kết được gì và đo bằng gì”. Một chỉ tiêu mức dịch vụ (SLO) thực dụng cho kênh thông báo qua Telegram thường gồm ba phần: tỷ lệ thông điệp giao thành công trên tổng thông điệp hợp lệ, độ trễ từ lúc phát sinh sự kiện tới lúc gửi thành công (phân theo làn ưu tiên), và tỷ lệ lỗi 429 trên tổng request. Phần thứ ba đặc biệt hữu ích vì nó là chỉ số dự báo: khi tỷ lệ này tăng, các chỉ số còn lại sẽ xấu đi sau đó vài phút.
Ngân sách thông lượng nên được ghi thành văn bản và gắn với từng làn. Ví dụ, với trần tham chiếu khoảng 30 tin/giây, một phân bổ có thể là: 5 tin/giây cho giao dịch và bảo mật, 10 tin/giây cho thông báo dịch vụ, 12 tin/giây cho broadcast, và 3 tin/giây để trống làm biên. Đây là ví dụ về cách tư duy phân bổ, không phải khuyến nghị áp dụng nguyên giá trị; mỗi hệ thống cần đo lại. Điều quan trọng là phần dự trữ phải thực sự được giữ trống — nếu mọi làn đều được phép mượn phần dự trữ khi rảnh, thì trong giờ cao điểm sẽ không còn gì để mượn.
Về nhật ký, nên ghi lại cho mỗi thông điệp: mã theo dõi, chat đích, làn ưu tiên, thời điểm đưa vào hàng đợi, thời điểm gửi thành công, số lần thử, và mã lỗi cuối cùng nếu thất bại. Lưu ý về dữ liệu: nội dung tin nhắn có thể chứa thông tin cá nhân, nên nhật ký chỉ nên lưu mã định danh và siêu dữ liệu, không lưu toàn văn nội dung, trừ khi có cơ sở pháp lý rõ ràng và thời hạn lưu trữ được xác định trước.
Khi nào không nên áp dụng mô hình này: với một bot nội bộ phục vụ dưới một nghìn người, các khái niệm SLO, làn ưu tiên và ngân sách thông lượng là quá mức. Dấu hiệu để nâng cấp là khi bắt đầu có sự cố mà nguyên nhân không xác định được trong vòng mười lăm phút, hoặc khi có ít nhất hai nhóm cùng phụ thuộc vào bot.
Tuân thủ: giới hạn kỹ thuật không thay thế giới hạn về quyền gửi
Một hệ thống gửi đúng nhịp vẫn có thể vi phạm điều khoản dịch vụ nếu gửi sai người. Nguyên tắc nền tảng là người nhận phải chủ động đồng ý nhận thông điệp, và phải có cách dừng dễ dàng. Với bot, biểu hiện thực tế của nguyên tắc này là: chỉ gửi cho người đã bấm bắt đầu cuộc trò chuyện với bot hoặc đã đăng ký qua một hành động rõ ràng; không mua danh sách người dùng; không gửi lại sau khi người dùng chặn bot; và luôn cung cấp một lệnh hoặc nút để hủy đăng ký.
Điều đáng lưu ý là các chỉ số kỹ thuật phản ánh khá trung thực mức độ tuân thủ. Tỷ lệ người dùng chặn bot tăng, tỷ lệ báo cáo spam tăng, và tỷ lệ gửi thành công giảm thường đi cùng nhau và thường xuất phát từ việc gửi quá dày hoặc gửi ngoài kỳ vọng. Theo dõi ba chỉ số này như một phần của bảng điều khiển vận hành là cách phát hiện vấn đề tuân thủ trước khi nó trở thành vấn đề pháp lý.
Về khía cạnh dữ liệu, nếu tổ chức của bạn chịu sự điều chỉnh của các quy định bảo vệ dữ liệu cá nhân, cần xác định rõ vai trò của mình, thời hạn lưu trữ mã định danh chat, và quy trình xóa khi có yêu cầu. Việc xóa một bản ghi trong cơ sở dữ liệu của bạn không xóa lịch sử trò chuyện trong ứng dụng Telegram của người dùng — đây là điểm cần giải thích rõ trong tài liệu nội bộ để tránh kỳ vọng sai. Khi nào cần tư vấn pháp lý: khi thông điệp chứa dữ liệu sức khỏe, tài chính hoặc dữ liệu của trẻ vị thành niên.
Khắc phục sự cố theo triệu chứng
Bảng dưới đây tổ chức việc chẩn đoán theo triệu chứng quan sát được, đi kèm nguyên nhân khả dĩ và cách xác minh. Cột xác minh cố tình nêu hành động cụ thể để bạn có thể tự kiểm chứng thay vì dựa vào phỏng đoán.
| Triệu chứng | Nguyên nhân khả dĩ | Cách xác minh | Hướng xử lý |
|---|---|---|---|
| Hàng loạt lỗi 429 trong vài giây | Nhiều worker cùng gửi vào một chat, hoặc retry đồng loạt | Đối chiếu log theo chat và theo worker trong cùng cửa sổ thời gian | Thêm khóa chat dùng chung, thêm jitter vào backoff |
| Tin nhắn tới muộn vài phút nhưng không có lỗi | Hàng đợi quá dài do ngân sách thông lượng bị chiếm bởi làn khác | Đo tuổi thông điệp cũ nhất theo từng làn | Tách làn ưu tiên, giữ phần dự trữ thực sự |
| Lỗi 403 khi gửi vào nhóm | Bot bị gỡ khỏi nhóm hoặc bị thu hồi quyền gửi | Kiểm tra danh sách quản trị viên và quyền của bot trong nhóm | Thêm lại bot, dừng retry tới khi quyền được khôi phục |
| Lỗi 400 với nội dung dài | Vượt 4.096 ký tự, hoặc chú thích media vượt 1.024 ký tự | Đếm độ dài trước khi gửi, ghi log phần bị cắt | Tách nội dung hoặc đưa ra trang ngoài |
| Tin nhắn gửi trùng | Timeout rồi retry dù request trước đã thành công | Đối soát mã theo dõi với log phía Telegram qua lịch sử chat | Thêm idempotency key, kiểm tra trạng thái trước khi retry |
Một điểm cần nhấn mạnh về quy trình: khi xảy ra sự cố, hãy đọc retry_after trước khi làm bất cứ điều gì khác. Giá trị này cho biết Telegram đang thấy gì về hành vi của bot, và thường là dữ liệu chẩn đoán chính xác nhất mà bạn có. Nếu retry_after tăng dần qua các lần thử, đó là dấu hiệu bot đang tiếp tục vượt ngưỡng trong lúc chờ; nếu nó giữ nguyên hoặc giảm, hành vi đang dần đi vào giới hạn cho phép.
Danh sách kiểm tra: khi nào nên và không nên dùng bot để gửi
Phần này tổng hợp các tiêu chí quyết định dưới dạng câu hỏi, để dùng trước khi cam kết một kiến trúc. Bốn tiêu chí đầu là điều kiện chấp nhận; bốn tiêu chí sau là dấu hiệu nên chọn kênh khác.
Nên dùng bot khi
- Người nhận đã chủ động bắt đầu trò chuyện với bot
- Thông điệp có tính cá nhân hóa hoặc cần phản hồi hai chiều
- Tổng lưu lượng nằm trong ngân sách thông lượng với biên dự phòng
- Có cơ chế đo tỷ lệ giao thành công và tỷ lệ chặn bot
Không nên dùng bot khi
- Mục tiêu là phát sóng tới lượng người theo dõi rất lớn trong thời gian ngắn
- Nội dung là thông báo một chiều, không cần tương tác
- Danh sách người nhận không có sự đồng ý rõ ràng
- Yêu cầu về độ trễ thấp hơn khả năng của hạ tầng chia sẻ
Với trường hợp phát sóng một chiều, kênh là lựa chọn tự nhiên hơn bot: người theo dõi chủ động nhận, không có chi phí request theo từng người nhận, và nội dung được lưu trữ có tổ chức. Bot vẫn hữu ích trong mô hình kết hợp — gửi một thông báo ngắn trỏ tới bài mới trên kênh, hoặc xử lý tương tác riêng tư với những người cần hỗ trợ cá nhân.
Danh sách kiểm tra thực hành tốt nhất trước khi phát hành
Trước khi đưa một hệ thống gửi tin vào production, có thể rà soát theo danh sách dưới đây. Mỗi mục đều có lý do vận hành cụ thể, và bỏ qua mục nào thường dẫn tới một dạng sự cố tương ứng.
- Một hàm gửi duy nhất. Mọi lời gọi API đi qua một lớp bao duy nhất có xử lý 429, backoff và ghi log. Nếu có ba nơi tự gọi API, bạn sẽ có ba hành vi khác nhau khi bị chặn.
- Hàng đợi có khóa theo chat. Đảm bảo mọi tiến trình nhìn thấy cùng một nhịp cho cùng một chat, kể cả khi chạy nhiều bản sao dịch vụ.
- Ngân sách thông lượng có phần dự trữ thực. Phần dự trữ phải không thể bị mượn tự động, nếu không nó sẽ biến mất đúng vào lúc cần nhất.
- Idempotency key cho mọi thông điệp. Bảo vệ khỏi gửi trùng khi timeout, và cho phép retry an toàn.
- Giới hạn số lần thử theo loại lỗi. 429 được thử lại rộng rãi; 400 và 403 thì không.
- Ghi log mã lỗi, không ghi toàn văn nội dung. Đủ để chẩn đoán, đủ ít để không tạo rủi ro dữ liệu.
- Kiểm tra
getWebhookInfođịnh kỳ nếu dùng webhook. Đây là cách duy nhất phát hiện endpoint chết trước khi người dùng phàn nàn. - Đo trước khi tối ưu. Ghi lại nhịp gửi thực tế và tỷ lệ 429 trong một tuần bình thường, để có đường cơ sở khi đánh giá thay đổi.
Một gợi ý về thứ tự ưu tiên khi phải chọn: nếu chỉ làm được một việc, hãy làm mục thứ nhất. Một lớp bao duy nhất có xử lý 429 đúng cách giải quyết phần lớn sự cố thực tế, trong khi các tối ưu khác chỉ có ý nghĩa khi nền tảng xử lý lỗi đã vững.
Câu hỏi thường gặp
Bot của tôi gửi bao nhiêu tin mỗi giây thì an toàn?
Không có con số an toàn tuyệt đối cho mọi hệ thống. Tài liệu Bot API nêu ngưỡng tham chiếu khoảng 30 tin/giây tới các người dùng khác nhau, khoảng 20 tin/phút vào cùng một nhóm và khuyến nghị không quá khoảng 1 tin/giây vào cùng một chat. Hãy chọn cấu hình thấp hơn ngưỡng công bố để có biên dự phòng, rồi đo lại bằng lưu lượng thật trên môi trường staging trước khi áp dụng cho production.
Lỗi 429 có nghĩa là bot bị đánh dấu spam vĩnh viễn không?
Không. 429 là phản hồi tạm thời cho biết bot đã vượt giới hạn tốc độ trong một cửa sổ thời gian. Trường retry_after trong phản hồi cho biết nên chờ bao lâu. Việc bị hạn chế lâu dài hoặc bị vô hiệu hóa là chuyện khác, thường liên quan tới hành vi bị người dùng báo cáo, và không thể suy ra chỉ từ một lỗi 429.
Có thể dùng nhiều token bot để gửi nhanh hơn không?
Về mặt kỹ thuật, mỗi token có ngân sách riêng. Tuy nhiên việc tách một dịch vụ thành nhiều bot chỉ để vượt giới hạn là hướng đi rủi ro: nó có thể bị coi là lạm dụng, làm phức tạp việc đối soát và khiến trải nghiệm người dùng bị phân mảnh vì phải tương tác với nhiều tài khoản khác nhau. Trước khi cân nhắc, hãy kiểm tra điều khoản dịch vụ hiện hành và ưu tiên các cách giảm số request.
Vì sao tin nhắn tới muộn dù không thấy lỗi nào?
Trong phần lớn trường hợp, độ trễ đến từ hàng đợi phía bạn chứ không phải từ Telegram. Một làn ưu tiên thấp có thể bị xếp sau hàng trăm nghìn thông điệp khác nếu ngân sách thông lượng bị chiếm hết. Hãy đo tuổi của thông điệp cũ nhất theo từng làn; nếu chỉ số này tăng đều, nguyên nhân là phân bổ thông lượng chứ không phải mạng.
Chỉnh sửa tin nhắn có bị tính vào giới hạn không?
Tài liệu Bot API không công bố ngưỡng riêng cho việc chỉnh sửa, nhưng quan sát thực nghiệm cho thấy chỉnh sửa quá dày trong thời gian ngắn cũng có thể bị chặn và trả về lỗi 429. Cách an toàn là giãn cách hợp lý, đặt một khoảng tối thiểu giữa hai lần chỉnh sửa cùng một tin, và dừng cập nhật khi nội dung không còn thay đổi. Muốn có con số cụ thể cho hệ thống của mình, hãy dựng bài đo trên bot thử và ghi lại khoảng cách cuối cùng còn thành công.
Kết luận: thiết kế cho giới hạn, không chống lại giới hạn
Điểm mấu chốt về cách Telegram giới hạn tốc độ gửi tin nhắn của bot là giới hạn này vận hành theo cửa sổ thời gian và theo từng chat, chứ không theo tổng khối lượng. Vì vậy, mọi kiến trúc bền vững đều xoay quanh hai ý tưởng: biết chính xác ngân sách thông lượng của mình, và không bao giờ để hai tiến trình tranh nhau cùng một suất gửi. Ngưỡng tham chiếu khoảng 30 tin/giây cho toàn bot và khoảng 20 tin/phút cho mỗi nhóm là điểm khởi đầu, không phải đích đến; giá trị thực tế của hệ thống bạn phải do chính bạn đo và ghi lại kèm ngày đo.
Bước tiếp theo nên làm rất cụ thể và không đòi hỏi đầu tư lớn. Trước tiên, gom mọi lời gọi Bot API về một lớp bao duy nhất có xử lý retry_after và jitter. Tiếp theo, thêm khóa theo chat vào hàng đợi và ghi log nhãn nguồn gửi để truy vết. Sau đó, đo trong một tuần bình thường ba chỉ số: nhịp gửi mỗi giây, tỷ lệ 429, và tuổi thông điệp cũ nhất theo làn. Khi đã có đường cơ sở, việc quyết định có cần làn ưu tiên, có cần gộp tin, hay có cần cân nhắc phương án trả phí để phát sóng nhanh sẽ trở thành một quyết định dựa trên số liệu thay vì phỏng đoán.
Cuối cùng, hãy giữ thói quen kiểm tra lại tài liệu Bot API mỗi khi nâng cấp hệ thống hoặc khi bắt đầu một chiến dịch lớn. Giới hạn tốc độ là một phần của hợp đồng dịch vụ có thể được điều chỉnh, và một cấu hình đúng vào năm ngoái không đảm bảo đúng vào năm nay. Về kỳ vọng phiên bản, hãy xem mọi ngưỡng và cơ chế mới như thông tin cần xác minh lại tại thời điểm triển khai; ghi ngày tra cứu, phiên bản tài liệu và kết quả đo vào cùng một chỗ — đó là tài sản vận hành có giá trị hơn bất kỳ con số nào được truyền miệng.