---
title: "Đóng / mở lại chủ đề"
locale: vi
url: https://tlg.builera.app/docs/reference/rest/groups.close_topic
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# Đóng / mở lại chủ đề

Đóng một chủ đề (chỉ quản trị viên còn đăng được) hoặc mở lại.

Đóng một chủ đề (chỉ quản trị viên còn đăng được) hoặc mở lại.

## Thông tin

| Tên | Giá trị |
| --- | --- |
| Mã | `groups.close_topic` |
| Scope cần | `groups.admin` |
| 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` | Có |
| Vai trò thành viên được phép | `owner`, `manager`, `agent` |
| Cần máy chạy từ bản | `1.0.23` |
| Trong app | Hộp thư → thông tin nhóm → Quản lý → Chủ đề |

## Trường vào

| Trường | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- |
| `conversationId` | `uuid` | Có |   |
| `topicId` | `số nguyên` | Có |   |
| `closed` | `đúng/sai` | Có |   |

## Ví dụ gọi

```bash
curl -X POST https://tlg.builera.app/api/public/v2/ops/groups.close_topic \
  -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","topicId":1,"closed":true}'
```

## 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.close_topic"`. Tên tool khi được liệt kê: `groups_close_topic`.