Tham chiếu

Xem chủ đề của nhóm

Liệt kê các chủ đề diễn đàn của một siêu nhóm (id, tên, đóng / ghim / ẩn, màu, chưa đọc, id tin mới nhất) và chủ đề có đang bật không. `q` tuỳ chọn để tìm theo tên. Dùng `id` của chủ đề làm `topicId` khi gửi (messages.send, tệp, bình chọn, nhãn dán, hẹn giờ) để đăng vào chủ đề đó; General có id 1 (gửi không cần topicId). Theo dõi thao tác để nhận dữ liệu.

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

Liệt kê các chủ đề diễn đàn của một siêu nhóm (id, tên, đóng / ghim / ẩn, màu, chưa đọc, id tin mới nhất) và chủ đề có đang bật không. q tuỳ chọn để tìm theo tên. Dùng id của chủ đề làm topicId khi gửi (messages.send, tệp, bình chọn, nhãn dán, hẹn giờ) để đăng vào chủ đề đó; General có id 1 (gửi không cần topicId). Theo dõi thao tác để nhận dữ liệu.

Thông tin

Tên	Giá trị
Mã	`groups.topics`
Scope cần	`messages.read`
Mức	Chỉ đọc
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`	Không
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ư → thanh chủ đề trên khung chat

Trường vào

Trường	Kiểu	Bắt buộc
`conversationId`	`uuid`	Có
`q`	`chữ`	Không
`after`	`uuid`	Không

Ví dụ gọi

curl -X POST https://tlg.builera.app/api/public/v2/ops/groups.topics \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -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ề

{
  "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.topics". Tên tool khi được liệt kê: groups_topics.

Xem chủ đề của nhóm

#Thông tin

#Trường vào

#Ví dụ gọi

#Trường ra (data)