批量颁发

批量颁发让你通过上传 CSV 文件,一次性为数百或数千名接收者发放徽章。流程分为四步,内置进度跟踪、暂停/恢复以及错误处理。

概览

批量颁发流程包含四个步骤:

1. 配置 — 选择徽章和选项
2. 上传 — 准备并上传 CSV 文件
3. 处理 — 随着颁发创建实时跟踪进度
4. 结果 — 查看结果并下载报告

第 1 步:配置

1. 从侧边栏打开 颁发 页面。
2. 点击 批量颁发。
3. 使用徽章选择器选择你要颁发的徽章。
4. 可选配置:
   • 颁发日期 — 应用到所有颁发的日期(默认为今天)
   • 到期 — 所有颁发的可选到期日期
   • 发送邮件 — 创建每条颁发后是否自动给接收者发邮件
5. 点击 下一步。

第 2 步:上传 CSV

CSV 格式

CSV 文件必须有两列:name 和 email。第一行应该是表头。

name,email
Jane Smith,jane@example.com
John Doe,john@example.com
Maria Garcia,maria@example.com

下载模板

点击 下载模板 获取带正确表头的空白 CSV。填入接收者后上传。

上传

1. 点击 上传 CSV 或拖放文件。
2. 文件会在开始处理前进行校验。

校验规则

每一行会进行校验:

• 姓名 至少 5 个字符
• 邮箱 必须是有效的电子邮件地址
• 文件内重复的邮箱会被标记
• 空行会被跳过

如果发现校验错误,会随行号一并显示。修正 CSV 中的问题后重新上传。

3. 点击 下一步 开始处理。

第 3 步:处理

处理一旦开始,你会看到进度条和实时状态:

• 进度条 — 显示已处理行数的百分比
• 当前行 — 正在处理的行
• 成功计数 — 已创建的颁发数量
• 错误计数 — 失败的行数

暂停与恢复

• 点击 暂停 临时停止处理。暂停期间不会创建新的颁发。
• 点击 恢复 从上次中断处继续。

取消

• 点击 取消 完全停止处理。已创建的颁发保持不变。

错误处理

当某一行失败(例如数据无效、达到月度颁发配额):

• 错误会带详情被记录
• 处理自动继续到下一行
• 失败的行将被收集用于结果步骤

页面刷新恢复

如果你不慎关闭浏览器或在处理过程中刷新页面,回到页面时批量颁发会话会被恢复。进度从中断处继续。

第 4 步:结果

处理完成(或取消)后,结果屏显示:

• 总处理数 — 尝试的行数
• 成功 — 创建的颁发数量
• 失败 — 失败的行数

下载报告

• 下载成功 CSV — 所有成功创建的颁发的 CSV,包含接收者姓名、邮箱和验证 URL
• 下载失败 CSV — 所有失败行及其错误详情的 CSV

重试失败

如果有行失败,可以下载失败 CSV,修复问题后作为新的批量颁发重新上传,重试这些接收者。