Pakat Email Marketing

核心用法

Pakat 技能封装了波斯语友好的邮件营销平台 API，通过 curl 命令与 new.pakat.net/api 交互。用户需先设置 PAKAT_API_KEY 环境变量获取自平台后台。

主要功能覆盖五大场景：

• 邮件列表管理：查询、创建、更新邮件列表
• 订阅者操作：添加、更新、删除订阅者，支持自定义字段
• 营销活动：创建、调度、发送营销邮件，支持模板绑定
• 事务邮件：触发式单封邮件发送，支持 HTML base64 编码
• 数据统计：查询活动送达率、打开率、点击率等指标

关键接口模式：GET/POST/PUT/DELETE 配合 X-API-KEY Header，POST 多用 multipart/form-data，PUT 使用 x-www-form-urlencoded。

显著优点

• 波斯语本地化：RTL 排版、波斯日期、本地邮件服务商优化送达率
• 完整功能闭环：从列表管理到发送追踪的全链路覆盖
• 模板系统：支持 HTML 模板复用及参数替换 ({{ params.key }})
• 调度灵活：营销活动支持客户时区，事务邮件支持 UTC 定时发送
• 安全编码指引：明确建议使用 heredoc 进行 base64 编码，避免 shell 注入

潜在缺点与局限

• 生态局限：主要服务伊朗及波斯语市场，国际邮件服务商兼容性未明确
• 文档完整性：部分高级功能需查阅本地 references/api_reference.md
• 时区复杂性：营销活动与事务邮件使用不同时区基准，易配置错误
• 域名验证：事务邮件发件域名需预先验证，增加部署步骤
• 依赖外部凭证：API 密钥泄露风险，无内置轮换机制

适合人群

• 面向伊朗/阿富汗市场的跨境电商运营者
• 需要波斯语邮件模板的本地化营销团队
• 希望自建邮件系统替代 Mailchimp 但需波斯语支持的技术团队
• 已有 Pakat 账户、需自动化集成的工作流开发者

常规风险

• 密钥泄露：PAKAT_API_KEY 明文存储于环境变量，共享环境或日志可能暴露
• 注入风险：尽管文档提示使用 heredoc，用户仍可能误用 echo 处理未过滤输入
• 发送声誉：频繁发送或内容不当可能导致域名/IP 被列入黑名单
• 数据合规：需确认是否符合 GDPR 等跨境数据法规，平台位于伊朗境内
• 服务可用性：地缘政治因素可能影响平台稳定性与国际访问

核心用法

Pakat Skill 是一套面向波斯语/波斯市场的邮件营销平台 API 封装工具，基于 curl 命令提供完整的邮件生命周期管理能力。用户通过配置 PAKAT_API_KEY 环境变量即可调用 Pakat 官方 REST API，完成邮件列表（Mailing Lists）创建与管理、订阅者增删改查、营销 Campaign 创建与定时发送、事务性邮件（Transactional Emails）推送以及投递统计与日志查询等核心操作。该 Skill 采用纯文档型设计，内部不包含可执行代码，仅提供标准化的 HTTP 请求模板和参数说明，Agent 可根据用户自然语言指令动态组装 curl 命令并执行。

典型工作流包括：查询所有邮件列表 → 向指定列表添加订阅者 → 基于模板创建 Campaign 并设置发送时间 → 监控 Campaign 送达率与打开数据。事务性邮件支持 base64 编码的 HTML 内容或模板引用模式，满足订单确认、密码重置等场景需求。

显著优点

1. 区域市场适配：Pakat 是少有的原生支持波斯语（Farsi）的邮件营销平台，对 RTL 排版、波斯语字符集、本地时区处理有深度优化，适合伊朗及波斯语用户群体运营。

2. 零依赖轻量设计：纯 Markdown 文档型 Skill，无第三方库依赖，不引入运行时负担，兼容各类 Agent 执行环境。

3. 完整功能覆盖：涵盖邮件营销全链路——列表管理、订阅者生命周期、Campaign 编排、事务性邮件、数据追踪，无需多平台切换。

4. 安全编码指引：文档内置安全提示，明确建议使用 heredoc 进行 base64 编码，避免 shell 注入风险，体现开发者安全意识。

5. 灵活的定时机制：Campaign 支持客户配置时区，事务性邮件采用 UTC 时间，兼顾本地化与国际化场景。

潜在缺点与局限性

1. T3 来源可信度：维护者为个人开发者 hadifarnoud，非官方团队或企业级背书，长期维护稳定性存在不确定性，需关注版本更新动态。

2. API 密钥管理负担：Skill 本身不提供密钥安全存储机制，用户需自行通过环境变量或密钥管理服务配置 PAKAT_API_KEY，存在配置遗漏或泄露风险。

3. 功能边界依赖平台：作为 Pakat 平台的 API 封装，功能深度受限于 Pakat 官方能力边界，高级自动化工作流（如跨平台用户同步、复杂条件触发）需额外开发。

4. 波斯市场局限性：虽在波斯语场景表现优异，但对全球其他区域邮件服务商（如 SendGrid、Mailgun）生态无直接支持，多平台并行时需技能切换。

5. 无可视化反馈：纯命令行交互模式，邮件预览、模板编辑、报表可视化需登录 Pakat Web 控制台完成，Agent 侧无图形化辅助。

适合的目标群体

• 波斯语市场运营团队：面向伊朗、阿富汗及海外波斯语用户的电商、SaaS、媒体机构，需要本地化邮件服务。
• 中小型技术团队：具备基础 API 集成能力，希望快速搭建邮件营销体系而不投入复杂基础设施。
• 自动化流程构建者：通过 Agent 将邮件发送嵌入用户注册、订单履约、会员运营等自动化工作流的技术人员。
• 成本敏感型用户：Pakat 区域定价策略通常优于国际主流邮件服务商，适合预算有限但需要合规本地服务的场景。

使用风险与注意事项

1. 凭证泄露风险：PAKAT_API_KEY 具备账户级权限，若通过命令行明文导出或提交至版本控制，可能导致邮件列表、Campaign 数据被恶意访问或滥用。建议采用专用密钥管理服务或运行时注入。

2. 邮件合规与声誉风险：自动化发送营销邮件需严格遵守 CAN-SPAM、GDPR 及伊朗本地法规，未获明确同意的批量发送可能导致域名被列入黑名单或法律追责。

3. 发送量与频率限制：Pakat 平台对 API 调用频次、每日发送额度存在默认限制，高并发场景需提前联系平台调整配额，避免服务中断。

4. 时区配置误区：Campaign send_at 与客户配置时区绑定，事务性邮件为 UTC，混用可能导致预期外发送时间，需仔细核对时间参数。

5. HTML 编码安全：虽文档提示 heredoc 编码，但用户若绕过建议直接拼接用户输入，仍存在 shell 命令注入漏洞，需严格执行安全编码规范。