---
title: "Thêm ghi chú nội bộ"
locale: vi
url: https://tlg.builera.app/docs/reference/rest/conversations.add_note
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# Thêm ghi chú nội bộ

Thêm ghi chú nội bộ của nhóm vào cuộc trò chuyện (không bao giờ gửi cho khách).

Thêm ghi chú nội bộ của nhóm vào cuộc trò chuyện (không bao giờ gửi cho khách).

## Thông tin

| Tên | Giá trị |
| --- | --- |
| Mã | `conversations.add_note` |
| Scope cần | `chats.manage` |
| Mức | Ghi |
| Có thể cần xác nhận | Không |
| Kiểu chạy | Trả kết quả ngay |
| Cần `Idempotency-Key` | Không |
| Vai trò thành viên được phép | `owner`, `manager`, `agent` |
| Trong app | Hộp thư → ghi chú |

## Trường vào

| Trường | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- |
| `conversationId` | `uuid` | Có |   |
| `body` | `chữ` | Có |   |

## Ví dụ gọi

```bash
curl -X POST https://tlg.builera.app/api/public/v2/ops/conversations.add_note \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"conversationId":"00000000-0000-0000-0000-000000000000","body":"…"}'
```

## Trường ra (`data`)

| Trường | Kiểu | Bắt buộc |
| --- | --- | --- |
| `ok` | `true` | Có |
| `id` | `chữ` | Có |

## Ví dụ trả về

```json
{
  "data": {
    "ok": true,
    "id": "00000000-0000-4000-8000-000000000000"
  }
}
```

## Dùng qua MCP

Tool `conversations_add_note` có tên sẵn trong profile: Vận hành realtime (`realtime`). Ở profile khác, tìm bằng `tools_search` rồi chạy bằng `tools_run`.