/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */
#content_views .toc,
/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */
#content_views.markdown_views > p:empty:has(+ .toc),
#content_views.markdown_views > .toc + p:empty,
/* 富文本旧版目录标记 */
#content_views.htmledit_views #main-toc,
#content_views.htmledit_views #hr-toc,
#content_views.htmledit_views p[id*=\”-toc\”] {
display: none !important;
}
/* 目录去掉后,紧跟的首个标题不再多出一块上边距 */
#content_views.markdown_views > .toc + h1,
#content_views.markdown_views > .toc + h2,
#content_views.markdown_views > .toc + h3,
#content_views.markdown_views > .toc + h4,
#content_views.markdown_views > .toc + p:empty + h1,
#content_views.markdown_views > .toc + p:empty + h2,
#content_views.markdown_views > .toc + p:empty + h3,
#content_views.markdown_views > .toc + p:empty + h4 {
margin-top: 0 !important;
}
在企业微信二次开发项目里,企业通常需要将订单通知、售后进度、任务执行结果等消息,自动发送到指定外部群。
但实际业务中,一个企业可能管理几十甚至上百个群聊。如果只根据客户名称或群名称发送消息,很容易出现任务关联错误、消息发错群等问题。
通过星云API接入消息自动收发能力后,可以结合群聊ID、业务任务ID和会话映射,实现指定群聊与业务任务的精准关联。
一、建立群聊与业务任务映射关系
建议在业务系统中维护独立的关联表:
instance_id
group_id
business_id
task_id
business_type
status
例如:
group_001 -> order_1001
group_002 -> after_sales_2001
group_003 -> project_3001
其中 group_id 用于确定消息发送目标,task_id 用于追踪具体业务任务。
需要注意,同一个群聊可能关联多个业务任务,因此不能简单地将一个群ID固定绑定到唯一任务。
二、收到群消息后定位对应任务
例如客户在外部群发送:
“帮我查询一下之前的售后进度。”
系统通过 Webhook 接收消息,提取:
message_id
instance_id
group_id
sender_id
content
随后根据群聊ID、发送成员和业务类型查询关联任务。
如果当前群存在多个售后工单,应要求客户补充工单号,而不是直接选择第一条记录。
整个流程为:
群消息 → 识别群聊 → 查询业务关联 → 定位任务 → 执行对应接口
三、主动发送时准确匹配目标群聊
除了被动接收消息,业务系统也可能主动触发通知。
例如订单系统检测到发货状态变化:
event_type: order_shipped
business_id: order_1001
task_id: task_1001
消息服务先根据业务ID查询群聊映射,确认对应的 instance_id 和 group_id。
再调用消息发送接口,将通知发送至目标群聊。
这样即使多个群同时存在相似业务,也能通过唯一标识区分发送目标。
四、通过任务ID关联异步执行结果
部分业务需要较长时间才能完成,例如报表生成、售后审核和数据统计。
建议在创建任务时保存:
task_id
request_id
instance_id
group_id
business_id
execute_status
send_status
任务完成后,通过 task_id 查询原始群聊信息,再将结果回推。
例如:
任务编号:task_1001
处理状态:已完成
业务结果:订单已发货
不建议在异步任务完成时重新通过群名称查找目标,避免群名称修改或重名造成消息错发。
五、避免多群并发导致消息错配
当多个外部群同时触发业务时,每条消息都需要建立独立请求记录。
例如:
request_001 -> group_001 -> task_001
request_002 -> group_002 -> task_002
request_003 -> group_003 -> task_003
业务处理完成后,按照请求关联关系返回结果。
同时做好以下控制:
-
使用 message_id 进行消息去重。
-
使用 task_id 追踪业务执行状态。
-
发送前校验群聊、实例和业务权限。
-
消息发送失败时单独重试,避免重复执行业务。
涉及个人订单、客户资料等敏感信息时,还应确认该群聊是否具备对应数据的查看权限。
六、统一记录消息发送结果
建议保存:
request_id
task_id
group_id
message_id
execute_status
send_status
fail_reason
这样发生异常时,可以快速判断是群聊映射错误、业务执行失败,还是消息发送失败。
整个流程可以设计成:
业务消息或事件 → 识别业务ID → 查询群聊映射 → 关联任务ID → 执行业务 → 校验目标群聊 → 发送处理结果
相关接口可以查看:
开发文档:星云API开发文档|企业微信API接口文档
官网:星云API|企业微信API接口服务平台
企业微信二次开发中,消息自动收发的关键不仅是能够发送消息,还要确保每个业务任务都能准确对应到指定群聊。通过星云API接入消息能力,再结合群聊映射、任务追踪和发送状态管理,可以让订单通知、售后处理、任务结果等业务消息准确送达对应外部群,减少消息错配和重复处理,提高多群业务管理效率。
网硕互联帮助中心






评论前必须登录!
注册