Zalo OA Token自动刷新工作流 – 实现持续访问令牌管理

## 工作流概述
这个n8n工作流专门用于维护Zalo OA访问令牌的自动刷新机制，通过Workflow Static Data实现令牌的持久化存储和管理。工作流支持定时自动刷新和手动重置两种模式，为其他集成服务提供稳定的令牌访问接口。

## 核心功能
– **自动令牌刷新**：每12小时自动刷新Zalo OA访问令牌
– **令牌缓存管理**：使用Workflow Static Data全局存储令牌和过期时间
– **多入口支持**：支持定时触发和手动Webhook触发
– **集成接口**：提供轻量级Webhook供其他服务获取当前令牌

## 节点配置详解

### 主要节点功能
1. **Schedule Trigger** – 定时触发器，每12小时执行自动刷新流程
2. **Execute_Node (Webhook)** – 手动重置入口，用于测试或凭证轮换
3. **Clean Zalo Static Data** – 清除令牌缓存，强制重新获取
4. **Set Refresh Token and App ID** – 设置刷新令牌和应用凭证
5. **Load to Static Data** – 初始化令牌缓存并检查刷新需求
6. **Refresh Token (Zalo v4)** – 调用Zalo OAuth API刷新访问令牌
7. **Store to SD & Pass token** – 持久化存储令牌并传递当前令牌
8. **Webhook (zalo-intergration-v1)** – 集成接口，返回缓存令牌
9. **Load Access Token** – 读取并返回缓存令牌信息

## 工作流程

### 自动刷新路径
Schedule Trigger → Set Refresh Token and App ID → Load to Static Data → Refresh Token (Zalo v4) → Store to SD & Pass token

### 手动重置路径
Execute_Node (Webhook) → Clean Zalo Static Data → Set Refresh Token and App ID → 继续自动刷新流程

### 令牌查询路径
Webhook (zalo-intergration-v1) → Load Access Token (返回缓存令牌)

## 技术特点

### 智能刷新机制
– 提前90秒刷新令牌，避免API调用期间令牌过期
– 首次运行时自动初始化刷新令牌
– 检查令牌有效性，仅在需要时执行刷新

### 安全考虑
– 建议将敏感值移至环境变量
– 手动重置Webhook应配置IP白名单或密钥保护
– 令牌缓存仅限于当前工作流范围

## 应用场景
– Zalo OA API集成项目
– 需要长期稳定访问Zalo服务的应用
– 多工作流共享Zalo令牌的场景
– 自动化消息推送和用户交互系统

## 优化建议
– 在”Load to Static Data”后添加IF条件，当缓存令牌仍有效时跳过刷新调用
– 配置适当的错误处理和重试机制
– 监控令牌刷新成功率和使用情况