Nivelle 开拓视野冲破艰险看见世界 身临其境贴近彼此感受生活

微信服务号开发之模板消息

2016-09-03
nivelle

定义:模板消息仅用于公众号向用户发送重要的服务通知,只能用于符合其要求的服务场景中,如信用卡刷卡通知,商品购买成功通知等。不支持广告等营销类消息以及其它所有可能对用户造成骚扰的消息。

注意:

  1. 每个账号可以使用25个模板
  2. 当前每个账号的模板消息的日调用上限为10万次,单个模板没有特殊限制。(以开发者中心页面标明的数字为准)
  3. 模板消息调用时主要需要模板ID和模板中各个参数的赋值内容
  4. 模板中参数必须以”.DATA”结尾,否则视为保留字
  5. 模板保留符号””

发送模板消息(其他大多数为第三方开发者准备,暂不描述)

接口请求地址:https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=ACCESS_TOKEN

参数 描述
touser 接收者openid
template_id 模板ID
url 模板跳转链接(非必填)
miniprogram 跳小程序所需数据,不需跳小程序可不用传该数据(非必填)
appid 所需跳转到的小程序appid(该小程序appid必须与发模板消息的公众号是绑定关联关系)
pagepath 所需跳转到小程序的具体页面路径,支持带参数,(示例index?foo=bar)
data 模板数据
color 模板内容字体颜色,不填默认为黑色

注:url和miniprogram都是非必填字段,若都不传则模板无跳转;若都传,会优先跳转至小程序。开发者可根据实际需要选择其中一种跳转方式即可。当用户的微信客户端版本不支持跳小程序时,将会跳转至url。

#### 事件推送

在模板消息发送完成后,微信服务器会将是否完成送达作为通知,发送到开发者中心填写的服务器配置地址中.

  • 送达成功时,推送的xml如下:
   <xml>
           <ToUserName><![CDATA[gh_7f083739789a]]></ToUserName>
           <FromUserName><![CDATA[oia2TjuEGTNoeX76QEjQNrcURxG8]]></FromUserName>
           <CreateTime>1395658920</CreateTime>
           <MsgType><![CDATA[event]]></MsgType>
           <Event><![CDATA[TEMPLATESENDJOBFINISH]]></Event>
           <MsgID>200163836</MsgID>
           <Status><![CDATA[success]]></Status>
   </xml>



参数 描述
ToUserName 公众号微信号
FromUserName 接收模板消息的用户的openid
CreateTime 创建时间
MsgType 消息类型是事件
Event 事件为模板消息发送结束
MsgID 消息id
Status 发送状态为成功
  • 送达由于用户拒收(用户设置拒绝接收公众号消息)而失败时,推送的xml如下:
           <xml>
           <ToUserName><![CDATA[gh_7f083739789a]]></ToUserName>
           <FromUserName><![CDATA[oia2TjuEGTNoeX76QEjQNrcURxG8]]></FromUserName>
           <CreateTime>1395658984</CreateTime>
           <MsgType><![CDATA[event]]></MsgType>
           <Event><![CDATA[TEMPLATESENDJOBFINISH]]></Event>
           <MsgID>200163840</MsgID>
           <Status><![CDATA[failed:user block]]></Status>
           </xml>


参数 描述
ToUserName 公众号微信号
FromUserName 接收模板消息的用户的openid
CreateTime 创建时间
MsgType 消息类型是事件
Event 事件为模板消息发送结束
MsgID 消息id
Status 发送状态为成功

单个模板消息最大数量10万条,多个模板消息总数也是10万条,模板数量随粉丝关注量增加而增加10W/100W/1000W粉丝都会增加模板数量,但是增加的具体标准没有明确。


评论