# 统一服务消息-开发者管理端配置

开发者服务器可以接收QQ小程序的消息推送服务。具体步骤:

  1. 填写服务器配置
  2. 据接口文档实现业务逻辑,接收消息和事件

【注意】 原模板消息接口已全部停用,开发者管理端入口已下线,模板消息相关接口调用失败,请改为使用一次性订阅消息进行消息通知。

# 第一步:填写服务器配置

登录小程序后台后,在「设置」-「开发设置」-「消息推送」中,填写服务器地址(URL)、令牌(Token) 等信息。

URL: 开发者用来接收消息和事件的接口 URL。开发者所填写的URL 必须以 http:// 或 https:// 开头,分别支持 80 端口和 443 端口。 Token: 可由开发者可以任意填写,用作生成签名(该 Token 会和接口 URL 中包含的 Token 进行比对,从而验证安全性)。

# 第二步:接收消息和事件

当某些特定的用户操作引发事件推送时(使用小游戏,订阅授权小程序/小游戏),QQ服务器会将消息(或事件)的数据包以 POST 请求发送到开发者配置的 URL,开发者可以依据自身业务逻辑进行响应。

QQ服务器在将用户的消息发给开发者服务器地址后,QQ服务器在五秒内收不到响应会断掉连接,并且重新发起请求,总共重试三次。如果在调试中,发现用户无法收到响应的消息,可以检查是否消息处理超时。关于重试的消息排重,有 msgid 的消息推荐使用 msgid 排重。

服务器收到请求必须做出下述回复,这样QQ服务器才不会对此作任何处理,并且不会发起重试,否则,将出现严重的错误提示。详见下面说明:

  1. 直接回复success(推荐方式)
  2. 直接回复空串(指字节长度为0的空字符串,而不是结构体中content字段的内容为空)
  3. 若接口文档有指定返回内容,应按文档说明返回