---
title: "Mở tệp của tin"
locale: vi
url: https://tlg.builera.app/docs/reference/rest/messages.open_media
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# Mở tệp của tin

Lấy link tải ngắn hạn cho tệp của một tin (tải từ Telegram về trước nếu cần).

Lấy link tải ngắn hạn cho tệp của một tin (tải từ Telegram về trước nếu cần).

## Thông tin

| Tên | Giá trị |
| --- | --- |
| Mã | `messages.open_media` |
| Scope cần | `messages.read` |
| 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` | Không |
| Vai trò thành viên được phép | `owner`, `manager`, `agent` |
| Trong app | Hộp thư → bấm tệp |

## Trường vào

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

## Ví dụ gọi

```bash
curl -X POST https://tlg.builera.app/api/public/v2/ops/messages.open_media \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"messageId":"00000000-0000-0000-0000-000000000000"}'
```

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

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

## Ví dụ trả về

```json
{
  "data": {
    "ok": true,
    "url": "text",
    "pending": false
  }
}
```

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