小区物业收费 + 业主消息自动回复:我们做的第一个完整示例
一句话需求(按真实物业场景提的):物业公司在公众号和企业微信上每天会收到几十上百条业主消息(停电报修、停车费、门禁卡、投诉),
既要及时回、又不能漏;同时后台要能查历史消息、能接管、能按合规要求删数据。
这篇把它拆开:做成什么样、怎么一步步做出来、中间踩了哪些坑。
一、做出来是什么样
先看成品(这是我们自己搭的示例环境,跑在本机、灌的是演示数据)。整个后台就一屏:上面是账号与回调配置 + 运行数据,下面是消息流水/待人工/规则/账号/审计几个页签。
后台首页:两个账号、16 条规则、待人工 5 条、消息总数 80
关键数字一眼可见
- 接入账号 2 个:服务号(default)+ 企微自建应用(lvting),一个后台同时管两条通道
- 自动回复规则 16 条:停电、停水、停车费、门禁卡、垃圾清运……命中即自动回
- 待人工 5 条:规则没命中或涉及费用争议的,进人工队列,不会「自动回复糊弄过去」
- 消息留存 90 天:到期自动清理;业主可要求删除其全部消息,删除动作进审计
消息流水:每条都能看到「业主说了什么 → 命中了哪条规则 → 回了什么」
待人工队列与审计记录:谁接管、谁删了谁的消息,都能追到
二、怎么做出来的(五步)
- 定数据表:messages(消息本体)、accounts(账号与 token)、rules(关键词→回复)、pending(待人工)、audit(操作留痕)。这五张表定了,后面全是填空。
- 接回调:公众号和企业微信各给一个回调地址
/wx/callback/<账号ID>,同一个服务按账号分流。 - 写规则引擎:按关键词/正则匹配,命中就走对应回复并记账(命中哪条规则,要能查)。
- 加人工队列:没命中、或规则标记「需人工」的,进队列等人接管,后台可手动回复。
- 补合规三件套:90 天留存清理、按业主删除、删除留审计。这三件不做,物业不敢用。
三、中间踩的五个坑
坑 1:两个通道的回调格式不一样。
公众号推的是 XML,企微自建应用走的是加密 XML(要先用 token+AESKey 解密),字段名也不同。
一开始用一个解析器吃两种格式,结果企微那边的消息全部静默丢掉 —— 不报错,只是「没进来」。
正确做法:入口先判来源账号,再走各自的解析与解密分支。
坑 2:默认只监听本机,回调永远收不到。
服务默认绑
127.0.0.1(安全考虑),但公众号回调是外网来的。
不配反向代理/端口映射,后台一切正常、消息数永远 0。这条最容易误判成「代码写错了」。坑 3:后台裸奔。
早期版本不登录也能访问
/ 和 /api/*,等于业主消息全公开。
现在未登录一律 401,只认两种凭据:HTTP Basic 或登录 Cookie。坑 4:消息不能永久留着。
合规要求「业主可要求删除其全部消息」,这就需要:按期清理(90 天)、按人删除、删完留审计。
少了审计这一环,删了就查不到谁删的,出问题说不清。
坑 5:没有备份等于没做。
数据库每天定时备份、保留 7 份。曾经有一次改表结构失手,靠七天前的备份把数据捞回来 —— 从那以后备份成了默认项。
四、这个场景适合谁
中小物业公司(几个到十几个小区)、园区/写字楼物业、社区服务中心。共同点:消息多但不复杂, 要的是「别漏、能查、能接管、能删」,而不是一套大型 CRM。