客户点了获客链接,有人会马上去获客客户列表里查找:只要点过,是不是就应该出现在列表里,哪怕双方还没有加为好友。2026年11月22日(北京时间)阅读的企业微信开发者中心《获取由获客链接添加的客户信息》(页标最后更新 2026/02/06)把这一接口写成:企业可通过此接口获取到由指定的获客链接添加的客户列表。同一天并行阅读的《获取获客转化数据指引》(页标最后更新 2026/10/09)则把「客户发起好友申请」和「客户添加成功」等写成获客转化数据里的不同对象,并在授权到期影响表里,把「微信客户打开获客链接」「发起好友请求事件」「添加成功事件」分列成不同回调。下面按原文转述这份客户列表的返回范围,以及它和转化数据对象的分界。页上没有写「一定查不到」,也没有写点击量口径或未登录时看不见的后台菜单位置,本文都不补写。本文不是完整的接口对接教程,也不宣称任何第三方工具已经接入该能力。
该页标题是「获取由获客链接添加的客户信息」,正文只有一节,标题为「获取获客客户列表」。节首第一句写:企业可通过此接口获取到由指定的获客链接添加的客户列表。请求里需要提供「link_id」,说明是获客链接 id,并写明需要是当前应用创建。
按这句已经写出的对象,接口要获取的是「由指定的获客链接添加的客户列表」。页上反复使用的是「添加的客户」,而不是「点击了链接的人」或「发起了好友申请但尚未添加成功的人」。要判断「点了但还没加到好友,能不能在这个列表里查到」,应先对到「添加的客户」这一返回范围,而不能把「点过」和「已经添加」收成同一种结果。
该页没有另外写一句「未添加成功的一定不会出现」或「点击后立刻就能查到」。本文只转述它已经写明的对象范围,不把这两句页上没有的话补进去,也不把未登录管理后台时看不到的列表界面写成已经核实的查询结果。同样,页上没有给出点击量、发起申请数量或「待通过好友」这类口径,不能把「customer_list」理解成这些过程数据的汇总查询。
在返回结果里,列表字段名为「customer_list」。字段说明包括:客户的「external_userid」;「userid」,被解释为通过获客链接添加此客户的跟进人 userid;「chat_status」,被解释为会话状态,取值是 0-客户未发消息、1-客户已发送消息、2-客户发送消息状态未知;以及「state」,用于区分客户具体是通过哪个获客链接进行添加。
这几项都是在「添加此客户」之后展开的。「userid」写的是添加此客户的跟进人;「chat_status」区分的是客户有没有发消息,或发送消息状态是否未知,并不是「有没有点开链接」或「有没有发出好友申请」。把「客户未发消息」读成「还没加到好友」,并不符合页上已经给出的取值说明。
「state」一节里出现了「点击」二字:用户可在获客链接后拼接「customer_channel」自定义字符串;通过点击带有该参数的链接获取到的客户,调用获客信息接口或获取客户详情接口时,返回的 state 参数即为链接后拼接的自定义字符串。这句说的是:已经获取到的客户,如何用链接上的渠道参数区分来源。它不是把「仅完成点击、尚未添加」写成「customer_list」里的一类记录。
并行核读的《获取获客转化数据指引》把「获客转化数据」解释为:广告投放时的转化数据,包括客户发起好友申请、客户添加成功、客户首次或多次发消息等。这里已经把「发起好友申请」和「客户添加成功」并列写出,可见在转化数据里,二者不是同一件事。
同一页的「授权到期影响」表,又把相关回调和接口分列开来,名称包括:微信客户打开获客链接、发起好友请求事件、添加成功事件、成员首次收消息事件、成员多次收消息事件、客户删除成员事件,以及「获取获客链接使用成员接受消息数据」。也就是说,官方在转化数据场景里,把「打开获客链接」「发起好友请求」和「添加成功」写成了不同的事件对象。
这张表里没有列入「获取由获客链接添加的客户信息」,也没有列入「获取获客客户列表」。因此,不能用转化数据授权到期后「不会收到回调」之类的表现,去改写客户列表接口的返回范围;反过来,也不能把客户列表理解成已经覆盖了打开链接、发起申请、添加成功全部过程。两页说的是不同对象,只并列对照,不自行收成一套更完整的查询口径。该指引里关于定期授权、有效期和管理入口的说明,属于转化数据授权机制,不是本题要展开的内容。
要判断「点了获客链接但还没加到好友,能不能在获客客户列表里查到」,可以按官方已经写出的层次来核对。
第一,《获取由获客链接添加的客户信息》把接口对象写成「由指定的获客链接添加的客户列表」,标题和节首用的都是「添加的客户」,不是「点过链接的人」。
第二,返回字段里的跟进人、会话状态,都是围绕已经添加的客户来写的。会话状态区分的是客户是否已发消息,不能读成加好友是否完成。
第三,「state」里提到的「点击」,只用于解释带「customer_channel」参数的链接如何回传渠道标识,不能证明未添加的点击记录会出现在该列表中。
第四,《获取获客转化数据指引》把打开获客链接、发起好友申请和添加成功分成不同对象;这些事件与「添加的客户列表」不是同一套返回范围。页上没有把点击量或待通过申请写成该列表的查询结果。
第五,页上没有写管理后台是否另有同名列表、未添加记录会不会出现在某个菜单里,也没有写「一定查不到」。未登录企业微信管理后台,这些都不能补写。获客链接本身能否继续使用、额度用尽后申请如何处理、已经是好友再点链接会分给谁,属于其他已经单独说明的问题,不能用来改写这份客户列表的返回范围。
本文依据的是 2026年11月22日(北京时间)阅读的上述公开文档,未调用接口,也未在管理后台查看获客客户列表。页上未写明的后台展示口径,以及第三方工具是否接入该能力,都仍未核实。最终只能以当时页面已经写出的返回范围和对象分界为准。
获取由获客链接添加的客户信息 https://developer.work.weixin.qq.com/document/path/101359 (页标最后更新 2026/02/06,2026年11月22日北京时间阅读)
获取获客转化数据指引 https://developer.work.weixin.qq.com/document/path/101893 (页标最后更新 2026/10/09,2026年11月22日北京时间阅读)
