---
title: "Tìm nhóm và khách tiềm năng"
locale: vi
url: https://tlg.builera.app/docs/guides/discover
verified: 2026-10-24
app_version: "2.0"
---

# Tìm nhóm và khách tiềm năng

Tìm nhóm Telegram, chọn tài khoản tham gia và quét người phù hợp trong phạm vi Telegram cho phép.


Bạn tìm nhóm hoặc kênh, chọn tài khoản Telegram để tham gia và lấy danh sách người phù hợp. Thêm nhóm vào danh sách không đồng nghĩa tài khoản đã tham gia nhóm.

## Ai làm được

**Chủ** và **Quản lý** tìm, thêm nhóm, tham gia, quét và bật theo dõi từ khoá. Các vai trò khác chỉ đọc dữ liệu được quyền truy cập.

## Cần chuẩn bị

- Tài khoản đã đăng nhập, có proxy và máy đang trực tuyến.
- Từ khoá, @username hoặc đường dẫn nhóm.
- Quyền xem nội dung hoặc thành viên của nhóm trên Telegram.

Việc tìm, tham gia và quét vẫn đi qua cổng an toàn, hạn mức và giờ chạy của tài khoản.

## Bắt đầu ở đâu

Mở **Tìm khách → Nhóm & kênh**.

![Danh sách nhóm và ô tìm kiếm trong Tìm khách](https://tlg.builera.app/docs-media/vi/discover.webp "Tìm nhóm")

## Các bước

1. Nhập từ khoá, @username hoặc link t.me vào ô **Từ khoá, @username hoặc link t.me/…**.
2. Chọn tài khoản ở **Tìm bằng** hoặc **Đọc nhóm bằng**. Từ khoá dùng để tìm nhóm/kênh công khai; đường dẫn và username dùng để đọc nhóm cụ thể.
3. Chọn **Thêm** ở kết quả muốn giữ.
4. Mở nhóm vừa thêm.
5. Chọn tài khoản tại **Vào nhóm bằng tài khoản**.
6. Bấm **Vào nhóm**. Nếu nhóm cần duyệt, chờ trạng thái **Đã gửi yêu cầu tham gia — chờ admin duyệt**.
7. Chọn tài khoản tại **Quét bằng tài khoản**.
8. Chọn **Quét người đang nhắn** hoặc **Quét thành viên**.

![Chi tiết nhóm với lựa chọn tài khoản và cách quét](https://tlg.builera.app/docs-media/vi/discover-group.webp "Chọn cách quét")

Hai cách quét có phạm vi khác nhau:

| Cách quét | Phạm vi |
|---|---|
| Người đang nhắn | Đọc tối đa 500 tin hoặc lùi tối đa 7 ngày; lấy người gửi xuất hiện trong phần đọc được |
| Thành viên | Tối đa 200 người trong một lượt, nếu Telegram cho xem danh sách |

Mỗi tài khoản có chốt tối đa **2.000 người/ngày** từ các lượt quét. Chốt này vẫn áp dụng ở chế độ **Tự do**. Số lượt quét còn chịu hạn mức hiệu lực của tài khoản.

Nhóm vừa quét phải chờ **24 giờ** trước lượt quét thông thường tiếp theo. Bạn có thể xác nhận **Quét lại** sớm hơn; thao tác này dùng thêm một lượt và không bỏ qua chốt ngày. Người đã có được cập nhật, không tạo trùng.

9. Bật **Theo dõi từ khoá** bằng tài khoản đã ở trong nhóm.
10. Mở **Sửa từ khoá · xem tín hiệu** để thiết lập từ khoá theo [hướng dẫn tín hiệu](https://tlg.builera.app/docs/guides/signals).

## Kết quả

Nhóm nằm trong danh sách tìm khách. Kết quả quét có thể mở bằng **Xem kết quả**; việc lưu người vào **Khách** là bước riêng.

## Kiểm tra

Xem tài khoản đã vào nhóm, tiến độ quét và **Lần quét cuối**. Với kênh, phần người đang nhắn thường chỉ có người đăng bài; không coi đó là danh sách người theo dõi.

## Khi có lỗi

- Nhóm riêng tư: cho tài khoản tham gia trước.
- Danh sách thành viên bị ẩn: dùng người đang nhắn nếu có quyền đọc.
- Việc chưa chạy: kiểm tra máy, lịch chạy và hạn mức trong [Nhật ký](https://tlg.builera.app/docs/guides/logs).
- Link hết hạn hoặc tài khoản bị loại khỏi nhóm: kiểm tra lại trên Telegram.

## Làm bằng API hoặc MCP

Dùng [groups.search](https://tlg.builera.app/docs/reference/rest/groups.search), [groups.join](https://tlg.builera.app/docs/reference/rest/groups.join), [scans.start](https://tlg.builera.app/docs/reference/rest/scans.start) và [groups.set_watch](https://tlg.builera.app/docs/reference/rest/groups.set_watch).

Tên tool tương ứng: `groups_search`, `groups_join`, `scans_start`, `groups_set_watch`. Kết nối cần đúng scope và quyền tài khoản; API không bỏ qua giới hạn quét.