海外运营 Email 活动状态
将以下提示词粘贴到你的 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,本技能只完成本次查询并把关键返回交给后续步骤。
技能如何工作
- 固定调用正式环境:
GEThttps://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中的原始 actioncampaign_status对应;需要完整营销链路时请查阅该聚合文档再组合调用。
使用场景
- 客服接到海外站邮件营销咨询,需先核对某次 Email 活动在平台上的当前状态再回复用户
- 运营编排多步营销流程时,在改配置或发信前先拉取 Email 活动状态列表做分支判断
- 上层 agent 执行 platform-marketing-campaign 计划,单独调用本接口获取 campaign_status 返回字段
- 权限或租户切换后,用正式环境接口验证当前账号能否看到 Email 活动状态数据
适合人员
- 负责酷特海外运营后台、需在对话或脚本里查询 Email 活动是否生效/排期的营销运营
- 把 platform-marketing-campaign 拆成原子接口、由 agent 自动串联状态查询与后续步骤的集成工程师
- 海外客服主管:工单里常要先对照平台活动状态,再决定是否允许改期或补偿说明
- 做多租户海外站运维、需用 Bearer 登录态调用 listEmailCampaignStatus 的后端或平台开发