用途:通过 Mailchimp Marketing API 执行邮件营销相关操作,包括账户信息查询、受众与成员管理、活动创建与报告读取、模板列表和成员搜索等。
主要能力:
- 认证与连通性检查:调用 /3.0/ping 验证令牌,或读取根端点获取 account_id、account_name、total_subscribers。
- 受众(Lists):列出、查看详情、创建受众。
- 成员:列出成员、添加订阅者、更新成员(可写 merge_fields 与 tags)、按邮箱搜索成员。
- 活动(Campaigns):列出、查看详情、创建 regular 等活动、获取活动报告(发送量、打开、点击)。
- 模板:列出模板。
使用方式:所有请求以 curl 调用 https://${MC_DC}.api.mailchimp.com/3.0/...,请求头 Authorization: Bearer $MAILCHIMP_TOKEN,并用 jq 筛选字段;POST/PATCH 的 JSON 请求体写入 /tmp/mailchimp_request.json 后通过 -d @ 文件提交。成员端点需使用小写邮箱的 MD5 值作为 subscriber-hash,可用 echo -n "email@example.com" | md5sum | cut -d' ' -f1 计算。
排障:请求失败时可运行 zero doctor check-connector --env-name MAILCHIMP_TOKEN,或 zero doctor check-connector --url https://us1.api.mailchimp.com/3.0/ping --method GET。
限制与注意事项:需先通过元数据端点确定 MC_DC 数据中心;成员状态值包括 subscribed、unsubscribed、cleaned、pending、transactional;活动类型包括 regular、plaintext、absplit、rss、variate;速率限制为 10 个并发连接,批量更新可用 batch 操作;分页使用 count 与 offset。
适用场景:需要以脚本方式维护订阅名单、触发或管理邮件活动、拉取营销数据做分析时。
暂未提供:具体价格、套餐限制、UI 操作步骤以及示例之外的字段说明。