Hàm lấy thông tin đánh giá của khách hàng

Lưu ý: Tối đa mỗi request giới hạn 50 đánh giá.

HTTP request

POST https://rest.esms.vn/MainService.svc/json/ZNS/GetRating/

• Content Type: application/json

• Response Type: application/json

curl --location 'https://rest.esms.vn/MainService.svc/json/ZNS/GetRating/' \
--header 'Content-Type: application/json' \
--data '{
    "ApiKey": "APIKEYCUABAN",
    "SecretKey": "SECRETKEYCUABAN",
    "OAID": "4097311281936189049",
    "TemplateID": "266986",
    "FromTime": "2024-07-28 00:00:00",
    "ToTime": "2024-07-30 23:59:59",
    "Offset": "0",
    "Limit": "50"
}'

• Cấu trúc body của request:

Tham số	Kiểu dữ liệu	Tính bắt buộc	Mô tả
ApiKey	string		ApiKey của tài khoản.
SecretKey	string		SecretKey của tài khoản.
OAID	string		Zalo OA ID, là ID của trang Zalo Offical Account của doanh nghiệp. Doanh nghiệp cần đăng nhập vào trang quản trị của Zalo OA để lấy phần Zalo OA ID này. Chú ý: sẽ phải đăng ký trước khi sử dụng.
TemplateID	string		Template của Zalo OA mà khách hàng đăng kí với eSMS.
FromTime	string		Thời gian bắt đầu lấy đánh giá. Định dạng: yyyy-mm-dd hh:mm:ss .
ToTime	string		Thời gian kết thúc lấy đánh giá. Định dạng: yyyy-mm-dd hh:mm:ss .
Offset	string		Vị trí thứ tự đánh giá đầu tiên trả về. Bắt đầu từ vị trí 0.
Limit	string		Số lượng đánh giá cần xem.

---

• Response:

100

{
    "CodeResult": "100",
    "ErrorMessage": "success",
    "Data": [
        {
            "feedbacks": [
                "Nhân viên tư vấn nhiệt tình, thái độ vui vẻ, dễ thương",
                "Chính sách hỗ trợ rõ ràng, đầy đủ và dễ hiểu",
                "Chất lượng sản phẩm rất tốt",
                "Giao hàng nhanh",
                "Dịch vụ chăm sóc rất tốt"
            ],
            "msgId": "5dcf84fe1fd8bd85e4ca",
            "note": "",
            "rate": 5,
            "submitDate": "1659750276218",
            "trackingId": ""
        }
    ],
    "Total": 1
}    

Request hợp lệ.

101

Cấu trúc body response:

Thuốc tính	Kiểu dữ liệu	Mô tả
CodeResult	string	Mã trả về
ErrorMessage	string	Thông tin lỗi trả về (nếu có lỗi)
Data	array	Chi tiết đánh giá.
Total	string	Tổng số lượt đánh giá.

Cấu trúc thuộc tính từng object trong Data

Thuốc tính	Kiểu dữ liệu	Mô tả
feedbacks	string	Tổng số tin được gửi trong ngày.
msgId	string	SmsId của zalo.
note	string	Ghi chút của khách hàng cho đánh giá.
rate	string	Số sao khách hàng đánh giá.
submitDate	string	submitDate: Thời điểm khách hàng submit đánh giá. Biến submitDate sẽ có giá trị trong khoảng thời gian từ from_time đến to_time (được truyền vào từ request). Lưu ý: Tính theo timestamp (millisecond).
trackingId	string	Là giá trị của tham số RequestId khách hàng truyền vào khi gửi tin Zalo.

• Thông tin chi tiết mã lỗi xem ở bảng: Mã lỗi .

• Lấy code mẫu các ngôn ngữ trên Postman: Link code mẫu.