# Lấy danh sách tin nhắn

{% hint style="info" %}
**Lưu ý:**

* Đối với các API sử dụng cho Shop thì API\_KEY: [`<api_key>`](https://docs.etelecom.vn/tich-hop-api/shop/tai-khoan#api-key). Thông tin base\_url của [Shop](https://docs.etelecom.vn/tich-hop-api/shop/tai-khoan)
* Đối với các API sử dụng cho Partner thì API\_KEY: [`<shop_key>`](https://docs.etelecom.vn/tich-hop-api/partner/su-dung#ket-noi-lan-thu-hai-tro-di). Thông tin base\_url của [Partner](https://docs.etelecom.vn/tich-hop-api/partner/tai-khoan)
  {% endhint %}

{% openapi src="/files/1QxLivzVFBPX8pAlPhwA" path="$BASE\_URL.Zalo/ListMessages" method="post" %}
[(17-03-2025)\_\_swagger.json](https://4211996220-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9CUTEBoYNqJaZqxNp3Eh%2Fuploads%2FzthdWLMHvrllgsOaS8RK%2F\(17-03-2025\)__swagger.json?alt=media\&token=481d60f5-faf7-4336-a959-e039343afb07)
{% endopenapi %}

**Request:**

```json
curl --location '$BASE_URL.Zalo/ListMessages' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer $API_KEY' \
--data '{
  "filter": {
   "date_from": "2023-08-02T14:15:22Z",
    "date_to": "2023-08-03T14:15:22Z"
      },
  "paging": {
    "limit": 50
  }
}'
```

**Response:**

```json
{
  "messages": [
    {
      "campaign_id": "string",
      "created_at": "2019-08-24T14:15:22Z",
      "delivery_status": "unknown",
      "delivery_time": "2019-08-24T14:15:22Z",
      "error_code": 0,
      "error_message": "string",
      "fee_main": 0,
      "fee_token": 0,
      "feedback": [
        "string"
      ],
      "id": "string",
      "is_charged": true,
      "is_development": true,
      "journey_id": "string",
      "msg_id": "string",
      "note": "string",
      "oa_id": "string",
      "phone": "string",
      "rate": 0,
      "sent_time": "2019-08-24T14:15:22Z",
      "shop_id": "string",
      "status": "Z",
      "submit_time": "2019-08-24T14:15:22Z",
      "template_data": {
        "property1": "string",
        "property2": "string"
      },
      "template_id": 0,
      "timeout": 0,
      "tracking_id": "string",
      "type": "unknown",
      "updated_at": "2019-08-24T14:15:22Z",
      "user_id": "string"
    }
  ],
  "paging": {
    "after": "string",
    "before": "string",
    "limit": 0,
    "next": "string",
    "prev": "string",
    "sort": "string"
  }
}
```

**Cấu trúc body của request**

<table><thead><tr><th width="142.33333333333331">Tham số</th><th width="173">Kiểu dữ liệu</th><th>Mô tả</th></tr></thead><tbody><tr><td>campaign_id</td><td>int64</td><td>ID của chiến dịch</td></tr><tr><td>oa_id</td><td>string</td><td>ID của OA</td></tr><tr><td>template_id</td><td>integer</td><td>ID của mẫu tin</td></tr><tr><td>journey_id</td><td>int64</td><td>ID của journey</td></tr><tr><td>msg_id</td><td>string</td><td>ID của thông báo ZNS</td></tr><tr><td>msg_type</td><td>string</td><td><p>Enum: </p><p><mark style="color:red;"><strong>"text":</strong></mark><strong> </strong><mark style="color:$info;"><strong>Tin dạng văn bản</strong></mark> </p><p><mark style="color:red;"><strong>"otp":</strong></mark><strong> </strong><mark style="color:$info;"><strong>Tin xác thực</strong></mark></p><p><mark style="color:red;"><strong>"table":</strong></mark><strong> </strong><mark style="color:$info;"><strong>Tin dạng bảng</strong></mark></p><p><mark style="color:red;"><strong>"rating":</strong></mark><strong> </strong><mark style="color:$info;"><strong>Tin đánh giá</strong></mark> <br><mark style="color:red;"><strong>"response button":</strong></mark><strong> </strong><mark style="color:$info;"><strong>Tin response button</strong></mark></p><p><mark style="color:red;"><strong>"payment_request":</strong></mark><strong> </strong><mark style="color:$info;"><strong>Tin yêu cầu thanh toán</strong></mark></p><p><mark style="color:red;"><strong>"voucher":</strong></mark><strong> </strong><mark style="color:$info;"><strong>Tin voucher</strong></mark></p><p><mark style="color:red;"><strong>"custom":</strong></mark><strong> </strong><mark style="color:$info;"><strong>Tin tinh chỉnh</strong></mark></p></td></tr><tr><td>is_development</td><td>boolean </td><td><p><mark style="color:red;"><strong><code>True</code></strong></mark>: Tin ZNS ở chế độ phát triển thử nghiệm</p><p><mark style="color:red;"><strong><code>False</code></strong></mark>: Tin ZNS không ở chế độ phát triển thử nghiệm</p></td></tr><tr><td>is_charged</td><td>bool</td><td>Tính phí hay không</td></tr><tr><td>delivery_status</td><td>string</td><td><mark style="color:red;"><strong>Enum: "unknown" "received" "seen"</strong></mark></td></tr><tr><td>phone</td><td>string</td><td>Số điện thoại người nhận</td></tr><tr><td>status</td><td>string</td><td>Trạng thái<br><mark style="color:red;"><strong><code>Z</code></strong></mark>: Mới tạo<br><mark style="color:red;"><strong><code>P</code></strong></mark>: Enable<br><mark style="color:red;"><strong><code>N</code></strong></mark>: Disable</td></tr><tr><td>date_from</td><td>string&#x3C;date-time></td><td>Ngày bắt đầu</td></tr><tr><td>date_to</td><td>string&#x3C;date-time></td><td>Ngày kết thúc</td></tr><tr><td>time_type</td><td>string (otTimeFilter)</td><td><p><mark style="color:red;"><strong><code>request_time</code></strong></mark>: Thời gian gửi tin</p><p><mark style="color:red;"><strong><code>updated_time</code></strong></mark>: Thời gian cập nhật của tin</p><p><mark style="color:red;"><strong><code>submit_time</code></strong></mark>: Thời gian cập nhật của tin đánh giá<br><strong>Lưu ý</strong>: Nếu tham số <code>time_type</code> không được truyền, mặc định<br> <code>time_type</code> <strong>=</strong> <code>updated_time</code></p></td></tr><tr><td>tracking_id</td><td>string</td><td>Mã số đánh dấu lần gọi API của bạn, do bạn định nghĩa. Bạn có thể dùng tracking_id để đối soát mà không phụ thuộc vào message_id của eTelecom cung cấp.</td></tr></tbody></table>

**Cấu trúc thuộc tính dữ liệu trả về**

<table><thead><tr><th width="136.33333333333331">Tham số</th><th width="160">Kiểu dữ liệu</th><th>Mô tả</th></tr></thead><tbody><tr><td>id</td><td>int64</td><td>ID tin nhắn trên hệ thống của eTelecom</td></tr><tr><td>shop_id</td><td>int64</td><td>ID cửa hàng trên hệ thống của eTelecom</td></tr><tr><td>user_id</td><td>int64</td><td>ID người gửi tin trên hệ thống của eTelecom</td></tr><tr><td>campaign_id</td><td>int64</td><td>ID của chiến dịch</td></tr><tr><td>delivery_status</td><td>string</td><td><p><mark style="color:red;"><strong><code>Unkown</code></strong></mark>: Không xác định</p><p><mark style="color:red;"><strong><code>Received</code></strong></mark>: Đã nhận <br><mark style="color:red;"><strong><code>Seen</code></strong></mark>: Đã xem </p></td></tr><tr><td>delivery_time</td><td>string&#x3C;date-time></td><td>Thời gian thiết bị của người dùng nhận được thông báo ZNS</td></tr><tr><td>error_code</td><td>int</td><td>Mã lỗi</td></tr><tr><td>error_message</td><td>string</td><td>Thông báo lỗi</td></tr><tr><td>fee_main</td><td>int</td><td>Phí chính</td></tr><tr><td>fee_token</td><td>int</td><td>Phí khởi tạo token</td></tr><tr><td>is_charged</td><td>boolean</td><td><p><mark style="color:red;"><strong><code>True</code></strong></mark>: Tin ZNS được tính phí</p><p><mark style="color:red;"><strong><code>False</code></strong></mark>: Tin ZNS không được tính phí</p></td></tr><tr><td>is_development</td><td>boolean</td><td><p><mark style="color:red;"><strong><code>True</code></strong></mark>: Tin ZNS ở chế độ phát triển thử nghiệm</p><p><mark style="color:red;"><strong><code>False</code></strong></mark>: Tin ZNS không ở chế độ phát triển thử nghiệm</p></td></tr><tr><td>journey_id</td><td>string</td><td>ID của journey</td></tr><tr><td>msg_id</td><td>string</td><td>ID của thông báo ZNS</td></tr><tr><td>type</td><td>string</td><td><p><mark style="color:red;"><strong><code>template</code></strong></mark>: ZNS thường</p><p><mark style="color:red;"><strong><code>journey</code></strong></mark>: ZNS  journey</p></td></tr><tr><td>status</td><td>string</td><td>Trạng thái<br><mark style="color:red;"><strong><code>Z</code></strong></mark>: Mới tạo<br><mark style="color:red;"><strong><code>P</code></strong></mark>: Enable<br><mark style="color:red;"><strong><code>N</code></strong></mark>: Disable</td></tr><tr><td>rate</td><td>integer</td><td>Số sao được khách hàng đánh giá</td></tr><tr><td>note</td><td>string</td><td>Phần ghi chú thêm của khách hàng</td></tr><tr><td>feedback</td><td>array</td><td>Phần nhận xét của khách hàng</td></tr><tr><td>submit_time</td><td>string&#x3C;date-time></td><td>Thời điểm khách hàng gửi đánh giá</td></tr><tr><td>template_data</td><td>object</td><td>Tham số tin nhắn</td></tr><tr><td>phone</td><td>string</td><td>Số điện thoại người nhận</td></tr><tr><td>sent_time</td><td>string&#x3C;date-time></td><td>Thời gian gửi thông báo ZNS</td></tr><tr><td>template_id</td><td>integer</td><td>ID của mẫu tin</td></tr><tr><td>timeout</td><td>integer</td><td>Thời gian tối đa mà hệ thống xử lý yêu cầu</td></tr><tr><td>tracking_id</td><td>string</td><td>Mã số đánh dấu lần gọi API của bạn, do bạn định nghĩa. Bạn có thể dùng tracking_id để đối soát mà không phụ thuộc vào message_id của eTelecom cung cấp.</td></tr><tr><td>updated_at</td><td>string&#x3C;date-time></td><td>Ngày cập nhật</td></tr><tr><td>created_at</td><td>string&#x3C;date-time></td><td>Ngày tạo</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.etelecom.vn/tich-hop-api/zalo-cloud/zalo-cloud-api/lay-danh-sach-tin-nhan.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.