Agent Skills
返回列表
海外运营 Email 活动状态

海外运营 Email 活动状态

企业运营 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-marketing-campaign-campaign-status。

技能介绍

要解决什么问题

在海外运营场景里,营销侧经常需要确认 Email 活动当前处于什么状态——例如活动是否已生效、是否在排期或已结束,以便客服、运营或上层自动化流程做下一步判断。若每次都手写网关地址、拼 Authorization 或误改正式环境 base_url,容易出错且难以在 agent 链路里复用。

本技能是 最小颗粒度 的接口技能,只负责一个动作:campaign_status(GET /campaign/listEmailCampaignStatus)。多步业务(创建活动、改配置、再查状态等)应由上层 agent 按聚合 skill 或计划文档编排多个原子 skill,本技能只完成本次查询并把关键返回交给后续步骤。

技能如何工作

  • 固定调用正式环境:GET https://www.kutetailor.com/api/marketing/campaign/listEmailCampaignStatus(来自 frontmatter 的 base_url,不接受用户输入覆盖)。
  • 工具参数统一放在嵌套对象 params 内:最外层只放 params,不要用 params.xxx 这类点号顶层 key。
  • 登录态:用 params.accessToken 生成 Authorization: Bearer …;若传入值已含 Bearer 前缀则不再重复拼接。
  • Path / Query / Body / 额外 Header 分别写入 params.path、params.query、params.body、params.headers;本接口无必填参数,GET 查询参数按需放在 URL query。
  • 返回以接口响应为唯一事实来源;若出现认证、权限、参数或业务错误,应把原始错误码与错误信息交给上层 agent,不要自行补造活动状态或业务字段。

适用边界与注意点

  • 这是查询类接口,仍受当前登录态、租户与用户权限约束;无权限时只会得到平台返回的错误,不会「推断」状态。
  • 单步只覆盖「Email 活动状态」列表查询;不包含邮件发送、模板编辑或其它营销子域接口。
  • 与聚合 skill platform-marketing-campaign 中的原始 action campaign_status 对应;需要完整营销链路时请查阅该聚合文档再组合调用。

使用场景

  • 客服接到海外站邮件营销咨询,需先核对某次 Email 活动在平台上的当前状态再回复用户
  • 运营编排多步营销流程时,在改配置或发信前先拉取 Email 活动状态列表做分支判断
  • 上层 agent 执行 platform-marketing-campaign 计划,单独调用本接口获取 campaign_status 返回字段
  • 权限或租户切换后,用正式环境接口验证当前账号能否看到 Email 活动状态数据

适合人员

  • 负责酷特海外运营后台、需在对话或脚本里查询 Email 活动是否生效/排期的营销运营
  • 把 platform-marketing-campaign 拆成原子接口、由 agent 自动串联状态查询与后续步骤的集成工程师
  • 海外客服主管:工单里常要先对照平台活动状态,再决定是否允许改期或补偿说明
  • 做多租户海外站运维、需用 Bearer 登录态调用 listEmailCampaignStatus 的后端或平台开发