跳转到正文

申请并配置服务号模板消息 ​

本篇帮助你为手边酒店小程序多商户版申请服务号模板消息,完成域名、接口凭据、后台模板与接收人配置,让负责人员接收对应业务通知。顾客端的小程序通知另见订阅消息。

1. 先准备认证服务号 ​

使用已经完成微信认证、准备用来接收业务通知的服务号,请该服务号管理员配合操作。还没有账号时,先完成服务号申请与认证。

同时向系统部署人员确认两项信息:接收人扫码绑定使用的网页授权域名、业务服务器调用微信接口的出口 IP。域名用于微信扫码授权,IP 用于接口白名单;不要填写自己电脑的 IP,也不要直接照抄图片中的账号、域名或参数。

2. 申请开通模板消息 ​

登录微信公众平台,确认当前是上述服务号。点击左侧底部的 「新的功能」,找到 「模板消息」→「去开通」。已经开通的账号无需重复申请。

服务号模板消息申请入口:新的功能与去开通

进入申请页,按照账号真实业务选择行业。图中酒店业务示例为 主营「酒店旅游 → 酒店」、副营「酒店旅游 → 旅游」;仅在符合实际经营业务时使用,其他业务以账号可选行业和微信要求为准。

模板消息申请:选择行业、填写申请理由并提交

申请理由要写实际用途,不要填写促销群发或营销推广。可结合自己的业务修改下面的示例:

本服务号用于酒店预订及住宿服务。申请模板消息用于向已关注服务号的相关工作人员发送待处理订单、客房服务申请、发票申请等必要业务提醒,便于及时处理对应服务。仅在真实业务发生时按模板要求发送,不发送广告、促销或与接收人无关的信息。

核对后点击 「提交」。如果页面显示待审核,先等待结果;只有账号显示模板消息功能已开通,才能继续同步模板。行业、申请资格、字数和审核要求以微信当前页面提示为准。

3. 设置网页授权域名 ​

在服务号后台点击左下角账号名称,进入账号设置,找到 「网页授权域名」→「设置」。它用于后面员工扫码绑定接收微信,不要误填到「业务域名」或「JS接口安全域名」。

网页授权域名:下载校验文件、填写域名并保存

  1. 下载当前弹窗中的校验文件,保留原文件名和内容,交给系统部署人员放到该域名对应的网站目录。
  2. 请部署人员确认校验文件可通过对应网址访问,再填写其提供的实际授权域名。例如对方确认使用 notify.example.com,就填写这个域名;不要填写后台登录页面的完整地址或照抄示例。
  3. 点击「保存」,重新打开设置,确认域名已保存。提示校验失败时,将错误提示和校验文件交给部署人员检查文件位置、访问情况及实际授权地址。

图中的「强制https校验」只是截图时的状态,不代表必须关闭;请由部署人员确认实际授权地址与 HTTPS 配置后,按当前页面要求设置。

4. 登录微信开发者平台,获取参数并配置 IP ​

打开微信开发者平台,使用有权限管理该服务号的微信登录。在 「我的业务」→「服务号」 中选择本次用于通知的服务号,核对名称后进入账号详情。

微信开发者平台:从我的业务选择服务号

在账号详情找到 AppID 和 「开发密钥」:

  • AppID:复制服务号的 AppID,稍后粘贴到酒店后台的服务号 APPID 栏;不要复制原始 ID 或小程序 AppID。
  • AppSecret:按页面提示由管理员启用并安全保存,稍后粘贴到酒店后台的 Secret 栏。若该服务号已被其他系统使用,先与维护人员核对现有密钥,避免随意重置导致已有对接失效。
  • API IP白名单:按当前页面提示完成 AppSecret 启用后,将部署人员提供的服务器出口 IP添加到白名单并保存。已有白名单条目需保留,除非已确认不再使用。

开发者平台账号详情:AppID、AppSecret 与 API IP 白名单位置

AppSecret 不要放进教程截图、群聊或排查材料中。 以上微信页面会随平台更新调整,以当前账号实际入口和提示为准。

5. 在平台管理保存公众号配置 ​

进入平台管理的 「设置」→「消息通知」→「公众号模板消息」,打开 「公众号配置」。

将第 4 步取得的 AppID 填到 「服务号 APPID」,AppSecret 填到 「服务号 Secret」,点击 「保存公众号配置」。两个参数必须来自同一个服务号,门店管理员无需另填一套公众号凭据。

多商户平台管理:公众号配置入口、服务号凭据和保存按钮

保存后重新进入页面确认配置保留。若报错,先核对服务号账号、凭据和服务器 IP 白名单,再继续同步。

6. 一键同步业务模板 ​

切换到 「模板消息管理」,点击右侧 「一键同步全部模板」,等待结果返回。

多商户模板管理:同步按钮、进度、各场景模板 ID 与状态

核对「同步进度」及每行的「模板 ID」「状态」。模板由平台统一维护,重复同步会尝试复用符合要求的已有模板,不需要先清空微信模板,也不用从其他账号复制模板 ID。

通知场景包括客房订单、商城/点餐/活动付款、住客服务、退款申请、提现和新会员等,以当前系统列表为准。

图中进度为 10/11,订房退款申请仍显示「未同步」,不是全部成功的示例。 自己后台也应逐行检查,不能仅看到「公众号:已配置」就认为全部模板可用。

7. 分别设置平台与门店接收人 ​

平台新会员通知 ​

切换到 「新会员接收人」,点击 「添加接收人」,由实际接收人使用已关注该服务号的微信扫码。绑定后核对列表中的人员,勾选并点击「保存接收人」。

平台新会员接收人:添加、勾选人员与保存接收人

这个列表只用于平台新会员通知,不代表已给所有门店绑定订单通知人员。人员变动时取消勾选并保存,必要时移除绑定。

门店订单与服务通知 ​

切换到对应门店后台,进入 「设置」→「消息通知」→「公众号提醒」:

  1. 在「统一接收人」区域点击 「添加接收人」,由该门店负责通知的员工微信扫码绑定并关注服务号。
  2. 勾选人员,点击 「保存统一名单」。
  3. 某个场景需要专人处理时,在对应行点击 「设置接收人」,选择「使用独立名单」,勾选并保存;该名单只影响当前场景,不要留空后误以为仍会使用统一名单。

各门店分别核对自己的接收人。住客服务处理入口见客户服务。

8. 检查实际业务通知 ​

在相应业务实际发生后,核对目标员工的微信是否收到对应服务号消息、内容是否与业务记录一致,以及点击后打开的页面是否正确。

平台新会员通知与门店订单通知要分别核对接收名单。模板显示「已配置」不等于消息已送达,不要用平台新会员名单替代门店设置。

配置没有成功时先检查什么 ​

看到的现象优先检查与处理
找不到模板消息开通入口先确认登录的是服务号,核对认证及该账号当前可开通能力;以微信页面给出的资格提示处理
后台保存凭据失败核对 AppID 与 AppSecret 是否来自同一个服务号,密钥是否有效、服务器出口 IP 是否已加入 API IP 白名单
员工扫码时提示授权域名不匹配核对第 3 步网页授权域名与实际扫码回调地址;把完整错误提示交给部署人员检查
同步提示没有可用类目、行业不符或模板数量受限在该服务号后台核对开通状态、行业或类目及模板列表,按具体提示处理后重新同步;不要为腾位置直接删除仍在使用的模板
某行提示找不到模板或字段不匹配记录场景名称和错误提示,交给维护人员核对;不要随意用同名但字段不同的模板替代
模板已配置但没有收到消息确认人员关注的是配置的服务号、已勾选保存到正确接收名单,并核对对应业务是否发生

需要协助时,提供所用版本、配置页面或场景名称、错误提示和发生时间;涉及订单时提供可定位的业务记录。截图先遮挡 AppSecret,不要提供密码或密钥。

手边酒店 · 让酒店预订更直接,让日常经营更省心