LMS コネクタ — コース修了時に発行

LMS を一度接続すれば、コースを修了した学習者全員に、検証可能なクレデンシャルが自動的に発行されます。Zapier もコードも手動発行も不要です。設定はダッシュボードの Integrations ページで行います。

現在対応しているプラットフォーム: Thinkific と Teachable。そのほか (Moodle、LearnWorlds) も対応予定です。

仕組み

1. LMS 用の接続を作成し、各コースを発行するバッジに対応付けます。
2. 学習者がコースを修了すると、LMS がプライベートな webhook URL を呼び出します。
3. badges.ninja がイベントを検証し、対応付けられたバッジを見つけて、学習者にクレデンシャルを発行します。学習者は、他のアワードと同様にアカウントなしで受け取れます。

1 回の修了で発行されるクレデンシャルは1 件です。配信は冪等です。LMS が同じ修了通知を 2 回送信しても (リトライ時など)、2 回発行されることはありません。発行は、他のアワードと同様にご利用プランのクレデンシャル発行枠にカウントされます。

接続を設定する

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 で (webhook には Growth プラン以上が必要です) Settings → Webhooks に移動し、webhook を追加します。
2. Event: Enrollment.completed。
3. URL: 接続の webhook URL。
4. Teachable は webhook に署名を付けないため、発行前に Teachable API で各修了を確認します。そのため、接続には Teachable API キーも必要です。接続の作成時に貼り付けてください。

動作を確認する

接続を開き、Recent deliveries を展開します。受信した各イベントには次の情報が記録されます。

• 検証されたかどうか、
• LMS が送信したイベントタイプ、
• 結果 — 発行済み、またはスキップ (例: コースが未対応付け) とその理由、
• そして生のペイロード。LMS が実際に何を配信したかを正確に確認できます。

LMS からテスト用の修了を送信し、ここに届くことを確認してください。本番稼働の前にエンドツーエンドの流れを確認する最も手早い方法です。配信ログは 7 日間保持されます。

知っておくべきこと

• コースが未対応付け? イベントは記録されてスキップされます (LMS にはエラーを返さないため、webhook が無効化されることはありません)。対応付けを追加すれば、次の修了から発行されます。
• 発行枠に達した? 発行枠がリセットされるかプランをアップグレードするまで、イベントは記録されてスキップされます。
• 一時停止: 接続を paused に設定すると、設定を削除せずに発行を停止できます。
• 接続で発行できるのは、ご自身のアカウントのバッジのみです。

関連項目

• 連携 (Zapier、Make、webhook) — コース修了以外のトリガー/アクション向け。
• バッジの発行 · 共有と検証