# 开放接口API说明-投诉反馈相关

# 推送接口

接口说明:推送投诉反馈相关信息。 请求方式: POST(HTTPS
请求地址: 第三方服务接口URL
请求参数:

参数名称 参数值
msgId 消息ID
dataId 数据ID
dataVersion 接口数据版本,如:001
dataFormat 数据格式:json
dataSource 数据来源。biz:业务功能产生,api:开放接口产生
timestamp 请求时间戳,如:1503276678552
status 数据同步状态。0:数据首次同步,2:数据失败同步
statusTime 上次同步失败时间。格式:yyyy-MM-dd HH:mm:ss
tenantId 企业ID,各注册企业在勤策(原外勤365)中对应的唯一ID
digest 数据签名,md5(data|pushsecret|timestamp)
dataType customer_suggest
data <<请求数据体>> ,说明:格式为JSON格式数据

请求数据体:

{
    "complainId": "8882305777016628188",
    "customerId": "4678348326854106720",
    "customerName": "客户名称",
    "complaintsDetails": "投诉反馈",
    "complainTime": "2022-06-23 13:43:57"
}

参数说明:

参数 类型 必填 说明
complainId VARCHAR(32) 投诉反馈ID
customerId VARCHAR(32) 客户ID
customerName VARCHAR(100) 客户名称
complaintsDetails VARCHAR(4000) 反馈内容
complainTime VARCHAR(32) 反馈时间

响应示例:

{
 "return_code": 0,
 "return_msg": ""
}

参数说明:

参数 类型 说明
return_code int 响应编码。0:成功,1:失败
return_msg String 响应说明

# 投诉反馈回复

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/custComplaint/v1/replaycomplaint/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "complainId": "8882305777016628188",
    "replayDetails": "投诉反馈回复"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
complainId VARCHAR(100) 投诉反馈ID
replayDetails VARCHAR(4000) 投诉反馈回复内容

响应示例:

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}

异常示例:

{
    "msg_id": "X000001",
    "return_code": 1,
    "return_msg": "当前投诉已解决"
}                 

参数说明:

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码。0:成功,1:失败。其他详见附录错误码说明 (opens new window)
return_msg String 响应说明