酷特海外营销邮件发送展示
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-marketing-campaign-send-history。
技能介绍
要解决什么问题
海外运营团队在复盘营销活动、核对触达效果或排查「邮件是否发出」时,往往需要到平台后台翻发送记录。若 agent 要自动汇总活动表现、串联下单或客服流程,就必须能按活动维度拉取邮件发送展示数据,而不是凭对话猜测发送状态或编造分页结果。
本技能对应酷特海外运营平台正式环境中的单一原子动作:send_history(GET /campaign-send-history/campaignShow)。它只负责完成这一次 HTTP 调用,并把接口返回的分页结构(IPage)交给上层编排。
技能如何工作
- 固定基址:执行器使用 frontmatter 中的正式环境
base_url(https://www.kutetailor.com/api/marketing/campaign-send-history/campaignShow),不接受用户输入覆盖。 - 参数形态:tool arguments 最外层仅包含嵌套对象
params;Query 条件写入params.query(类型为CampaignShowRequest),Path / Body / 额外 Header 分别写入params.path、params.body、params.headers。 - 登录态:通过
params.accessToken生成Authorization: Bearer …;若传入值已含Bearer前缀则不再重复拼接。 - 返回事实:列表与分页字段以接口响应为准;认证、权限、参数或业务错误时,将原始错误码与错误信息原样传给上层 agent。
适用边界与注意点
这是最小颗粒度接口 skill,不包含创建活动、改模板、重发邮件等步骤。完整链路需由上层 agent 参考聚合 skill platform-marketing-campaign 或计划文档,组合多个原子 skill。查询类接口仍受当前登录态、租户与用户权限约束;缺少 accessToken 或 Query 不合法时,应预期接口层错误而非本地补数据。
使用场景
- 复盘某次海外营销活动时,需按活动 ID 与筛选条件拉取邮件发送展示分页列表核对触达记录
- 客服接到「活动邮件有没有发」的工单时,让 agent 调用 send_history 查正式环境发送历史再回复
- 编写多步营销链路时,上层 agent 在本步只取 IPage 结果,再交给统计或报表 skill 汇总
- 权限或租户切换后排查「列表为空」时,用同一 Query 重调 campaignShow 对照接口原始错误信息
适合人员
- 负责酷特海外运营平台、需在对话里查活动邮件发送明细的营销运营
- 把 platform-marketing-campaign 拆成原子接口、要编排 send_history 的 agent 集成工程师
- 活动复盘会上需要可核对的分页发送数据、而不是口述猜测的运营分析同事
- 对接 kutetailor 正式环境、维护 accessToken 与 Query 参数契约的后端或平台开发