20. API get thống kê tin nhắn gửi ra của nhân viên theo từng ngày

1. API

Domain: https://apiring.antbuddy.com

GET /reports/omni/messages/sent-by-user-daily

2. Mô tả

Thống kê số lượng tin nhắn gửi ra theo từng nhân viên, gom theo từng ngày trong khoảng thời gian lọc.

3. Headers

• apikey (bắt buộc ): API key của API Ring.

4. Query Parameters

Tham số	Kiểu dữ liệu	Bắt buộc	Giải thích
startDate	String	Y	Thời gian bắt đầu, định dạng ISO date. Ví dụ: 2026-03-27T00:00:00.000Z
endDate	String	Y	Thời gian kết thúc, định dạng ISO date. Ví dụ: 2026-03-27T23:59:00.000Z
pageIds	string[]	Y	Danh sách pageId, ngăn cách bằng dấu phẩy. Ví dụ: ['123','456']
channel	string	N	Kênh lọc: FACEBOOK, INSTAGRAM, ZALO, WHATSAPP, ...
userIds	string[]	N	Danh sách userId, ngăn cách bằng dấu phẩy. Ví dụ: ['123','456']

5. Response — 200 OK

{
  "success": true,
  "totalSent": 30,
  "totalByDate": [
    { "date": "2026-03-20", "dateDisplay": "20/03/2026", "totalSent": 12 },
    { "date": "2026-03-21", "dateDisplay": "21/03/2026", "totalSent": 18 }
  ],
  "users": [
    {
      "user": {
        "_id": "67d8f7c81e8f98a1b2c3d4e5",
        "firstname": "An",
        "lastname": "Nguyen",
        "email": "[e-mail]",
        "avatar": "",
        "displayName": "An Nguyen"
      },
      "totalSent": 16,
      "byDate": [
        { "date": "2026-03-20", "dateDisplay": "20/03/2026", "totalSent": 7 },
        { "date": "2026-03-21", "dateDisplay": "21/03/2026", "totalSent": 9 }
      ]
    }
  ]
}

6. Mô tả các trường Response

• success — Boolean, true khi thành công.

• totalSent — Tổng số tin nhắn gửi ra trong khoảng thời gian.

• totalByDate — Mảng thống kê tổng tin nhắn theo từng ngày.

• users — Mảng thống kê theo từng nhân viên, chứa thông tin user và byDate.

7. Mã lỗi

Mã lỗi	Mô tả
400	Thiếu/sai tham số lọc (startDate, endDate, userIds không hợp lệ, không có page subscribe, ...).
500	Lỗi hệ thống.

8. Ví dụ cURL

Ví dụ cơ bản:

curl --request GET \
  'https://YOUR_DOMAIN/reports/omni/messages/sent-by-user-daily?startDate=2026-03-01T00:00:00.000Z&endDate=2026-03-27T23:59:59.999Z' \
  --header 'apikey: YOUR_API_KEY'

Ví dụ đầy đủ (có lọc pageIds, channel, userIds):

curl --request GET \
  'https://YOUR_DOMAIN/reports/omni/messages/sent-by-user-daily
   ?startDate=2026-03-01T00:00:00.000Z
   &endDate=2026-03-27T23:59:59.999Z
   &pageIds=123456789,987654321
   &channel=WHATSAPP
   &userIds=67d8f7c81e8f98a1b2c3d4e5,67d8f7c81e8f98a1b2c3d4e6' \
  --header 'apikey: YOUR_API_KEY'