公有云苍穹：V5.0.013及以上

私有云苍穹：V5.0.011及以上（部分功能V7.0.1及以上支持）

本文将介绍公有云苍穹和私有云苍穹与企业微信的集成方案，通过配置免登和消息渠道，实现企业微信免登访问苍穹和推送流程待办至企业微信。

因企业微信自建应用需要校验可信域名，公有云苍穹的域名会被企业微信判定为服务商域名，无法通过可信域名校验。故公有云是采用金蝶上架企业微信的第三方服务商应用（即星瀚应用管家）方案，私有云则采用企业微信的自建应用方案。

接下来，将分别介绍苍穹公有云和私有云如何与企业微信集成。

1. 安装星瀚应用管家

访问https://qing.ik3cloud.com/kdcloud/install应用管家安装页面，如下图所示，点击第一个应用“星瀚应用管家”的添加按钮，弹出二维码界面，使用企业微信管理员扫码完成安装星瀚应用管家。

图1 安装应用管家

注：人人费用、人人差旅、流程助手3个应用按需扫码安装，非必须。

2. 设置数据中心

企业微信管理员从企业微信工作台打开星瀚应用管家，点击“设置数据中心”>输入苍穹域名>点击“获取数据中心”>选择开启数据中心>弹出验证苍穹管理员界面>输入苍穹管理员的密码验证身份，验证通过即完成设置。

图2 设置数据中心

3. 设置可见范围

企业微信管理员进入企业微信管理后台，通过“应用管理>星瀚应用管家>可见范围"，设置哪些用户可以使用星瀚应用管家。

图3 设置可见范围

4. 添加应用菜单

星瀚应用管家默认预置“流程助手”和“人人费用”，管理员可按需添加需要在企业微信访问的苍穹表单页面或轻分析。

苍穹管理员打开星瀚应用管家>点击页面下方“应用管理”>进入应用管理界面>点击“添加应用”>进入应用编辑界面>添加苍穹表单页面或轻分析。

图4 添加应用菜单

5. 购买许可

星瀚应用管家自扫码安装日起90天试用，为避免影响正常使用，请在试用到期前购买许可（企业微信基础账号），超期未购买许可并绑定序列号，则将无法再使用星瀚应用管家。

联系金蝶销售人员在KBC订购产品：企业微信基础账号（编码：SBOM-2023-0144），订购企业微信基础账号需要从外购通用软件产品中选择，签约主体为金蝶中国或机构主体。

图5 购买许可

6. 绑定序列号

在KBC购买企业微信基础账号许可后，系统将向订单中填写的邮箱地址发送产品序列号，如邮箱未收到邮件，请联系金蝶销售人员。

企业微信管理员在进入星瀚应用管家过程中有个加载过渡页面，点击页面的"轻应用设置"-->序列号-->输入企业微信基础账号的产品序列号-->点击"确定"完成绑定。

图6 绑定序列号

注：一个序列号仅能使用一次，在绑定前请确认绑定的企业微信组织，避免序列号绑到企业微信测试组织上，绑定后无法撤销操作，请谨慎操作。

7. 启用消息渠道

如需将苍穹待办消息推送至企业微信，需启用公有云企业微信消息渠道，并配置消息类型。若推送流程待办还需要在对应的流程设计中启用“发送渠道待办”。

苍穹管理员登录苍穹PC端>基础服务云>公共设置>消息设置>消息渠道>启用编码为“kingdee_sky”的消息渠道。

图7 配置消息渠道

渠道启用后，在基础服务云>公共设置>消息设置>消息类型>配置不同类型消息的发送渠道，才能在对应渠道收到消息。

图8 配置消息类型>发送渠道

注：用户需先在企业微信手工输入账密登录一次，绑定映射关系后才能成功推送消息给用户。

1. 创建企业微信应用

企业微信管理员账号登录企业微信管理后台，进入应用管理>点击“创建应用”，上传应用logo，填写应用名称、应用介绍，设置应用的可见范围（哪些用户可使用此应用），最后点击【创建应用】完成创建。

图9 创建企业微信应用

完成应用创建后，获取应用的AgentId和Secret，以及企业ID（后面配置需要用到）。其中AgentId和Secret在应用详情页获取，企业ID在“我的企业”页面获取。

2. 苍穹端配置

使用管理员账号登录苍穹，进入系统服务云>第三方服务设置>企业协同软件配置>企业微信>点击“添加应用”空白卡片创建应用。

填写企业ID、企业名称、应用ID、应用名称、应用秘钥等信息，其中企业ID、应用ID、应用秘钥即前面在企业微信管理后台获取的企业ID、AgentId和Secret，填写完成后点击“保存”。

图10 苍穹端配置

注：V7.0以上版本无需配置插件，低版本则需在MC配置authtication.apps参数，参数值为kd.bos.login.thirdauth.app.tencent.WxqyhAuthtication

3. 设置应用主页

企业微信管理员进入企业微信管理后台>打开先前创建的应用详细页>点击应用主页的“设置”>弹出“设置工作台应用主页”界面>设置企业微信应用免登打开的苍穹页面地址。

图11 设置应用主页1

图12 设置应用主页2

注：V7.0以上版本可通过苍穹端配置页面的“获取主页地址”一键生成PC端和移动端免应用主页链接地址，低版本则需手动构造链接地址。

图12 一键生成URL

4. 设置可信域名

企业微信管理员进入企业微信管理后台>先前创建的应用详细页>开发者接口“网页授权及JS-SDK”>点击“设置可信域名”。

图13 设置可信域名1

在设置可信域名界面，将苍穹域名地址填写到“可信域名”输入框。

图14 设置可信域名2

点击“申请校验域名”，根据提示“下载文件”，并部署到苍穹web站点根目录下。

图15 设置可信域名3

5. 设置企业可信IP

在应用详情页面的开发者接口“企业可信IP”点击“配置”，弹出企业可信IP输入框，填写苍穹部署的服务器IP，点击“确定”，保存成功。

图16 设置企业可信IP

注：V7.0以上版本可通过苍穹端配置页面的“获取可信IP”一键获取，低版本则需自行查询服务器IP地址。

图17 获取可信IP

6. 配置检测

完成苍穹端和企业微信端配置后，可在苍穹端的配置列表获详情页点击【配置检测】按钮，进行关键配置检测。

注：仅V7.0以上版本支持此功能。

图18 配置检测

7. 异常日志

完成以上配置，在企业微信端尝试访问苍穹应用，如未免账密登录，可在苍穹端的配置列表下的异常日志查看错误日志，通过日志分析排查问题。

注：仅V7.0以上版本支持此功能。

图19 异常日志

8. 启用消息渠道

如需将苍穹待办消息推送至企业微信，需启用公有云企业微信消息渠道和配置消息类型，若推送流程待办还需要在对应的流程设计中启用“发送渠道待办”。

苍穹管理员登录苍穹PC端>基础服务云>公共设置>消息设置>消息渠道>启用编码为“weixinqy”的消息渠道。

图20 配置消息渠道

渠道启用后，在基础服务云>公共设置>消息设置>消息类型>配置不同类型消息的发送渠道，才能在对应渠道收到消息。

图21 配置消息类型>发送渠道

注：用户需先在企业微信免登一次，绑定映射关系后才能成功推送消息给用户。

1. 公有云星瀚应用管家，首次登录需手工输入账密登录一次绑定映射关系；私有云自建应用，首次登录用户授权后即可免账密登录。

2. 推送企业微信消息待办的前提条件，用户须在企业微信登录过苍穹绑定了映射关系，否则用户无法收到消息待办。

企业微信免登私有云苍穹：https://vip.kingdee.com/link/s/ZG7jr

企业微信免登公有云苍穹：https://vip.kingdee.com/link/s/ZG74z

私有云云之家免登苍穹： https://vip.kingdee.com/link/s/ZMRpI

公有云云之家免登苍穹：https://vip.kingdee.com/link/s/ZJtos

钉钉免登苍穹：https://vip.kingdee.com/link/s/ZzIUg

飞书免登苍穹：https://vip.kingdee.com/link/s/ZJtUj

WeLink免登苍穹：https://vip.kingdee.com/link/s/Zmg3y

微信公众号免登苍穹：https://vip.kingdee.com/link/s/ZYhmI

对文章有任何疑问或建议，欢迎评论区留言~