Merge 3323a9a into 4e13d13

lib/api_template.js

@@ -81,40 +81,37 @@ exports.sendTemplate = async function (openid, templateId, url, topColor, data,
  * Examples:
  * ```
  * var templateId = '模板id';
- * // URL置空，则在发送后,点击模板消息会进入一个空白页面（ios）, 或无法点击（android）
- * var url = 'http://weixin.qq.com/download';
- * var appid = '',; // 小程序 appid
- * var pagepath = 'index?foo=bar'; // 小程序页面路径
+ * var page = 'index?foo=bar'; // 小程序页面路径
+ * var formId = '提交表单id';
  * var color = '#FF0000'; // 字体颜色
  * var data = {
- *  user: {
+ *  keyword1: {
  *    "value":'黄先生',
  *    "color":"#173177"
  *  }
+ * var emphasisKeyword = 'keyword1.DATA'
  * };
- * api.sendMiniProgramTemplate('openid', templateId, url, appid, pagepath, data, color);
+ * api.sendMiniProgramTemplate('touser', templateId, page, formId, data, color, emphasisKeyword);
  * ```
- * @param {String} openid 用户的openid
- * @param {String} templateId 模板ID
- * @param {String} url URL置空，则在发送后，点击模板消息会进入一个空白页面（ios），或无法点击（android）
- * @param {String} appid 小程序 appid
- * @param {String} pagepath 小程序路径
- * @param {Object} data 渲染模板的数据
- * @param {String} color 字体颜色
+ * @param {String} touser 接收者（用户）的 openid
+ * @param {String} templateId 所需下发的模板消息的id
+ * @param {String} page 点击模板卡片后的跳转页面，仅限本小程序内的页面。支持带参数,（示例index?foo=bar）。该字段不填则模板无跳转
+ * @param {String} formId 表单提交场景下，为 submit 事件带上的 formId；支付场景下，为本次支付的 prepay_id
+ * @param {Object} data 模板内容，不填则下发空模板
+ * @param {String} color 模板内容字体的颜色，不填默认黑色 【废弃】
+ * @param {String} emphasisKeyword 模板需要放大的关键词，不填则默认无放大
  */
-exports.sendMiniProgramTemplate = async function (openid, templateId, url, appid, pagepath, data, color) {
+exports.sendMiniProgramTemplate = async function (touser, templateId, page, formId, data, color, emphasisKeyword) {
   const { accessToken } = await this.ensureAccessToken();
   var apiUrl = this.prefix + 'message/wxopen/template/send?access_token=' + accessToken;
   var template = {
-    touser: openid,
+    touser: touser,
     template_id: templateId,
-    url: url,
-    miniprogram: {
-      appid: appid,
-      pagepath: pagepath
-    },
+    page,
+    form_id: formId,
+    data: data,
     color: color,
-    data: data
+    emphasis_keyword: emphasisKeyword
   };
   return this.request(apiUrl, postJSON(template));
 };