独享版的用户如果需要创建企业微信集成模式版的账号,需要先创建企业,然后进行企业微信绑定。
创建企业时,需要填写以下信息:
这一步需要登录 企业微信管理后台,获取企业微信有关参数与简道云账号进行绑定。
然后在「应用管理 >> 应用 >> 自建」新建一个自建应用,这一步是为了获取后文需要配置的自建应用ID、自建应用 secret 等参数。如下图所示:
填写基础资料后点击「创建应用」,如下图所示:
创建应用后,将应用中的 AgentId 和 Secret 分别复制下来进行备份:
备份后继续滑动页面至底部,在「开发者接口 >> 网页授权及JS-SDK >> 设置可信域名」处「申请校验域名」,如下图所示:
在校验弹窗中,获取域名验证文件内容进行备份,如下图所示:
将下载好的文件上传至独享版控制台处:
先确认验证文件在指定域名下可以访问,校验地址:
https://private.yourdomain.com/WW_verify_xxxxxxxx.txt
地址中的部分参数需要替换成您自己的参数:
当访问后显示的文件名与校验地址的文件名一致时,即表示可访问,效果如下:
自建应用需要设置企业可信 IP,企业可信 IP 为本企业服务器的 IP 地址,仅所配 IP 可通过接口获取企业数据。
上滑页面,在「功能>>接收消息>>设置API接收」处点击随机获取按钮,分别获取 Token 和 EncodingAESKey 数据,如下图所示:
注:获取后请勿关闭此页面,后续还需返回此页面操作。
登录独享版控制台,在企业管理处找到本文【2.节】创建的企业,点击企业详情,切换集成模式至「企业微信集成」。然后将上述步骤获取的所有参数分别配置到对应的位置,如下图所示:
参数对应关系如下:
企业微信相关参数 | 对应独享版企业填写内容 |
企业 ID | 本文【3.1节】获取的企业 ID |
AgentId | 自建应用 ID |
Secret | 自建应用 secret |
Token | 消息编码 token |
EncodingAESKey | 消息编码 aes_key |
全部填写好以后点击提交。
回到【3.5节】的页面继续设置回调地址,回调地址的组成如下:
https://private.yourdomain.com/wxwork/corp/{corpid}/service
地址中的部分参数需要替换成您自己的参数:
将替换好的地址填入下图所示的位置:
设置好以后,点击「保存」。
在企业自建应用中设置主页地址,主页地址的组成如下:
https://private.yourdomain.com/wxwork/{corpid}/dashboard
地址中的部分参数需要替换成您自己的参数:
设置主页网页地址,并勾选在「微信插件中始终进入主页」,如下图所示:
在「开发者接口 >> 网页授权及JS-SDK」设置可信域名,域名地址为您绑定的独享版账号的域名,无需设置“https//:”等协议头,正确示例如下:
private.yourdomain.com
配置域名后点击「申请校验」,如下图所示:
然后勾选「用于OAuth2.0回调的可信域名是否校验」后点击确定,如下图所示:
校验成功后,会提示「修改成功」,如下图所示:
检验不通过则无法保存回调地址的设置,可以检查域名及之前的各项配置是否正确。
在自建应用中的「开发者接口 >> 企业微信授权登录」设置免登回调域:
域名地址为您绑定的独享版账号的域名,无需设置“https//:”等协议头,正确示例如下:
private.yourdomain.com
设置后点击「保存」,如下图所示:
至此,账号集成相关配置已全部完成。
登录独享版控制台,点击基础信息中的访问地址,通过企业管理员用户名和密码可登录企业中:
登录后可以看到,企业已由「内置模式」更换为「企业微信集成模式」,如下图所示:
登录 通讯录,可以看到已经同步过来的企业微信成员,如下图所示:
除创建者身份以外的其他成员(包括管理员)登录简道云时,可以通过企业账号 URL 扫码进行登录。如下图所示:
也可以直接在「企业微信工作台 >> 绑定的简道云应用」中直接登录。如下图所示:
1)管理中心填写 corpId 和 secret 错误:可能是真的填错了,也可能是企业微信自建应用的可信 IP 配置错误。
2)企业微信后台回调验证 openapi 失败:可以根据页面引导进行处理,如果还有问题可以找联系简道云技术支持让研发进行介入。