Konektory LMS — wystawianie po ukończeniu kursu

Połącz swój LMS raz, a każdy uczestnik, który ukończy kurs, otrzyma weryfikowalną cyfrową odznakę automatycznie — bez Zapiera, bez kodu, bez ręcznego wystawiania. Skonfigurujesz to na stronie Integrations w panelu.

Obsługiwane obecnie platformy: Thinkific i Teachable. Kolejne (Moodle, LearnWorlds) są w drodze.

Jak to działa

1. Tworzysz połączenie dla swojego LMS i przypisujesz każdy kurs do odznaki, którą ma wystawiać.
2. Twój LMS wywołuje prywatny adres URL webhooka, gdy uczestnik kończy kurs.
3. badges.ninja weryfikuje zdarzenie, znajduje przypisaną odznakę i wystawia cyfrową odznakę uczestnikowi — który może ją odebrać bez konta, dokładnie tak jak każde inne przyznanie.

Jedno ukończenie wystawia jedną cyfrową odznakę. Dostarczanie jest idempotentne: jeśli Twój LMS wyśle to samo ukończenie dwa razy (ponawia próby), odznaka nie zostanie wystawiona dwukrotnie. Wystawianie wlicza się do limitu cyfrowych odznak w Twoim planie, tak jak każde inne przyznanie.

Konfiguracja połączenia

1. W panelu otwórz Integrations i wybierz Add connection.
2. Wybierz swoją platformę i nadaj połączeniu nazwę.
3. Przypisz kursy: wpisz identyfikator kursu z Twojego LMS i wybierz odznakę do wystawienia. Możesz też ustawić domyślną odznakę dla każdego kursu, który nie jest przypisany.
4. Zapisz. Zobaczysz adres URL webhooka i sekret podpisywania — są pokazywane tylko raz, więc skopiuj je teraz, a następnie wklej do swojego LMS (kroki poniżej).

Thinkific

1. W Thinkific przejdź do Settings → Code & Analytics → Webhooks → New webhook.
2. Topic: enrollment.completed.
3. Target URL: adres URL webhooka z Twojego połączenia.
4. Wybierz signing secret i wklej sekret podpisywania z Twojego połączenia. Zapisz i wyślij test.

Thinkific podpisuje każde dostarczenie, a my weryfikujemy podpis przed wystawieniem.

Teachable

1. W Teachable (plan Growth lub wyższy, wymagany dla webhooków) przejdź do Settings → Webhooks i dodaj webhook.
2. Event: Enrollment.completed.
3. URL: adres URL webhooka z Twojego połączenia.
4. Ponieważ Teachable nie podpisuje swoich webhooków, przed wystawieniem potwierdzamy każde ukończenie w API Teachable — dlatego połączenie wymaga także Twojego klucza API Teachable. Wklej go podczas tworzenia połączenia.

Sprawdź, czy działa

Otwórz połączenie i rozwiń Recent deliveries. Każde przychodzące zdarzenie jest rejestrowane wraz z:

• informacją, czy zostało zweryfikowane,
• typem zdarzenia wysłanym przez Twój LMS,
• wynikiem — wystawione lub pominięte (np. kurs nie był przypisany), wraz z powodem,
• oraz surowym payloadem, dzięki czemu widzisz dokładnie, co dostarczył Twój LMS.

Wyślij testowe ukończenie ze swojego LMS i obserwuj, jak się tu pojawia. To najszybszy sposób na sprawdzenie całego przepływu przed uruchomieniem produkcyjnym. Logi dostarczeń są przechowywane przez 7 dni.

Warto wiedzieć

• Kurs nie jest przypisany? Zdarzenie jest rejestrowane i pomijane (bez błędu zwracanego do Twojego LMS, więc webhook nie zostanie wyłączony). Dodaj przypisanie, a następne ukończenie wystawi odznakę.
• Limit wyczerpany? Zdarzenie jest rejestrowane i pomijane, dopóki limit się nie zresetuje lub nie przejdziesz na wyższy plan.
• Wstrzymanie: ustaw połączenie jako wstrzymane, aby przestać wystawiać odznaki bez usuwania jego konfiguracji.
• Połączenie może wystawiać wyłącznie odznaki z Twojego własnego konta.

Powiązane

• Integracje (Zapier, Make i webhooki) — dla wyzwalaczy i akcji wykraczających poza ukończenie kursu.
• Przyznawanie odznak · Udostępnianie i weryfikacja