Đánh giá
Xem danh sách bài viết review
HTTP Request
URL: /v2/business-pages/{bpId}/social/reviews/get-list
Method: POST
Content Type: application/json
Response Type: application/json
Example Request
{
"reviewObjectType": 2,
"sourceProductIds": [
1342
],
"tagIds": [
],
"fromTime": 1736817676973,
"toTime": 1737117676973,
"size": 10
}
Mô tả example request
| Tham số | Kiểu dữ liệu | Mô tả | Bắt buộc | Giá trị mặc định (nếu có) |
| reviewObjectType | int | Loại đối tượng được đánh giá. Mặc định điền giá trị = 1 | true | |
| sourceProductIds | list long | Danh sách oaId cần lấy bài viết đánh giá | true | [] |
| ratings | list int | Dùng để tìm kiếm bài viết đánh giá theo thang điểm đánh giá. Các giá trị được chấp nhận: 1,2,3,4,5 | false | [] |
| points | list int | Bỏ qua dữ liệu này. | false | [] |
| tagIds | list long | Dùng để tìm kiếm bài viết theo thẻ | false | [] |
| toId | long | Cờ cursor để load danh sách review tiếp theo, lấy theo postId của bài viết đánh giá cuối trong danh sách được trả về | false | 0 |
| size | int | Số lượng bản ghi cần lấy trong 1 request (giá trị >0) | true | 10 |
| paid | boolean | Đã mua trên MoMo lấy các review đã mua hàng | false | false |
| unpaid | boolean | Dùng để lấy các bài viết đánh giá Chưa mua trên MoMo | false | false |
| fromExternalSource | boolean | lấy các review từ nguồn ngoài | false | false |
| fromTime | long | Thời gian bắt đầu trong khoảng thời gian muốn lấy các bài đánh giá | false | 0 |
| toTime | long | Thời gian kết thúc trong khoảng thời gian muốn lấy các bài đánh giá | false | 0 |
Example Response
{
"cmdId": "19501fb4-b152-4370-9696-4ac45dc89f2a",
"success": true,
"data": {
"reviewObjectType": 2,
"sourceProductIds": [
1342
],
"size": 10,
"fromTime": 1736817676973,
"toTime": 1737117676973,
"posts": [
{
"postId": 395312298453372,
"desc": "ahu hau nha hú hua hhg kaka hay ok cũng ổn được nha haha cười xỉu nhưng ko cười ok năm qua ta đã làm gì chưa làm gì cả",
"zoneType": 5,
"zoneId": 107054184414924,
"postType": 17,
"status": 2,
"createdTime": 1737019679672,
"updatedTime": 1737019686708,
"creatorId": "0900000000",
"likeCount": 4,
"likeReactionCount": 4,
"showCount": 5,
"clickCtaCount": 1,
"interactionCount": 9,
"imageUrls": [
"https://attachment-uat.momocdn.net/social/u/270834d8a35cf25b66b107c8c67ff0e03a6f4de733ea9476c90e2908b491d61b/a9c53b81-a217-4179-b03a-adc7fd063f0cf4moeggy.jpg"
],
"sharePostMetaData": {
},
"sharePostPreviewData": {
},
"ctaType": 3,
"ctaLabel": "Đặt vé",
"ctaRefId": "cinema_mini_select_film",
"ctaParams": "{\"idFilmMoMo\":1342}",
"ctaButton": "Bố Già",
"ctaDesc": "Hài, Chính Kịch, Gia Đình",
"ctaImageUrl": "https://cinema.momocdn.net/img/2962632b-9911-4974-8a5a-301da8f944d8-2175169224865465.jpg",
"ctaCustomize": true,
"creatorName": "Tu Anh",
"tagIds": [
109976067944848
],
"tagsV2": [
{
"tagId": 109976067944848,
"keyword": "Ngon",
"status": 2,
"createdBy": 2,
"authorId": "df9fb526-f868-4d5b-81e0-a198d32587a0",
"reveal": 1,
"createdTime": 1678101622010,
"updatedTime": 1678101622010,
"buttonUIClassName": "GBUC_DEFAULT"
}
],
"point": 10,
"productId": 562949953422654,
"productName": "Bố Già",
"productDesc": "Hài, Chính Kịch, Gia Đình",
"paid": true,
"groupId": 110055248434011,
"typeId": 110055274864789,
"albumType": 1,
"extraImg": "{\"statsImg\":[{\"url\":\"https://attachment-uat.momocdn.net/social/u/270834d8a35cf25b66b107c8c67ff0e03a6f4de733ea9476c90e2908b491d61b/a9c53b81-a217-4179-b03a-adc7fd063f0cf4moeggy.jpg\",\"widthImg\":768,\"heightImg\":1024}]}",
"reviewRatingMethod": 1,
"reviewObjectType": 2,
"sourceProductId": 1342,
"viewCount": 53,
"fine": true,
"activityText": "đánh giá",
"mentionMode": 1,
"privacyLevel": 1,
"reviewObjectId": 1342
},
{
"postId": 395312167142141,
"desc": "giờ là lúc nhìn lại xem một năm vừa trải qua buồn vui thế nào có giận hờn có thứ tha hài lòng hay thất vọng trưởng thành hơn hay vẫn ngây ngô như lúc ban đầu dù là như thế nào",
"zoneType": 5,
"zoneId": 107054184414924,
"postType": 17,
"status": 2,
"createdTime": 1737017676973,
"updatedTime": 1737017733116,
"creatorId": "0900000000",
"likeCount": 4,
"likeReactionCount": 4,
"showCount": 11,
"clickCtaCount": 1,
"interactionCount": 15,
"imageUrls": [
"https://attachment-uat.momocdn.net/social/u/f195c9ab7882574a31b8977cc2ee3de638e80014327c5504e5668375f801a191/3692c531-b4b7-45bf-b413-336810badfd8xf6mglzo.jpg"
],
"sharePostMetaData": {
},
"sharePostPreviewData": {
},
"ctaType": 3,
"ctaLabel": "Đặt vé",
"ctaRefId": "cinema\_mini\_select\_film",
"ctaParams": "{\"idFilmMoMo\":1342}",
"ctaButton": "Bố Già",
"ctaDesc": "Hài, Chính Kịch, Gia Đình",
"ctaImageUrl": "https://cinema.momocdn.net/img/2962632b-9911-4974-8a5a-301da8f944d8-2175169224865465.jpg",
"ctaCustomize": true,
"creatorName": "Nguyễn Ngọc Anh Vũ",
"point": 10,
"productId": 562949953422654,
"productName": "Bố Già",
"productDesc": "Hài, Chính Kịch, Gia Đình",
"paid": true,
"groupId": 107054184414924,
"typeId": 110055274864789,
"albumType": 1,
"extraImg": "{\"statsImg\":[{\"url\":\"https://attachment-uat.momocdn.net/social/u/f195c9ab7882574a31b8977cc2ee3de638e80014327c5504e5668375f801a191/3692c531-b4b7-45bf-b413-336810badfd8xf6mglzo.jpg\",\"widthImg\":768,\"heightImg\":1024}]}",
"reviewRatingMethod": 1,
"reviewObjectType": 2,
"sourceProductId": 1342,
"viewCount": 98,
"fine": true,
"activityText": "đánh giá",
"mentionMode": 1,
"privacyLevel": 1,
"reviewObjectId": 1342
}
],
"_class": "mservice.social.feedv2.mention.api.messages.GetProductFeedMsg"
}
}
Mô tả example response
| Tham số | Kiểu dữ liệu | Mô tả |
| postId | long | Mã định danh của bài viết |
| title | string | Dùng để quản lý, không hiển thị cho user trong bài viết |
| desc | string | Nội dung của bài viết được đăng tải. |
| createdTime | long | Thời gian tạo bài viết, theo millisecond |
| creatorName | string | Tên của người tạo bài viết |
| likeCount | int | Số lượng thích bài viết |
| commentCount | int | Số lượng bình luận bài viết |
| shareCount | int | Số lượng lượt chia sẻ bài viết |
| viewCount | int | Số lượng lượt xem trên 3s của bài viết |
| clickCtaCount | int | Số lượng lượt click CTA của bài viết |
| interactionCount | int | Tổng lượt tương tác = likeCount + commentCount + shareCount + viewCount +clickCtaCount |
| imageUrls | String array | Đường dẫn CDN ảnh bài viết |
| tagsV2 | Json array | Thông tin các thẻ được gắn vào bài viết |
| paid | boolean | Trạng thái mua hàng của sản phẩm: * Nếu = true: Đã mua trên MoMo |
| rating | Int | Số điểm đánh giá bài viết. Giá trị từ 1 -> 5 tương ứng 1 sao -> 5 sao |
| ctaType | int | Là thể loại đường dẫn của nút CTA, với các loại tương ứng 1 = CTA dẫn đến 1 đường dẫn web 2 = CTA dẫn đến 1 MiniApp 3 = CTA dẫn đến 1 web trong app |
| ctaLabel | String | Là nội dung nút tương ứng. Chỉ sử dụng khi ctaCustomize = true. |
| ctaRefId | string | Là đường dẫn từ CTA tương ứng với nội dung; dùng khi ctaType = 3 |
| ctaParams | string | Là param bổ sung cho refID tương ứng; dùng khi ctaType = 3 |
| ctaButton | string | Là tiêu đề CTA để hiển thị lên nội dung CTA |
| ctaDesc | string | Là mô tả CTA để hiển thị lên nội dung CTA |
| ctaImageUrl | string | * Là hình ảnh icon trong nút CTA (dành cho CTA customize) |
| ctaCustomize | boolean | Là thông tin xác định xem nút CTA tùy chỉnh hay dùng giao diện mặc định: - Chỉnh theo các thông tin nhập (label, description...) - Dùng giao diện mặc định |
| ctaHighlight | boolean | Là thông tin xác định nút CTA có highlight sau khi user xem bài viết nhiều hơn 3 giây |
| actionUrls | String array | Là weblink/ deeplink để điều hướng CTA đến màn hình đích. Đường dẫn sẽ tương ứng với ctaType được lựa chọn. |
| zoneType | int | Là loại bài viết hiển thị trên bảng tin MoMo. 1: Bài viết BP 5: Bài viết review |
Cấu trúc data của thẻ trong bài viết
| Tham số | Kiểu dữ liệu | Mô tả |
| tagId | long | Mã định danh của thẻ |
| keyword | string | Tên của thẻ tương ứng |
Xem chi tiết bài viết review
HTTP Request
Lưu ý: API cũng được sử dụng để Xem chi tiết bài viết review.
URL: /v2/business-pages/{bpId}/social/reviews/get-detail
Method: POST
Content Type: application/json
Response Type: application/json
Example Request
{
"postIds": [ 392571544453146 ]
}
Example Response
{
"cmdId": "519072e4-4c07-4f83-a7fc-bb3ab29e1b14",
"success": true,
"data": {
"postIds": [
392571544453146
],
"posts": [
{
"postId": 392571544453146,
"desc": "oke nè",
"zoneType": 5,
"zoneId": 107054566841665,
"postType": 17,
"status": 2,
"createdTime": 1695199092319,
"updatedTime": 1695199130961,
"likeCount": 1,
"likeReactionCount": 1,
"shareCount": 1,
"showCount": 6,
"clickCtaCount": 3,
"interactionCount": 8,
"imageUrls": [
"https://attachment-dev.momocdn.net/social/u/789b7ee0825253478b485146ef0fb4f98649c43ef07079f26d5172a95d94d251/ec364baa-8b04-46d0-afe5-a88efcda7ce02q\_wf9ro.jpg"
],
"sharePostMetaData": {
},
"sharePostPreviewData": {
},
"creatorName": "NGUYEN THI LAP LANH ANH SAO MAI",
"tagIds": [
109918999201396,
109918993224689,
110552797578332,
109877775757634
],
"tagsV2": [
{
"tagId": 109918999201396,
"keyword": "Phục vụ tốt",
"status": 2,
"createdBy": 2,
"authorId": "df9fb526-f868-4d5b-81e0-a198d32587a0",
"reveal": 1,
"createdTime": 1677230822804,
"updatedTime": 1677230827615,
"buttonUIClassName": "GBUC_DEFAULT"
},
{
"tagId": 109918993224689,
"keyword": "Sạch sẽ",
"status": 2,
"createdBy": 2,
"authorId": "df9fb526-f868-4d5b-81e0-a198d32587a0",
"reveal": 1,
"createdTime": 1677230731494,
"updatedTime": 1677230831645,
"buttonUIClassName": "GBUC_DEFAULT"
},
{
"tagId": 110552797578332,
"keyword": "Được duyệt hình ảnh",
"description": "Tag nội bộ gắn cho các bài post Q&A kđược API duyệt hình ảnh",
"status": 2,
"createdBy": 2,
"authorId": "df9fb526-f868-4d5b-81e0-a198d32587a0",
"reveal": 2,
"createdTime": 1686901818949,
"updatedTime": 1686901823559,
"buttonUIClassName": "GBUC_DEFAULT"
},
{
"tagId": 109877775757634,
"keyword": "Được AI duyệt review",
"status": 2,
"createdBy": 2,
"authorId": "df9fb526-f868-4d5b-81e0-a198d32587a0",
"reveal": 2,
"createdTime": 1676601802727,
"updatedTime": 1676601844382,
"buttonUIClassName": "GBUC_DEFAULT"
}
],
"rating": 5,
"productId": 281474976715047,
"productName": "Phúc Long 22 team hay test",
"productDesc": "C̵h̵à̵o̵ ̵c̵á̵c̵ ̵c̵h̵u̵ỗ̵i̵ ̵v̵ă̵n̵ ̵b̵ả̵n̵ ̵-̵ ̵n̵g̵ư̵ờ̵i̵ ̵b̵ạ̵n̵ ̵c̵ũ̵ ̵c̵ủ̵a̵ ̵t̵ô̵i̵!̵ b̸ă̸m̸ ̸k̸h̸ô̸n̸g̸ ̸m̸ấ̸y̸ ̸b̸ạ̸n̸🅱ă🅼 🅺🅷ô🅽🅶 🅼ấ🆈 🅱ạ🅽băm👏🏿 không👏🏿 mấy👏🏿 bạn𝖇𝖆̆𝖒 𝖐𝖍𝖔̂𝖓𝖌 𝖒𝖆̂́𝖞 𝖇𝖆̣𝖓𝖇𝖆̆𝖒 𝖐𝖍𝖔̂𝖓𝖌 𝖒𝖆̂́𝖞 𝖇",
"attributes": [
"3 Khách, Có nhà vệ sinh lộ thiên"
],
"groupId": 109866644059402,
"typeId": 109866650012848,
"albumType": 1,
"extraImg": "{\"statsImg\":[{\"url\":\"https://attachment-dev.momocdn.net/social/u/789b7ee0825253478b485146ef0fb4f98649c43ef07079f26d5172a95d94d251/ec364baa-8b04-46d0-afe5-a88efcda7ce02q\_wf9ro.jpg\",\"widthImg\":768,\"heightImg\":1024}]}",
"reviewObjectType": 1,
"sourceProductId": 4391,
"viewCount": 12,
}
],
"tags": [
{
"tagId": 109918993224689,
"keyword": "Sạch sẽ",
"status": 2,
"createdBy": 2,
"authorId": "df9fb526-f868-4d5b-81e0-a198d32587a0",
"reveal": 1,
"createdTime": 1677230731494,
"updatedTime": 1677230831645,
"buttonUIClassName": "GBUC_DEFAULT"
},
{
"tagId": 109877775757634,
"keyword": "Được AI duyệt review",
"status": 2,
"createdBy": 2,
"authorId": "df9fb526-f868-4d5b-81e0-a198d32587a0",
"reveal": 2,
"createdTime": 1676601802727,
"updatedTime": 1676601844382,
"buttonUIClassName": "GBUC_DEFAULT"
},
{
"tagId": 109918999201396,
"keyword": "Phục vụ tốt",
"status": 2,
"createdBy": 2,
"authorId": "df9fb526-f868-4d5b-81e0-a198d32587a0",
"reveal": 1,
"createdTime": 1677230822804,
"updatedTime": 1677230827615,
"buttonUIClassName": "GBUC_DEFAULT"
},
{
"tagId": 110552797578332,
"keyword": "Được duyệt hình ảnh",
"description": "Tag nội bộ gắn cho các bài post Q&A kđược API duyệt hình ảnh",
"status": 2,
"createdBy": 2,
"authorId": "df9fb526-f868-4d5b-81e0-a198d32587a0",
"reveal": 2,
"createdTime": 1686901818949,
"updatedTime": 1686901823559,
"buttonUIClassName": "GBUC_DEFAULT"
}
],
"_class": "mservice.social.feedv2.mention.api.messages.MultiGetPostMsg"
}
}
Mô tả example response
| Tham số | Kiểu dữ liệu | Mô tả |
| postId | long | Mã định danh của bài viết |
| title | string | Dùng để quản lý, không hiển thị cho user trong bài viết |
| desc | string | Nội dung của bài viết được đăng tải. |
| createdTime | long | Thời gian tạo bài viết, theo millisecond |
| creatorName | string | Tên của người tạo bài viết |
| likeCount | int | Số lượng thích bài viết |
| commentCount | int | Số lượng bình luận bài viết |
| shareCount | int | Số lượng lượt chia sẻ bài viết |
| viewCount | int | Số lượng lượt xem trên 3s của bài viết |
| clickCtaCount | int | Số lượng lượt click CTA của bài viết |
| interactionCount | int | Tổng lượt tương tác = likeCount + commentCount + shareCount + viewCount +clickCtaCount |
| imageUrls | String array | Đường dẫn CDN ảnh bài viết |
| tagsV2 | Json array | Thông tin các thẻ được gắn vào bài viết |
| paid | boolean | Trạng thái mua hàng của sản phẩm: Nếu = true: Đã mua trên MoMo |
| rating | Int | Số điểm đánh giá bài viết. Giá trị từ 1 -> 5 tương ứng 1 sao -> 5 sao |
| ctaType | int | Là thể loại đường dẫn của nút CTA, với các loại tương ứng 1 = CTA dẫn đến 1 đường dẫn web 2 = CTA dẫn đến 1 MiniApp 3 = CTA dẫn đến 1 web trong app |
| ctaRefId | string | Là đường dẫn từ CTA tương ứng với nội dung; dùng khi ctaType = 3 |
| ctaParams | string | Là param bổ sung cho refID tương ứng; dùng khi ctaType = 3 |
| ctaButton | string | Là tiêu đề CTA để hiển thị lên nội dung CTA |
| ctaDesc | string | Là mô tả CTA để hiển thị lên nội dung CTA |
| ctaImageUrl | string | Là hình ảnh icon trong nút CTA (dành cho CTA customize) |
| ctaCustomize | boolean | Là thông tin xác định xem nút CTA tùy chỉnh hay dùng giao diện mặc định: - Chỉnh theo các thông tin nhập (label, description...) - Dùng giao diện mặc định |
| ctaHighlight | boolean | Là thông tin xác định nút CTA có highlight sau khi user xem bài viết nhiều hơn 3 giây |
| actionUrls | String array | Là weblink/ deeplink để điều hướng CTA đến màn hình đích. Đường dẫn sẽ tương ứng với ctaType được lựa chọn. |
| zoneType | int | Là loại bài viết hiển thị trên bảng tin MoMo. 1: Bài viết BP 5: Bài viết review |
Cấu trúc data của thẻ trong bài viết
| Tham số | Kiểu dữ liệu | Mô tả |
| tagId | long | Mã định danh của thẻ |
| keyword | string | Tên của thẻ tương ứng |
Xem danh sách comment của 1 bài viết review; hoặc danh sách phản hồi của 1 comment
Tương tự như Xem danh sách comment của 1 bài viết BP.
Thêm bình luận và phản hồi trên bài viết review
Tương tự như Thêm bình luận và phản hồi trên bài viết BP.
3. Danh sách bình luận của người dùng
HTTP Request
URL: /v2/business-pages/{bpId}/social/reviews/get-comment-zone
Method: POST
Content Type: application/json
Response Type: application/json
Example Request
{
"size": 50,
"oaIds": [
1252
],
"zoneTypes": [
1
],
"statuses": [
1
],
"fromId": 112795555736731,
"fromTime": 1692525540000,
"toTime": 1724147940000,
"showReply": true
}
Mô tả example request
| Tham số | Kiểu dữ liệu | Mô tả | Bắt buộc | Giá trị mặc định (nếu có) |
| size | int | Kích thước của danh sách comment trả về, giá trị: < 51 | true | |
| oaIds | list long | Danh sách các oaId cần lấy bình luận của user. | true | |
| zoneTypes | list int | Dùng để tìm kiếm bình luận của người dùng theo zoneType của bài viết trong cộng đồng của oaId tương ứng. zoneType = 1: bài viết BP zoneType = 3: bài viết của người dùng zoneType = 5: bài viết review | true | |
| statuses | list int | Dùng để tìm kiếm bình luận của người dùng theo trạng thái của bình luận. status = 1: hiển thị status = 3: đã xóa | false | |
| fromId | long | Cờ cursor để load danh sách comment tiếp theo, lấy theo commentId của bình luận cuối cùng trong danh sách được trả về trước đó, giá trị = 0 để lấy danh sách bình luận lần đầu tiên. | false | |
| fromTime | long | thời gian bắt đầu để tìm kiếm bình luận theo khoảng, nếu có giá trị sẽ phải đi kèm với toTime cũng phải có giá trị (fromTime < toTime). Nếu fromId lớn hơn 0 thì bỏ qua trường này. | false | |
| toTime | long | thời gian kết thúc để tìm kiếm bình luận theo khoảng, nếu có giá trị sẽ phải đi kèm với fromTime cũng phải có giá trị (toTime > fromTime). Nếu fromId lớn hơn 0 thì bỏ qua trường này. | false | |
| showReply | boolean | giá trị = true trong danh sách trả về sẽ lấy thêm cả các bình luận mà các bình luận này là bình luận đã trả lời các bình luận khác | false | false |
| onlyReply | boolean | giá trị = true trong danh sách trả danh sách các bình luận là bình luận trả lời các bình luận khác | false | false |
| fromAdmin | boolean | giá trị = true trong danh sách trả danh sách các bình luận là bình luận của merchant oa | false | false |
Example Response
{
"cmdId": "ca3a76db-5e22-4144-9cb9-d36586d2579d",
"success": true,
"data": {
"size": 2,
"oaIds": [
1252
],
"zoneTypes": [
1
],
"statuses": [
1
],
"showReply": true,
"fromTime": 1692525540000,
"toTime": 1724147940000,
"fromId": 112795555736731,
"comments": [
{
"commentId": 112795523787302,
"message": "<user name=\"NGUYỄN THỦY TIÊN\" socialAgentId=\"c80d3d006c1b6e00f0326d9e53465c34\">@NGUYỄN THỦY TIÊN</user> hâhhha",
"extra": "",
"creatorId": "0900000000",
"creatorName": "Tú Anh",
"postId": 108328730781378,
"parentId": 109103967249042,
"zoneType": 1,
"zoneId": 107059573304974,
"likeCount": 0,
"replyCount": 0,
"createdTime": 1721123104040,
"updatedTime": 1721187660056,
"status": 1,
"avatarUrl": "https://avatar-dev.momocdn.net/avatar\_test/bb6b/6e8ec34dc94d5ff21ab433765333752298ed06d6d4051726e2cb3cd61dbf.png",
"likeReactionCount": 0,
"hahaReactionCount": 0,
"wowReactionCount": 0,
"sadReactionCount": 0,
"loveReactionCount": 0,
"angryReactionCount": 0,
"fromMerchantOA": false,
"merchantOAId": 0,
"merchantOAName": "",
"merchantOAAvatar": "",
"agentId": 0,
"previewDeepLinkUrl": "",
"previewDeepLinkImgUrl": "",
"previewDeepLinkTitle": "",
"previewDeepLinkDesc": "",
"additionalButtons": [
],
"previewDeepLinkObjectType": 0,
"previewDeepLinkObjectId": 0,
"fromAdmin": false,
"fromAdminRole": 0,
"fromAdminPageId": 0,
"fromAdminUserId": "",
"imageUrls": [
],
"extraImage": "\"\"",
"sticker": "",
"stickerUrls": [
],
"adminReplied": false,
"socialAgentId": "ef8df3bcc5bfe6cb3dc4c2563aee22fc"
},
{
"commentId": 112795521176792,
"message": "<page pageId=\"107059573304974\">@Heo Đất MoMo</page> ơi",
"extra": "",
"creatorId": "0900000000",
"creatorName": "Nguyễn Văn A",
"postId": 108328730781378,
"parentId": 109103967249042,
"zoneType": 1,
"zoneId": 107059573304974,
"likeCount": 0,
"replyCount": 0,
"createdTime": 1721123064047,
"updatedTime": 1721187660056,
"status": 1,
"avatarUrl": "https://avatar-dev.momocdn.net/avatar\_test/b0cd/75b432dc363b53ecbc0343c1386268be86816dd47933f6161d3ac89ce85c.png",
"likeReactionCount": 0,
"hahaReactionCount": 0,
"wowReactionCount": 0,
"sadReactionCount": 0,
"loveReactionCount": 0,
"angryReactionCount": 0,
"fromMerchantOA": false,
"merchantOAId": 0,
"merchantOAName": "",
"merchantOAAvatar": "",
"agentId": 0,
"previewDeepLinkUrl": "",
"previewDeepLinkImgUrl": "",
"previewDeepLinkTitle": "",
"previewDeepLinkDesc": "",
"additionalButtons": [
],
"previewDeepLinkObjectType": 0,
"previewDeepLinkObjectId": 0,
"commentCtaButtons": [
{
"ctaType": 3,
"ctaLabel": "Heo đất",
"ctaRefId": "transfer\_p2p",
"ctaParams": "{\"contacts\":[{\"name\":\"Nguyễn Văn A\",\"number\":\"\*\*\*\*\*\*\*233\",\"agentId\":42014367,\"avatarUrl\":\"https://avatar-dev.momocdn.net/avatar\_test/b0cd/75b432dc363b53ecbc0343c1386268be86816dd47933f6161d3ac89ce85c.png\",\"receiverType\":14}],\"serviceId\":\"transfer\_masking\",\"source\":\"vn.momo.newsfeed\",\"transferSource\":\"vn.momo.newsfeed\"}"
}
],
"fromAdmin": false,
"fromAdminRole": 0,
"fromAdminPageId": 0,
"fromAdminUserId": "",
"imageUrls": [
],
"extraImage": "\"\"",
"sticker": "",
"stickerUrls": [
],
"adminReplied": false,
"socialAgentId": "88281b2d5603d11144bd005544140aaa"
}
],
"totalComments": 5958,
"_class": "mservice.social.feedv2.mention.api.messages.oa.GetListZoneUserCommentMsg"
}
}
Mô tả example response
| Tham số | Kiểu dữ liệu | Mô tả |
| size | int | Kích thước của danh sách bình luận trả về. |
| oaIds | list long | Danh sách các oaId cần lấy các bình luận của người dùng |
| zoneTypes | list long | Loại bài viết hiển thị trên bảng tin Momo. 1: bài viết BP 2: bài viết của người dùng |
| statuses | list int | Trạng thái của bình luận. 1: hiển thị 3: đã xóa |
| show reply | boolean | Giá trị dùng để quyết định có trả về các bình luận là các bình luận đã trả lời bình luận khác hay không. |
| fromTime | long | Thời gian bắt đầu để tìm kiếm bình luận theo khoảng. |
| toTime | long | Thời gian kết thúc để tìm kiếm bình luận theo khoảng. |
| fromId | long | Cờ cursor để lấy danh sách bình luận tiếp theo. |
| comments | list | Danh sách kết quả bình luận được trả về. |
| commentId | long | Mã định danh của bình luận. |
| message | string | Text do người dùng viết hiển thị ở bình luận. |
| creatorName | string | Tên của người viết bình luận. |
| postId | long | Mã định danh của bài viết mà người dùng bình luận. |
| parentId | long | Mã định danh của bình luận mà bình luận này trả lời. |
| status | int | Trạng thái của bình luận. |
| avatarUrl | string | Hình ảnh đại diện của người tạo bình luận. |
| likeReactionCount | int | Số lượng like của bình luận. |
| hahaReactionCount | int | Số lượng haha reaction của bình luận. |
| wowReactionCount | int | Số lượng wow reaction của bình luận. |
| sadReactionCount | int | Số lượng sad reaction của bình luận. |
| loveReactionCount | int | Số lương love reaction của bình luận. |
| angryReactionCount | int | Số lượng angry reaction của bình luận. |
| sticker | string | Tên của sticker được gắn trong bình luận. |
| stickerUrls | list string | Hình ảnh của sticker được gắn trong bình luận. |
| adminReplied | boolean | Đã được admin trả lời bình luận chưa. |
| totalComments | long | Tổng số comment của tất cả các bài viết đang được public của BP |
Xem số liệu bình luận theo BP
HTTP Request
URL: /v2/business-pages/{bpId}/social/reviews/get-list-comment-zone
Method: POST
Content Type: application/json
Response Type: application/json
Example Request
{
"creatorOAId": "134406",
"postId": 113621550538345
}
Mô tả example request
| Tham số | Kiểu dữ liệu | Mô tả | Bắt buộc | Giá trị mặc định (nếu có) |
| creatorOAId | String | Id của merchant | true | |
| postId | long | Id của bài viết | true |
Example Response
{
"cmdId": "a94c552d-d3a6-4b73-9661-2ca4699f576d",
"user": "0972365207",
"success": true,
"data": {
"creatorOAId": "134406",
"postId": 113621550538345,
"replyCount": 2,
"commentCount": 3,
"_class": "mservice.social.feedv2.api.messages.GetListCommentByOAMsg"
}
}
Lấy dữ liệu review (có filter đã thanh toán MoMo)
HTTP Request
URL: /v2/business-pages/{bpId}/social/reviews/get-list-by_conditional
Method: POST
Content Type: application/json
Response Type: application/json
Example Request
{
"paid": true,
"typeId": 110055274864789,
"sourceIds": [
],
"reviewObjectIds": [
961
],
"points": [
10
],
"ratings": [
]
}
Mô tả example request
| Tham số | Kiểu dữ liệu | Mô tả | Bắt buộc | Giá trị mặc định |
| paid | boolean | trạng thái thanh toán của bài review | false | false |
| typeId | long | loại sản phẩm , dùng để xác định loại sản phẩm được review VD: 110055274864789 (film) | true | |
| sourceIds | string array | mã định danh của các sản phẩm | false | |
| reviewObjectIds | long array | mã định danh của các sản phẩm | false | |
| points | Int array | filter dữ liệu theo từng mức điểm đánh giá, áp dụng cho thang điểm 10 (VD: film) | false | [1,2,3,...,10] |
| ratings | Int array | filter dữ liệu theo từng mức điểm đánh giá, áp dụng cho thang điểm 5 (VD: OA) | false | [1,2,3,4,5] |
Note: mặc dù 2 params sourceIds và reviewObjectIds required false nhưng chỉ áp dụng cho trường hợp 1 trong 2 field này có dữ liệu, nếu cả 2 đều trống sẽ trả về lỗi. VD: sourceIds: [“example”], reviewObjectId: [] hoặc ngược lại.
Example Response
{
"cmdId": "b418d4fa-f692-49fc-a768-c0de0b1878f6",
"success": true,
"data": {
"paid": true,
"typeId": 110055274864789,
"points": [
10
],
"reviewObjectIds": [
961
],
"entries": [
{
"reviewObjectId": 961,
"productId": 562949953422273,
"tenPointCount": 15,
"reviewCount": 15,
"avgPoint": 10.0
}
],
"_class": "mservice.social.feedv2.mention.api.messages.review.CountReviewGroupByCondMsg"
}
}
Mô tả example response
| Tham số | Kiểu dữ liệu | Mô tả |
|---|---|---|
| entries | jsonarray | danh sách các product kèm với rating/point count tương ứng. |
| reviewObjectId | long | mã định danh sản phẩm |
| tenPointCount | int | số lượng bài review đã được lọc theo điều kiện truyền vào, VD: points: [10] -> tenPointCount |
| reviewCount | int | tổng số bài review đã được lọc theo điều kiện truyền vào |
| avgPoint | double | điểm point trung bình dựa trên tổng số point (với sản phẩm đánh giá điểm thang 10) trên tổng số bài viết được trả về trong response |
Lấy dữ liệu review (không filter đã thanh toán MoMo)
HTTP Request
URL: /v2/business-pages/{bpId}/social/reviews/get-list-by-no-paid-conditional
Method: POST
Content Type: application/json
Response Type: application/json
Example Request
{
"reviewObjectType": 2,
"reviewObjectIds": [
961
]
}
Mô tả example request
| Tham số | Kiểu dữ liệu | Mô tả | Bắt buộc | Giá trị mặc định |
| reviewObjectType | int | mã định danh của nhóm sản phẩm enum GrpcReviewObjectType REVIEW_BASE = 0 REVIEW_OA = 1 REVIEW_FILM = 2; REVIEW_BUS = 3; REVIEW_ATTRACTION = 4; REVIEW_STOCK = 5; REVIEW_SKU = 6; REVIEW_MSERVICE_GIFT = 7 | false | |
| reviewObjectIds | long array | mã định danh của các sản phẩm | false | |
| sourceIds | string array | mã định danh của các sản phẩm | false |
Example Response
{
"cmdId": "670a70dc-acb9-4102-ac32-3be4b4936df8",
"success": true,
"data": {
"reviewObjectType": 2,
"reviewObjectIds": [
961
],
"extendDataList": [
{
"reviewObjectId": 961,
"productId": 562949953422273,
"reviewCount": 120,
"oneStarCount": 0,
"twoStarCount": 0,
"threeStarCount": 0,
"fourStarCount": 0,
"fiveStarCount": 0,
"onePointCount": 5,
"twoPointCount": 3,
"threePointCount": 0,
"fourPointCount": 2,
"fivePointCount": 7,
"sixPointCount": 5,
"sevenPointCount": 17,
"eightPointCount": 17,
"ninePointCount": 13,
"tenPointCount": 35,
"adminReviewIds": [
392717739898123,
392702209124315,
392729832097733,
392730657122297,
393828544996030,
393930379585154,
394089511497021,
395089511497021,
392717739898123,
392702209124315,
392729832097733,
392730657122297,
393828544996030,
393930379585154,
394089511497021,
395089511497021
],
"repliedReviewIds": [
392583533663240,
392559196404916,
390232830726889,
392717739898123,
392702209124315,
392729832097733,
392730657122297,
393828544996030,
393930379585154,
394089511497021,
394405036961235,
394185212223716,
394683371349008,
395089511497021
],
"topReviewIds": [
395089511497021,
394683371349008,
394683371246551,
394683357040343,
394683355652203,
394682624375391,
394523795698526,
394405036961235,
394190995549002,
394185212223716,
394089511497021,
393930379585154,
393913699011375,
393913601349253,
393884271011237,
393828544996030,
393330158328310,
392957061232144,
392957061232144,
392922542274148,
392883563271614,
392881752127727,
392878083095464,
392878049902196,
392800006053228,
392798853443669,
392798733920793,
392798693190664,
392798686202122,
392798680100775,
392798579956383,
392798526974885,
392798508345342,
392798371434357,
392776605939474,
392740431963779,
392740275805066,
392740092447420,
392739965173279,
392736235799410,
392730657122297,
392730476985571,
392729832097733,
392717739898123,
392702209124315,
392695904920399,
392695898988260,
392695885320731,
392695740846822,
392685367231359
],
"outstandingReviewIds": [
394089511497021,
392702209124315,
392559439428637,
392559196404916,
391099127464476,
391036917643961,
390284412030898,
390233149473242,
390232830726889,
390232508645227
],
"avgStar": 0.0,
"avgPoint": 7.8,
"publicCreatorCount": 40,
"privateCreatorCount": 0
}
],
"avgPoint": 7.8,
"_class": "mservice.social.feedv2.mention.api.messages.MultiGetProductExtendDataMsg"
}
}
Mô tả example response
| Tham số | Kiểu dữ liệu | Mô tả |
|---|---|---|
| reviewObjectId | long array | mã định danh của các sản phẩm |
| productId | social product id | |
| reviewCount | Số lượng review ở trạng thái Hiển thị | |
| oneStarCount …. fiveStarCount | số lượng review đánh giá 1 sao …… số lượng review đánh giá 5 sao (dành cho thang điểm 5 như OA) | |
| onePointCount …. tenPointCount | số lượng review đánh giá 1 điểm ….. số lượng review đánh giá 1 điểm (dành cho thang điểm 5 như Film) | |
| avgStar | Điểm đánh giá trung bình của các review ở trạng thái hiển thị (dành cho thang điểm 5 như OA) | |
| avgPoint | Điểm đánh giá trung bình của các review ở trạng thái hiển thị (dành cho thang điểm 10 như film) | |
| publicCreatorCount | Số lượng bài viết count theo đầu người, ở trạng thái hiển thị |