企业微信群二维码 API：如何获取客户群二维码？

/* 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;
}

加好友的活码（单人入会话）之前写过，这篇讲它的群版本：客户群二维码——客户扫码直接进群。配置接口、群码与好友码的差异、以及最容易被忽略的一块：群码的生命周期管理（过期、满员、换码）。群码看着是个小功能，投放出去之后的管理功夫才是大头。

群码怎么来：配置群聊联系方式

群二维码不靠"先建群再截图"，正确姿势是配置接口生成：通过联系方式配置接口（addContactWay）创建一条群类型的联系方式，配置里指定进群后自动打什么标签、由哪个群主承接，接口返回二维码链接——这个链接就是可分发的群码。

与好友活码的配置差异点在类型参数：类型选群聊方式，承接主体是群而不是个人销售。二维码链接拿到后，海报、落地页、短信里随便嵌——码是配置的产物，不是群的截图，这决定了它可以随时换、随时统计。

群码与好友活码：三个关键差异

维度

好友活码

群二维码

第三行是重点：好友码配一次能用一年，群码是消耗品——群有人数上限（上限值以文档为准），满了就进不去；二维码有效期到了就扫不出来。投放渠道挂着一个死码，流量默默漏光还没告警——这就是为什么要做生命周期管理。

生命周期管理：巡检与自动换码

群码上量之后，三个巡检动作保平安：

容量监控：group_member_add 事件驱动本地成员计数，群人数逼近上限时提前告警——提前的标准是留出缓冲（比如到 90% 就预警），满员那一刻才发现，已经漏了流量。

有效期巡检：二维码配置的时效字段（以文档为准）入库，临期前 N 天触发换码流程——新码替换海报与落地页里的旧链接。

换码衔接：多群轮换的场景（一群满自动切二群），配置里预挂多个群，切换逻辑做成配置驱动——切群动作本身是运营决策，系统能做的是把"该切了"的信号准时送到。

def check_group_code_health():
for code in active_group_codes():
if code.usage_ratio > 0.9:
alert(f"群 {code.room_id} 人数达 {code.usage_ratio:.0%}，准备换码")
if code.expire_in_days <= 3:
alert(f"群码 {code.id} 将于 {code.expire_date} 过期")

进群之后的闭环：群码的价值在码外

扫码进群只是开始，进群事件（group_member_add）触发的自动化决定这个群的运营质量：群欢迎语（配置方式群欢迎语篇写过）、按 state 打来源标签（渠道溯源的规则与好友活码一致）、高价值客户识别（进群客户如果在 CRM 里是已有客户，通知对应销售做私下触达——群里沉淀关系，会话里做转化，两不耽误）。

统计侧复用活码统计那套口径：按 state 汇总扫码量、进群量、留存率——扫码到进群的漏斗每周看一眼，哪个渠道的码"扫码多进群少"，落地页或码本身就有问题。

群码这篇的要点浓缩成三句：码是配置的产物（可换可统计）、群码是消耗品（要巡检要换码）、进群只是漏斗的中段（码外闭环才是价值）——投放之前把这三句想清楚，群码才不会变成"发出去就没人管的那张图"。