---
title: "Gửi tin nhắn chữ"
locale: vi
url: https://tlg.builera.app/docs/reference/rest/messages.send
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# Gửi tin nhắn chữ

Gửi tin nhắn chữ trong một cuộc trò chuyện qua cửa an toàn của tài khoản (hạn mức, giờ chạy, người đã từ chối). Trả về messageId + một thao tác để theo dõi tới khi Telegram xác nhận.

Gửi tin nhắn chữ trong một cuộc trò chuyện qua cửa an toàn của tài khoản (hạn mức, giờ chạy, người đã từ chối). Trả về messageId + một thao tác để theo dõi tới khi Telegram xác nhận.

## Thông tin

| Tên | Giá trị |
| --- | --- |
| Mã | `messages.send` |
| 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ư → ô soạn tin |

## 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 |   |
| `inReplyToEventId` | `chữ` | Không |   |
| `ifLastMessageId` | `uuid` | Không |   |
| `clientMessageId` | `uuid` | Không |   |

## Ví dụ gọi

```bash
curl -X POST https://tlg.builera.app/api/public/v2/ops/messages.send \
  -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 |
| --- | --- | --- |
| `timings` | `đối tượng \| null` | Không |
| `ok` | `true` | Có |
| `messageId` | `chữ` | Có |

## Ví dụ trả về

```json
{
  "data": {
    "timings": {
      "startedAt": 1,
      "stages": {}
    },
    "ok": true,
    "messageId": "00000000-0000-4000-8000-000000000000"
  }
}
```

## Dùng qua MCP

Tool `messages_send` 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`.