---
title: "Bật / tắt chủ đề"
locale: vi
url: https://tlg.builera.app/docs/reference/rest/groups.toggle_topics
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# Bật / tắt chủ đề

Bật hoặc tắt chủ đề diễn đàn cho một siêu nhóm (cần quyền đổi thông tin nhóm). Tắt đi vẫn giữ tin nhưng bỏ cấu trúc chủ đề.

Bật hoặc tắt chủ đề diễn đàn cho một siêu nhóm (cần quyền đổi thông tin nhóm). Tắt đi vẫn giữ tin nhưng bỏ cấu trúc chủ đề.

## Thông tin

| Tên | Giá trị |
| --- | --- |
| Mã | `groups.toggle_topics` |
| Scope cần | `groups.admin` |
| Mức | Ghi |
| 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.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ó |   |
| `enabled` | `đúng/sai` | Có |   |

## Ví dụ gọi

```bash
curl -X POST https://tlg.builera.app/api/public/v2/ops/groups.toggle_topics \
  -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","enabled":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.toggle_topics"`. Tên tool khi được liệt kê: `groups_toggle_topics`.