LMS 連接器 — 課程完成時自動頒發

只要連接一次你的 LMS,每位完成課程的學員都會自動取得一枚可驗證的憑證 — 不需要 Zapier、不需要寫程式、也不必手動頒發。請在儀表板的 整合 頁面中進行設定。

目前支援的平台:Thinkific 與 Teachable。更多平台(Moodle、LearnWorlds)即將推出。

運作方式

1. 你為自己的 LMS 建立一個連線,並將每門課程對應到應頒發的徽章。
2. 學員完成課程時,你的 LMS 會呼叫一個私有的 webhook URL。
3. badges.ninja 會驗證該事件、找到對應的徽章,並將憑證頒發給學員 — 學員不需要帳號即可領取,與其他任何頒發方式完全相同。

一次課程完成只會頒發一筆憑證。傳送具備冪等性:若你的 LMS 重複傳送同一筆完成事件(它們會重試),系統不會重複頒發。頒發同樣會計入你方案的憑證額度,與其他頒發方式相同。

設定連線

1. 在儀表板中開啟 整合,然後選擇 新增連線。
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 金鑰。建立連線時請將其貼上。

確認是否正常運作

開啟該連線並展開 近期傳送紀錄。每個傳入事件都會記錄:

• 是否已通過驗證,
• 你的 LMS 傳送的事件類型,
• 結果 — 已頒發,或已略過(例如課程未對應),並附上原因,
• 以及原始 payload,讓你清楚看到 LMS 實際傳送了什麼內容。

從你的 LMS 傳送一筆測試的完成事件,並觀察它出現在此處。在正式上線前,這是確認端到端流程最快的方式。傳送紀錄會保留 7 天。

注意事項

• **課程未對應?**事件會被記錄並略過(不會回傳錯誤給你的 LMS,因此不會停用 webhook)。新增對應後,下一次完成事件就會頒發。
• **已達額度上限?**事件會被記錄並略過,直到你的額度重置或你升級方案。
• **暫停:**將連線設為暫停,即可在不刪除其設定的情況下停止頒發。
• 連線只能頒發你自己帳號的徽章。

相關內容

• 整合(Zapier、Make 與 webhook) — 適用於課程完成以外的觸發器/動作。
• 頒發徽章 · 分享與驗證