邮件任务

当前状态：Beta

邮件任务用于在你已经选定达人并确认可靠邮箱后，管理 NoxInfluencer 内的 email-task 记录。

适合什么场景

你要创建或查看邮件任务
你要管理某个任务的收件人、发件人设置和已确认内容
你要按历史联系、CRM、合作、资源池或其他邮件任务状态过滤收件人
你要管理邮件任务协作者及其成员管理权限
你要在确认收件人、发件人、发送时间和内容后发送或定时邮件任务

当前 beta 范围

查看 email tasks 和 drafts
通过 task_id 查看单个任务
创建、更新、复制或删除邮件任务
添加、替换和查看任务收件人
删除或清空未发送任务的收件人
保存和查看任务级收件人隐藏/去重过滤条件
查看可用收件人过滤选项和可用于过滤的邮件任务
查看、替换、添加或移除任务协作者
保存任务内容、更新发件人设置
发送、定时或取消邮件任务
查看、保存和应用邮件内容模板
查看、替换和删除邮件商品卡
查看邮件任务报告、团队汇总和团队明细指标

安全执行规则

很多 email 命令是 JSON-first，需要使用 --body-file
写操作默认 dry-run；只有在你确认具体对象和动作后才使用 --force
执行 email send 或 email schedule 前，需要先读回任务和收件人
发送或定时前必须确认收件人、发件人、必要时的发送时间，以及内容已经获批
email schedule 的 plan_send_at 必须是带整点 timezone offset 的 ISO 8601 时间，例如 Z、+08:00 或 -05:00
邮件报告会区分 email tracking replies、creator-level replied counts 和 inbound message counts
团队报告筛选使用 SaaS 团队成员 uid，不是 Gmail 或企业邮箱账号
商品卡使用商品中心的 product_collect_id
收件人过滤使用 email recipients filter options 返回的公开 body patches，不要自己猜 SaaS 原始字段名
协作者命令使用 SaaS 团队 user_uid；如果不确定有效成员，先查看 collaborators list

关键命令

构建任务、协作者、收件人、过滤条件、内容、发件人、模板或商品卡 body 前，先查看 schema：

noxinfluencer schema "email create"
noxinfluencer schema "email collaborators add"
noxinfluencer schema "email recipients add"
noxinfluencer schema "email recipients filter update"
noxinfluencer schema "email content save"
noxinfluencer schema "email products replace"

发送前先读取任务状态：

noxinfluencer email list --keyword shoes --page_size 10
noxinfluencer email drafts --page_size 10
noxinfluencer email get <task_id>
noxinfluencer email recipients list <task_id>

管理收件人隐藏和去重过滤前，先读取当前支持的选项：

noxinfluencer email recipients filter options
noxinfluencer email recipients filter tasks
noxinfluencer email recipients filter get <task_id>
noxinfluencer email recipients filter update <task_id> --body-file recipient-filter.json --force

按团队成员 user_uid 管理任务协作者：

noxinfluencer email collaborators list
noxinfluencer email collaborators list <task_id>
noxinfluencer email collaborators add <task_id> --body-file collaborator.json --force
noxinfluencer email collaborators remove <task_id> --body-file collaborator.json --force

在已经有确认过的收件人和内容后，再组装邮件任务：

noxinfluencer email create --body-file email-task.json --force
noxinfluencer email recipients add <task_id> --body-file recipients.json --force
noxinfluencer email recipients delete <task_id> --body-file recipient-delete.json --force
noxinfluencer email content save <task_id> --body-file content.json --force
noxinfluencer email sender update <task_id> --body-file sender.json --force

只有读回任务并确认无误后，才发送或定时：

noxinfluencer email send <task_id> --force
noxinfluencer email schedule <task_id> --body-file schedule.json --force
noxinfluencer email cancel <task_id> --force

发送后分析使用邮件报告：

noxinfluencer email report <task_id>
noxinfluencer email team-summary --task-ids <task_id>,<task_id>
noxinfluencer email team-breakdown --task-ids <task_id>,<task_id> --page_size 20

商品记录已存在于商品中心后，再添加商品卡：

noxinfluencer email products list <task_id>
noxinfluencer email products replace <task_id> --body-file email-products.json --force
noxinfluencer email products delete <task_id> <email_product_id> --force

当前边界