资讯 / 文章页

「联系我」里配置的 state,是用来区分添加渠道的吗?先看官方对这个自定义参数的说明

微信活码
2026-11-21

配置企业微信「联系我」时,有人会把接口里的「state」理解成可有可无的备注,也有人看见「渠道」二字,就把它和别的渠道参数、甚至「加入群聊」里的同名参数当成同一个开关。2026年11月21日(北京时间)阅读的企业微信开发者文档《客户联系「联系我」管理》(页标最后更新 2026/10/08),在「配置客户联系「联系我」方式」的参数说明里写:「state」为非必填项,企业自定义的 state 参数,用于区分不同的添加渠道,在调用「获取客户详情」时会返回该参数值,不超过 30 个字符。以下只转述该页对这一参数的含义、长

https://cdn2.quma.cn/uploads/2/2026/11/21/Ftld7MHItSrHZ9iW6Xgb1ubELcFx.jpg

度和返回时机的说明。本文未登录企业微信管理后台,不能把接口参数写成管理端一定已有同名开关,也不能编造后台字段位置或扫码实测结果,更不宣称任何第三方工具已经接入该接口。

官方把 state 写成可选的企业自定义参数

在「配置客户联系「联系我」方式」一节,官方先说明:企业可以在管理后台-客户联系-加客户中配置成员的「联系我」的二维码或者小程序按钮;同时,企业可通过此接口为具有客户联系功能的成员生成专属的「联系我」二维码或者「联系我」按钮。参数表随接口给出,其中「state」的「必须」列为「否」,说明它不是必填项。

同一张参数表里,还有同样不超过 30 个字符的「remark」。官方对「remark」的说明是:联系方式的备注信息,用于助记,不超过 30 个字符。它和「state」字数上限看起来相近,但用途不是同一句:一个是助记用的备注,一个是企业自定义、用来区分添加渠道的参数。不能因为都叫自定义、都有字数限制,就把备注当成渠道参数,或把「state」理解成只给自己看的备忘。

该页还写:通过 API 添加的「联系我」不会在管理端进行展示。管理端可以配置「联系我」的二维码或按钮,和接口配置不是自动出现在同一处的展示范围。本文只在分界时点到这一层,不把「state」写成管理端菜单里已经核过的某个字段名,也不重写管理端与接口配置的总论。

页上已经写明:用于区分不同的添加渠道,并在获取客户详情时返回

和本题直接对应的原文,就是这一句:企业自定义的 state 参数,用于区分不同的添加渠道,在调用「获取客户详情」时会返回该参数值,不超过 30 个字符。

这句话里已经有三层意思。第一,参数是企业自定义的。第二,用途被写明为「用于区分不同的添加渠道」。第三,返回时机被写明为:在调用「获取客户详情」时会返回该参数值。也就是说,按官方已经给出的说明,把「state」理解成用来区分添加渠道,是有原文依据的;但它并不是扫码当时就在页面上显示出来的说明文字,而是在调用「获取客户详情」时才会返回的参数值。

同一页「获取企业已配置的「联系我」方式」返回说明里,也出现了「state」,表述同样是:企业自定义的 state 参数,用于区分不同的添加渠道,在调用「获取客户详情」时会返回该参数值。「更新企业已配置的「联系我」方式」的参数说明里,用途和返回时机的表述与此相同,但该处没有再次写出「不超过 30 个字符」。本文按各表已写内容转述,不自行补成更新时一定相同或一定不同的字数规则,也不把「获取客户详情」展开成另一套接口教程。

长度和出现位置要按原文来看,不要扩写成后台开关

新增配置的参数说明里,明确写了「不超过 30 个字符」。这是该页对「state」已经给出的长度边界。页面没有再解释这里的「字符」是否按某种编码另行计算,也没有写超长时会如何提示。没有写明的处理方式,不能补成已经核实的规则。

「state」出现在接口参数说明和返回说明里,并不等于已经证明管理后台的配置界面里一定有一个同名输入项。该页只写到管理后台可以配置「联系我」的二维码或小程序按钮,没有在管理端那一句里点出「state」字段的名称或位置。未登录管理后台,就不能把接口参数写成「管理端一定已有同名开关」,也不能指认它在哪个菜单、哪个输入框。

同样,页上也没有写客户扫码或点击按钮时会看到「state」,更没有给出不同「state」值对应的实测添加结果。这些都超出了原文,不能写成已经发生过的操作结论。「外部客户添加时是否无需验证」「单人/多人」「临时会话模式」「通过二维码联系或在小程序中联系」等,是同一张参数表里的其他项,只在分界时点到,不在本题展开。

不要和其他渠道参数或「加入群聊」里的 state 混成同一个对象

实际配置里,还容易把这里的「state」和另外两类对象收成一句话。一类是获客链接后面另行拼接的渠道参数,它不是本页「联系我」配置参数表里的「state」,本文不展开。另一类是客户群「加入群聊」配置里也有一个名为「state」的企业自定义参数。

2026年11月21日(北京时间)为分界核读的《客户群「加入群聊」管理》把那里的「state」写成:企业自定义的 state 参数,用于区分不同的入群渠道;如果有设置此参数,在调用获取客户群详情接口时会返回每个群成员对应的该参数值。该次摘录未见页标最后更新日期。两相对照,「联系我」里的「state」区分的是添加渠道,返回时机写的是调用「获取客户详情」;「加入群聊」里的「state」区分的是入群渠道,返回时机写的是获取客户群详情。名称相同,并不是同一个配置对象。本题只点到这一分界,不把「加入群聊」写成另一篇参数说明。

核对时只回到官方已写明的含义、长度和返回时机

要判断「联系我」里配置的「state」是不是用来区分添加渠道,可以按该页已经写出的内容来核对。

第一,「state」在配置「联系我」方式时是可选的企业自定义参数,不是必填项,也不能把它和用于助记的「remark」当成同一项。

第二,官方已经写明它用于区分不同的添加渠道,并在调用「获取客户详情」时返回该参数值;新增配置的说明里还写了不超过 30 个字符。

第三,不要把接口参数写成管理端一定已有同名开关,也不要在未登录、未实测时补扫码可见结果或后台字段位置。

第四,获客链接后拼接的渠道参数,以及「加入群聊」配置里用于区分入群渠道的「state」,都不是本题的主对象,不要收成同一个开关。

第五,无需验证、分配、临时会话、场景和按钮样式等,是同一份文档里的其他配置,只作分界,不在本题展开。

本文依据的是 2026年11月21日(北京时间)阅读的《客户联系「联系我」管理》现有表述,未登录企业微信管理后台,也未调用配置或「获取客户详情」接口做实测。页上没写管理端是否提供同名输入项,也没写客户添加过程中如何展示该参数,这些都仍未核实。最终只能以当时页面已经写出的含义、长度和返回时机为准。

参考资料

客户联系「联系我」管理 https://developer.work.weixin.qq.com/document/path/92228 (页标最后更新 2026/10/08,2026年11月21日北京时间阅读)

客户群「加入群聊」管理 https://developer.work.weixin.qq.com/document/path/92229 (2026年11月21日北京时间分界核读,本次摘录未见页标最后更新日期)

购买咨询
微信扫码咨询
400-600-7511