Tham chiếu
Tìm nhóm công khai
Tìm nhóm Telegram công khai theo từ khoá từ một tài khoản. Theo dõi thao tác để nhận kết quả.
Xem MarkdownTrang này sinh tự động từ mã nguồn mỗi lần phát hành.
Tìm nhóm Telegram công khai theo từ khoá từ một tài khoản. Theo dõi thao tác để nhận kết quả.
Thông tin
| Tên | Giá trị |
|---|---|
| Mã | groups.search |
| Scope cần | discovery.write |
| Mức | Ghi |
| Có thể cần xác nhận | Không |
| Kiểu chạy | Xếp việc cho máy chạy |
Cần Idempotency-Key |
Không |
| Vai trò thành viên được phép | owner, manager |
| Trong app | Tìm khách → Tìm nhóm |
Trường vào
| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
accountId |
uuid |
Có | |
query |
chữ |
Có |
Ví dụ gọi
curl -X POST https://tlg.builera.app/api/public/v2/ops/groups.search \
-H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"accountId":"00000000-0000-0000-0000-000000000000","query":"…"}'Trường ra (data)
| Trường | Kiểu | Bắt buộc |
|---|---|---|
ok |
true |
Có |
searchId |
chữ |
Có |
Ví dụ trả về
{
"data": {
"ok": true,
"searchId": "00000000-0000-4000-8000-000000000000"
}
}Dùng qua MCP
Tool groups_search có tên sẵn trong profile: Tìm khách (prospecting). Ở profile khác, tìm bằng tools_search rồi chạy bằng tools_run.