回调通知

在集成微盛开放接口与企业系统时,我们往往需要搭建一个回调服务,可以及时获取到状态变化

1、回调服务配置

配置回调服务,目前只需要一个配置项:URL

URL为回调服务地址,由开发者搭建,用于接收通知消息或者事件

2、回调服务需要实现的功能

配置回调服务时,目前需要能支持HttpPost

2.1 支持HttpPost请求接收业务数据

假设企业的接收消息的URL设置为 https://platform.wshoto.com/notify

当用户触发回调行为时,会发送回调消息到填写的URL,请求内容如下:

请求方式: POST(HTTPS)

请求地址: https://platform.wshoto.com/notify

接收数据格式:

{
  "message_id": "message_id",
  "type": 0,
  "content": "msg_content",
  "gmt_create": 1653375234
}

参数说明:

参数 类型 说明
message_id string 消息id
type int 消息类型
content string 消息结构体
gmt_create long 消息创建时间

2.2 接收消息请求的说明

  • 微盛服务器在五秒内收不到响应会断掉连接,并且重新发起请求,总共重试三次。
  • 当接收成功后,返回SUCCESS表示接收ok,其他错误码微盛后台会一律当做失败并发起重试
  • 关于重试消息排重,推荐使用message_id排重

消息类型说明:

枚举值 说明
15 客户变更通知
16 客户群变更通知
19 代客订单变更消息推送
20 付款回单变更消息推送
21 自定义字段变更消息推送
32 客户积分变更消息推送
34 商城订单变更消息推送
35 商城售后订单变更消息推送
40 超时回复生成记录消息推送
41 触发敏感词生成记录消息推送

results matching ""

    No results matching ""