> For the complete documentation index, see [llms.txt](https://docs.etelecom.vn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.etelecom.vn/tich-hop-api/zalo-cloud/zalo-cloud-api/lay-danh-sach-tin-nhan.md).

# 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>