用途:管理 Klaviyo 的邮件活动与相关受众资源,适合需要脚本化操作 Klaviyo Campaign API 的营销或运营场景。
主要能力:提供四个捆绑脚本。campaign.sh 支持 list、get、create、update、delete、clone、send、send-status、cancel、assign-template、list-messages、get-message、update-message、refresh-estimation、get-estimation、get-estimation-job;audience.sh 支持 get、create、update;lists.sh 支持 list、get、create、update、delete、get-profiles、get-profile-ids、add-profiles、remove-profiles;profiles.sh 支持 search、list、get、create、update、upsert、get-lists、get-segments。
使用方式:脚本以 bash 调用,读操作立即请求 API;写操作默认试运行,须显式加 --send 才执行。API key 解析顺序为 --api-key 参数、KLAVIVO_API_KEY 环境变量、本地保存的 ~/.config/klaviyo-send-email/api_key。可用 --api-key <key> --save-api-key、--configure-api-key 或 --clear-api-key 管理保存的密钥。发送活动前须先通过 assign-template 给消息分配模板(会克隆可复用模板)。
限制:不要将这些脚本与 SendGrid、Instantly 的 API key 或 FREVANA_TOKEN 混用。受众端点处于 beta,需 2026-04-15.pre 修订头;活动相关端点使用稳定版 2026-04-15 修订。不得虚构活动 ID、受众 ID、分段 ID、API key、模板 ID 或消息 ID;不要打印 API key,若用户在对话中分享密钥应建议轮换。Klaviyo API 使用 Klaviyo-API-Key 授权头而非 Bearer。各脚本所需 API key 权限范围在提供的资料中未完整列出。