SuperAPI AI 工具集

klaviyo-multi-env-setup

编程与开发

查看项目

更新于 10-15 23:26

技能介绍

用途:为 Klaviyo 集成搭建多环境配置,覆盖开发、预发布(staging)与生产三套环境,各自使用独立 API 密钥与配置。

主要能力:提供 detectEnvironment() 环境检测与按环境的 ENV_CONFIGS 配置映射,可按环境切换 enableSending、缓存与限流并发;按环境存储密钥;提供发送与删除防护函数(guardCampaignSend、guardedProfileDeletion),非生产环境仅记录日志而不触碰真实数据;通过 GitHub Actions 矩阵将 staging 映射到 staging 密钥、main 映射到生产密钥并校验连通性后部署;启动时连接一次并记录账号名,若在生产环境外检测到 pk_live_*** 密钥则发出警告。

使用方式:需为每个环境准备独立的 Klaviyo 账号或 API 密钥,使用密钥管理方案(GCP Secret Manager、AWS Secrets Manager 或 Vault),并安装 klaviyo-api SDK。创建 src/config/klaviyo.ts 配置模块,按平台创建各环境密钥(如 gcloud secrets create、aws secretsmanager create-secret),本地开发读取被 git 忽略的 .env.local,切勿提交密钥。完整配置模块、各平台密钥命令、防护函数、CI 矩阵与启动校验见 references/implementation.md。

适用场景:需要将 Klaviyo 集成从本地开发推进到预发布验证再到生产发送的团队,尤其是担心误发邮件或误删数据的场景。

限制:Klaviyo 没有沙箱模式,开发与预发布必须使用单独的测试账号,否则可能发送真实邮件;资料未提供具体价格、平台支持范围或效果数据。