# 调整
微信小程序已停用模板消息功能，改为使用订阅消息，所以请各位老板移步：
[**《发送订阅消息》**](https://www.yuque.com/apifm/doc/sw1dg9)
# 前言
本教程是基于 “apifm-wxapi” 模块，教你快速实现小程序开发，所以你可能需要先了解以下知识点：
[《创建 HelloWorld 项目》](https://www.yuque.com/apifm/doc/hezlrm)
[《使用 “apifm-wxapi” 快速开发小程序》](https://www.yuque.com/apifm/doc/mdldsd)
[《免费注册开通后台，获得专属域名》](https://www.yuque.com/apifm/doc/qr6l4m)
本案例中，部分功能，需要用户登录后才能操作，也就是说需要 token 授权，请先了解：
[《微信小程序登录获取openid及三方token》](https://www.yuque.com/apifm/doc/kaygbw)
# 功能介绍
给用户发送模板消息，所以你要先在后台设置好你的小程序 appid 和 secret
[《后台配置小程序的 appid 和 secret》](https://www.yuque.com/apifm/doc/ngdgyi)
# 选择合适的模板消息模板
登录你的小程序后台 [https://mp.weixin.qq.com/](https://mp.weixin.qq.com/) ，左侧菜单的模板消息中，你可选择从现有模板库中选用模板 / 自己设置模板消息并提交审核通过，来启用你的模板消息模板
启用模板后，你将可以获取 模板消息ID、消息变量
# apifm-wxapi 方法
### 保存 formid/预支付Id
```javascript
WXAPI.addTempleMsgFormid(token, type, formId)
```
> type: form/pay ，分别代表支付还是表单提交
>
> formId: 表单提交场景下，为 submit 事件带上的 formId；支付场景下，为支付的 prepay_id
>
小程序给用户发送模板消息有特殊规定：
[https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/template-message.html](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/template-message.html)
1. 当用户在小程序内完成过支付行为，可允许开发者向用户在7天内推送有限条数的模板消息（1次支付可下发3条，多次支付下发条数独立，互相不影响）
2. 当用户在小程序内发生过提交表单行为且该表单声明为要发模板消息的，开发者需要向用户提供服务时，可允许开发者向用户在7天内推送有限条数的模板消息（1次提交表单可下发1条，多次提交下发条数独立，相互不影响）
_所以为了突破这个数量限制，我们预先收集很多的 formid/预支付Id ，这样就可以不受限制的给用户发送模板消息了_
**小程序模板消息调试请使用手机，开发工具获取到的formid 是一个 mock（模拟的），无法用来真正发送模板消息**
### 给用户发送模板消息
```javascript
WXAPI.sendTempleMsg(Object object)
```
> 具体参数说明详见接口文档
>
> 可实现立即发送消息；按照条件触发发送消息
>
本方法可以指定一个 formid/预支付Id ，也可以不传该参数，那么系统将自动从上面的方法存储的 formid/预支付Id 里面获取一个用来发送模板消息
**关于更加详细的参数使用，以及更加高级的进阶使用方法，可以参考api接口文档说明：**
[《api接口文档》](https://api.it120.cc/doc.html)
_关于 apifm-wxapi 更多的使用方法：_
[《apifm-wxapi使用说明》](https://github.com/gooking/apifm-wxapi/blob/master/instructions.md)
_本案例Demo代码下载：_
[《apifm-wxapi使用Demo程序》](https://github.com/gooking/apifm-wxapi-demo)
期待你的进步！
感谢！