---
title: "Lưu nháp lên Telegram"
locale: vi
url: https://tlg.builera.app/docs/reference/rest/conversations.save_draft
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# Lưu nháp lên Telegram

Giữ chữ chưa gửi làm bản nháp Telegram của cuộc trò chuyện (hiện trên các thiết bị khác của tài khoản); chữ rỗng là xoá nháp. Trong nhóm diễn đàn, truyền topicId để lưu nháp riêng của chủ đề đó. Không gửi gì.

Giữ chữ chưa gửi làm bản nháp Telegram của cuộc trò chuyện (hiện trên các thiết bị khác của tài khoản); chữ rỗng là xoá nháp. Trong nhóm diễn đàn, truyền topicId để lưu nháp riêng của chủ đề đó. Không gửi gì.

## Thông tin

| Tên | Giá trị |
| --- | --- |
| Mã | `conversations.save_draft` |
| 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ư → ô soạn (rời chat khi còn chữ) |

## Trường vào

| Trường | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- |
| `conversationId` | `uuid` | Có |   |
| `text` | `chữ` | Có |   |
| `replyToMessageId` | `số nguyên` | Không |   |
| `topicId` | `số nguyên` | Không |   |

## Ví dụ gọi

```bash
curl -X POST https://tlg.builera.app/api/public/v2/ops/conversations.save_draft \
  -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","text":"…"}'
```

## 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.save_draft"`. Tên tool khi được liệt kê: `conversations_save_draft`.