Klaviyo 集成
使用私有 API 密钥将 Klaviyo 连接到 Frevana。本指南将帮助您创建专用密钥,并为工作流程选择所需权限。
开始之前
您需要访问目标 Klaviyo 账号的权限,以及管理该账号 API 密钥的权限。
第 1 步:打开 API 密钥设置
登录正确的账号,然后打开 Klaviyo API Keys。您也可以在 Settings → Account → API Keys 中找到此页面。
第 2 步:创建私有 API 密钥
选择 Create Private API Key,并输入便于识别的名称,例如 Frevana Integration。
选择 Custom Key,然后选择 Frevana 工作流程所需的 API 权限范围。原始设置要求对以下资源授予完整访问权限:
- Campaigns(营销活动)
- Segments(细分群组)
- Tags(标签)
- Templates(模板)
- Lists(列表)
- Profiles(用户资料)

完整访问权限可能同时允许读取和修改。请仔细检查各项权限,仅授予工作流程所需的访问权限。根据使用的资源,您可能还需要其他权限,例如事件权限。使用专用密钥便于日后审查和轮换。
第 3 步:生成并复制密钥
选择 Create 生成私有 API 密钥。

及时复制完整密钥,并将其存入安全的密码管理器或密钥存储工具。
请像保护密码一样保护私有 API 密钥,不要在公开消息、电子邮件或截图中分享。
第 4 步:提供密钥
如需将密钥设置为环境变量,请将占位符替换为完整的私有密钥,并确保没有多余的空格或换行。
macOS / Linux
export KLAVIYO_API_KEY="your_klaviyo_private_api_key"
Windows PowerShell
setx KLAVIYO_API_KEY "your_klaviyo_private_api_key"
export 命令对当前终端及从该终端启动的进程生效。在 Windows 中,setx 对新启动的进程生效,不会影响当前 PowerShell 会话。请确保 Frevana 启动时可以访问该变量;您可能需要重启 Frevana。
故障排查
401 Unauthorized
请检查是否复制了完整密钥、密钥是否仍然有效,以及使用的是私有 API 密钥而不是公开标识符。
403 Forbidden
请检查密钥是否属于目标 Klaviyo 账号,以及是否具备访问所需资源的权限。如果无法修改现有密钥的权限,请创建具有所需权限的新密钥,并更新 Frevana 的配置。
找不到 API 密钥页面
请确认您已登录正确的账号,打开了 Settings → Account → API Keys,并具有管理 API 密钥的权限。
准备连接
Frevana 可以访问密钥后,即可继续完成 Klaviyo 集成设置。