小程序 发送模板消息的功能实现

☹. 背景

    此处参考京东购物的消息通知如下(也就是在下想要实现的效果):

❶ 前期准备

我们可以先对文档进行一遍 简单的浏览,以方便自己的流程理解,避免蒙头苍蝇乱撞

②. 小程序给与了我们最方便的手动模板配置方式

我们可以先去 1(模板库)中选取自己需要的模板,自定义标题、排序 申请成功之后,进入 2(我的模板)中就可以看到自己能够使用的模板,我们后期进行代码编辑时,用到的就是那个模板ID

❷ 实现步骤

此处,主要以 <form/> 组件形式的实现为例,对于prepay_id 的实现请参考文末的 附录

1. 小程序端的要求

    第一步:以我的代码实现为例,首先需要对我的 <form/> 组件进行需发模板消息的声明,即设置属性 report-submit="true"(【个人建议,请使用真机测试,不排除部分使用开发工具无法获取 form_id 的情况】) 第二步:对应的 pages/cart/payment.js代码中,编写的提交代码,以及对 event参数打印的结果则为:
    第三步:request 调用发送消息通知的方法

2. 服务端代码配置

我对服务端的代码,整合集中在了一个文件中,可从附录中进行下载
    第一步:替换小程序配置信息 第二步:修改方法 sendTemplatePaySuccess() 提示:

❸ 运行测试

    ①. 首先,要 特别注意 一点,不可以使用 进行测试,不然会有如下报错:
可参考道友解释:
    ②. 并且,如果已经发送过一次模板消息,会有如下提示信息:
//#这说明,你的formid 已经用过了,系统要求只能使用一次!!!
{
	"status":0,"result":"sendTemplatePaySuccess Failed!",
	"data":
		{
			"errcode":41029,"errmsg":"form id used count reach limit hint: [9mUwja01342277]"
		}
}

❹ 附录

A. 补充信息

    开发文档中有这样一句话:
    值得注意:
第一点:
	使用 "<form/>" 组件
	获得的 "formId" 只能使用一次
	相对适合的通知业务 —— 支付成功或失败后,充值成功、	续费成功、挂号成功等被动响应的信息...

第二点:
	"prepay_id" 只有进行了支付行为才能获得,并且必须支付成功!
	一个 "prepay_id" 可以使用三次
	相对适合的通知业务有 —— 后台发货提醒、审核通知、课程开班提醒、拼团成功通知等主动推送的信息...

第三点:
	prepay_id 使用时的报错信息:

	//# 如果支付不成功,但是要使用获得的 prepay_id,会有如下类似的信息
	{"data":
		{"errcode":41028,"errmsg":"invalid form id hint: [XiZ04574125]"}
	}
	
	//# 如果支付成功,使用获得的 prepay_id 次数超过了三次,会有如下的信息:
	{"data":
		{"errcode":41029,"errmsg":"form id used count reach limit hint: [oFN1Aa08963936]"}
	}

B. 后台发货通知的设计思路

    温馨提示:
毕竟存放的 "prepay_id" 最多只用使用三次,所以对于项目设计中的使用位置要做好规划 !!!

C. 使用真机测试,顺利运行的效果为:

D. Access_Token 建议

官方文档 -
    代码中,所必须涉及到的业务 —— access_token 的获取,请参考文档介绍,进行定时刷新,以避免不必要的资源请求 个人的思路就是,创建数据表字段,根据其返回的时长 expires_in,在失效前保存数据 access_token 可根据自己的实际需求,优化小编提供的 opGetAccessToken() 方法! 有一点,或许很多人不多加注意:

❺. 源代码参考

    请对应代码进行正确配置哦
经验分享 程序员 微信小程序 职场和发展