让决策更智能
新一代智能数据分析平台

企业微信完全集成方案

观远产品部发表于:2021年03月21日 22:00:04更新于:2021年05月27日 16:37:33

    观远数据支持与企业微信的深度集成,集成后可实现:

  • 观远平台成为企业微信的内嵌应用

  • 从企业微信的应用里访问观远,免密登录(包括企业微信的移动端和PC端)

  • Web端可用企业微信扫码登录

  • 订阅、预警消息推送至企业微信,一键触达

    集成配置步骤——

  • 【企业微信后台】创建观远BI应用

  • 【观远管理后台】填写企业微信应用相关信息,获取回调域名&应用主页链接

  • 【企业微信后台】在观远BI应用中完成授权配置

  • 【观远管理后台】用户属性中关联企业微信账号

    以下详细描述。

1.【企业微信后台】创建观远BI应用

    企业微信管理后台地址:https://work.weixin.qq.com/wework_admin/frame#apps

    在企业微信PC端管理后台——"应用与小程序"里,点击“创建应用”。

image.png

    点击后,填写相关信息即可: 

image.png

    创建完毕后,可获取CorpId、AgentId和Secret,用于随后在观远管理后台进行配置。

    CorpId的获取入口:企业微信管理后台—我的企业—企业信息,此页面最底部

image.png

    AgentId与Secret的获取入口:应用详情页

2.【观远管理后台】填写企业微信应用相关信息

    配置入口:管理员设置—>系统集成—>企业微信配置,填写信息包括CorpId、AgentId和Secret(获取入口如1所述)。

image.png

    填写后,需要"启用",才能正常进行企业微信消息推送和免密/扫码登录。

    同时可获取回调域名以及应用主页链接,用于下一步在企业微信后台进行微应用配置。

    (回调地址可从观远管理后台直接获取。私有化环境下,回调域名地址可在管理员设置->系统管理->高级设置->域名设置中进行配置)

3.【企业微信后台】在观远BI应用中完成授权配置

    点击应用,进入应用的设置页面。

    如果不需要免密登录和扫码登录,则只需要配置"工作台应用主页"即可;如果需要免密登录和扫码登录,则红框中的3个都需要配置。

image.png

    以下详细说明:

    3.1【工作台应用主页】

    填写点击应用后跳转的链接

image.png

    特别注意:

    如需要免密/扫码登录,则此处链接需按照企业微信的要求加上相关参数。(可从观远管理后台直接获取,获取入口即上一步截图中的“应用主页”,一键复制即可。)

    自行拼接链接的格式如下,其中,需要替换的参数有4个,其他复制即可:

    https://open.weixin.qq.com/connect/oauth2/authorize?appid=<corpid>&redirect_uri=<host_url>/m/%3Fprovider%3Dwechatwork%26domain%3D<domain_id>&response_type=code&scope=snsapi_base&agentid=<agentid>&state=MOBILE#wechat_redirect

    1.替换参数说明(替换时不保留< >):

    1)<corpid>,企业的corpid。

    2)<host_url>,授权后重定向的回调链接地址(要带http、https)。

    3)<domain_id>,即域名。私有化部署情况下,该参数也可做缺省处理(即 %26domain%3D<domain_id>这一串可缺省)。

    4)<agentid>,即当前企业微信应用的id。

    2.如不需要免密/扫码登录,则直接填写企业的观远BI登录地址即可。(此处网址需要必须带http或https)

image.png

    3.2【网页授权及JS-SDK】

    填写可信域名,一般填写企业的观远BI登录地址即可。(可从观远管理后台直接获取,获取入口如2所述。)

image.png

    注意:网址不能带http、https等,会标红提示,无法保存。

image.png

    3.3【企业微信授权登录】

    点击后,在Web网页一项中,填写回调地址。(可从观远管理后台直接获取,获取入口如2所述。)

    注意:此处网址不能带http或https。

image.png

4.【观远管理后台】用户属性中关联企业微信账号

    企业微信配置“启用”后,系统会自动添加2个用户基础属性:“企业微信账号”和“企业微信公司名称”。

image.png

    管理员可以给单个用户添加,也可以在“用户基础属性”设置中批量修改配置。

    注1:企业微信账号不是个人微信号,也不是企业微信名称,而是企业微信里的id。用户的企业微信账号查看入口:

    1)企业微信管理后台—通讯录—点击某个用户

image.png

    2)企业微信管理后台—通讯录—批量导出

image.png

    注2:如果您的企业,只配置一个企业微信公司应用,则“企业微信公司名称”这个属性可以为空。

    如果您的企业有多个子公司,且每个子公司单独使用一个企业微信,此处配置了多个公司的企业微信应用,则每个用户属性里必须补充“企业微信公司名称”信息,否则无法正常使用企业微信免密登录、扫码登录和接收消息。

    “企业微信公司名称”这个属性配置值,为下拉选择,选项即企业微信配置时填写的子公司名称。

image.png

效果演示

    1.PC端登录页面出现 企业微信登录入口,点击后可扫码登录。

image.png

    注:如果您的企业配置了多个企业微信公司的应用,则此处点击扫码登录后,需要先选择对应的子公司,得到对应子公司的二维码才能正常扫码登录。

image.png

    2.企业微信手机APP端——工作台中,可看到创建的应用,点击进入即可免密登录到观远平台H5界面。

    3.企业微信PC端应用中,在OA工作台可以看到观远平台应用入口,点击后可免密登录到观远平台。

    4.订阅、预警消息推送至企业微信。

    在配置订阅、预警通知渠道时,可以选择“企业微信”作为触达方式。

image.png

    其他补充信息:

    企业微信免密/扫码登录、消息推送的集成适用于私有化部署用户和SaaS用户,SaaS用户必须在redirect_url中额外配置domain信息。

    SaaS用户可做企业微信内嵌应用的简单集成,通过记住密码来实现快捷登录。

    私有化部署集成企业微信时,请确保观远服务器与企业微信服务器的网络连通。

    如果配置了多个公司的企业微信应用,且某个用户已经设置过企业微信公司名称,后又修改企业微信公司名称,需要对原有用户的属性值做更新。

    举例:原来公司名叫AA,且把小张的“企业微信公司名称”属性值设置为AA。后来在企业微信配置处,把公司名称改为BB,则小张的属性值仍是AA,需要手动更新为BB。


    您需要登录后才可以回复