WorkBuddy与OA系统集成有三种技术路径：一、OAuth 2.0授权码模式实现单点登录与可信身份联合；二、调用OA RESTful API实现流程级数据双向同步；三、通过Webhook接收OA事件推送实现实时响应。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望将WorkBuddy深度嵌入现有OA系统，实现单点登录、流程触发与数据双向同步，则可能是由于当前OA系统未开放标准API接口或未配置OAuth 2.0信任关系。以下是实现WorkBuddy与OA系统集成的多种技术路径：
一、通过OAuth 2.0授权码模式建立可信身份联合
该方式确保用户在OA系统中一次登录后，无需重复输入凭证即可调用WorkBuddy服务，所有令牌交换由后端完成，杜绝client_secret前端暴露风险。
1、在OA系统后台启用“外部应用接入”模块，创建新应用，填写名称为“WorkBuddy集成客户端”，应用类型选择“Web应用”。
2、设置授权回调地址为WorkBuddy实例专属地址：https://your-workbuddy-domain.com/oauth/callback，该地址必须与后续WorkBuddy管理后台填写的redirect_uri完全一致。
3、获取OA系统分配的client_id与client_secret，进入WorkBuddy管理后台【集成中心】→【OAuth 2.0应用注册】，选择“自定义平台”，手动填入上述凭证及OA系统的授权端点（如/oauth/authorize）与令牌端点（如/oauth/token）。
4、勾选【启用PKCE增强】并保存，WorkBuddy将生成code_verifier并注入后续授权请求。
5、点击【启动授权流程】，跳转至OA登录页；用户完成认证并授权后，WorkBuddy后端自动完成令牌交换，获取access_token与refresh_token。
二、调用OA系统RESTful API实现流程级联动
该方式适用于OA已提供标准化接口文档的场景，WorkBuddy可作为客户端主动拉取待办、审批流、公文等结构化数据，并触发本地自动化任务。
1、从OA厂商获取API文档，确认支持GET /api/v1/tasks/pending（获取待办）、POST /api/v1/approvals/submit（提交审批）等核心端点。
2、在WorkBuddy【数据源中心】点击【新增自定义API源】，填写OA系统基础信息：名称设为“主OA系统”，基础URL填入https://oa.yourcompany.com/api/v1。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
3、在认证方式中选择“Bearer Token”，粘贴上一步OAuth流程获取的access_token，并启用【自动刷新令牌】选项。
4、配置定时同步策略：设置每15分钟调用GET /tasks/pending?status=unhandled，响应体中提取task_id、title、due_time字段映射至WorkBuddy内部待办模型。
5、在【流程编排】中新建“OA待办自动处理”流程，添加“HTTP请求”节点调用POST /approvals/submit，传入预置JSON载荷，其中approval_id动态绑定上一节点输出的task_id。
三、部署Webhook接收OA系统事件推送
该方式使OA系统成为事件发布者，WorkBuddy作为订阅端实时响应，避免轮询开销，适用于需即时响应公文签发、流程归档等关键动作的场景。
1、在WorkBuddy管理后台进入【事件中心】→【Webhook服务】，点击【新建接收端点】，系统自动生成唯一URL，格式为：https://your-workbuddy-domain.com/webhook/oa-event-7f3a9d。
2、登录OA系统管理员后台，进入“系统集成”→“Webhook管理”，点击【新增订阅】，在“目标地址”栏粘贴上一步生成的URL。
3、在事件类型中勾选“公文签发完成”“流程归档成功”“待办超时提醒”三项，设置内容格式为JSON，启用签名验证并复制OA系统生成的secret_key，回填至WorkBuddy Webhook配置页的“签名密钥”字段。
4、在WorkBuddy侧为每个事件类型配置响应动作：例如收到“公文签发完成”事件后，自动调用本地Word模板引擎，生成带电子签章的PDF存档，并上传至指定NAS路径/archive/official-docs/20260518_XXX.pdf。
5、点击【启用订阅】，WorkBuddy立即开始监听，首次收到测试事件后状态图标变为绿色对勾。
