Mọi thứ bạn cần biết

Tải xuống & cài đặt

Ứng dụng là di động trên Windows và kéo-thả trên macOS. Không phụ thuộc, không cần quyền quản trị.

Windows

macOS

Nơi dữ liệu được lưu trữ

Thiết lập Telegram API

Mỗi ứng dụng khách Telegram đều cần api_id và api_hash — thông tin đăng nhập chính thức miễn phí từ Telegram. Nhận chúng mất khoảng 3 phút.

Kích hoạt & gói

Ba gói, một cửa sổ kích hoạt. Chuyển đổi bất cứ lúc nào bằng cách nhập khóa mới.

Các gói trong nháy mắt

Kích hoạt khóa

Thời gian gia hạn ngoại tuyến

Ứng dụng kiểm tra giấy phép mỗi 6 giờ. Nếu có sự cố mạng, nó tiếp tục hoạt động từ trạng thái được lưu trong bộ nhớ đệm trong tối đa 30 ngày (cho đến ngày kết thúc đã được xác minh lần cuối). Bạn sẽ thấy huy hiệu Ngoại tuyến màu xám trên thẻ giấy phép, nhưng không có chức năng nào bị mất.

Nơi xem trạng thái

• Thẻ thanh bên — tên gói, số ngày còn lại, ngày kết thúc
• Cài đặt → Giấy phép — thông tin tương tự trong trang cài đặt
• Biểu ngữ trên cùng — hiển thị nếu giấy phép bị thiếu hoặc hết hạn

Tài khoản

Trang Tài khoản là trung tâm của bạn. Mọi thứ khác — người nhận, quảng cáo, chiến dịch — đều thuộc về tài khoản hiện được chọn.

Lưới tài khoản

Mỗi tài khoản là một thẻ hiển thị:

• Tên và huy hiệu chữ cái đầu
• Trạng thái — Đã ủy quyền (xanh lá) hoặc Chưa ủy quyền (xám)
• Thông tin người dùng — tên hiển thị và @username trên Telegram
• Số điện thoại, Proxy và trạng thái phiên hiện tại

Tài khoản bạn đang làm việc được đánh dấu bằng viền màu tím và huy hiệu HIỆN TẠI ở góc trên bên phải.

Thanh công cụ

Hành động trên thẻ

Thêm tài khoản mới

Ủy quyền QR / SMS

Hai phương thức. QR nhanh hơn và không cần trường số điện thoại — SMS là dự phòng.

Chọn phương thức

Nhấp vào Ủy quyền trên bất kỳ tài khoản nào. Một hộp thoại mở ra với hai tùy chọn:

• Mã QR — được khuyến nghị. Chỉ cần API ID + API Hash.
• Mã SMS — yêu cầu số điện thoại trong cài đặt tài khoản.

Nếu số điện thoại trống, tùy chọn SMS bị vô hiệu hóa với gợi ý.

Đăng nhập QR

Đăng nhập SMS

Kiểm tra tình trạng phiên v4.0

Ứng dụng giữ cho các phiên Telegram của bạn tồn tại mà bạn không cần phải trông coi chúng.

Cách hoạt động

Khi khởi động ứng dụng và theo khoảng thời gian đã cấu hình, ứng dụng sẽ duyệt qua từng tài khoản và xác minh phiên còn sống. Đây là một thao tác nhanh — một yêu cầu cho mỗi tài khoản. Không cần QR hay SMS, các phiên được tải từ data/sessions/.

Các lần kiểm tra chạy trong một nhóm luồng nền (tối đa 3 tài khoản song song), vì vậy giao diện vẫn phản hồi.

Chỉ báo trạng thái

Trong trang Tài khoản, mỗi thẻ nhận được một chấm màu bên cạnh tên:

• 🟢 Đã ủy quyền — phiên còn sống, sẵn sàng hoạt động
• 🔴 Chưa ủy quyền — phiên đã chết, cần ủy quyền lại qua QR
• 🟠 Không thể kết nối — vấn đề mạng (không có internet, proxy hỏng). Phiên có thể còn sống — chúng tôi chỉ không thể xác minh
• ⚪ Chưa cấu hình — tài khoản không có thông tin API
• 🟣 Đang kiểm tra — đang kiểm tra

Bật và định cấu hình

Đi tới Cài đặt → Kiểm tra tình trạng phiên:

Kiểm tra thủ công

Nhấp vào Kiểm tra phiên trên thanh công cụ ở trang Tài khoản. Tiến trình được hiển thị qua các chỉ báo chấm; nút hiển thị đang kiểm tra… X/Y.

Hàng đợi ủy quyền lại

Khi phát hiện phiên bị chết, ứng dụng đề nghị ủy quyền lại chúng từng cái một:

1. Một lời nhắc xuất hiện: "Đã tìm thấy N phiên bị chết. Ủy quyền lại tất cả ngay bây giờ?"
2. Nhấp vào Có — một cửa sổ đăng nhập QR mở ra cho tài khoản bị chết đầu tiên
3. Quét QR bằng điện thoại của bạn. Khi tài khoản đó được ủy quyền, QR tiếp theo sẽ tự động mở
4. Quá trình tiếp tục cho đến khi hàng đợi trống
5. Một thông báo tóm tắt hiển thị: Hoàn tất ủy quyền lại: N thành công, M thất bại

Giám sát tình trạng tài khoản v4.0

Chỉ báo rủi ro cho mỗi tài khoản, dựa trên hoạt động gửi thực tế trong 24 giờ qua.

Mở nó

Trên bất kỳ thẻ tài khoản nào, nhấp vào biểu tượng khiên. Một hộp thoại mở ra với dữ liệu tình trạng cho tài khoản đó.

Những gì bạn sẽ thấy

Mức độ rủi ro

Khuyến nghị

Nhấp vào Khuyến nghị trong hộp thoại để xem danh sách kiểm tra dựa trên dữ liệu hiện tại. Ví dụ:

• Nếu PEER_FLOOD > 0 — tạm dừng tài khoản này trong 24–48 giờ
• Nếu floods thường xuyên — tăng độ trễ giữa các tin nhắn
• Nếu đã gửi > 100/24h — giảm khối lượng hàng ngày
• Các tài khoản xanh lá nhận được thông báo "Bạn ổn, tiếp tục làm những gì bạn đang làm"

Người nhận

Các nhóm, kênh và danh bạ có sẵn cho tài khoản hiện tại, được bố trí trong ba cột.

Thanh công cụ

Ba cột

• Nhóm — các cuộc trò chuyện và siêu nhóm nơi bạn có quyền đăng bài
• Kênh — các kênh phát sóng mà bạn quản trị
• Danh bạ — những người dùng bạn có thể nhắn tin trực tiếp

Làm việc với các mục

• Hộp kiểm — chọn từng người nhận
• Hộp kiểm ở tiêu đề — chọn / bỏ chọn tất cả trong cột này
• Nút xóa khi di chuột — xóa một người nhận khỏi danh sách cục bộ (không ảnh hưởng đến Telegram)
• Thêm + — thêm thủ công một người nhận (nhập tên chính xác)
• Xóa mục đã chọn — xóa tất cả người nhận đã chọn

Thanh hành động lựa chọn

Khi có ít nhất một mục được chọn, một thanh hành động màu tím xuất hiện phía trên các cột với:

• Thêm vào nhóm — di chuyển lựa chọn vào một nhóm được đặt tên
• Xóa khỏi nhóm — chỉ hiển thị khi bộ lọc nhóm đang hoạt động
• Xóa — xóa hoàn toàn người nhận đã chọn
• Bỏ chọn — bỏ chọn mọi thứ

Nhóm người nhận v4.0

Bộ sưu tập người nhận được đặt tên — như "Chính", "VIP", "Thử nghiệm" — để chọn bằng một cú nhấp trong quảng cáo.

Tạo một nhóm

Quản lý nhóm

Trong hộp thoại Quản lý nhóm, bạn có thể:

• Đổi tên một nhóm — biểu tượng bút chì
• Xóa một nhóm — biểu tượng thùng rác. Bản thân người nhận vẫn ở trong danh sách của bạn; chỉ có tư cách thành viên nhóm bị xóa.
• Xem số lượng thành viên bên cạnh mỗi nhóm

Lọc chế độ xem Người nhận

Sử dụng menu thả xuống bộ lọc nhóm trên thanh công cụ để chỉ xem các thành viên của một nhóm cụ thể. Tùy chọn:

• Tất cả người nhận — hiển thị mọi thứ
• Không có nhóm — chỉ người nhận không thuộc bất kỳ nhóm nào
• Bất kỳ tên nhóm cụ thể nào

Chọn một nhóm trong trình soạn thảo quảng cáo

Mở bất kỳ quảng cáo nào → tab Người nhận. Phía trên ba cột, bạn sẽ thấy một hàng chip nhóm:

• ○ tên — 12 — không có gì được chọn (12 có sẵn)
• ◐ tên — 5/12 — được chọn một phần
• ✓ tên — 12 — được chọn hoàn toàn (xanh lá)

Nhấp vào một chip để bật/tắt toàn bộ nhóm. Nhấp lại để bỏ chọn mọi thứ trong nhóm đó.

Nhập CSV / Excel / JSON v4.0

Tải hàng loạt danh sách người nhận từ bảng tính, kết xuất JSON hoặc CSV được xuất từ ứng dụng khác.

Định dạng được hỗ trợ

• CSV — tự động phát hiện dấu phân cách (;, , hoặc tab)
• Excel — .xlsx và .xlsm với hộp thoại ánh xạ cột tương tác
• JSON — danh sách đối tượng hoặc một từ điển với các khóa group/channel/contact

Định dạng CSV

Hai hoặc ba cột: type, name và group tùy chọn.

type;name;group
group;Marketing chat;Main
channel;@my_channel;Main
contact;John Smith;
group;Test chat;Test

Loại chấp nhận các từ đồng nghĩa bằng tiếng Anh và tiếng Nga:

• group, groups, группа, группы
• channel, channels, канал, каналы
• contact, contacts, контакт, контакты, user, users

Định dạng JSON

Hai hình dạng được chấp nhận:

[
  { "type": "group",   "name": "Marketing chat", "group": "Main" },
  { "type": "channel", "name": "@my_channel",   "group": "Main" }
]

Hoặc được nhóm theo loại:

{
  "group":   ["Marketing chat", "Test chat"],
  "channel": ["@my_channel"],
  "contact": ["John Smith"]
}

Ánh xạ cột Excel

Khi bạn nhập tệp .xlsx, một hộp thoại ánh xạ xuất hiện:

• Cột loại — cột nào chứa group/channel/contact
• Cột tên — cột nào chứa tên người nhận thực tế
• Cột nhóm — nhóm được đặt tên tùy chọn để gán từng người nhận

Ứng dụng tự động đoán dựa trên tên tiêu đề ("type", "name", "group", và các từ tương đương tiếng Nga). Bản xem trước trực tiếp hiển thị 4 hàng đầu tiên như chúng sẽ được phân tích cú pháp.

Xem trước nhập

Sau khi phân tích cú pháp, bạn sẽ thấy một bản tóm tắt:

• Mới — có bao nhiêu hàng mới sẽ được thêm
• Trùng lặp — có bao nhiêu hàng đã tồn tại trong danh sách của bạn
• Lỗi — các vấn đề phân tích cú pháp, với số dòng
• Nhóm được phát hiện — tên nhóm được tìm thấy trong tệp

Hợp nhất so với Thay thế

• Hợp nhất — thêm người nhận mới, bỏ qua các bản trùng lặp, để nguyên những người hiện có
• Thay thế — xóa danh sách hiện tại và chỉ sử dụng những gì có trong tệp (một hộp thoại xác nhận bổ sung xuất hiện)

Xuất sang CSV

Nhấp vào Xuất CSV trên thanh công cụ. Tệp được lưu với:

• Mã hóa UTF-8 BOM — Excel mở văn bản không phải ASCII một cách chính xác
• Dấu phân cách chấm phẩy
• Cột group tùy chọn liệt kê tất cả các nhóm người nhận mà mục đó thuộc về

Tên tệp mặc định: recipients_AccountName_20261016_143052.csv.

Tổng quan quảng cáo

Trang Quảng cáo liệt kê tất cả các tin nhắn đã lên lịch của bạn cho tài khoản hiện tại và cung cấp khả năng kiểm soát trực tiếp đối với từng tin nhắn.

Bố cục

Chia hai bảng:

• Trái — danh sách các quảng cáo với dấu hiệu đang chạy/tạm dừng/đã dừng
• Phải — chi tiết cho quảng cáo đã chọn

Dấu hiệu trong danh sách

• ▶ — đang chạy
• ⏸ — đã tạm dừng
• ⏹ — đã dừng

Hành động trên thanh công cụ

Bảng chi tiết

Hiển thị tóm tắt nội dung của quảng cáo đã chọn, khoảng thời gian, cửa sổ thời gian, số lượng người nhận, độ trễ và — trong khi chạy — thanh tiến trình trực tiếp.

Nút điều khiển:

• Bắt đầu — bắt đầu gửi
• Tạm dừng / Tiếp tục — tạm thời dừng mà không mất trạng thái
• Dừng — hủy hoàn toàn (chu kỳ đang chạy bị ngắt ngay lập tức)
• Chỉnh sửa, Nhân bản, Xóa

Tạo quảng cáo mới

Nhấp vào Quảng cáo mới để mở trình soạn thảo. Trình soạn thảo có bốn tab:

1. Nội dung — văn bản, phương tiện, luân chuyển, chuỗi
2. Người nhận — nhóm, kênh, danh bạ, chủ đề diễn đàn
3. Lịch trình — khoảng thời gian, cửa sổ thời gian, ngày, độ trễ, tự động dừng
4. Nâng cao — giới hạn gửi, mẫu

Mỗi tab được đề cập trong phần riêng của nó bên dưới.

Trình soạn thảo quảng cáo — Nội dung

Soạn tin nhắn. Ba chế độ: tin nhắn đơn, luân chuyển nội dung và chuỗi tin nhắn.

Chế độ 1 — Tin nhắn đơn

Chế độ mặc định. Điền văn bản tin nhắn và tùy chọn đính kèm phương tiện. Các biến được hỗ trợ (xem bên dưới).

Chế độ 2 — Luân chuyển nội dung

Bật Sử dụng luân chuyển để xác định nhiều biến thể (xem phần luân chuyển dành riêng).

Chế độ 3 — Chuỗi tin nhắn

Bật Chuỗi tin nhắn để chuyển sang các kịch bản nhiều bước (xem phần chuỗi dành riêng).

Trường tin nhắn

Hỗ trợ văn bản nhiều dòng, định dạng HTML và các biến động:

Trong các chiến dịch người đăng ký (DM), các biến người dùng này cũng có sẵn:

• {name} — họ và tên
• {first_name}, {last_name} — các phần của tên
• {username} — @username nếu có

Phương tiện

Nhấp vào Thêm tệp để đính kèm ảnh, video hoặc tài liệu. Nhiều tệp (tối đa 10) được gửi dưới dạng album Telegram.

• Các tệp được liệt kê với tên cơ sở và nút xóa khi di chuột
• Bất kỳ loại tệp nào Telegram chấp nhận: JPG, PNG, MP4, MOV, ZIP, PDF, v.v.
• Phương tiện được tải lên cho mỗi tin nhắn — không có vấn đề về giới hạn tốc độ ngoài độ trễ gửi tiêu chuẩn

Chuyển tiếp từ Tin nhắn đã lưu

Thay vì viết văn bản, bạn có thể chuyển tiếp một tin nhắn đã lưu hiện có (hoặc toàn bộ album):

Xem trước và Gửi thử

Ở cuối trình soạn thảo:

• Xem trước — hiển thị tin nhắn như nó sẽ xuất hiện trong Telegram (với sự thay thế các biến ngày/giờ)
• Gửi thử — gửi tin nhắn một lần đến người nhận đầu tiên được chọn. Sử dụng điều này trước khi khởi chạy một chiến dịch dài.

Luân chuyển nội dung v4.0

Xác định nhiều biến thể văn bản và phương tiện. Mỗi người nhận nhận được một biến thể khác nhau — làm giảm đáng kể việc phát hiện mẫu spam.

Bật luân chuyển

Quy tắc ghép nối

Chế độ luân chuyển

Phương tiện cho mỗi biến thể

Mỗi biến thể có danh sách phương tiện riêng. Nhấp vào Thêm tệp dưới bất kỳ biến thể nào để đính kèm phương tiện cụ thể cho biến thể đó. Nếu một biến thể không có phương tiện, nó được gửi dưới dạng tin nhắn chỉ có văn bản.

Sử dụng luân chuyển bên trong chuỗi

Luân chuyển cũng hoạt động bên trong chuỗi — mỗi bước có thể có nút Sử dụng luân chuyển riêng. Bước 1 có thể gửi ngẫu nhiên 3 biến thể văn bản, Bước 2 có thể không có luân chuyển, Bước 3 có thể luân chuyển qua 5 hình ảnh khác nhau. Bộ đếm của mỗi bước là độc lập.

Chuỗi tin nhắn v4.0

Biến một quảng cáo duy nhất thành một cuộc đối thoại nhiều bước — 2 đến 5 tin nhắn được gửi nối tiếp nhau với khoảng thời gian tạm dừng có thể cấu hình.

Bật chuỗi

Mỗi bước có

• Văn bản — nội dung tin nhắn riêng
• Phương tiện — tệp đính kèm riêng (ảnh, video, tài liệu)
• Luân chuyển tùy chọn — nút bật/tắt cho mỗi bước để xác định nhiều biến thể trong bước
• Độ trễ sau — bao nhiêu giây để đợi trước khi gửi bước tiếp theo (chỉ hiển thị giữa các bước, không phải sau bước cuối cùng)

Quản lý các bước

• Thêm bước — thêm một bước trống mới ở cuối
• Mũi tên ↑ / ↓ — sắp xếp lại các bước (bị vô hiệu hóa ở bước đầu tiên/cuối cùng)
• X — xóa một bước (phải còn lại ít nhất một bước)

Luân chuyển cho mỗi bước

Trong bất kỳ bước nào, hãy bật Sử dụng luân chuyển để xác định nhiều biến thể văn bản+phương tiện cho bước đó. Chế độ luân chuyển (ngẫu nhiên/theo chu kỳ) là riêng biệt cho mỗi bước.

Xem trước dòng thời gian

Nhấp vào Xem trước để xem toàn bộ chuỗi dưới dạng dòng thời gian được đánh số với các bong bóng nội dung cho mỗi bước và các chỉ báo tạm dừng giữa chúng.

Ví dụ thực tế — Chuỗi khởi động

Đối với các chiến dịch người đăng ký, một chuỗi 3 bước hoạt động như sau:

Lịch trình

Kiểm soát thời điểm và tần suất quảng cáo kích hoạt. Hai chế độ lập lịch, cộng với cửa sổ thời gian, ngày trong tuần và bảo vệ tự động dừng.

Chế độ lập lịch

Chế độ khoảng thời gian

Đặt khoảng thời gian tính bằng phút. Khuyến nghị tối thiểu: 180 đối với các kênh, 60 là mức sàn tuyệt đối. Dưới mức đó Telegram bắt đầu phản hồi bằng FloodWait.

Chế độ thời gian cố định

Thêm một hoặc nhiều thời điểm trong ngày (HH:MM). Ứng dụng tính toán lần chạy theo lịch tiếp theo — nếu một ngày có tất cả các thời điểm đã qua, thời gian đầu tiên của ngày tiếp theo sẽ được sử dụng.

Cửa sổ thời gian

Giới hạn việc gửi trong những giờ cụ thể — ví dụ: chỉ trong giờ làm việc. Các cửa sổ qua đêm cũng hoạt động (22:00 → 06:00).

Ngày trong tuần

Bảy hộp kiểm: Thứ Hai đến Chủ Nhật. Chỉ những ngày được chọn mới được phép gửi. Nếu ứng dụng đang chạy nhưng ngày hiện tại không được chọn, nó sẽ ghi nhật ký "sai ngày" và chờ.

Độ trễ giữa các tin nhắn

Một phạm vi ngẫu nhiên tính bằng giây. Đối với mỗi người nhận, độ trễ được rút ra đồng nhất giữa mức tối thiểu và tối đa.

Bảo vệ tự động dừng

Điều gì xảy ra khi tự động dừng kích hoạt

1. Chiến dịch dừng ngay lập tức
2. Một mục nhật ký xuất hiện: "Tự động dừng: 5 lỗi liên tiếp. Quảng cáo 'X' đã dừng."
3. Nếu thông báo Telegram được bật, bạn sẽ nhận được báo cáo trong Tin nhắn đã lưu
4. Quảng cáo vẫn ở trong danh sách của bạn — hãy khắc phục sự cố và khởi động lại

Chủ đề diễn đàn

Nếu một nhóm đã chọn là một diễn đàn Telegram (có chủ đề), bạn có thể gửi đến các chủ đề cụ thể — hoặc đến cuộc trò chuyện chính.

Định cấu hình chủ đề

Điều gì xảy ra khi gửi

Đối với mỗi nhóm người nhận là một diễn đàn, ứng dụng sẽ gửi một tin nhắn riêng đến từng chủ đề được chọn. Nếu bạn chọn 3 chủ đề trong một nhóm và cùng một nhóm cũng được chọn cho một quảng cáo khác, các chủ đề chỉ áp dụng cho quảng cáo này.

Đếm người nhận

Tổng số người nhận trong chi tiết quảng cáo bao gồm các phần tách chủ đề. Một nhóm duy nhất với 3 chủ đề được chọn được tính là 3 người nhận.

Trò chuyện chính

Luôn có sẵn. Nếu bạn chỉ chọn cuộc trò chuyện chính — không có chủ đề — tin nhắn chỉ đi đến nguồn cấp dữ liệu chung.

Chiến dịch DM

Thu thập người tham gia từ bất kỳ nhóm hoặc kênh nào, sau đó gửi cho họ tin nhắn trực tiếp được cá nhân hóa.

Cách hoạt động

1. Bạn chỉ định một nguồn — một nhóm hoặc kênh bạn có quyền truy cập
2. Ứng dụng tìm nạp danh sách người tham gia (với các bộ lọc)
3. Nó gửi cho mỗi người tham gia một DM được cá nhân hóa
4. Tiến trình được theo dõi — cùng một người dùng không bao giờ nhận được tin nhắn hai lần

Tạo một chiến dịch

Xem trước người tham gia

Nhấp vào Xem trước trên bất kỳ chiến dịch nào. Một cửa sổ mở ra với danh sách người dùng sẽ được nhắm mục tiêu, hiển thị tên, @username và ID người dùng. Xác minh các bộ lọc hoạt động như mong đợi trước khi khởi chạy.

Chạy chiến dịch

Nhấp vào Bắt đầu. Lượt đầu tiên chạy ngay lập tức. Thống kê trực tiếp xuất hiện trong bảng thông tin và cập nhật mỗi giây:

• Đã gửi — tin nhắn đã gửi
• Đã bỏ qua — người dùng không có tên người dùng, được bảo vệ quyền riêng tư, bị vô hiệu hóa, bot
• Thất bại — lỗi (thường là quyền riêng tư hoặc flood)
• Đã theo dõi — tổng số người dùng riêng biệt đã nhận được tin nhắn

Điều kiện bỏ qua

Người dùng được bỏ qua trong im lặng (được tính trong Đã bỏ qua) khi Telegram trả về:

• Hạn chế quyền riêng tư — "người dùng không chấp nhận tin nhắn từ người lạ"
• Không phải danh bạ lẫn nhau
• Tài khoản bị vô hiệu hóa
• Bạn đã bị người dùng chặn

Đặt lại tiến trình

Nhấp vào Đặt lại để xóa danh sách "đã gửi". Sử dụng điều này nếu bạn muốn gửi lại cùng một chiến dịch — nhưng chỉ sau khi thay đổi nội dung tin nhắn một cách có ý nghĩa.

Lý do hoàn thành

Tham gia nhóm

Tham gia hàng loạt nhóm và kênh từ danh sách liên kết với độ trễ có thể cấu hình.

Chuẩn bị liên kết

Dán liên kết vào vùng văn bản — mỗi dòng một liên kết. Định dạng được hỗ trợ:

• https://t.me/joinchat/XXXXX — liên kết mời riêng tư
• t.me/username — nhóm hoặc kênh công khai
• @username — công khai
• +invite_hash — lời mời riêng tư

Độ trễ giữa các lần tham gia

Được khuyến nghị: 10–30 giây. Giá trị thấp hơn dẫn đến lỗi FloodWait rất nhanh. Mặc định 5 giây là tích cực — bạn sẽ muốn ít nhất 15 giây.

Chạy trình tham gia

1. Dán liên kết hoặc nhấp vào Tải từ tệp để nhập một tệp .txt
2. Đặt độ trễ
3. Nhấp vào Bắt đầu tham gia

Ứng dụng xử lý các liên kết từng cái một:

• Thanh tiến trình hiển thị vị trí hiện tại
• Mỗi lần thử được ghi vào Nhật ký sự kiện
• Danh sách kết quả trực tiếp xuất hiện bên dưới với các chỉ báo ✓ / ✗
• Thông báo cuối cùng hiển thị: N thành công, M thất bại

Lưu danh sách của bạn

Danh sách liên kết của bạn được tự động lưu trong localStorage giữa các phiên. Nhấp vào Lưu vào tệp để xuất nó dưới dạng tệp .txt để sao lưu.

Chiến dịch Story

Tự động phát hành story Telegram theo lịch. Yêu cầu Telegram Premium trên tài khoản.

Tạo một chiến dịch story

Chạy chiến dịch

Chọn chiến dịch, nhấp vào Bắt đầu. Ứng dụng:

• Kiểm tra tài khoản có Premium không
• Xác minh tệp phương tiện tồn tại
• Phát hành story đầu tiên ngay lập tức
• Lên lịch các story tiếp theo vào khoảng thời gian đã chỉ định

Yêu cầu phương tiện

Tự động trả lời Enterprise

Tự động phản hồi tin nhắn riêng tư đến dựa trên khớp từ khóa. Chỉ gói Enterprise.

Những gì nó làm

Ứng dụng theo dõi tất cả tin nhắn riêng tư đến trên tài khoản hiện tại. Khi một tin nhắn khớp với điều kiện của quy tắc, hành động được cấu hình sẽ kích hoạt.

Tạo một quy tắc

Loại khớp

Hành động

Thử nghiệm một quy tắc

Nhấp vào Thử nghiệm trên bất kỳ quy tắc trả lời nào đã bật. Ứng dụng gửi văn bản trả lời đến Tin nhắn đã lưu của chính bạn — hữu ích để xem chính xác cách nó hiển thị với việc thay thế biến.

Cách các quy tắc kích hoạt

• Tin nhắn đến được phân tích cú pháp
• Các quy tắc được kiểm tra theo thứ tự; kết quả khớp đầu tiên sẽ thắng
• Kiểm tra thời gian hồi diễn ra — cùng một người dùng không thể được tự động trả lời thường xuyên hơn thời gian hồi
• Nếu hành động là trả lời và độ trễ được đặt, ứng dụng sẽ đợi số giây đó rồi gửi

Thống kê v4.0

Bảng điều khiển phân tích đầy đủ: hoạt động theo ngày và giờ, mục tiêu hàng đầu, lỗi hàng đầu, sự kiện gần đây với xuất CSV.

Bộ lọc

Thẻ KPI

• Đã gửi — các lần gửi thành công (xanh lá)
• Lỗi — lỗi cứng (đỏ)
• Floods — sự kiện FloodWait (vàng)
• Tỷ lệ — đã gửi / (đã gửi + lỗi + floods) dưới dạng phần trăm
• Lượt xem — tổng lượt xem cho các tin nhắn kênh được theo dõi

Biểu đồ

Hoạt động theo ngày — biểu đồ thanh của số lần gửi mỗi ngày, với đường lỗi phủ lên.

Hoạt động theo giờ — biểu đồ thanh của số lần gửi mỗi giờ trong ngày. Hữu ích để phát hiện các cửa sổ gửi tốt nhất của bạn.

Mục tiêu hàng đầu

10 người nhận được sử dụng nhiều nhất với số lần gửi, số lỗi và — đối với các kênh — huy hiệu tổng lượt xem.

Lỗi hàng đầu

10 loại lỗi hàng đầu theo tần suất. Hữu ích để hiểu các vấn đề hệ thống:

• not_found — người nhận không còn tồn tại
• privacy — hạn chế quyền riêng tư của người dùng
• peer_flood — tín hiệu dừng cứng từ Telegram
• flood_wait — đạt giới hạn tốc độ
• Và những người khác, tùy thuộc vào lỗi cụ thể được trả về

Sự kiện gần đây

30 sự kiện cuối cùng với dấu thời gian, tên chiến dịch, mục tiêu và viên thuốc trạng thái. Được lọc theo cùng khoảng thời gian/tài khoản/chiến dịch như các KPI.

Theo dõi lượt xem kênh

Đối với các kênh phát sóng nơi tài khoản của bạn là quản trị viên, ứng dụng sẽ tự động tìm nạp số lượt xem trong nền. Được làm mới mỗi 10 phút cho các tin nhắn tối đa 7 ngày tuổi.

Xuất CSV

Nhấp vào Xuất CSV để lưu tất cả các sự kiện khớp với bộ lọc hiện tại vào tệp CSV (tối đa 100.000 hàng). Cột:

timestamp;account_id;campaign_name;campaign_type;target_name;target_kind;status;error_kind;views

Lưu giữ

Thống kê được lưu trữ cục bộ trong SQLite. Các sự kiện cũ hơn 90 ngày được tự động thanh lọc bởi một công việc nền hàng ngày. Thay đổi thời gian lưu giữ trong cấu hình nếu cần.

Nhật ký sự kiện

Mọi hành động ứng dụng thực hiện đều được ghi lại ở đây. Sử dụng nó để giám sát chiến dịch và chẩn đoán sự cố.

Loại sự kiện

• INFO (xanh dương) — các sự kiện thường lệ: bắt đầu gửi thư, đã gửi tin nhắn, chiến dịch hoàn thành
• WARNING (cam) — các vấn đề tiềm ẩn: khoảng thời gian nhỏ, mạng chậm, người dùng bị bỏ qua
• ERROR (đỏ) — các lỗi thực tế: không tìm thấy thực thể, không có quyền, PEER_FLOOD

Bộ lọc

Bộ đếm

Phía trên nội dung nhật ký, bạn thấy các bộ đếm trực tiếp:

• Tổng cộng — tất cả các sự kiện hiển thị
• Đã gửi — các lần gửi thành công
• Cảnh báo — cảnh báo
• Lỗi — lỗi

Xuất

• Xuất TXT — văn bản thuần túy, mỗi dòng một sự kiện
• Xuất CSV — có cấu trúc với dấu thời gian, cấp độ, loại, cờ im lặng, tài khoản, tin nhắn. UTF-8 BOM cho Excel.

Sao chép tất cả

Sao chép tất cả các sự kiện đã lọc vào clipboard ở cùng định dạng TXT. Hữu ích để dán vào một phiếu hỗ trợ.

Xóa

Nhấp vào Xóa để xóa bộ đệm hiển thị và danh sách trong bộ nhớ. Nhật ký tệp trên đĩa (data/logs/app.log) không bị ảnh hưởng.

Cài đặt

Tất cả cấu hình toàn cầu trong một trang.

Chung

Proxy toàn cầu

Một proxy duy nhất được sử dụng bởi tất cả các tài khoản không có proxy riêng. Các trường: loại (SOCKS5 / SOCKS4 / HTTP), máy chủ, cổng, tên người dùng và mật khẩu tùy chọn.

• Lưu — ghi vào cấu hình
• Kiểm tra — kiểm tra IP bên ngoài của bạn thông qua proxy này qua api.ipify.org. Kết quả xuất hiện dưới dạng thông báo.
• Xóa — đặt lại tất cả các trường và xóa proxy toàn cầu

Cửa sổ thời gian toàn cầu

Một cửa sổ gửi duy nhất được áp dụng cho mọi quảng cáo và chiến dịch trên tài khoản. Khi được bật, nó ghi đè cài đặt cho từng quảng cáo.

Tự động bắt đầu

• Tự động bắt đầu tất cả quảng cáo sau khi ủy quyền — khi một tài khoản được ủy quyền, mọi quảng cáo mà nó sở hữu sẽ bắt đầu ngay lập tức

Kiểm tra tình trạng phiên

Được đề cập chi tiết trong phần Kiểm tra Tình trạng Phiên:

• Bật khi khởi động
• Khoảng thời gian tự động kiểm tra (phút, 0 = đã tắt)
• Tự động ủy quyền lại các phiên bị chết

Thông báo Telegram

Xem phần dành riêng bên dưới.

Giấy phép

Hiển thị gói hiện tại, số ngày còn lại, ngày kết thúc. Nút để mở lại hộp thoại kích hoạt.

Dữ liệu & nhật ký

• Thống kê lưu trữ — tổng kích thước dữ liệu, tài khoản, người nhận, bộ đếm chiến dịch
• Mở thư mục nhật ký — mở data/logs/ trong trình quản lý tệp của bạn
• Xuất sao lưu — toàn bộ hồ sơ sang ZIP
• Nhập sao lưu — khôi phục từ ZIP với hộp thoại xem trước
• Kiểm tra cập nhật — kiểm tra cập nhật thủ công
• Gỡ lỗi — hiển thị kết xuất JSON về trạng thái hệ thống con cập nhật (hữu ích cho hỗ trợ)

Vùng nguy hiểm

• Đặt lại cài đặt — xóa proxy, cửa sổ thời gian, tự động bắt đầu, kiểm tra phiên và cài đặt thông báo trở về mặc định
• Xóa tài khoản — xóa mọi tài khoản và phiên của nó. Hộp thoại xác nhận trước.

Thông báo Telegram

Nhận báo cáo chiến dịch ngay trong Telegram — đến Tin nhắn đã lưu hoặc bất kỳ cuộc trò chuyện nào.

Bật

Thử nghiệm

Nhấp vào Gửi thông báo thử. Nó sử dụng tài khoản được ủy quyền đầu tiên và gửi một tin nhắn thử đến mục tiêu bạn đã chọn. Nếu không có tài khoản được ủy quyền nào tồn tại, bạn sẽ nhận được một lỗi rõ ràng.

Sự kiện được gửi

Mỗi thông báo mang một bản tóm tắt được định dạng. Một báo cáo hoàn thành chiến dịch điển hình trông như sau:

✅ Gửi thư hoàn thành

📣 Chiến dịch: Khuyến mãi
📤 Đã gửi: 45
❌ Lỗi: 2

⏱ Thời lượng: 12 phút
🕐 14:30 — 14:42

Sao lưu toàn bộ hồ sơ v4.0

Một cú nhấp để xuất mọi thứ: cấu hình, cơ sở dữ liệu, phiên, quảng cáo, chiến dịch và thống kê dưới dạng một tệp ZIP duy nhất.

Những gì được bao gồm

• config.json — tất cả cài đặt, bộ nhớ đệm khóa giấy phép
• autoposter.db — tài khoản, người nhận, quảng cáo, story, người đăng ký, mẫu, quy tắc tự động trả lời, thống kê
• sessions/*.session — các tệp phiên Telegram (tùy chọn, xem bên dưới)
• templates/ — bất kỳ dữ liệu thư mục mẫu nào

Những gì bị loại trừ

• logs/ — tệp nhật ký
• exports/ — tệp CSV đã xuất
• backups/ — các bản sao lưu cũ
• Tệp tạm thời WAL/SHM SQLite

Xuất

Nhập

Cập nhật

Ứng dụng kiểm tra các phiên bản mới khi khởi động và cung cấp cửa sổ lịch sử thay đổi khi có sẵn.

Kiểm tra tự động

2,5 giây sau khi khởi động, một yêu cầu nhỏ được gửi đến máy chủ cập nhật. Nếu có phiên bản mới hơn, một hộp thoại lịch sử thay đổi xuất hiện với các mục được phân loại (tính năng, sửa lỗi, cải tiến, bảo mật).

Hộp thoại cập nhật

• Tải xuống — mở trang tải xuống trong trình duyệt của bạn
• Nhắc lại sau — hộp thoại đóng, sẽ hiển thị lại trong lần khởi chạy tiếp theo
• Bỏ qua phiên bản này — không bao giờ hiển thị lại phiên bản cụ thể này (nếu có phiên bản mới hơn, hộp thoại sẽ quay lại)

Kiểm tra thủ công

Hai cách:

• Biểu tượng tải xuống trên thanh trên cùng
• Cài đặt → Dữ liệu & nhật ký → Kiểm tra cập nhật

Thông tin gỡ lỗi

Cài đặt → Gỡ lỗi hiển thị kết xuất JSON với phiên bản hiện tại của bạn, phản hồi của máy chủ và liệu bản cập nhật có kích hoạt hay không. Hữu ích khi mở phiếu hỗ trợ.

Dữ liệu & thư mục

Mọi thứ được lưu trữ trong một thư mục. Hiểu nó và bạn hiểu ứng dụng.

Vị trí thư mục

Bên trong có gì

Sao lưu tự động

Mỗi khi bạn lưu cài đặt hoặc một chiến dịch, config.json trước đó sẽ được sao chép vào backups/ với dấu thời gian. Chỉ 5 bản gần nhất được giữ lại.

Khôi phục bản sao lưu cấu hình thủ công

1. Đóng ứng dụng
2. Mở data/backups/ và tìm bản sao bạn muốn
3. Đổi tên nó thành config.json và thay thế tệp hiện tại
4. Khởi động lại ứng dụng

Di chuyển sang máy tính mới

1. Sao chép toàn bộ thư mục data/ (hoặc tương đương trên macOS) vào USB
2. Cài đặt ứng dụng trên máy tính mới
3. Đóng nó một lần (để nó tạo thư mục data/ trống)
4. Thay thế thư mục data/ mới bằng thư mục từ USB
5. Khởi chạy — mọi thứ được bảo tồn

Khắc phục sự cố

Câu trả lời nhanh cho các vấn đề phổ biến nhất.