文档

# 模板消息

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

# 模板消息

小程序场景下，开发者可以通过form组件收集formid（formid是下发模板消息的凭证，一个formid 7天内可以给用户下发一次模板消息）。小游戏没有form组件，平台为了给小游戏提供消息下发能力，会在用户登录小游戏时通过开发者在管理端配置的回调地址给开发者推送formid以及用户的openid。一个用户7天内无论登录多少次，平台最多给开发者推送一个formid。开发者收到平台推送的formid后，可以在7天内的任意时间调用sendTemplateMessage接口给用户下发模板消息。

# 步骤：

  1. 在管理端配置回调地址 配置入口：设置->开发设置->消息路径

  2. 接收formid

开发者通过回调收到的消息如下，MsgType如果是"game_formid"，表示推送的是formid。formid放到content字段中。

消息示例：

{
    "CreateTime":1564540754,
    "OpenId":"4392C24248DB16CEBD1BFFDB3561D9BD",
    "MsgType":"game_formid",
    "MsgId":"2d0379e0ba81e114bde3c5f60aea5753",
    "Content":"8d2ec2556d0a437d9c2d2b2c4898eb08"
}
1
2
3
4
5
6
7
属性 类型 默认值 必填 说明
MsgType string 是 通知formid的消息类型
MsgId string 是 消息唯一标识，用于去重
OpenId string 是 登录小游戏的用户id
Content string 是 平台推送的formid， 通过sendTemplateMessage下发消息时，需要填到formid字段
CreateTime int 是 消息发送时间
  1. 通过sendTemplateMessage接口给用户下发模板消息

← 获取小程序码 →