微信公众号消息模板配置方法

2025-04-08

一、配置前的准备工作

  1. 账号要求

    • 必须为微信认证的服务号(订阅号和个人号不支持模板消息功能)。

    • 开通模板消息权限:登录公众平台 → 【功能】→【模板消息】→ 确认服务开通。

  2. 行业选择

    • 每个公众号可选择1个主营行业 + 1个副营行业(如电商、IT科技、教育等)。

    • 行业选择影响可用的模板类型,需与公众号实际业务匹配(行业分类参考)。


二、消息模板配置步骤

步骤1:登录微信公众平台

  1. 进入微信公众平台,使用服务号管理员账号登录。

  2. 左侧菜单栏选择【功能】→【模板消息】。

步骤2:选择行业

  1. 点击【模板库】→【选择行业】,提交主营和副营行业(需微信审核,约1-3天)。

    • 注意:每月可修改一次行业,频繁修改可能影响模板使用。

步骤3:添加模板

  1. 从模板库选择

    • 在【模板库】中搜索关键词(如“订单通知”、“预约提醒”),找到所需模板后点击“详情”。

    • 确认模板内容格式,点击【添加】获取模板ID(如TM00001)。

  2. 申请新模板(若无合适模板):

    • 点击【我的模板】→【申请新模板】,填写模板标题、内容(含变量占位符如{{keyword1.DATA}})。

    • 提交后等待微信审核(通常1-3个工作日)。

步骤4:获取模板ID与内容格式

  • 添加成功后,在【我的模板】中查看模板ID及参数说明,例如:

    text
    复制
    模板ID: TM00001 模板内容: 订单号:{{keyword1.DATA}} 商品名称:{{keyword2.DATA}} 订单金额:{{keyword3.DATA}} 备注:{{remark.DATA}}

三、通过API发送模板消息

1. 发送流程

  1. 获取用户OpenID(通过网页授权或用户主动消息)。

  2. 调用接口:https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=ACCESS_TOKEN

  3. 组装JSON数据(替换模板参数):

    json
    复制
    {"touser":"用户OpenID","template_id":"TM00001","url":"https://example.com",// 可选:跳转链接"data":{"keyword1":{"value":"20231001123456","color":"#173177"},"keyword2":{"value":"微信开发教程","color":"#FF0000"},"keyword3":{"value":"¥99.00"},"remark":{"value":"点击查看订单详情"}}}

2. 代码示例(Python)

python
复制
import requestsimport jsondefsend_template_message(access_token, openid, template_id): url =f"https://api.weixin.qq.com/cgi-bin/message/template/send?access_token={access_token}" data ={"touser": openid,"template_id": template_id,"url":"https://example.com/order/123","data":{"keyword1":{"value":"20231001123456","color":"#173177"},"keyword2":{"value":"微信开发教程"},"keyword3":{"value":"¥99.00"},"remark":{"value":"感谢您的支持!"}}} response = requests.post(url, data=json.dumps(data))return response.json()# 调用示例result = send_template_message("your_access_token","用户OpenID","TM00001")print(result)

四、常见问题与解决方案

问题原因解决方案
提示“模板不存在”模板ID错误或未添加模板检查【我的模板】中的模板ID是否复制正确。
用户未收到消息用户取消关注或拒收消息确保用户已授权接收模板消息且未取关。
接口返回“41028: form_id错误”使用一次性表单ID且已过期改用长期有效的模板ID,非小程序场景无需form_id。
模板审核不通过内容含营销信息或变量不规范按微信规范修改模板内容,避免促销词汇。

五、注意事项

  1. 内容合规

    • 禁止发送营销类信息(如优惠券、抽奖),仅限服务通知。

    • 变量内容需真实有效,与用户行为相关。

  2. 发送频率限制

    • 同一用户同一模板7天内最多发送1条(防止骚扰)。

  3. 模板变量规范

    • 变量名格式为{{keywordX.DATA}},X为数字(从1开始)。

    • 颜色值使用十六进制(如#173177),非必填。


六、调试工具推荐

  1. 微信公众平台接口调试工具
    在线调试模板消息发送

  2. 日志监控
    记录每次API请求与响应,便于排查参数错误或权限问题。


通过以上步骤,可快速完成模板消息的配置与发送。若需模板消息的高级功能(如跳小程序、订阅通知),建议参考微信官方模板消息文档


其它案例