1. 引言
组织架构一变,消息就开始打偏:部门改名、人员调岗、客户还写在旧负责人名下。通讯录要解决的是「现在谁是谁、在哪个部门」。发送要解决的是「这句话打到哪个会话」。两张表不要合成一张还按中文名匹配。
2. 通讯录是目录,不是发送地址
部门名、职务、备注都会变。高效调用不是狂刷全量,而是:变更入站后更新目录,发送仍用已经绑定的会话 ID。未绑定拒绝发送,不要搜名字顶上。
QiWe API 发送按会话 ID,组织架构变更只更新展示和负责人映射。
| 变更 | 目录怎么做 | 发送怎么做 |
|---|---|---|
| 改部门名 | 更新名称 | ID 不变则继续发 |
| 调岗 | 换负责人绑定 | 旧号停任务 |
| 离职 | 停该员工任务 | 不要换凭证硬发 |
| 重名 | 用内部工号消歧 | 禁止模糊匹配 |
通讯录怎么拉、变更怎么收,对照 API文档,不要每次发送现搜。
3. 减少无效调用
全量每天一次做对账,增量靠回调或变更队列。发送路径上禁止嵌通讯录搜索。搜索超时再重试,容易打到错误对象。
python
def resolve_owner(dept_no, db):
row = db.get_owner(dept_no)
if not row or not row["device"] or not row["peer"]:
raise ValueError("unbound")
return row["device"], row["peer"]
真正出站走 QiWe API。目录更新失败不应阻断已经绑定的发送,只阻断未绑定的新任务。
4. 多号与可见范围
官方应用有可见范围。账号通道有员工是否还在职、号是否在线。范围外的人,不要用另一个号「帮忙发」,会串责任人。
组织架构和发送是两块,不要在发送函数里搜中文名。
5. 验收
改部门名后,原绑定会话仍能收到测试句;调岗后旧号不再出站;重名两人不会发错。
6. 总结
高效管理组织架构,是变更驱动的目录,加上禁止在发送函数里搜中文名。通讯录 API 管结构,会话 ID 管投递。