用途:在 Cargo 工作区自有的发信域名上开通真实发件箱,管理预热、发信额度、往来邮件与退订抑制,实际投递交由编排动作 sendEmail 完成。
安装与登录:npm install -g @cargo-ai/cli;cargo-ai login --email you@company.com(也支持 --oauth、--token),用 cargo-ai whoami 确认工作区。命令均输出 JSON,失败以非零退出并返回 errorMessage;每个命令是一次 HTTP 调用,无需轮询运行,仅新建邮箱的 pending 状态用 mailbox refresh-status 查询。
主要命令:mailbox create(需 --domain-uuid、--type google/shared/private、--username、姓名、签名、文件夹;outlook 不支持,会报 transportNotSupported)、mailbox list/get/update/remove;start-warmup(--daily-target 1–40,默认 40)、get-warmup-stats、update-warmup、stop-warmup(会重置 45 天与每日 5 封的爬坡);get-send-allowance 查看 dailyLimit、sentCount、remainingCount;message、thread、event、suppression(list/create,无删除,写入幂等并规范化地址)、pricing get。发信需权限 mailboxManagement:write,读取需 read。
限制:无 CLI 命令列出或查询发信域名,需从 Web 应用或 CDK 获取 UUID;未预热邮箱固定在每日 5 封,预热需 45 天;超出额度立即失败而非排队;CLI 无试发;bounced 事件暂无生产者,不能把退订/退信为空当作名单干净;邮箱按 100–160 积分/月持续计费,remove 才能停止。发信前需完成权限依据、抑制名单与相关性三项检查。