搜「企业微信群消息接口」,内部群 webhook 和外部群会话经常被接错。这篇只讲往指定群里发一条会话消息,以及群 ID、@、防刷怎么接。
先确认群类型
内部群:官方机器人 webhook,POST 一段文本即可。
外部群 / 客户群:要由在群里的企微账号发出,走二次开发群消息接口。
webhook 进不了客户群。外部群接口也不该拿去刷内部告警。token、环境、群类型全部拆开。
群消息接口最小集合
校验实例在线
用外部群 ID 发送(禁止群名)
文本先行,再图片文件
回执:成功 / 不在群 / 限频
可选:@ 指定成员(成员也用稳定 ID)
没有 2 和 4,改名或退群后任务会假成功。
@ 不要假装成功
接口若不支持真正 @,文案里不要写「已 @ 全员」。@ 所有人是外部群最贵的注意力,默认关闭。只 @ 当事成员,并确认对方还在群。
群消息默认少发。同一群两次主动推送要有间隔;节点通知可以例外,活动必须审核。
防刷屏
同一
request_id只成功一次同一群同一主题冷却
群内正在客诉,活动类群消息跳过
内部群文案和外部群文案禁止共用
回调或发送结果里要能区分群和私聊,避免把私聊欢迎语打进客户群。
对接
自己维护点进群再发送,会被客户端改版拖死。群消息走 HTTP。QiWe API面向外部群主动推送,按群 ID 调发送即可。
群 ID、消息类型、@ 相关字段以QiWe API文档为准:API文档
验收
改群名仍打到原 ID;退群后失败可理解;重复提交群里一条;未 @ 指令不在本接口里当自动回复滥用。
小结
企业微信群消息接口怎么接:分内外群、主键用群 ID、@ 要真实、发送要冷却。外部群通道用QiWe API接口化后,运营只审名单和文案。群还在、人不静音,比多发一条更值钱。