Skip to content

LMS-Konnektoren — Ausstellung bei Kursabschluss ​

Verbinde dein LMS einmal, und jede Lernende bzw. jeder Lernende, die oder der einen Kurs abschließt, erhält automatisch ein verifizierbares Credential — ohne Zapier, ohne Code, ohne manuelles Ausstellen. Die Einrichtung erfolgt auf der Seite Integrationen im Dashboard.

Aktuell unterstützte Plattformen: Thinkific und Teachable. Weitere (Moodle, LearnWorlds) folgen.

So funktioniert es ​

  1. Du erstellst eine Verbindung für dein LMS und ordnest jedem Kurs das Abzeichen zu, das ausgestellt werden soll.
  2. Dein LMS ruft eine private Webhook-URL auf, wenn jemand einen Kurs abschließt.
  3. badges.ninja verifiziert das Ereignis, findet das zugeordnete Abzeichen und stellt das Credential für die lernende Person aus — sie kann es ohne Konto abholen, genau wie jede andere Vergabe.

Ein Kursabschluss stellt ein Credential aus. Zustellungen sind idempotent: Sendet dein LMS denselben Abschluss zweimal (es wiederholt Zustellungen), wird nicht doppelt ausgestellt. Das Ausstellen zählt wie jede andere Vergabe auf das Credential-Kontingent deines Tarifs.

Eine Verbindung einrichten ​

  1. Öffne im Dashboard Integrationen und wähle Verbindung hinzufügen.
  2. Wähle deine Plattform und gib der Verbindung einen Namen.
  3. Ordne deine Kurse zu: Gib jede Kurs-ID aus deinem LMS ein und wähle das Abzeichen, das ausgestellt werden soll. Du kannst auch ein Standard-Abzeichen für jeden Kurs festlegen, der nicht zugeordnet ist.
  4. Speichere. Dir werden eine Webhook-URL und ein Signaturgeheimnis angezeigt — diese erscheinen nur einmal, kopiere sie also jetzt und füge sie in dein LMS ein (Schritte unten).

Thinkific ​

  1. Gehe in Thinkific zu Settings → Code & Analytics → Webhooks → New webhook.
  2. Topic: enrollment.completed.
  3. Target URL: die Webhook-URL deiner Verbindung.
  4. Wähle signing secret und füge das Signaturgeheimnis deiner Verbindung ein. Speichere und sende einen Test.

Thinkific signiert jede Zustellung, was wir vor dem Ausstellen verifizieren.

Teachable ​

  1. Gehe in Teachable (Growth-Tarif oder höher, der für Webhooks erforderlich ist) zu Settings → Webhooks und füge einen Webhook hinzu.
  2. Event: Enrollment.completed.
  3. URL: die Webhook-URL deiner Verbindung.
  4. Da Teachable seine Webhooks nicht signiert, bestätigen wir jeden Abschluss vor dem Ausstellen über die Teachable-API — daher verlangt die Verbindung auch deinen Teachable-API-Schlüssel. Füge ihn beim Erstellen der Verbindung ein.

Prüfen, ob es funktioniert ​

Öffne die Verbindung und klappe Letzte Zustellungen auf. Jedes eingehende Ereignis wird protokolliert mit:

  • ob es verifiziert wurde,
  • dem Ereignistyp, den dein LMS gesendet hat,
  • dem Ergebnis — ausgestellt oder übersprungen (z. B. weil der Kurs nicht zugeordnet war), mit Begründung,
  • und der Roh-Payload, damit du genau siehst, was dein LMS geliefert hat.

Sende einen Test-Abschluss aus deinem LMS und sieh zu, wie er hier ankommt. So bestätigst du den gesamten Ablauf am schnellsten, bevor du live gehst. Zustellungsprotokolle werden 7 Tage lang aufbewahrt.

Gut zu wissen ​

  • Kurs nicht zugeordnet? Das Ereignis wird protokolliert und übersprungen (kein Fehler an dein LMS, der Webhook wird also nicht deaktiviert). Füge die Zuordnung hinzu, und der nächste Abschluss wird ausgestellt.
  • Kontingent erreicht? Das Ereignis wird protokolliert und übersprungen, bis dein Kontingent zurückgesetzt wird oder du upgradest.
  • Pausieren: Setze eine Verbindung auf pausiert, um das Ausstellen zu stoppen, ohne ihre Konfiguration zu löschen.
  • Eine Verbindung kann ausschließlich Abzeichen deines eigenen Kontos ausstellen.

Verwandte Themen ​

badges.ninja Documentation