创建「联系我」二维码客户扫码添加好友收到回调后请求获取客户详情接口返回错误码:84061是为什么?

2025/05/27
提问

时间:2025-05-26 20:01:37.651

步骤:

(1)通过创建「联系我」二维码接口:https://qyapi.weixin.qq.com/cgi-bin/externalcontact/add_contact_way?access_token=ACCESS_TOKEN

(2)联系我二维码:https://wework.qpic.cn/wwpic3az/512662_5JlxbyRuT7OWkGt_1745202205/0

(3)客户扫码添加收到回调:<xml><ToUserName><![CDATA[wx65bfc6dbe274669e]]></ToUserName><FromUserName><![CDATA[sys]]></FromUserName><CreateTime>1748260897</CreateTime><MsgType><![CDATA[event]]></MsgType><Event><![CDATA[change_external_contact]]></Event><ChangeType><![CDATA[add_half_external_contact]]></ChangeType><UserID><![CDATA[10091635]]></UserID><ExternalUserID><![CDATA[wmS37DCAAAon6wlsxr6uEcLjsE-03Qpg]]></ExternalUserID><State><![CDATA[RE-20250421102325005000645]]></State><WelcomeCode><![CDATA[Rj5FgQp_CbbYlMa2BW2KBegdXvtzPeiW3cqzVx82mS4]]></WelcomeCode></xml>

(4)请求获取客户详情接口/cgi-bin/externalcontact/get?access_token=ACCESS_TOKEN

(5)收到响应errcode=84061, errmsg=not external contact, hint: [1748260897128591547134923], from ip: 123.58.243.37, more info at https://open.work.weixin.qq.com/devtool/query?e=84061


问题一:

排查日志发现ChangeType是add_half_external_contact而不是add_external_contact,

在官网查了半天说是客户通过企微APP成员二维码添加了成员,并且成员在设置中设置了添加我为好友时无需验证不添加对方到通讯录才会收到add_half_external_contact这个回调,我上面提供的回调参数有State参数说明客户是通过「联系我」二维码扫码添加的好友并不是通过成员企微APP二维码添加的好友,经过我测试通过企微APP二维码添加的好友回调中是没有State这个参数的。


问题二:

收到回调后查询客户详情接口时却返回84061错误代码,通过排查其他成员日志也有返回add_half_external_contact事件类型时查询查询客户详情接口也有正常返回客户详情的这是为什么?


问题三:

在收到回调后通过WelcomeCode请求发送欢迎语接口:/cgi-bin/externalcontact/send_welcome_msg?access_token=ACCESS_TOKEN

请求参数:request={"welcome_code":"Rj5FgQp_CbbYlMa2BW2KBegdXvtzPeiW3cqzVx82mS4","text":{"content":"亲爱的,感谢您关注新奥燃气企业微信,我们在下方开通了小程序窗口,您可以进入小程序完成燃气缴费、在线维修、下单等功能。\n"},"attachments":[{"miniprogram":{"title":"通知:您的用气账单已生成,请点击查看。","pic_media_id":"3qwjkWVmU3AVis1Tv6aVv62eEebaRKdTOJqWwUzmNzOrTnb9whelaxPLcuOY2BrZW3ivrDuJ07NLGHuwDQS8wxg","appid":"wx13fde910008faf37","page":"pages/xzjh-chat/pages/entryXzjh/entry-xzjh?source=4&type=bill"},"msgtype":"miniprogram"}]}

响应结果:response={"errcode":0,"errmsg":"ok"}


请求发送欢迎语接口响应成功但是并未收到欢迎语请问是什么原因?

回答·1
2025/05/27

add_half_external_contact 半添加事件,此时员工还没有添加客户为好友。所以无法获取到客户详情。


一般是两个可能性:

1:员工当前客户数已满。

2:员工在设置内设置了自动通过客户--不添加到通讯录。需要设置为自动添加到通讯录。

赞同
评论 5
2025/05/27
1:员工当前客户数没满
2:通过「联系我」二维码创建的二维码客户扫码添加好友不受APP里设置了自动通过客户--不添加到通讯录这个限制
赞同
回复
回复 2025/05/27
第2条是存疑的,只能参考,不能当真。最好还是检查一下是不是对方确实设置了这个设置。
赞同
回复
回复 2025/05/27
企微内部应该是没有严格遵循这个机制。但是又不是说完全不遵循这个机制。
赞同
回复
回复 2025/05/27
都试过了,社区里的我看也有跟我类似的问题,但都没有什么有用的答案,之前还是add_external_contact后来就部分员工添加的好友回调是add_half_external_contact,还有就是查询客户详情返回84061这个错误代码说是因为不是好友关系所以返回这个错误,但是我通过APP添加单项好友也可以正常查询到客户详情就是有的时候可以正常调通有个时候就返回84061
赞同
回复
回复 2025/05/27
能查询到单向好友,是客户删除了员工类型的,这种时候,员工没有删除客户,所以可以查询到。

现在这个场景是,客户加了员工,但是员工没加客户。所以查询不到详情。

社区里没什么有用的回答的原因是,都是我们这些社会闲散人员在回答,所以权威回答不多,这个问题,如果能由官方回答,一锤定音比较好。

我个人也比较想知道真正的原因。
赞同
回复
你还未登录,请先登录