模板与字段映射 · PushMsg 文档

模板消息使用公众号账号下已添加的完整模板 ID，data 的键对应模板详情里的变量名。当前系统已验证下面三个模板的微信接口调用，队列记录过 SENT。

SENT 表示微信接口接受了发送请求；实际展示与阅读情况以微信客户端为准。模板或服务类目发生变化后，应重新读取账号模板列表。

收到工单通知

配置项	当前值
模板编号	42925
模板标题	收到工单通知
完整模板 ID	`6UZkNMe8nSjxoX1GX2pVlcD2CxzpaQajDo6mnSF2bkg`

显示字段	微信变量	请求 data 键
工单名称	`{{thing4.DATA}}`	thing4
工单编号	`{{character_string11.DATA}}`	character_string11
编号	`{{character_string2.DATA}}`	character_string2

{
  "thing4": {"value": "测试工单"},
  "character_string11": {"value": "WO20261026001"},
  "character_string2": {"value": "CRM20261026001"}
}

完整请求可下载工单消息示例，并按通用消息接口提交。

工单处理通知

配置项	当前值
模板编号	43711
模板标题	工单处理通知
完整模板 ID	`fawy0-2uCpeCl6EjxRIDx7GhDy94929NuUSwWMbTYLg`

显示字段	微信变量	请求 data 键
联系电话	`{{phone_number3.DATA}}`	phone_number3
工单类别	`{{phrase4.DATA}}`	phrase4
客户姓名	`{{thing8.DATA}}`	thing8
站址名称	`{{thing11.DATA}}`	thing11
工单号	`{{character_string18.DATA}}`	character_string18

{
  "phone_number3": {"value": "13800000000"},
  "phrase4": {"value": "保修"},
  "thing8": {"value": "测试客户"},
  "thing11": {"value": "测试站点"},
  "character_string18": {"value": "WO20261026001"}
}

新客户跟进通知

配置项	当前值
模板编号	43736
模板标题	新客户跟进通知
完整模板 ID	`OpH0RvriM-Zi5WmN25X6ox0FY6rKMoStoXb_ab-jiRw`

显示字段	通用接口 data 键	CRM 专用字段
客户名称	thing2	customerName
客户类型	thing3	customerType
客户来源	thing5	customerSource
客户电话	phone_number6	customerPhone
标记时间	time8	markedAt

通用模板请求的 data 示例：

{
  "thing2": {"value": "测试客户"},
  "thing3": {"value": "潜在客户"},
  "thing5": {"value": "CRM录入"},
  "phone_number6": {"value": "13800000000"},
  "time8": {"value": "2026-10-26 11:00"}
}

CRM 业务可直接使用 CRM 专用接口，由服务端完成这组映射。

在控制台读取模板

在“公众号通道”中确认目标公众号已启用。
打开“推送测试”，选择目标通道。
点击“读取微信模板”，从账号已添加的模板中选择。
根据生成的字段填写业务内容，检查接收人的 OpenID，再明确提交测试。

模板读取接口为管理员接口：

GET /api/admin/channels/xianbao/templates
X-API-Key: YOUR_ADMIN_API_KEY

CRM 业务应用可通过 GET /api/v1/crm/template 查看当前 CRM 映射，无需管理员密钥。

添加和变更模板

在微信服务号后台的“模板消息”中，根据实际服务类目从公共模板库添加到“我的模板”。完整模板 ID 取自账号下已添加的模板，模板库编号用于选择模板，两者用途不同。

服务类目、账号权限和模板使用要求以微信后台及微信官方说明为准。订阅通知和一次性订阅消息具有各自的授权流程，当前 TEMPLATE 类型调用普通模板消息接口；不能仅凭模板标题判断接口类型。

变更模板时，先核对新模板的完整 ID、全部变量名和字段类型，再调整调用方数据。CRM 固定模板通过 PUSHMSG_CRM_TEMPLATE_ID 配置，字段结构需与当前五项映射一致。