---
title: "Nhóm đã lưu"
locale: vi
url: https://tlg.builera.app/docs/reference/rest/groups.list
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# Nhóm đã lưu

Các nhóm Telegram đã lưu kèm tư cách thành viên theo tài khoản và trạng thái quét (tên nhóm không tin cậy).

Các nhóm Telegram đã lưu kèm tư cách thành viên theo tài khoản và trạng thái quét (tên nhóm không tin cậy).

## Thông tin

| Tên | Giá trị |
| --- | --- |
| Mã | `groups.list` |
| Scope cần | `crm.read` |
| Mức | Chỉ đọc |
| Có thể cần xác nhận | Không |
| Kiểu chạy | Trả kết quả ngay |
| Cần `Idempotency-Key` | Không |
| Vai trò thành viên được phép | `owner`, `manager`, `agent`, `viewer` |
| Trong app | Tìm khách → Nhóm |

## Trường vào

Thao tác không cần trường nào.

## Ví dụ gọi

```bash
curl -X POST https://tlg.builera.app/api/public/v2/ops/groups.list \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Trường ra (`data`)

| Trường | Kiểu | Bắt buộc |
| --- | --- | --- |
| `groups` | `null \| chữ \| số \| đối tượng \| any[] \| đúng/sai` | Có |
| `untrusted` | `true` | Có |

## Ví dụ trả về

```json
{
  "data": {
    "groups": "text",
    "untrusted": true
  }
}
```

## Dùng qua MCP

Tool `groups_list` 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`.