---
title: "Đánh dấu chưa đọc"
locale: vi
url: https://tlg.builera.app/docs/reference/rest/conversations.mark_unread
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# Đánh dấu chưa đọc

Đặt hoặc bỏ dấu chưa đọc của Telegram trên cuộc trò chuyện (mở chat là dấu mất).

Đặt hoặc bỏ dấu chưa đọc của Telegram trên cuộc trò chuyện (mở chat là dấu mất).

## Thông tin

| Tên | Giá trị |
| --- | --- |
| Mã | `conversations.mark_unread` |
| 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` |
| Cần máy chạy từ bản | `1.0.15` |
| Trong app | Hộp thư → menu chat → Đánh dấu chưa đọc |

## Trường vào

| Trường | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- |
| `conversationId` | `uuid` | Có |   |
| `unread` | `đúng/sai` | Có |   |

## Ví dụ gọi

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