企业微信参数配置

功能及平台机制说明

提供与企业微信第三方平台配置参数功能 从39版本开始，第三方平台参数配置都在门户的统一通用配置中设置参数，包括企业微信、钉钉、短信、邮件、双重认证、水印、门户配置等

具体操作

  1. 在官网进行企业微信注册，具体可参考官网注册说明。
  2. 进入企业微信管理后台，打开【我的企业】页面，企业ID即企业微信CorpId
  3. 打开应用管理页面的自建应用中，点击+创建应用
  4. 创建完成后，即可企业微信AgentId、企业微信应用Secret.png)
  5. 如上配置完成后，在门户应用中的系统配置下，打开统一通用配置功能。
  6. 点击添加按钮，在打开的配置项页面中，选择企业微信配置项确定
  7. 打开参数设置页面，在配置项中进行参数设置

  8. 配置项参数说明如下：

    1. CorpId：填写企业微信ID,必填
    2. 授权服务URL：私有部署企业微信环境下的url地址，具体URL地址参考私有部署的环境，私有部署情况下必填
    3. AgentId：填写创建企业微信应用的AgentId，必填
    4. 应用Secre：填写创建企业微信应用的Secret，必填
    5. 通讯录回调Secret：填写企业微信通讯录回调Secret，目前可不填
    6. 通讯录回调Token：填写企业微信通讯录回调Token，目前可不填
    7. 通讯录Secret：填写企业微信通讯录Secret，必填
    8. 用户自动映射：新增特性，针对组织和企业微信组织各自独立不需要同步组织情况下，设置为用户ID自动映射后，只要门户的组织账号和企业微信组织的ID一致，即可完成自动映射(注：原需要企业微信和门户组织账号是通过企业集成应用中的映射表进行映射)
    9. 禁用用户同步：针对门户组织自动往企业微信同步时使用；1、设置为禁用时，组织禁用状态同时会同步到企业微信；2、设置为删除时，门户里禁用状态的组织，对应企业微信组织会被直接删除（此选项前提必须是全量同步过一次，禁用/删除才会生效）
    10. 是否同步别名：针对门户组织自动往企业微信同步时使用，从平台组织里同步到企业微信时有别名，导致在通讯录里看到xxx(xxx)，不想看到别名时，此选项设置为否。
    11. 排除字段：针对门户组织自动往企业微信同步时使用，在同步时可以排除一些字段值不同步到企业微信中，目前可以配置的有“职位、别名、地址、座机”，多个值用逗号“,”分隔
    12. 是否同步不存在禁用用户：针对门户组织自动往企业微信同步且在企业微信里组织不存在时使用，选项设置为否时，门户组织里禁用状态组织则不再同步到企业微信中
    13. 是否忽略用户同步错误：针对门户组织自动往企业微信同步时使用，当用户手机号不全时，组织同步日志中会提示错误提示，如想忽略则设置此属性为是；

    14. 仅同步选中部门及子部门：针对门户组织自动往企业微信同步且只同步某个节点下组织情况下使用，属性值填写组织编码路径，多个组织使用逗号分隔

      1. 打开组织管理，选中要同步的组织或者子组织，勾选显示组织全路径编码

    15. 人员扩展字段映射：针对企业微信通讯录管理中自定义字段值与门户组织扩展字段映射配置属性

      1. 如上图中配置映射规则为：企业微信自定义字段：门户users表中字段，多个字段映射使用用逗号分隔
      2. 是否开启模拟同步：开启模拟同步选项后，当组织进行自动同步时，在企业集成-模拟同步记录功能中可查看模拟同步信息。
      3. 接收消息回调Token：针对发送的按钮交互型应用消息进行更新任务卡片消息中按钮状态设置时使用。
      4. 接收消息回调AES密钥：针对发送的按钮交互型应用消息进行更新任务卡片消息中按钮状态设置时使用。
  9. 如上必填项参数配置完成后，在门户-系统管理-第三方平台配置-企业微信配置功能里会自动生成一个企业微信工作台URL地址，这个地址需要复制到企业微信后台自建应用的应用主页中，用于后续从企业微信中打开自建应用打开企业门户主页
  10. 进入企业微信后台，打开自建应用，在功能区，选择工作台应用主页，设置应用主页（使用步骤11中获取的工作台URL地址）
  11. 在开发者接口区，对网页授权及JS-SDK、企业微信授权登录设置业务域名（注：只需配置域名，由于企业微信调整，目前新建应用设置可信域名都需要进行域名归属校验）。
    1. 在平台中进行域名归属校验步骤如下：
      1. 下载校验文件（微信公众平台配置业务域名里获取校验文件）
      2. 登录微信后台配置业务域名里下载校验文件
    2. 通过提供的mini-server 插件用于快速添加 API实现校验文件配置
      1. 打开“应用服务管理-企业门户-更多-网关”，
      2. 选择所有服务，开启 mini-server，设置插件参数
      3. 插件参数说明如下：
        • token 中的值是固定的 Ignore-Validation
        • servers 中可以添加多个配置
        • 配置名称：输入一个名称
        • 请求路径：以 / 开头，访问时前面加上应用的域名
        • 返回内容：请求返回的内容
        • 直接发送
    3. 配置后，执行智能更新网关插件，在浏览器中访问，访问地址为：应用域名 + 请求路径，返回请求路径中的内容即表示配置正确。
  1. 由于企业微信接口调整 ，新建自建应用，在企业微信后台开发者接口中，企业微信可信ip属性必须设置，

results matching ""

    No results matching ""