Skip to main content

企业微信常见问题

注意

常见错误码请参考微信企业api的开发文档:https://work.weixin.qq.com/api/doc#90000/90139/90313,了解具体是什么问题导致的报错。

1. 发送的消息,在微信中收不到,只在企业微信中收到

原因1:企业微信中用户自己设置了“仅在企业微信中接收消息”。

原因2:在微信企业号中屏蔽了应用消息。

img

img

2. 在微信中接收到了待办等消息,却打不开消息详情

原因:外网地址是否没填写对,需要外网能访问的地址。

img

3. 通过oauth认证获取不到当前用户登录信息

原因:vbase服务中的人员账号和微信后台的人员账号不一致。

4. 通讯录管理界面获取不到微信的机构和人员信息

通讯录管理界面:若是获取不到微信的机构和人员信息。

解决方法:

  1. 需要在基本数据信息设置界面选择通讯录的应用;

  2. 配置中心 → 系统高级配置 → 系统维护 → 配置管理 → 微信企业号授权版的配置中,看是否选对了“simple/auth”类型。

img

5. 拍照、获取位置信息、图片上传等提示js-sdk未开启

如果在应用中用到了拍照、获取位置信息、图片上传等手机系统的功能时提示js-sdk未开启。

img

解决方法:配置中心 → 系统高级配置 → 移动端管理 → 微信管理中,开启企业号简单版js-sdk。

img

6. 控制台-微信管理已开启js-sdk,还是提示如下错误

解决方法:如果确认已开启js-sdk服务,则清除cookie

调用的接口如下:

授权版:vbase_wx_qy_yw_api.API_CleanCookie

简单版:vbase_wx_qy_simple_yw_api.API_CleanCookie

img

7. 保存并发布菜单时,提示如下错误

原因:菜单链接写的不完整,缺少“ http ”或者“ https ”头信息。

img

8. 创建应用菜单时,通过选择窗体的方式选不到自己的窗体

原因:该窗体所在的构件没有部署到vbase服务。

9. 新建好应用后,使用微信三大功能(菜单维护,通讯录,消息管理)失败

原因:配置中心 → 系统高级配置 → 系统维护 → 配置管理 → 微信企业号授权版的配置中,看是否选对了“simple/auth”类型。

img

10. 选择应用执行图片上传等功能时提示corpid不正确

原因:选择应用时,授权方企业号id和秘钥是接收应用授权方的企业号id和秘钥。

img

img

11. 自定义框架菜单时,需要注意传参

例如:配置流程发送微信提醒时获取不到应用列表。

原因:加载菜单树时缺少传参。

img

img

img

12. 配置简单版应用时url校验失败

原因1:检查微信后台应用和vbase服务应用中的Token、EncodingAESKey、AgentId、Secret 是否匹配(注意空格)。

原因2:检查oauth认证回调url地址:可能是初始化地址不正确或者回调url地址被人为改动过。

img

13. 对应的suiteticke未从微信端推送到当前应用提供商

解决方法:去微信服务商后台手动刷新一下应用的ticket(即可快速投入使用)。

img

img

14. 将企业微信授权版-通讯录应用授权给企业号使用时提示已开启openapi同步

解决方法:在被授权的企业微信后台-管理工具-通讯录同步中关掉api接口同步。

img

img

15. 微信企业号授权版的应用菜单修改后不生效

原因:需要手动在微信企业后台修改应用的自定义菜单,并且重新授权给企业号。

16. 常见错误码请参考微信企业api的开发文档

17. 私有化微信,开启微信简单版jdk报错

img

解决方法:确认一下是否有填写第三方服务域名【配置管理】窗体下“第三方服务域名管理”下的企业微信服务域名项是否有填写。

img

18. 企业微信自动登录不了,获取不到用户信息

排查步骤&方法:

  1. 检查打开的url是否有进行OAuth验证(配置参数的格式:&wxqyJHOAuthId=企业id|应用id);
  2. 如果用了OAuth验证发现获取不到资源信息报错,则要确认一下环境是怎样搭建的,是否是一个一个构件进行安装的(旧版本才会出现一个一个构件进行安装,这个是错误的安装步骤)。

解决方法:

  1. 34vbase-bizmodules-weixin-qy-impl-oauth-handler ,在服务器下把这个bundle删除,然后重启服务;
  2. 如果进行上述操作会出现设置了OAuth加载出页面,则检查是否配置了web上下文,找不到js,css等文件了,如果有去掉就好了。

20. 授权版多租户使用注意事项

  1. 多租户的环境需要使用授权版的企业微信。

  2. 如果是使用的远程调用应用,那么应该到新建应用的那台服务新增应用菜单;如报销系统是使用远程调用认证中心的应用,所以要到认证中心中新增应用菜单。

  3. 多租户的服务,需要在新建应用的时候将oauth验证回调url的最后面加上“VucTenant”。

    img

  4. 如果是远程调用服务端的应用,那么需要在服务端新增应用的时候将将应用的oauth认证url、oauth认证回调url、数据回调url的地址改为业务系统(客户端)的地址。

    img

  5. 是多租户的服务需要在后台开启授权版的js-sdk。

    img

  6. 新建菜单应用的时候,在【企业应用菜单管理】菜单中进行新增,如果需要自动登录需要勾选上“是否需要OAuth验证”,新增后点击保存,会有应用菜单URI生成,将生成的URI手动填到企业微信后台的菜单中,格式“域名+菜单URI”,如菜单URI为 “?wxV2menuCode=bxsp&wxqyOAuthId=wx3c9f63f9d59637f9”,域名为http://tfr-test.wx.ework360.com/则手动填到微信后台的菜单url为http://tfr-test.wx.ework360.com/?wxV2menuCode=bxsp&wxqyOAuthId=wx3c9f63f9d59637f9

    img

  7. 如果新增了菜单后又对菜单进行了修改,此时会有缓存需要重装应用。

  8. 如果遇到数据回调URL验证不通过的时候,需要看看本地(如报销系统)统一门户客户端的配置是否正确,可以诊断试试看。

    img

  9. 多租户的服务需要在【微信应用】菜单中新增微信附加属性。

    img

  10. 【发送消息-简单版】-根据账号搜索人员的时候提示“请检查输入的账号是否正确或者请选择根节点重试”。

    img

    确认输入的账号信息是正确的情况下还是报这个错,检查一下【通讯录管理_简单版】菜单里有没有选择通讯录应用。

    img

21. 启动企业号、发送信息报错等

解决方案:检查配置中心的域名和可信域名是否去掉 Http://

img

img