# 评价管理差评通知事件

本文档描述服务器端接收的消息或事件,详细说明参见消息推送

事件英文名:wxa_comment_bad_score

使用微信小程序客服消息能力的开发者,针对用户差评,平台提供了「差评客服会话」能力,开发者可使用该能力主动下发一条客服消息给差评用户;当用户回复后,开发者可继续用小程序客服消息能力与用户沟通。

使用流程:

  1. 用户发起差评
  2. 微信服务器会推送此事件,通知开发者
  3. 开发者可以选择调用重置客服quota的api,详情可看重置Api客服quota
  4. 重置客服quota后,可以直接使用微信小程序客服的api能力去下发客服消息

# 1. 消息参数

# 请求体 Request Payload

参数名类型说明
ToUserNamestring商家小程序名称
FromUserNamestring微信团队的 OpenID(固定值)
CreateTimenumber事件时间,Unix时间戳
MsgTypestring消息类型,固定为event
Eventstring事件类型,固定为 wxa_comment_bad_score
resultobject结果对象

# Body.result Object Payload

结果对象

参数名类型说明
comment_idstring评价 ID

# 2. 消息返回

# 返回体 Response Payload

回复 success 或空字符串(无需加密)

# 3. 注意事项

本事件无特殊注意事项

# 4. 代码示例

# 4.1 JSON 示例

请求示例

{
    "ToUserName": "gh_abcdefg",
    "FromUserName": "oABCD",
    "CreateTime": 1704038400,
    "MsgType": "event",
    "Event": "wxa_comment_bad_score",
    "result": {
        "comment_id": "2272502024443330610"
    }
}

返回示例

SUCCESS

# 4.2 XML 示例

请求示例

<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>

返回示例

SUCCESS