LMS 连接器——课程完成时自动颁发

只需连接一次你的 LMS,每位完成课程的学习者都会自动获得可验证凭证——无需 Zapier、无需代码、无需手动颁发。你可以在控制台的 Integrations 页面中进行设置。

目前支持的平台:Thinkific 和 Teachable。更多平台(Moodle、LearnWorlds)即将推出。

工作原理

1. 你为 LMS 创建一个连接,并将每门课程映射到应颁发的数字徽章。
2. 学习者完成课程时,你的 LMS 会调用一个私有的 webhook URL。
3. badges.ninja 验证该事件,找到映射的徽章,并向学习者颁发凭证——学习者无需账户即可领取,与其他任何奖励完全一样。

一次完成只会颁发一份凭证。投递是幂等的:如果你的 LMS 重复发送同一次完成事件(它们会重试),不会重复颁发。颁发会像其他任何奖励一样计入你套餐的凭证额度。

设置连接

1. 在控制台中打开 Integrations,然后选择 Add connection。
2. 选择你的平台,并为连接命名。
3. 映射课程:输入 LMS 中每门课程的课程 ID,并选择要颁发的徽章。你也可以为未映射的课程设置一个默认徽章。
4. 保存。你会看到一个 webhook URL 和一个签名密钥——它们只会显示一次,请立即复制,然后粘贴到你的 LMS 中(见下方步骤)。

Thinkific

1. 在 Thinkific 中,前往 Settings → Code & Analytics → Webhooks → New webhook。
2. Topic:enrollment.completed。
3. **Target URL:**你的连接中的 webhook URL。
4. 选择 signing secret,并粘贴连接中的签名密钥。保存并发送测试。

Thinkific 会为每次投递签名,我们会在颁发前验证签名。

Teachable

1. 在 Teachable 中(Growth 套餐或更高,webhook 需要此套餐),前往 Settings → Webhooks 并添加一个 webhook。
2. Event:Enrollment.completed。
3. **URL:**你的连接中的 webhook URL。
4. 由于 Teachable 不会为其 webhook 签名,我们会在颁发前通过 Teachable API 确认每次完成——因此连接还需要你的 Teachable API 密钥。创建连接时请粘贴它。

确认一切正常

打开连接并展开 Recent deliveries。每个收到的事件都会被记录,包含:

• 是否已验证,
• 你的 LMS 发送的事件类型,
• 结果——已颁发或已跳过(例如课程未映射),并附原因,
• 以及原始负载(raw payload),让你确切看到 LMS 投递了什么。

从你的 LMS 发送一次测试完成事件,并观察它出现在这里。这是正式上线前确认端到端流程的最快方式。投递日志保留 7 天。

须知

• 课程未映射? 事件会被记录并跳过(不会向你的 LMS 返回错误,因此不会导致 webhook 被禁用)。添加映射后,下一次完成就会颁发。
• 额度已用完? 事件会被记录并跳过,直到你的额度重置或你升级套餐。
• 暂停: 将连接设为暂停,即可停止颁发而无需删除其配置。
• 连接只能颁发你自己账户的徽章。

相关

• 集成(Zapier、Make 和 webhooks)——适用于课程完成之外的触发器/操作。
• 颁发徽章 · 分享与验证