# Lấy danh sách người dùng

{% 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/NU9hBvwVjJ0u1KZHFzaQ" path="$BASE\_URL.Zalo/ListFollowers" method="post" %}
[swagger (6).json](https://4211996220-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9CUTEBoYNqJaZqxNp3Eh%2Fuploads%2FM3MA0yrRz1uxyAN2jSKD%2Fswagger%20\(6\).json?alt=media\&token=7af53a27-477d-4477-b6ec-157336cbb25c)
{% endopenapi %}

**Request:**

```json
curl --location '$BASE_URL.Zalo/ListFollowers' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer $API_KEY' \
--data '{
  "filter": {
    "assigned_user_id": "string",
    "date_from": "2019-08-24T14:15:22Z",
    "date_to": "2019-08-24T14:15:22Z",
    "gender": "unknown",
    "has_conversation": true,
    "name": "string",
    "oa_id": "string",
    "phone": "string",
    "state": "follow",
    "tags": [
      "string"
    ],
    "zl_user_id": "string",
    "zl_user_ids": [
      "string"
    ]
  },
  "paging": {
    "after": "string",
    "before": "string",
    "limit": 0,
    "sort": "string"
  }
}'
```

**Response:**

```json
{
  "followers": [
    {
      "assigned_user_id": "string",
      "avatar": "string",
      "avatars": {
        "120": "string",
        "240": "string"
      },
      "created_at": "2019-08-24T14:15:22Z",
      "full_name": "string",
      "gender": "unknown",
      "has_conversation": true,
      "id": "string",
      "oa_id": "string",
      "phone": "string",
      "shared_info": {
        "address": "string",
        "city": "string",
        "district": "string",
        "name": "string",
        "phone": "string",
        "ward": "string"
      },
      "shop_id": "string",
      "state": "follow",
      "tags_and_notes_info": {
        "notes": [
          "string"
        ],
        "tag_names": [
          "string"
        ]
      },
      "updated_at": "2019-08-24T14:15:22Z",
      "zl_user_id": "string",
      "zl_user_id_by_app": "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="234.33333333333331">Tham số</th><th width="201">Kiểu dữ liệu</th><th>Mô tả</th></tr></thead><tbody><tr><td>assigned_user_id</td><td>string</td><td>ID nhân viên được gán</td></tr><tr><td>oa_id</td><td>int64</td><td>ID của OA</td></tr><tr><td>name</td><td>string</td><td>Tên người dùng Zalo</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>gender</td><td>string (pwGender) Enum</td><td>Giới tính<br><mark style="color:red;"><strong>"</strong><strong><code>unknown</code></strong><strong>" "</strong><strong><code>male</code></strong><strong>" "</strong><strong><code>female</code></strong><strong>" "</strong><strong><code>other</code></strong><strong>"</strong></mark></td></tr><tr><td>has_conversation</td><td>boolean</td><td><p><mark style="color:red;"><strong><code>True</code></strong></mark>: Có cuộc hội thoại</p><p><mark style="color:red;"><strong><code>False</code></strong></mark>: Không có cuộc hội thoại</p></td></tr><tr><td>phone</td><td>string</td><td>Số điện thoại người dùng</td></tr><tr><td>state</td><td>string (gqFollowState) Enum</td><td><p><mark style="color:red;"><strong><code>follow</code></strong></mark><strong>:</strong> Đã quan tâm</p><p><mark style="color:red;"><strong><code>unfollow</code></strong></mark><strong>:</strong> Chưa quan tâm</p></td></tr><tr><td>tags</td><td>Array of strings</td><td>Nhãn được gán cho người dùng</td></tr><tr><td>zl_user_id</td><td>string</td><td>ID người dùng Zalo</td></tr></tbody></table>

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

<table><thead><tr><th width="234.33333333333331">Tham số</th><th width="201">Kiểu dữ liệu</th><th>Mô tả</th></tr></thead><tbody><tr><td>assigned_user_id</td><td>string</td><td>ID nhân viên được gán</td></tr><tr><td>avatar</td><td>string</td><td>Ảnh đại diện người dùng</td></tr><tr><td>full_name</td><td>string</td><td>Tên người dùng</td></tr><tr><td>id</td><td>string</td><td>ID người dùng trên eTelecom</td></tr><tr><td>oa_id</td><td>int64</td><td>ID của OA</td></tr><tr><td>shared_info</td><td>object (mrSharedInfo)</td><td>Người dùng đồng ý chia sẻ thông tin</td></tr><tr><td>address</td><td>string</td><td>Địa chỉ</td></tr><tr><td>city</td><td>string</td><td>Thành phố</td></tr><tr><td>district</td><td>string</td><td>Quận, Huyện</td></tr><tr><td>ward</td><td>string</td><td>Phường</td></tr><tr><td>name</td><td>string</td><td>Tên người dùng Zalo</td></tr><tr><td>created_at</td><td>string&#x3C;date-time></td><td>Thời điểm ghi nhận tương tác</td></tr><tr><td>updated_at</td><td>string&#x3C;date-time></td><td>Thời điểm update</td></tr><tr><td>gender</td><td>string (pwGender) Enum</td><td>Giới tính<br><mark style="color:red;"><strong>"</strong><strong><code>unknown</code></strong><strong>" "</strong><strong><code>male</code></strong><strong>" "</strong><strong><code>female</code></strong><strong>" "</strong><strong><code>other</code></strong><strong>"</strong></mark></td></tr><tr><td>has_conversation</td><td>boolean</td><td><p><mark style="color:red;"><strong><code>True</code></strong></mark>: Có cuộc hội thoại</p><p><mark style="color:red;"><strong><code>False</code></strong></mark>: Không có cuộc hội thoại</p></td></tr><tr><td>phone</td><td>string</td><td>Số điện thoại người dùng</td></tr><tr><td>shop_id</td><td>string</td><td>ID shop trên eTelecom</td></tr><tr><td>state</td><td>string (gqFollowState) Enum</td><td><p><mark style="color:red;"><strong><code>follow</code></strong></mark><strong>:</strong> Đã quan tâm</p><p><mark style="color:red;"><strong><code>unfollow</code></strong></mark><strong>:</strong> Chưa quan tâm</p></td></tr><tr><td>tags</td><td>Array of strings</td><td>Nhãn được gán cho người dùng</td></tr><tr><td>zl_user_id</td><td>string</td><td>ID người dùng Zalo</td></tr><tr><td>zl_user_id_by_app</td><td>string</td><td>ID người dùng Zalo theo app</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-nguoi-dung.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.