---
title: "Nâng lên siêu nhóm"
locale: vi
url: https://tlg.builera.app/docs/reference/rest/groups.upgrade
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# Nâng lên siêu nhóm

Nâng nhóm thường lên siêu nhóm (cần cho chế độ chậm, cấm thành viên, nhóm lớn hơn). Không hoàn tác được; nhóm cũ chỉ còn đọc và siêu nhóm trở thành chat mới.

Nâng nhóm thường lên siêu nhóm (cần cho chế độ chậm, cấm thành viên, nhóm lớn hơn). Không hoàn tác được; nhóm cũ chỉ còn đọc và siêu nhóm trở thành chat mới.

## Thông tin

| Tên | Giá trị |
| --- | --- |
| Mã | `groups.upgrade` |
| Scope cần | `groups.admin` |
| Mức | Nguy hiểm |
| Có thể cần xác nhận | Có |
| Kiểu chạy | Xếp việc cho máy chạy |
| Cần `Idempotency-Key` | Có |
| Vai trò thành viên được phép | `owner`, `manager`, `agent` |
| Cần máy chạy từ bản | `1.0.17` |
| Trong app | Hộp thư → thông tin nhóm → Quản lý |

## Trường vào

| Trường | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- |
| `conversationId` | `uuid` | Có |   |

## Ví dụ gọi

```bash
curl -X POST https://tlg.builera.app/api/public/v2/ops/groups.upgrade \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: <mã riêng mỗi việc>" \
  -d '{"conversationId":"00000000-0000-0000-0000-000000000000"}'
```

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

| Trường | Kiểu | Bắt buộc |
| --- | --- | --- |
| `ok` | `true` | Có |
| `jobId` | `chữ` | Có |

## Ví dụ trả về

```json
{
  "data": {
    "ok": true,
    "jobId": "00000000-0000-4000-8000-000000000000"
  }
}
```

## Dùng qua MCP

Không có tên sẵn trong profile nào: gọi `tools_describe` rồi `tools_run` với `code: "groups.upgrade"`. Tên tool khi được liệt kê: `groups_upgrade`.