Tài liệu

Tham chiếu

Đánh dấu đã đọc

Đánh dấu cuộc trò chuyện đã đọc trên Telegram (khách thấy dấu đã xem).

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

Đánh dấu cuộc trò chuyện đã đọc trên Telegram (khách thấy dấu đã xem).

Thông tin

Tên Giá trị
Mã conversations.mark_read
Scope cần messages.send
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
Trong app Hộp thư → mở chat

Trường vào

Trường Kiểu Bắt buộc Mô tả
conversationId uuid Có
topicIds số nguyên[] Không

Ví dụ gọi

curl -X POST https://tlg.builera.app/api/public/v2/ops/conversations.mark_read \
  -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ó
changed false Có

Ví dụ trả về

{
  "data": {
    "ok": true,
    "changed": false
  }
}

Dùng qua MCP

Tool conversations_mark_read có tên sẵn trong profile: Vận hành realtime (realtime), Thiết lập tự chạy (setup), Tìm khách (prospecting), Báo cáo (reports), Quản trị (admin), Đầy đủ (full). Ở profile khác, tìm bằng tools_search rồi chạy bằng tools_run.

Trang này có hữu ích không?

Kiểm lại lần cuối: 24/10/2026 · bản 2.0