模板消息
发送工单状态模板消息;收件人用 unionid。
模板字段映射由运营在公众号配置里设置,产品站只传语义字段。
收件人用 unionid
对外只传
unionid(你手里通常只有它),平台内部映射到公众号 openid 投递。POST
/api/v1/notify/work-order-statusX-Api-Key · wechat_notify工单状态变更
json
{
"unionid": "oUnionYYYY",
"project_name": "你的产品名",
"status": "账号过期",
"customer_name": "用户昵称",
"time": "2026-07-17 18:00",
"url": "https://你的站/notify?scene=expired",
"client_msg_id": "防重ID(可选)"
}| 字段 | 必填 | 约束 |
|---|---|---|
unionid | 是 | 接入方共享的 unionid;平台内部映射到投递 openid |
project_name | 是 | ≤100 |
status | 是 | ≤100;映射 short_thing 时微信侧常 ≤5 字 |
customer_name | 是 | ≤100 |
time | 否 | YYYY-MM-DD HH:MM / 带秒 / YYYY/MM/DD HH:MM |
url / client_msg_id | 否 | 点击跳转 / 防重 |
成功返回 { "ok": true, "msgid": "..." }。time 格式非法 → 400 invalid_time_format。
收件人须已关注
微信只能给已关注公众号的人发模板消息。若传的
unionid 从未关注过共享服务号(平台无记录),返回 400 wechat_member_not_found——发送前可用「查是否关注」预检。