企业微信机器人-应用对接

本文档为 Dora 平台对接企业微信机器人的前置操作流程，请按顺序完成，否则系统无法对接企业微信用户名/ID。

1）必须拥有企业微信管理后台权限；

2）已为 Dora 服务配置域名；

3）已获取 FineAI 组件所在服务器的 IP地址（用于企微可信 IP 配置）。

3.1 创建企业微信自建应用

3.1.1 创建应用

企业微信管理员登录 企业微信管理后台，进入「应用管理>应用>自建」，创建应用

3.1.2 设置应用信息

设置应用logo，应用名称与可见范围，其中可见范围需包括企业中使用机器人的用户/部门，建议选择全员。

3.2 配置「API接收」信息

3.2.1 进入API接收配置页

完成自建应用创建后，自动跳转至应用配置详情页，在「功能>接收消息」中点击「设置API接收」，进入接收消息服务器配置页。

3.2.2 接收消息服务器配置

1）参考以下规则，获取URL

https://{dora服务域名}/{BI服务后缀}/external/api/im/config/wecom/callback

示例：https://www.example.com/decision/external/api/im/config/wecom/callback

2）点击随机获取，系统自动生成 Token 与 EncodingAESKey

注：生成 Token 和 EncodingAESKey 后，先不要点保存！必须先去 Dora 管理后台填写这两项。

3.3 Dora后台配置应用对接

以超级管理员身份进入「Dora 管理后台>用户管理>IM用户映射」，点击应用对接的配置按钮，将上一步获取到的 Token 与 EncodingAESKey 填入弹窗中，并点击下一步，完成对接操作。

3.4 保存API接收

回到企业微信后台，保存【3.2】中的API接收配置。

3.5 配置企业可信IP

回到自建应用配置详情页，前往「开发者接口>企业可信IP」中点击「配置」，在弹窗中添加 Dora 服务的出口 IP 地址，点击确认，完成白名单配置。

3.6 配置CorpSecret与CorpId

3.6.1 获取企业微信CorpSecret与CorpId

1）前往「自建应用>配置详情页>Secret」，点击查看，可获取 CorpSecret

2）前往「我的企业>企业信息」中，下拉页面，获取企业ID

3.6.2 Dora后台添加CorpSecret与CorpId

以超级管理员身份进入「Dora 管理后台>用户管理>IM用户映射」，继续【3.3】步骤的下一步，在弹窗中填入刚刚获取到的 CorpSecret 与 CorpId，点击「测试连接并保存」，页面提示「已配置」，即为配置成功。