---
sourceType: api-reference
sourceTypeMatchedRule: api-prefix
slug: BOT/apis/sendMessage
title: sendMessage
---
API cho phép Bot của bạn gửi tin nhắn văn bản đến người dùng hoặc các cuộc trò chuyện.


* **URL**: `https://bot-api.zaloplatforms.com/bot${BOT_TOKEN}/sendMessage`
* **Method**: POST
* **Response Type**: application/json

#### Sample code


### Code sample — Nodejs

```js
const axios = require('axios'); 

const entrypoint = `https://bot-api.zaloplatforms.com/bot${BOT_TOKEN}/sendMessage`;
const response = await axios.post(entrypoint, { chat_id: 'abc.xyz', text: 'Hello'});
```

### Code sample — cURL

```bash
curl -X POST "https://bot-api.zaloplatforms.com/bot<BOT_TOKEN>/sendMessage" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": "abc.xyz",
    "text": "Hello"
  }'
```


### Parameters


| Trường | Kiểu dữ liệu | Bắt buộc | Mô tả |
| --- | --- | --- | --- |
| `chat_id` | String | true | ID của người nhận hoặc cuộc trò chuyện |
| `text` | String | true | Nội dung văn bản của tin nhắn sẽ được gửi, với độ dài từ 1 đến 2000 ký tự|
| `parse_mode` | String | false | Cho phép server tự suy ra định dạng từ `text`. Nhận một trong hai giá trị: `markdown` hoặc `html`. Khi dùng `parse_mode`, các ký tự đánh dấu (markup) sẽ được loại bỏ khỏi nội dung hiển thị|
| `text_styles` | Array | false | Danh sách các đoạn định dạng (style run) áp dụng trực tiếp lên `text` ở dạng thô. Xem chi tiết bên dưới|

### Định dạng văn bản (Rich Text)

Bot có thể gửi tin nhắn có định dạng (in đậm, in nghiêng, màu sắc, danh sách...) bằng một trong hai cách: dùng `parse_mode` để server tự phân tích, hoặc dùng `text_styles` để chỉ định trực tiếp các đoạn định dạng.

:::info Thứ tự ưu tiên
Nếu cả `parse_mode` và `text_styles` cùng được gửi, **`parse_mode` sẽ được ưu tiên** và `text_styles` sẽ bị bỏ qua. Hai trường này dùng hệ tọa độ offset khác nhau (`parse_mode` tính trên văn bản đã loại bỏ markup, còn `text_styles` tính trên văn bản thô) nên không thể kết hợp đồng thời. Cả hai trường đều tùy chọn và tương thích ngược — nếu không gửi, tin nhắn sẽ được gửi dưới dạng văn bản thuần.
:::

#### Cách 1: dùng `parse_mode`

Đặt `parse_mode` là `markdown` hoặc `html` và viết nội dung định dạng trực tiếp trong trường `text`. Server sẽ phân tích, loại bỏ phần markup và tự sinh định dạng tương ứng.

### Code sample — Markdown

```js
await axios.post(entrypoint, {
  chat_id: 'abc.xyz',
  parse_mode: 'markdown',
  text: '**Xin chào** _bạn_, đây là ~~tin nhắn~~ tin nhắn có định dạng'
});
```

### Code sample — HTML

```js
await axios.post(entrypoint, {
  chat_id: 'abc.xyz',
  parse_mode: 'html',
  text: '<b>Xin chào</b> <i>bạn</i>, đây là <s>tin nhắn</s> tin nhắn có định dạng'
});
```

**Cú pháp Markdown được hỗ trợ:**

| Cú pháp | Kết quả |
| --- | --- |
| `**đậm**`, `__đậm__` | In đậm |
| `*nghiêng*`, `_nghiêng_` | In nghiêng |
| `***đậm nghiêng***` | In đậm + in nghiêng |
| `~~gạch ngang~~` | Gạch ngang |
| `` `code` `` | Giữ nguyên nội dung (không áp định dạng) |
| `# Tiêu đề` … `#### Tiêu đề` | In đậm (riêng `#` còn tăng cỡ chữ) |
| `- mục`, `* mục`, `+ mục` | Danh sách không thứ tự |
| `1. mục` | Danh sách có thứ tự |
| `> trích dẫn` | Thụt lề (mỗi cấp `>` là một mức) |
| khoảng trắng đầu dòng | Thụt lề (2 khoảng trắng = 1 mức) |
| `{red}…{/red}`, `{orange}…{/orange}`, `{yellow}…{/yellow}`, `{green}…{/green}` | Màu chữ |
| `{big}…{/big}` | Cỡ chữ lớn |
| `{underline}…{/underline}` | Gạch chân |
| `\*`, `\_`, … | Ký tự thoát (escape) để hiển thị nguyên ký tự đánh dấu |

**Thẻ HTML được hỗ trợ:**

| Thẻ | Kết quả |
| --- | --- |
| ``, `` | In đậm |
| ``, `` | In nghiêng |
| `` | Gạch chân |
| ``, ``, `` | Gạch ngang |
| ``–`` | In đậm (kèm tăng cỡ chữ với `h1`–`h4`) |
| `<ul>`, ``, `<li>` | Danh sách không thứ tự / có thứ tự |
| ``, `` | Khối văn bản (xuống dòng) |
| `style="..."` | `font-size`, `font-weight`, `font-style`, `text-decoration`, `color` (chỉ nhận các màu trong bảng màu được hỗ trợ) |

> Các thẻ HTML không nằm trong danh sách trên sẽ bị loại bỏ nhưng phần nội dung văn bản bên trong vẫn được giữ lại.

#### Cách 2: dùng `text_styles`

Gửi danh sách các đoạn định dạng áp trực tiếp lên `text`. Mỗi phần tử gồm:

| Trường | Kiểu dữ liệu | Mô tả |
| --- | --- | --- |
| `start` | Integer | Vị trí bắt đầu của đoạn, tính theo UTF-16 code unit (chỉ số chuỗi như trong JavaScript/Java) |
| `len` | Integer | Độ dài của đoạn (số UTF-16 code unit) |
| `st` | Array&lt;String&gt; | Danh sách các mã định dạng áp cho đoạn, ví dụ `["b", "c_db342e"]` |

```bash
curl -X POST "https://bot-api.zaloplatforms.com/bot<BOT_TOKEN>/sendMessage" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": "abc.xyz",
    "text": "Xin chào bạn",
    "text_styles": [
      { "start": 0, "len": 7, "st": ["b", "c_db342e"] }
    ]
  }'
```

**Bảng mã định dạng (`st`) được hỗ trợ:**

| Mã | Ý nghĩa |
| --- | --- |
| `b` | In đậm |
| `i` | In nghiêng |
| `u` | Gạch chân |
| `s` | Gạch ngang |
| `f_13`, `f_15`, `f_18`, `f_20` | Cỡ chữ (nhỏ / thường / lớn / rất lớn) |
| `c_050a19` | Màu mặc định |
| `c_15a85f` | Màu xanh lá |
| `c_f7b503` | Màu vàng |
| `c_f27806` | Màu cam |
| `c_db342e` | Màu đỏ |
| `lst_1` | Danh sách không thứ tự |
| `lst_2` | Danh sách có thứ tự |
| `ind_1` … `ind_5` | Mức thụt lề (1 đến 5) |

> Các mã không nằm trong danh sách trên sẽ bị bỏ qua, vì client chỉ hiển thị được tập mã đóng này. Các offset vượt ngoài phạm vi của `text` sẽ được tự điều chỉnh hoặc loại bỏ.

### Sample response

```json
{
  "ok": true,
  "result": {
    "message_id": "82599fa32f56d00e8941",
    "date": 1749632637199
  }
}
```