Tham chiếu

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ủ đề.

Xem MarkdownTrang này sinh tự động từ mã nguồn mỗi lần phát hành.

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

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ề

{
  "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.

Bật / tắt chủ đề

#Thông tin

#Trường vào

#Ví dụ gọi

#Trường ra (data)