最近做的企微二开机器人不能只等客户发消息才回——客户加好友 3 天没聊要主动推个问候、订单状态变了要主动通知、生日要主动发祝福。和之前聊的定时任务不同那篇重点是调度引擎这篇重点是主动推送机制本身——什么时候推、调哪个接口推、频率怎么控、推完怎么确认送达。把调了哪些接口记下来。Eyun 平台开放的企微 API统一 POSTJSON鉴权用 App Token 加 appidAuthorization: Bearer eyk_xxxx路径{BASE_URL}/wx-api/api/模块/动作响应封套{code, data, detail, message, time}code 为 0 成功。主动推送不是定时发消息最早理解偏了以为主动推送就是写个 cron 定时发消息。做完发现主动推送是个完整机制——要有触发条件、内容生成、频率控制、送达确认、失败重试。光定时发不管条件客户被骚扰光发不管送达消息丢了不知道。触发条件什么时候推主动推送的触发有几类时间触发客户加好友 3 天、生日当天事件触发订单状态变化、工单状态变化行为触发客户浏览了产品页、客户在名片页留资阈值触发3 天未跟进、7 天未下单def check_triggers(appid, customer_uin): triggers [] # 加好友3天未聊 if days_since_add(appid, customer_uin) 3 and not has_message(appid, customer_uin): triggers.append({type: no_touch_3d, delay_hours: 0}) # 生日当天 if is_birthday(appid, customer_uin): triggers.append({type: birthday, delay_hours: 9}) # 早上9点发 return triggers触发检查靠事件加定时——事件触发实时响应时间触发定时扫描。主动发消息调 sendText触发后调消息接口主动发消息给客户import requests BASE https://api.eyun.com HEADERS {Authorization: Bearer eyk_xxxx, Content-Type: application/json} def push_message(appid, to_uin, content): resp requests.post( f{BASE}/wx-api/api/message/sendText, headersHEADERS, json{appid: appid, to: to_uin, content: content} ) body resp.json() if body[code] 0: return body[data][msgId] # 消息ID用于回执 raise Exception(body[message])to是客户 uin主动发消息不用conversationId用to。返回的msgId用来查送达状态。接口参数在Eyun 开发文档。发富文本卡片调 sendRichText有些推送适合发卡片——产品推荐、订单状态更新def push_card(appid, to_uin, title, desc, url): card { title: title, description: desc, url: url } resp requests.post( f{BASE}/wx-api/api/message/sendRichText, headersHEADERS, json{appid: appid, to: to_uin, cards: [card]} ) return resp.json()[code] 0卡片比文字更吸引注意力客户点击率高。但卡片成本高要构造、要图片不是所有推送都用卡片。频率控制不打扰客户主动推送最容易翻车的是频率——客户一天收 3 条主动推送直接删好友。频率控制def check_frequency(appid, customer_uin, window_hours24, max_count2): recent count_pushed(appid, customer_uin, window_hours) return recent max_count def push_safe(appid, customer_uin, content): if not check_frequency(appid, customer_uin): return {status: rate_limited} return push_message(appid, customer_uin, content)每个客户 24 小时内最多收 2 条主动推送。超频次的推送延后或取消。不做频率控制客户被骚扰删好友之前做的全都白费。送达确认查消息回执消息发出后要确认送达。调消息接口查回执def check_receipt(appid, msg_id): resp requests.post( f{BASE}/wx-api/api/message/getMessageReceipt, headersHEADERS, json{appid: appid, msgId: msg_id} ) return resp.json()[data] # 送达状态送达状态有已送达、已读、未读。未读的可以再推一次提醒但不要频繁——客户没读可能是忙不是没收到。失败重试和补偿推送失败要重试但不能无限重试def push_with_retry(appid, to_uin, content, max_retry3): for i in range(max_retry): try: return push_message(appid, to_uin, content) except Exception as e: if i max_retry - 1: log_failed_push(appid, to_uin, content, str(e)) return None time.sleep(60 * (i 1)) # 退避重试重试间隔递增——60秒、120秒、180秒。重试 3 次还失败的记日志人工排查。不做重试网络抖动导致消息丢了没人管。推送效果统计推送上线后要统计效果推送成功率发出去了没送达率客户收到了没已读率客户看了没回复率客户回了没删好友率推送后客户删了没这个最关键删好友率是推送效果的负面指标——如果某类推送后删好友率飙升说明这类推送太扰民要调整。关于消息接口和推送机制在Eyun 企业微信 API 平台开通后可以测试。写在最后机器人主动推送这套东西本质是把企微的消息接口用活——sendText 主动发文字、sendRichText 主动发卡片、getMessageReceipt 查送达、加频率控制防骚扰。把触发条件设对、频率控制做严、送达确认做实主动推送才能真正触达客户而不是赶走客户。