Freshdesk-Linear 双向工单同步工作流

企业支持团队经常需要在 Freshdesk 和 Linear 两个平台之间手动同步工单信息，导致数据不一致和重复工作。这个工作流实现了 Freshdesk 和 Linear 之间的双向自动同步，确保两个平台的工单状态、优先级和信息始终保持一致。

## 💡 主要使用场景

🔄 **双向工单同步** – 在 Freshdesk 和 Linear 之间自动同步工单创建和更新
📊 **状态映射** – 智能映射两个平台之间的状态和优先级系统
🔗 **双向链接** – 在工单和问题之间建立可追溯的链接关系
⚡ **实时更新** – 任何一方的变更都会立即同步到另一方

## 🧠 工作原理 – 分步说明

### Freshdesk → Linear 同步流程

1. **🎣 Webhook 触发器**
– **新建工单 Webhook** – 通过 POST 端点捕获新创建的 Freshdesk 工单
– **更新工单 Webhook** – 处理现有 Freshdesk 工单的修改

2. **📄 数据转换与字段映射**
– **映射 Freshdesk 字段到 Linear** – 将工单数据转换为 Linear 就绪格式
– 优先级映射：Low/Medium/High/Urgent ↔ 4/3/2/1
– 状态映射：Open/Pending/Resolved/Closed ↔ todo/in_progress/done/canceled
– 处理标题和描述格式

3. **🎯 API 操作**
– **创建 Linear Issue** – 向 Linear API 发送 GraphQL 变更调用
– **检查创建成功** – 验证 API 响应后再继续
– **链接 Freshdesk 与 Linear ID** – 使用 Linear 问题引用更新 Freshdesk 工单

4. **📊 日志管理**
– **记录 Linear 创建成功** – 记录带时间戳和 ID 的成功操作
– **记录 Linear 创建错误** – 捕获详细失败信息用于调试

### Linear → Freshdesk 同步流程

1. **🎣 Linear 问题更新 Webhook**
– 接收 Linear 问题修改时的 Webhook 通知

2. **📄 数据转换与字段映射**
– **映射 Linear 到 Freshdesk 字段** – 将 Linear 问题数据转换为 Freshdesk 格式
– 状态映射：todo/backlog→Open, in_progress→Pending, done→Resolved, canceled→Closed
– 优先级转换：1—4 ↔ 4—1
– 从描述中恢复原始 Freshdesk 工单 ID

3. **🎯 API 操作与验证**
– **检查 Freshdesk 工单 ID 是否存在** – 验证 Linear 问题包含有效的 Freshdesk 工单引用
– **更新 Freshdesk 工单** – 向 Freshdesk 发送 REST API 调用以更新同步数据

4. **📊 日志与错误管理**
– **记录 Freshdesk 更新成功** – 记录带时间戳和 ID 的成功工单更新
– **记录缺失工单 ID 错误** – 捕获 Linear 问题缺少 Freshdesk 工单引用的情况

## 🧩 使用的集成

– **Freshdesk Webhooks** – 用于工单创建和更新触发器
– **Linear GraphQL API** – 用于问题创建和管理
– **HTTP Request** – 用于 API 通信
– **Function 节点** – 用于数据转换和映射逻辑
– **If 节点** – 用于条件检查和验证

## 👤 谁可以使用这个工作流？

非常适合：

🏢 **企业支持团队** – 需要跨平台管理客户支持工单
💻 **开发团队** – 使用 Linear 进行项目管理但需要与客户支持系统集成
🔄 **跨职能团队** – 需要在支持和技术团队之间同步工作
📈 **成长型企业** – 希望自动化重复的数据同步任务

## 🚀 优势

⏰ **节省时间** – 消除手动同步工单的需要
🔗 **数据一致性** – 确保两个平台始终保持同步
📊 **完整审计跟踪** – 详细的日志记录所有同步操作
⚡ **实时同步** – 变更立即传播到两个平台
🔧 **可扩展性** – 可轻松适应其他集成需求

## 📦 准备启动？

只需配置：

✅ 您的 Freshdesk 域名和 API 凭据
✅ Linear API 密钥用于 GraphQL 通信
✅ Webhook 端点用于双向触发器
✅ 字段映射逻辑以适应您的特定需求

您的团队就可以享受自动化的双向工单同步，无需手动数据输入！