# Transaction evaluation - Evaluation management interface

"Weixin Mini Program transaction evaluation" is a true and fair evaluation system provided by the official Mini Program. Trading users in the Mini Program can rate a certain trading experience and post suggestions and feelings. The following interfaces are provided to Weixin Mini Program developers for querying, replying, and processing Mini Program user transaction evaluation.

1. query

• 1.1 Query evaluation list
• 1.2 Query Comment List
• 1.3 Inquiry Evaluation Details

2. Comment

• 2.1 Create a comment
• 2.2 Delete comment

3. Reply

• 3.1 Create a reply
• 3.2 Delete reply

4. Ratings customer service sessions

• 4.1 Bad Review Notice CallBack
• 4.2 Reset API customer quota

5. Acknowledgement of the settlement

# 1 - Inquiries

Use this interface can query a Weixin Mini Program, all evaluation related content.

# 1.1 Query a list of reviews

Query all the comments below a Weixin Mini Program.

# How to request

GET

# Request URL

https://api.weixin.qq.com/wxaapi/comment/mpcommentlist/get

# Sample Request Parameters: Javascript

https://api.weixin.qq.com/wxaapi/comment/mpcommentlist/get?filterType=1&offset=0&limit=8&startTime=1588237130&endTime=1588237131&access_token=xxxx

The query parameters include

{
    startTime: "1588237130",  
    endTime: "1588237131",    
    filterType: 1,
    offset: 0,
    limit: 8,
    access_token: 'xxxx'
}

# The meaning of the request parameter

# Evaluation type filter enumeration (filterType)

# Return the example correctly

{
  errcode: 0,
  success: true,
  commentList: [{
    commentId: "2797755680173111111",
    amount: 100,
    orderId: "payorder@_4200001761202302096311111111",
    payTime: "1675915718",
    wxPayId: "4200001761202302096311111111",
    orderInfo: {
      busiOrderId: 'xxxxxx'
    },
    userInfo: {
      openid: "xxxxxxxxxx",
      headImg: "http://wx.qlogo.cn/mmhead/xxxxxxxxxxx",
      nickName: "test"
    },
    bizInfo: {
        appid: "wx1234567890",
        headImg: "http://wx.qlogo.cn/mmhead/xxxxxxxxxxxx",
        nickName: "xxx"
    },
    score: 200, // 200分对应2星，每100分就是1星
    createTime: "1676351504",
    content: {
      media: [{img: 'http://xxx', thumbImg: 'http://xxx'}],
      txt: "一般吧 我总感觉这个成分很伤皮肤，用了之后一直很干燥，不是很喜欢这款产品"
    },
    extInfo: {
      isAlreadySendTmpl: false,
    },
    productInfo: {
      productList: [
        {
            name: "纸巾一张",
            picUrl: "https://xxxxxx",
        }
      ]
    }
  }],
  total: 3,
  offset: 0,
}

# Return the meaning of the parameter

Specific parameters of userInfo

Specific parameters of orderInfo

Specific parameters of bizInfo

Specific parameters of content

Specific parameters of extInfo

Specific parameters of productInfo

# 1.2 Query a list of reviews

Look up all the comments and responses below a review. (Currently, the first response created by a developer is defined as a comment, and subsequent responses are based on that comment. Future comments will be made on how a response is developed.)

# How to request

GET

# Request URL

https://api.weixin.qq.com/wxaapi/comment/replyandcommentreplylist/get

# Sample Request Parameters: Javascript

https://api.weixin.qq.com/wxaapi/comment/replyandcommentreplylist/get?commentId=123456&access_token=xxxx

The query parameters include

{
  commentId: '123456',
  access_token: 'xxxx' // 登录凭证
}

# The meaning of the request parameter

# Return the example correctly

{
  errcode: 0,
  list: {
    reply: {  // 评论（评论回复第一条内容）
      commentId: '123', 
      replyId: '1'
      createTime: '1669032337',
      updateTime: '1669032341',
      replyContent: { content: '999' },
      replyObject: {
        nickname: '小程序名称',
        imgUrl: 'http://xxx/xx'
      },
    },
    commentReplyList: [ // 回复（评论回复第二条及之后的所有集合）
      {
        commentId: '12345',
        commentReplyId: '1'
        createTime: '1669032388',
        updateTime: '1669032392',
        commentReplyContent: { content: 'uuuuuuuuu' },
        commentReplyObject: { nickname: '啊哈', imgUrl: 'xxx' },
      }
    ]
  }
}

# Return the meaning of the parameter

Meaning of parameters under reply (comments)

Parameter meaning under commentReplyList

# 1.3 Enquire about the evaluation details

Find out the details of an evaluation.

# How to request

GET

# Request URL

https://api.weixin.qq.com/wxaapi/comment/commentinfo/get

# Sample Request Parameters: Javascript

https://api.weixin.qq.com/wxaapi/comment/commentinfo/get?commentId=123456&access_token=xxxxxx

Sample query parameters

{
  commentId: '123456',
  access_token: 'xxxxxx'
}

# The meaning of the request parameter

# Return the example correctly

{
  info: {
    content: {
      commentId: '123',
      createTime: '1669031402',
      userInfo: { openid: 'xxx', headImg: '', nickName: '啊哈' },
      content: {
        txt: '突突突突突突有',
        media: [
          {
            video:
              'https://xxx/xx',
            videoCover: 'http://xxx/xx',
            videoDuration: 11
          }
        ]
      },
      bizInfo: {
        appid: "wx1234567890",
        headImg: "http://wx.qlogo.cn/mmhead/xxxxxx",
        nickName: "xxx的小商店"
      },
      score: 200, // 评价分数、星级，这里200分对应2星
      orderId: 'payorder@xxxx',
      wxPayId: 'xxxx',
      orderInfo: {
        busiOrderId: 'xxxxxx'
      },
      productInfo: {
        productList: [{
          name: "我是描述",
          picUrl: "https://xxxxx/x"
        }]
      },
      payTime: '1669030760',
      amount: 1,
    }
  },
  processInfo: { // 订单处理进度数据
    commentId: 'xxx',
    actionList: [
      {
        type: 1,
        updateTime: 1669031402,
      },
      { type: 2 },
      { type: 3 }
    ]
  },
  oldComment: {
    commentId: 'xxx',
    content: {},
    score: 100,
    createTime: 11111
  },
}

# Return the meaning of the parameter

Return specific parameters

Specific information in the info

Specific parameters of bizInfo

Specific parameters of userInfo

Specific parameters of orderInfo

Specific parameters of info.content.content

Specific parameters of productInfo

Specific parameters of processInfo progress

ActionListItem (each element in processInfo.actionList) Specific parameters

Specific parameters for oldComment

# 2 Comments

The first response created by a developer is currently defined as a comment.

# 2.1 Create a Comment

# How to request

POST

# Request URL

https://api.weixin.qq.com/wxaapi/comment/reply/add

# Sample Request Parameters: Javascript

https://api.weixin.qq.com/wxaapi/comment/reply/add?access_token=xxxx

The query parameters include

{
  access_token: 'xxxx' // 登录凭证  
}

Body parameters include

{
  commentId: "xxxxxxxxxx",
  content: "我是内容"
}

# The meaning of the request parameter

# Return the example correctly

{
  errcode: 0,
  success: true
}

# Return the meaning of the parameter

# 2.2 Delete Comments

The first response created by a developer is currently defined as a comment, and if that comment is removed, all responses based on that comment are deleted together.

# How to request

POST

# Request URL

https://api.weixin.qq.com/wxaapi/comment/reply/delete

# Sample Request Parameters: Javascript

https://api.weixin.qq.com/wxaapi/comment/reply/delete?access_token=xxxx

The query parameters include

{
  access_token: 'xxxx'
}

Body parameters include

{
  commentId: "xxxxxxxxxx",
  replyId: "xxxxx"
}

# The meaning of the request parameter

# Return the example correctly

{
  errcode: 0,
  success: true
}

# Return the meaning of the parameter

# 3 / Reply

# 3.1 Create a Reply

# How to request

POST

# Request URL

https://api.weixin.qq.com/wxaapi/comment/commentreply/add

# Sample Request Parameters: Javascript

https://api.weixin.qq.com/wxaapi/comment/commentreply/add?access_token=xxxx

The query parameters include

{
  access_token: 'xxxx'
}

Body parameters include

{
  commentId: "xxxxxxxxxx",
  replyId: "xxxxx",
  content: "我是内容"
}

# The meaning of the request parameter

# Return the example correctly

{
  errcode: 0,
  success: true
}

# Return the meaning of the parameter

# 3.2 Delete reply

# How to request

POST

# Request URL

https://api.weixin.qq.com/wxaapi/comment/commentreply/delete

# Sample Request Parameters: Javascript

http://api.weixin.qq.com/wxaapi/comment/commentreply/delete?access_token=xxxx

The query parameters include

{
  access_token: 'xxxx'
}

Body parameters include

{
  commentId: "xxxxxxxxxx",
  replyId: "xxxxx",
  commentReplyId: "xxxxx"
}

# The meaning of the request parameter

# Return the example correctly

{
  errcode: 0,
  success: true
}

# Return the meaning of the parameter

# 4 Ratings customer service sessions

Using Weixin Mini Program customer service messaging capabilitiesFor developers of , in response to user bad reviews, the platform provides a "bad review customer service session" capability, which developers can use to actively send a customer service message to bad review users;When the user replies, the developer can continue to communicate with the user using the customer service messaging capability.

How to use it:

1. Users initiate bad reviews 2.WeChat The server will push a callback request to notify the developer, see [4.1 Bad Review Notification CallBack] () 3.Developers can choose to call the API to reset customer quota, see [4.2 Reset API customer quota] () 4.Once you reset the customer quota, you can use Weixin Mini Program customer service api capabilities to send customer service messages

# 4.1 Negative Review Notice CallBack

# How to request

POST

# Request URL

Developers in WeChat open platform configuration callback server address

# The meaning of the request parameter

# Example Requests

<xml>
    <ToUserName><![CDATA[gh_abcdefg]]></ToUserName> 
    <FromUserName><![CDATA[oABCD]]></FromUserName> 
    <CreateTime>1704038400</CreateTime>
    <MsgType><![CDATA[event]]></MsgType> 
    <Event><![CDATA[wxa_comment_bad_score]]></Event>
    <result>
        <comment_id>2272502024443330610</comment_id>
    </result>
</xml>

# Return the example correctly

{
  errcode: 0,
  success: true
}

# 4.2 Reset the API quota

# How to request

POST

# Request URL

https://api.weixin.qq.com/wxaapi/comment/apikfquota/reset

# Sample Request Parameters: Javascript

https://api.weixin.qq.com/wxaapi/comment/apikfquota/reset?access_token=xxxx

The query parameters include

{
  access_token: 'xxxx'
}

Body parameters include

{
  commentId: "xxxxxxxxxx"
}

# The meaning of the request parameter

# Return the example correctly

{
  errcode: 0,
  success: true
}

# Return the meaning of the parameter

# 5. Acknowledgement of the settlement

# How to request

POST

# Request URL

https://api.weixin.qq.com/wxaapi/comment/confirmcompromise

# Sample Request Parameters: Javascript

https://api.weixin.qq.com/wxaapi/comment/confirmcompromise?access_token=xxxx

The query parameters include

{
  "access_token": 'xxxx'
}

Body parameters include

{
  commentId: "xxxxxxxxxx",
  picList: ['mediaid', 'mediaid'],
  content: "我是和解的内容"
}

# The meaning of the request parameter

# Return the example correctly

{
  errcode: 0,
  success: true
}

# Return the meaning of the parameter

# ERRORCODE