配置「联系我」时,有人会把二维码、按钮和小程序当成三种并列的样式去选。2026年11月19日(北京时间)阅读的企业微信开发者文档《客户联系「联系我」管理》并不是这样写的。该页把「通过二维码联系」和「在小程序中联系」写成两种场景;样式参数只用于「在小程序中联系」时的控件样式,附录给的是按钮默认样式的编号,而不是把二维码再单列成一种样式取值。本文只转述该页已经写出的场景、样式和返回结果,不把三种叫法收成官方的三个样式值,也不把这份开发文档写成某家活码产品的后台配置教程。它讨论的是企业微信客户联系里的「联系我」配置,不是个人微信二维码,也不是「加入群聊」的群码。

该页在「配置客户联系「联系我」方式」一节开头写:企业可以在管理后台-客户联系-加客户中配置成员的「联系我」的二维码或者小程序按钮,客户通过扫描二维码或点击小程序上的按钮,即可获取成员联系方式,主动联系到成员。企业可通过此接口,为具有客户联系功能的成员生成专属的「联系我」二维码或者「联系我」按钮。
对应到接口参数,场景是必填项:取值为 1,表示在小程序中联系;取值为 2,表示通过二维码联系。联系方式类型也是必填的:1 为单人,2 为多人。也就是说,先要确定的是「在哪种场景里展示、用二维码还是用小程序按钮」,以及这份配置是单人还是多人,而不是先在一个叫「样式」的字段里,把二维码和按钮混在一起选。
如果配置的是「联系我」按钮,该页写明:需要开发者的小程序接入小程序插件。通过二维码联系这一侧,并没有写同样的插件要求。页面也没有把「不配插件就一定不能用二维码」,或「配了插件就一定能在小程序里打开」写成保证,本文也不补这句。
新增配置时,样式字段是选填的,说明是:在小程序中联系时使用的控件样式,详见附表。获取已配置的方式时,该页写得更清楚:样式是小程序中联系按钮的样式,仅在场景为 1 时返回,详见附录。更新时则写:样式,只针对「在小程序中联系」的配置生效。
附录的原文是:企业微信为「在小程序中联系」按钮提供了如下的默认样式,用户可根据需要自行选择,样式参数和样式的对应关系如下。单人类型列出样式 1、样式 2、样式 3,分别对应取值 1、2、3,并配了样图;多人类型列出样式 1、样式 2,分别对应取值 1、2,同样配了样图。样图没有另写文字名称,也没有把其中某一张标成「二维码样式」或「小程序样式」。因此,不能把附录的编号理解成「1 是二维码、2 是按钮、3 是小程序」。在这份文档里,样式是「在小程序中联系」按钮的默认外观选项;通过二维码联系时,并不靠这个字段来区分展示方式。
新增成功后的返回里,会给出配置 id;「联系我二维码链接」则写明:仅在场景为 2 时返回。获取已配置的方式时也一样:联系二维码的网址,仅在场景为 2 时返回。反过来,按钮样式只在场景为 1 时返回。如果创建时选的是在小程序中联系,却按「一定能拿到一张二维码链接」去理解返回结果,已经和该页的字段说明不一致。
该页还写了:通过接口添加的「联系我」不会在管理端进行展示,每个企业可通过接口最多配置 50 万个「联系我」。用户需要妥善存储返回的配置 id,配置 id 丢失可能导致用户无法编辑或删除「联系我」。这是接口配置和管理端展示的分界,不是本题的主线,只用来说明:拿不到码,或在管理端看不到,不一定等于场景或样式选错了,也可能落在「接口添加的配置本来就不在管理端展示」这一层。列表接口的对象名称也值得记一笔:它写的是获取「联系我」二维码和「联系我」小程序插件列表,并且不包含临时会话;还注明该接口仅可获取 2021 年 7 月 10 日以后创建的「联系我」。
与配置同时写出、但不要夸大的限制还包括:传入的成员和部门需要在此应用的可见范围内;配置的使用成员必须在企业微信激活,且已经过实名认证,且配置了客户联系功能;每个联系方式最多配置 100 个使用成员,这个人数包含部门展开后的成员;成员或部门必须在应用可见范围,或客户可建联的成员范围内。类型为 1(单人)时,用户列表为必填,且只能有一个;部门列表只在类型为 2(多人)时有效。该页没有写「员工或部门被移除后,这份配置是否仍有效」,因此不能根据上述条件自行补出失效或仍然有效的结论。
外部客户添加时是否无需验证,是另一个选填字段,默认值为是。企业自定义的渠道参数用于区分不同的添加渠道,在调用「获取客户详情」时会返回该参数值,不超过 30 个字符。备注信息用于助记,也不超过 30 个字符。这些字段会影响添加过程和渠道识别,但该页没有把它们写成展示样式的取值。
临时会话模式在该页另有专门说明,包括有效期、仅支持单人、仅支持医疗行业企业创建等,不是本题要展开的对象。这里只记下与展示相关的一句:返回或配置二维码链接,仍然受场景字段约束,不能把临时会话的有效期规则,当成「二维码和按钮样式」的差别。
权限方面,调用接口的应用需要满足相应权限:自建应用要配置到「客户联系 可调用接口的应用」中;代开发应用和第三方应用则需具有「配置「联系我」二维码」权限。这是调用条件,不是对某一种样式是否可用的展示说明。
要分清「联系我」在官方文档里怎么展示,可以按下面的顺序对照该页原文,而不是先把它收成三种样式:
- 场景选的是 1(在小程序中联系),还是 2(通过二维码联系)
- 如果是按钮,小程序是否按该页要求接入了小程序插件;样式取值是否按附录,在单人的 1 到 3、或多人的 1 到 2 中选择;不要把样式编号理解成二维码或小程序这两种场景
- 如果是通过二维码联系,是否只在场景为 2 的返回里查找二维码链接;不要在场景为 1 的结果里要求一定出现这张码
- 类型是单人还是多人,这会改变附录里可选的按钮样式数量,也会改变用户列表、部门列表怎么填
- 在管理端找不到时,先分清这是不是通过接口添加、本来就不会在管理端展示的配置,以及配置 id 是否还在
这些核对只帮助判断展示方式落在该页的哪一层,不能写成「按这个清单配置完就一定能扫开或一定能点开」。本文未登录企业微信管理后台,也未调用这些接口,不把某一次生成结果写成已经核实的效果。最终仍以当时对照官方页面核对的结果为准。
[1] 客户联系「联系我」管理 https://developer.work.weixin.qq.com/document/path/92228,最后更新:2026/10/08,访问日期 2026-11-19(北京时间)。该页将场景区分为「在小程序中联系」和「通过二维码联系」,说明样式仅用于小程序中联系按钮的默认外观,二维码链接仅在场景为 2 时返回,并写明配置按钮需接入小程序插件。
