酷特海外运营营销活动邮件发送统计
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-marketing-campaign-email-send-list。
技能介绍
要解决什么问题
海外运营团队在复盘营销活动时,往往需要核对邮件是否按批次发出、各状态数量如何,而不是凭后台截图或手工导出。本技能对应酷特海外运营平台的一个原子接口:email_send_list,专门拉取营销活动邮件发送统计的分页结果,供上层 Agent 在「查统计 → 对明细 → 写报告」等链路里作为一步数据源。
技能如何工作
执行器固定请求正式环境 GET /campaign-send-history/emailSendList(base_url 写在 skill frontmatter,不可被用户输入覆盖)。调用时 tool 参数只使用顶层 params 对象:
- Query:按接口契约传入
EmailSendListRequest(写在params.query) - 鉴权:
params.accessToken生成Authorization: Bearer …;若已含Bearer前缀则不再重复拼接 - 其它:Path / Body / 额外 Header 分别放入
params.path、params.body、params.headers(本接口为 GET,以 query 为主)
返回以接口原始响应为准,类型为分页结构 IPage;认证、权限、参数或业务错误时,应把错误码与错误信息原样交给上层编排,而不是本地猜测补全发送量或状态。
适用边界与注意点
这是最小颗粒度接口 skill,只完成 email_send_list 一次调用。若用户要「创建活动、改模板、重发、导出全链路」,需要由 Agent 按聚合 skill platform-marketing-campaign 或计划文档组合多个原子 skill。
即便属于查询类接口,仍受当前登录态、租户与用户权限约束;统计口径与筛选字段以平台 EmailSendListRequest 定义为准,不要在 skill 层编造库存、订单号或物流类字段。
使用场景
- 复盘某次海外营销活动后,按活动 ID 与筛选条件拉取邮件发送分页统计
- Agent 编排链路中需要先查询 campaign 邮件发送量,再决定是否调用明细类接口
- 运营同学核对群发批次是否落库,用 EmailSendListRequest 查询各状态数量
- 权限范围内的租户用户导出统计口径前,先通过接口拿到 IPage 原始分页结果
适合人员
- 负责酷特海外运营平台营销活动复盘、需核对邮件发送量的运营专员
- 搭建 platform-marketing-campaign 聚合链路的 Agent 开发者,需嵌入 email_send_list 原子步骤
- 按租户权限为业务方出营销邮件发送报表的数据或 BI 对接同学
- 海外区市场负责人要在周会前汇总各活动邮件发送统计并追问异常批次