Lấy danh sách nhóm OA đang quản lý

Lưu ý

Ứng dụng cần được cấp quyền quản lý thông tin nhóm.

HTTP request

• URL: https://openapi.zalo.me/v3.0/oa/group/getgroupsofoa
• Method: GET
• Response Type: text/json

Example request

curl --location --request GET 'https://openapi.zalo.me/v3.0/oa/group/getgroupsofoa' \
--header 'access_token: <your_access_token>'

Tham số header

Tham số	Kiểu dữ liệu	Tính bắt buộc	Mô tả
access_token	string	yes	Token cho phép ứng dụng đại diện OA gọi API. Xem chi tiết cách lấy access token tại đây.

Tham số

Tham số	Kiểu dữ liệu	Tính bắt buộc	Mô tả
offset	integer	optional	Offset muốn query. Mặc định: 0
count	integer	optional	Số lượng mong muốn query. Mặc định: 5

Example respond

{
    "data": {
                "offset": 0,
        "count": 5,
        "total": 2,
        "group_count": 2,
        "groups": [
            {
                "name": "Tư vấn nha khoa nhân viên",
                "avatar": "https://ava-grp-talk.zadn.vn/5/4/1/5/2/360/d0971a0b57485397b9f1542af4861f18.jpg",
                "group_id": "f414c8f76fa586fbdfb4",
                "group_link": "https://zalo.me/g/ikvhur409",
                "group_description": "Group tư vấn nha khoa cho các nhân viên",
                "total_member": 2,
                "status":"enabled", 
            },
            {
                "name": "b53",
                "avatar": "http://s120.ava.grp.talk.zdn.vn/default",
                "group_id": "aee702d6bc8455da0c95",
                "group_link": "https://zalo.me/g/ylegxq050",
                "group_description": "Group tư vấn nha khoa cho các nhân viên 2",
                "total_member": 2,
                "status":"enabled", 
            }
        ]
    },
    "error": 0,
    "message": "Success"
}

Cấu trúc thuộc tính data

Tham số	Kiểu dữ liệu	Mô tả
offset	integer	offset muốn query
count	integer	Số lượng muốn query
total	integer	Tổng số lượng các nhóm của OA
groups	array	Danh sách các nhóm của OA
member_count	integer	Số lượng các thành viên được trả về

Cấu trúc thuộc tính groups

Tham số	Kiểu dữ liệu	Mô tả
name	string	Tên nhóm
avatar	string	Hình đại diện của nhóm
group_id	string	ID của nhóm
group_link	string	Link để tham gia nhóm
group_description	string	Mô tả nhóm
total_member	integer	Tổng số lượng thành viên trong nhóm
status	string	Trạng thái nhóm: enabled: OA có thể quản lý và gửi tin nhắn trong nhóm disabled: OA không thể quản lý và không thể gửi tin nhắn trong nhóm