开源的 WhatsApp 共享收件箱让你的团队可以查看代码并自己运行应用。当客户对话必须留在自己的基础设施里,或者你不想让托管依赖于某一家供应商时,这会很有用。
能拿到源代码只是起点。在选择项目之前,要看它是否真的支持团队协作,以及你的团队能否运维它周边的一切。
先看团队工作流
一个代码仓库能连上 WhatsApp,并不等于它是共享收件箱。要让多人一起处理客户,请确认是否具备:
- 每位队友有独立账号
- 分配,或其他清晰可见的归属方式
- 用于交接的内部备注
- 针对发送、管理和导出的角色与权限
- 持久保存的对话历史
- 搜索、标签或其他查找旧工作的方式
用两个用户试一试这些功能:把一段对话分配给一个人,再以另一个人的身份登录,检查每个账号能看到和修改什么。
阅读许可证
“在 GitHub 上可获取”并不总是意味着开源。请检查应用本身的许可证以及重要依赖项的许可证。
WATeamInbox 的应用代码采用 MIT 许可证。它依赖的 whatsmeow 单独采用 MPL-2.0 许可证,仓库中记录了这一区别。
如果你打算修改软件、在内部使用,或把它作为其他服务的一部分提供,请让熟悉贵机构许可证要求的人审阅相关条款。
弄清你需要运行什么
团队收件箱通常不止一个网页。在估算工作量之前,先列出每项服务:
- 网页应用和 API
- 数据库
- WhatsApp 连接 worker
- 实时消息服务
- 搜索
- 存放图片、文档和语音消息的对象存储
- TLS 代理或负载均衡器
WATeamInbox 提供了开发环境配置和单主机生产基础方案。自托管文档列出了当前的组件和配置。
检查运维文档
不要只看安装命令。有用的文档应当涵盖:
- 环境变量和密钥处理
- 数据库迁移
- HTTPS 和网络暴露
- 备份和恢复
- 对象存储
- 日志和监控
- 升级和回滚
一个项目可能适合用来测试,但在用于生产之前仍需要更多工作。在连接重要的商务号码之前,先决定由谁来承担这些工作。
测试权限,而不只是顺利的情形
创建不同角色的账号,亲自验证各项限制:
- 坐席能否连接或移除 WhatsApp 号码?
- 他们能查看所有对话,还是只能看分配给自己的?
- 谁可以发送消息?
- 谁可以导出客户数据?
- 队友离职后,访问权限会怎样?
把团队打算使用的权限记录下来。默认设置不能代替访问策略。
规划媒体文件和备份
文字消息只是客户收件箱的一部分。图片、文档和语音消息可能会成为存储和备份中占比最大的部分。
请确认媒体存放在哪里、访问如何授权,以及数据库恢复后是否仍指向正确的对象。请在一台干净的机器上测试恢复,不要以为备份日志显示成功就足够了。
问清楚 WhatsApp 如何连接
WATeamInbox 使用非官方的 WhatsApp 客户端库。这意味着 WhatsApp 的变化可能影响配对、消息同步或投递,账号也可能受限。WATeamInbox 是独立项目,与 WhatsApp 或 Meta 没有关联。
任何部署设置都无法消除这种平台风险。如果贵机构要求接入官方的 WhatsApp Business Platform,请选择专为此需求打造的产品。
比较自托管与托管的云服务
自托管让你掌控应用环境和数据所在位置,同时也让你负责打补丁、备份、监控和恢复。
托管服务能省去大部分日常的基础设施工作,但由运营方承担更多运行环境的责任。WATeamInbox 两种方式都提供:公开仓库用于自托管,WATeamInbox Cloud 用于托管。
一份简短的评估计划
- 阅读许可证和架构文档。
- 用非关键的 WhatsApp 号码运行应用。
- 邀请两位不同角色的队友。
- 测试分配、备注、媒体和导出。
- 停掉一项服务,确认你清楚如何恢复。
- 备份数据并在一个干净的系统上恢复。
- 写下由谁来维护这套部署。
这样的演练比 GitHub 星标数或一长串功能列表更能说明问题。如果 WATeamInbox 符合你的需求,请继续阅读安装和生产环境文档。