「企业微信消息接口」容易被理解成调一个 send 就结束。能上生产的用法是:分清消息类型、先入队、再用回执对账。这篇只讲消息接口,不讲通讯录。
你要用的是哪一种消息接口
应用消息:员工工作台卡片,官方接口成熟
内部群 webhook:同事群告警
外部群会话消息:企微账号在客户群里发的那条
客户群里要「马上看到一条人话」,是第三种。用应用消息冒充客户触达,客户收不到。
类型先做文本,再做媒体
一期只开放文本。图片、文件要先拿资源 ID 再发,失败时文本仍应完整。不要第一条就上图文混排、小程序卡片。
发送参数锁死:实例 ID、目标 ID(外部群稳定 ID)、type、content、request_id。禁止群名当主键。
消息接口前面必须有队列
同一秒 200 个业务事件,不能同一秒打进一个号。网关按账号限速、按群冷却、按工作时段放行。掉线整账号暂停。
重试带同一request_id。消息接口最难看的现场,是群里连续两条一字不差的通知。
回执状态只留人话
待发送、发送中、成功;失败:离线、不在群、限频、参数错误。
RPA 通道里,接口 200 ≠ 群内可见。运营看板认终态。
现成通道里,QiWe API把外部群消息发送做成 HTTP。业务系统只创建消息任务,不点窗口。
消息类型、异步结果怎么查,对照QiWe API文档:API文档
和官方消息并存
员工审批走官方。客户外部群走二次开发消息接口。同一分钟不要对同一群复读同一句。
小结
企业微信消息接口怎么用:选对落点、文本先行、队列限速、回执分类。需要外部群会话能力时,用QiWe API接发送和回执。推得准、失败能解释,接口才算被用起来。