CRM

当前状态：Beta

CRM 用于在达人筛选、资源池整理或触达准备之后，查询和更新 NoxInfluencer 内的关系记录。

适合什么场景

你需要查看已选达人的 CRM channel
你要更新某个 channel 的合作状态、标签、负责人、邮箱、URL 或备注
你要把 CRM 记录组织成分组，方便后续跟进
你要把 CRM channel 加入已有邮件任务
你需要创建 CRM 异步导出

当前 beta 范围

用 JSON-first 筛选条件查询 CRM channel
通过不透明 creator_id 查看单个 CRM channel
更新、归档和恢复 CRM channel
创建 CRM 导出任务
对 crm add-to-email 执行 validate、preview 和 apply
对 CRM 批量更新执行 validate、preview 和 apply
查看、创建、更新和删除 CRM 标签
查看、读取、创建、更新和删除 CRM 分组

安全执行规则

CRM 查询和很多写操作都是 JSON-first，需要使用 --body-file
分阶段工作流应按 validate、preview、apply --force 顺序执行
update、archive、restore、export、group create/update/delete、add-to-email apply 等直接写操作需要你明确确认后才能使用 --force
保留稳定的不透明 ID，例如 creator_id、group_id、task_id 和 export_id
批量 preview 和 apply 返回 existing、creatable、created 等计数时，应以这些字段解释结果，不要只根据请求 ID 数量推断成功

关键命令

构建 JSON-first 请求前，先查看准确 body 契约：

noxinfluencer schema "crm list"
noxinfluencer schema "crm batch-update apply"
noxinfluencer schema "crm labels create"

读取 CRM channels 和 groups：

noxinfluencer crm list --body-file crm-query.json
noxinfluencer crm get <creator_id>
noxinfluencer crm groups list --keyword vip --page_size 20
noxinfluencer crm groups get <group_id>

管理批量打标签所需的 labels：

noxinfluencer crm labels list --keyword vip --page_size 20
noxinfluencer crm labels create --body-file crm-label.json --force
noxinfluencer crm labels update <label_id> --body-file crm-label.json --force
noxinfluencer crm labels delete <label_id> --force

返回的 label_id 可用于 crm batch-update，并通过 labels.operation=add 或 remove 增删标签：

noxinfluencer crm batch-update validate --body-file crm-batch-update.json
noxinfluencer crm batch-update preview --body-file crm-batch-update.json
noxinfluencer crm batch-update apply --body-file crm-batch-update.json --force

把 CRM channels 加入已有邮件任务：

noxinfluencer crm add-to-email validate --body-file crm-add-to-email.json
noxinfluencer crm add-to-email preview --body-file crm-add-to-email.json
noxinfluencer crm add-to-email apply --body-file crm-add-to-email.json --force

当前边界

这是 NoxInfluencer CRM，不是外部 CRM 集成
只更新负责人或只归档的操作可能需要已有 CRM channel
平台 creator_id 只有在支持的合作状态或标签更新路径里才能物化成 CRM channel；owner-only、email-only、remark-only 和 URL-only 更新需要已有 CRM channel
crm add-to-email 只负责把已有 NoxInfluencer CRM channel 加入已有邮件任务
CRM 标签是 remark / message 共享标签；crm_channel_count 不一定等于所有历史 CRM 行数量
CRM 不替代达人发现、达人分析或联系方式获取

CRM

适合什么场景

当前 beta 范围

安全执行规则

关键命令

当前边界

推荐下一步