将Zendesk知识库文章同步到Airtable的n8n工作流

## 概述
这个工作流从Zendesk知识库获取文章，并将它们同步到Airtable数据库中。它专为希望在其他工具中重用、备份或丰富Zendesk内容的团队设计，使内容在Airtable（或其他地方）可用。

## 适用对象
* 希望在其他工具中使用Zendesk文章的客户服务或支持团队
* 正在整合或迁移知识库的内容/知识经理
* 需要文章Markdown版本的操作/自动化专家（可适配到Notion、Google Sheets或任何支持Markdown的系统）

## 先决条件
* **Airtable数据库**：使用[此模板](https://airtable.com/apptzJnbB6FphIprO/shrA6AhTkogTgrRn5)设置，包含字段：`标题`、`内容`、`URL`和`文章ID`
* **Zendesk账户**：具有API访问权限（对帮助中心文章的读取权限）
* **Zendesk API凭据**（见下方说明）
* **Airtable API凭据**（见下方说明）

## 获取凭据
**Airtable：**
1. [注册或登录Airtable](https://airtable.com/)
2. 转到[账户设置](https://airtable.com/account)并生成**个人访问令牌**（推荐范围：`data.records:read`、`data.records:write`）
3. 在n8n中，使用此令牌创建新的Airtable凭据

**Zendesk：**
1. 登录您的Zendesk仪表板
2. 转到**管理中心 > 应用和集成 > Zendesk API**
3. 启用”令牌访问”，并创建API令牌
4. 在n8n中，使用您的Zendesk域名、电子邮件和API令牌添加Zendesk凭据

## 工作原理
### 1. **触发器**
* **手动触发器**：用于首次设置，获取**所有**现有文章
* **计划触发器**：自动每N天运行一次，仅获取自上次运行以来的**新增或更新**文章

### 2. **从Zendesk获取文章**
* 调用Zendesk帮助中心API，使用分页处理大量数据

### 3. **提取和准备数据**
* 拆分每个文章，然后收集字段：`id`、`url`、`title`和`body`
* 将文章正文从HTML转换为Markdown（便于移植和重用）

### 4. **更新插入到Airtable**
* 插入新文章，或更新现有文章（使用`文章ID`作为唯一键）
* 存储的字段：**标题**、**内容**（Markdown）、**URL**、**文章ID**

## Airtable模板
* 使用[此Airtable模板](https://airtable.com/apptzJnbB6FphIprO/shrA6AhTkogTgrRn5)作为起点
* 确保表格有列：**标题**、**内容**、**URL**、**文章ID**。您可以根据需要添加更多列

## 示例用例
* 将Zendesk文章迁移到另一个知识库
* 在Airtable或Notion中构建内部知识中心
* 为合规性或版本控制创建Markdown备份

## 节点说明
工作流包含以下关键节点：
– **手动触发器**：用于初始完整同步
– **计划触发器**：用于定期增量同步
– **HTTP请求节点**：调用Zendesk API获取文章数据
– **拆分节点**：将文章数组拆分为单个项目
– **设置字段节点**：选择和重命名字段
– **Markdown转换节点**：将HTML内容转换为Markdown格式
– **Airtable节点**：将数据更新插入到Airtable数据库

## 注意事项
* **无重复**：Airtable中的现有文章会被更新，不会重复
* **灵活的目标**：工作流可以适配将文章存储到任何支持Markdown的地方（Notion、Google Sheets、您的数据库等）
* **API速率限制**：如果您有很多文章，Zendesk API可能会限制您的请求。n8n会处理分页，但长时间运行可能会达到限制
* **字段映射**：工作流已准备好用于提供的模板。如果您更改Airtable结构，请更新节点映射
* **凭据**：只需要Zendesk和Airtable凭据