肇新合同肇新合同2.0文档中心
功能介绍
功能介绍

集成与通知配置指南

详解系统邮件、短信、钉钉、企业微信、飞书及OnlyOffice集成配置步骤与推送规则，帮助管理员快速完成第三方集成。 系统设置 - 集成与通知配置指南

肇新合同官方 2026-07-18 次阅读

适用角色：系统管理员
使用阶段：系统首次上线前、通知渠道调整时、第三方平台接入时
前置条件：已完成基础系统参数配置；如需组织同步，需具备对应第三方平台管理员权限
操作路径：【管理后台】→【开发管理】→【参数设置】→【集成与通知】
权限：需要管理员权限
关联文档：00-角色与系统初始化总览、01-系统设置-通用配置、03-组织架构管理、07-通知模板与提醒

本节介绍如何配置邮件、短信、钉钉、企业微信、飞书等第三方集成，以及 OnlyOffice 在线编辑。配置完成后需要点击「保存」按钮生效。

一、邮件配置

配置邮件通知的 SMTP 服务器信息，用于任务中心待办通知推送。

推送规则

  • 任务中心产生新待办时，自动向处理人发送邮件通知
  • 待办转交给其他人办理时，自动向新处理人发送邮件通知
  • 审批完成时，自动向发起人发送结果通知邮件
  • 用户需在「个人中心」中填写邮箱地址，否则无法收到邮件

可配置项

  • 启用邮件通知：关闭/开启
  • SMTP服务器：邮件服务器地址，如 smtp.exmail.qq.com
  • 端口：SMTP 端口，如 465
  • 发送账号：用于发送邮件的邮箱地址
  • 密码/授权码：邮箱密码或 SMTP 授权码
  • 启用SSL：关闭/开启
  • 系统访问地址：邮件中「查看详情」按钮的跳转地址前缀，如 https://your-domain.com
  • 邮件布局模板：所有邮件共用的 HTML 外层模板，使用 ${emailBody} 作为正文占位符。修改后所有邮件立即生效。可点击「预览效果」查看

配置步骤

  1. 登录邮箱（如腾讯企业邮箱），在设置中开启 SMTP 服务，获取授权码
  2. 在系统中填写 SMTP 服务器地址和端口
  3. 填写发送账号和密码/授权码
  4. 填写系统访问地址（用于邮件中的跳转链接）
  5. 点击「保存」
  6. 点击「发送测试邮件」验证配置是否正确

二、短信配置

用于任务中心待办、转办和审批结果等短信通知推送。

推送规则与前置条件

  • 任务中心产生新待办时，自动向处理人发送短信通知
  • 待办转交给其他人办理时，自动向新处理人发送短信通知
  • 审批完成时，自动向发起人发送结果通知短信
  • 用户需在系统中绑定手机号，否则无法收到短信
  • 需先在已接入的短信服务平台创建应用、签名和模板，并通过审核
  • 完成此处配置后，还需前往【管理后台】→【消息推送管理】→【通知模板】为每个业务场景配置对应的短信模板ID和短信参数顺序，否则短信将不会发送

开通步骤

  1. 开通短信服务：在企业实际使用的短信服务平台开通短信能力
  2. 获取接口凭证：获取系统配置页面所需的接口密钥或应用标识
  3. 创建短信签名：在短信服务平台创建签名并等待审核通过
  4. 创建短信模板：创建通知类模板，记录模板 ID
  5. 配置消息模板：前往【管理后台】→【消息推送管理】→【通知模板】为每个业务场景配置短信模板 ID 和参数顺序

可配置项

  • 启用短信通知：关闭/开启
  • SecretId：短信服务接口密钥标识
  • SecretKey：短信服务接口密钥
  • SDKAppID：短信应用 ID
  • 短信签名：签名内容，需在短信服务平台创建并审核通过

三、钉钉配置

配置钉钉集成、登录、组织架构同步和消息推送。

推送规则与前置条件

  • 消息推送需先完成「组织架构同步」，建立钉钉用户与系统用户的映射关系
  • 在「用户管理」页面点击「同步钉钉」即可一键同步
  • 未同步用户不影响系统使用，仅无法收到钉钉消息推送

3.1 基础开关

  • 启用钉钉集成：总开关
  • 启用钉钉登录：控制登录页是否显示钉钉扫码入口，同时影响移动端 JSAPI 免登和 PC 端自动免登。关闭后所有端均无法通过钉钉登录（不影响消息推送）
  • 启用组织架构同步：是否允许从钉钉同步部门和用户
  • 启用消息推送：是否向钉钉推送待办和审批通知

3.2 应用凭证

  • 企业CorpId：企业的唯一标识，在钉钉开放平台 →「企业信息」页获取，格式如 dingxxxxxxxxxx
  • 应用ID (AppId)：在钉钉开放平台 → 应用 →「凭证与基础信息」页获取（即 Client ID / AppKey）
  • 应用密钥 (AppSecret)：与应用 ID 在同一页面获取（即 Client Secret）
  • AgentId：在应用信息页获取，用于发送工作通知消息

3.3 地址配置

  • 登录回调地址：钉钉扫码登录的 OAuth 回调地址。格式：{前端访问地址}/{API前缀}/syncData/oauth/dingtalk/callback
    • {API前缀} 即前端 .env 文件中的 VITE_APP_BASE_API（开发环境为 /dev-api，生产环境为 /prod-api）
    • 此地址必须同时在钉钉开放平台 →「安全设置」→「回调地址」中添加，两边完全一致
  • 移动端跳转地址：（可选）用户在钉钉移动端点击消息通知后跳转的 H5 地址。未配置时自动使用 PC 端跳转地址
  • PC端跳转地址：用户在钉钉 PC 端点击消息后最终跳转的地址（PC 前端域名）。消息链接会先经过后端自动完成 OAuth 免登，再跳转到具体页面

3.4 配置前准备（页面内有详细指引）

  1. 在钉钉开放平台创建 H5 微应用，获取 AppKey/AppSecret/AgentId
  2. 申请权限：通讯录读取、手机号/邮箱、消息推送、登录相关
  3. 在「安全设置」中配置回调地址
  4. 在「网页应用」中配置移动端首页和 PC 端首页
  5. 填入凭证后，在「用户管理」页面点击「同步钉钉」完成组织架构同步

四、企业微信配置

配置企业微信集成、登录、组织架构同步和消息推送。

推送规则与前置条件

  • 消息推送需先完成「组织架构同步」，建立企业微信用户与系统用户的映射关系
  • 在「用户管理」页面点击「同步企业微信」即可一键同步
  • 未同步用户不影响系统使用，仅无法收到企业微信消息推送

4.1 基础开关

  • 启用企业微信集成：总开关
  • 启用企业微信登录：控制登录页是否显示企业微信扫码入口，同时影响 PC 端自动免登。关闭后无法通过企业微信登录（不影响消息推送）
  • 启用组织架构同步：是否允许从企业微信同步部门和用户
  • 启用消息推送：是否向企业微信推送待办和审批通知

4.2 应用凭证

  • 企业ID (CorpId)：在企业微信管理后台「我的企业 → 企业信息」中获取
  • 应用AgentId：在「应用管理 → 自建应用」中获取
  • 应用Secret：在自建应用详情页 → 点击 Secret 旁的「查看」→ 管理员扫码确认后获取

4.3 地址配置

企业微信采用域名级回调配置（非完整URL），系统会自动生成 OAuth 授权链接。您需要在企业微信管理后台完成两项域名配置：① 可信域名（应用详情 → 网页授权及JS-SDK）；② 授权回调域（应用详情 → 企业微信授权登录 → Web网页）。两项均只填域名，不含协议和路径。

  • 移动端跳转地址：（可选）用户在企业微信移动端点击消息通知后跳转的 H5 地址。未配置时自动使用 PC 端跳转地址
  • PC端跳转地址：用户在企业微信 PC 端点击消息后最终跳转的地址（PC 前端域名）
  • OAuth回调地址：企业微信消息卡片的 OAuth 回调地址（后端地址），格式为 {后端地址}/qywx/login/mobileCallback。配置后消息推送链接均走后端 OAuth 重定向登录，自动完成免登

4.4 配置前准备（页面内有详细指引）

  1. 获取企业 ID、创建自建应用获取 AgentId 和 Secret
  2. 配置可信域名和可信 IP
  3. 配置企业微信授权登录回调域（PC 扫码登录必需）
  4. 配置应用主页（移动端 + PC 端）
  5. 在「用户管理」页面点击「同步企业微信」完成组织架构同步

五、飞书配置

配置飞书集成、登录、组织架构同步和消息推送。

推送规则与前置条件

  • 消息推送基于飞书用户 open_id，需先完成「组织架构同步」建立映射关系
  • 在「用户管理」页面点击「同步飞书」即可一键同步
  • 未同步用户不影响系统使用，仅无法收到飞书消息推送

5.1 基础开关

  • 启用飞书集成：总开关
  • 启用飞书登录：控制登录页是否显示飞书扫码入口，同时影响移动端 JSAPI 免登和 PC 端自动免登。关闭后所有端均无法通过飞书登录（不影响消息推送）
  • 启用组织架构同步：是否允许从飞书同步部门和用户
  • 启用消息推送：是否向飞书推送待办和审批通知

5.2 应用凭证

  • App ID：飞书自建应用的 App ID，在飞书开放平台「凭证与基础信息」页获取
  • App Secret：飞书自建应用的 App Secret

5.3 地址配置

  • 登录回调地址：飞书扫码登录的 OAuth 回调地址。格式：{前端访问地址}/{API前缀}/syncData/oauth/feishu/callback
    • 此地址必须同时在飞书开放平台 →「安全设置」→「重定向 URL」中添加，两边完全一致
  • 移动端跳转地址：（可选）用户在飞书移动端点击消息通知后跳转的 H5 地址。未配置时自动使用 PC 端跳转地址
  • PC端跳转地址：用户在飞书 PC 端点击消息后最终跳转的地址（PC 前端域名）

5.4 配置前准备（页面内有详细指引）

  1. 在飞书开放平台创建企业自建应用，获取 App ID/App Secret
  2. 申请权限：通讯录基本信息、部门组织架构、用户手机号等
  3. 开启「机器人」能力（消息推送前置条件）
  4. 申请消息权限：im:message:send_as_bot
  5. 设置通讯录授权范围为「全部员工」
  6. 在「安全设置」中配置重定向 URL 和 H5 可信域名
  7. 在「网页」能力中配置桌面端主页和移动端主页
  8. 发布应用版本，管理员审批通过
  9. 在「用户管理」页面点击「同步飞书」完成组织架构同步

六、OnlyOffice 配置

配置 OnlyOffice 文档服务器，用于在线预览和编辑合同文件（Word/Excel/PDF）。

配置要点

  • 服务器地址：填写协议+域名/IP，不含端口和路径（如 http://192.168.0.10）
  • 回调地址：OnlyOffice 服务器必须能访问到此地址，否则文档无法保存和预览
  • JWT 密钥：必须与 OnlyOffice 服务器 local.json 中的 secret 完全一致

PC 端配置

  • 服务器地址：OnlyOffice Document Server 的访问地址，填写协议+域名或IP，不含端口和路径。示例：http://192.168.0.10（内网）或 https://office.your-domain.com（公网）
  • 端口：OnlyOffice 服务端口。Docker 默认映射 8082，Nginx 反代后填 80 或 443
  • 回调地址：OnlyOffice 保存/下载文件时回调的后端接口地址。格式：{后端地址}/onlyofficeCallback。⚠️ 此地址必须是 OnlyOffice 服务器能够访问到的后端地址，不能填 localhost
  • JWT Secret：与 OnlyOffice 服务器 local.json 中的 secret 完全一致。不配置则使用 OnlyOffice 默认密钥
  • 预览允许打印：关闭/开启。文档预览（非编辑）模式下是否允许用户打印。关闭后预览页面将隐藏打印按钮
  • 插件地址：OnlyOffice 自定义插件的 config.json 地址，可添加多个。不需要插件可留空

部署步骤（页面内有详细指引）

  1. 使用 Docker 部署：docker run -d -p 8082:80 onlyoffice/documentserver
  2. 访问 http://服务器IP:8082 确认启动成功
  3. 进入容器修改 local.json 配置 JWT 密钥，重启容器
  4. 在系统中填写服务器地址、端口、回调地址和 JWT Secret
  5. 点击「保存」