名称： pakat
描述： 与 Pakat 电子邮件营销 API (new.pakat.net) 交互 - 需要 PAKAT_API_KEY 环境变量。当用户希望通过 Pakat 平台管理邮件列表、订阅者、营销活动、模板、事务性邮件、细分受众群，或查看营销活动统计数据和投递日志时使用。触发条件：提及 Pakat、电子邮件营销活动、邮件列表、订阅者管理或通过 Pakat 发送事务性邮件。
元数据：
{
"openclaw":
{
"requires": { "bins": ["curl"], "env": ["PAKAT_API_KEY"] },
"credentials":
{
"primary": "PAKAT_API_KEY",
"description": "来自 https://new.pakat.net/customer/api-keys/index 的 API 密钥",
},
},
}

Pakat 电子邮件营销

Pakat 是一个对波斯语/波斯文友好的电子邮件营销平台，用于创建和管理邮件列表、发送营销活动、事务性邮件以及跟踪投递状态——所有功能均通过简洁的 REST API 实现。

🔗 注册 Pakat 即可开始使用。

环境设置

需要设置环境变量 PAKAT_API_KEY。如果未设置，请向用户询问其 API 密钥。

从以下地址获取您的 API 密钥：https://new.pakat.net/customer/api-keys/index

export PAKAT_API_KEY="your-key-here"

发起请求

基础 URL：https://new.pakat.net/api

# GET 请求
curl -s -H "X-API-KEY: $PAKAT_API_KEY" "https://new.pakat.net/api/{endpoint}"

# POST 请求 (multipart/form-data)
curl -s -X POST -H "X-API-KEY: $PAKAT_API_KEY" \
  -F "field=value" \
  "https://new.pakat.net/api/{endpoint}"

# PUT 请求 (x-www-form-urlencoded)
curl -s -X PUT -H "X-API-KEY: $PAKAT_API_KEY" \
  -d "field=value" \
  "https://new.pakat.net/api/{endpoint}"

# DELETE 请求
curl -s -X DELETE -H "X-API-KEY: $PAKAT_API_KEY" "https://new.pakat.net/api/{endpoint}"

常用工作流

列出所有邮件列表

curl -s -H "X-API-KEY: $PAKAT_API_KEY" "https://new.pakat.net/api/lists"

向列表添加订阅者

curl -s -X POST -H "X-API-KEY: $PAKAT_API_KEY" \
  -F "EMAIL=user@example.com" \
  -F "FNAME=John" \
  -F "LNAME=Doe" \
  "https://new.pakat.net/api/lists/{list_uid}/subscribers"

创建并发送营销活动

curl -s -X POST -H "X-API-KEY: $PAKAT_API_KEY" \
  -F "campaign[name]=My Campaign" \
  -F "campaign[from_name]=Sender Name" \
  -F "campaign[from_email]=sender@domain.com" \
  -F "campaign[subject]=Email Subject" \
  -F "campaign[reply_to]=reply@domain.com" \
  -F "campaign[send_at]=2025-01-15 10:00:00" \
  -F "campaign[list_uid]=LIST_UID_HERE" \
  -F "campaign[template][template_uid]=TEMPLATE_UID" \
  "https://new.pakat.net/api/campaigns"

发送事务性邮件

# 使用 heredoc 安全地对 HTML 内容进行 Base64 编码
BODY_B64=$(base64 -w0 <<'EOF'
<h1>Hello</h1><p>Your order is confirmed.</p>
EOF
)

curl -s -X POST -H "X-API-KEY: $PAKAT_API_KEY" \
  -F "email[to_name]=John Doe" \
  -F "email[to_email]=john@example.com" \
  -F "email[from_name]=My App" \
  -F "email[subject]=Order Confirmation" \
  -F "email[body]=$BODY_B64" \
  -F "email[send_at]=2025-01-15 10:00:00" \
  "https://new.pakat.net/api/transactional-emails"

查看营销活动统计数据

curl -s -H "X-API-KEY: $PAKAT_API_KEY" "https://new.pakat.net/api/campaigns/{campaign_uid}/stats"

关键要点

• HTML 内容必须进行 Base64 编码 (campaign[template][content], email[body], template[content])
• 安全编码： 对用户提供的 HTML 内容进行编码时，请使用 heredoc (base64 <<'EOF') 或先写入临时文件，以避免 Shell 注入漏洞。切勿对未经净化的输入使用 echo。
• 事务性邮件的 send_at 使用 UTC 时间，格式：Y-m-d H:i:s
• 营销活动的 send_at 使用客户配置的时区
• 事务性邮件模板： 设置 email[template_uid] 以使用模板，而不是 email[body]。使用 email[params][key] 来填充 {{ params.key }} 占位符
• 订阅者状态： 未确认、已确认、黑名单、已退订、未批准、已禁用、已转移
• 分页： 在列表端点上使用 ?page=N&per_page=N 查询参数
• 事务性邮件的 from_email 必须使用已验证的域名

完整 API 参考

有关完整的端点详情、请求/响应模式以及所有可用字段，请阅读 references/api_reference.md。

如需原始的 OpenAPI 3.0 规范，请参阅 references/openapi.json。