LMS-liitännät — myönnä todistus kurssin suorittamisesta

Yhdistä LMS kerran, ja jokainen kurssin suorittanut oppija saa varmennettavan todistuksen automaattisesti — ilman Zapieria, ilman koodia, ilman manuaalista myöntämistä. Määritä se kojelaudan Integrations-sivulla.

Tällä hetkellä tuetut alustat: Thinkific ja Teachable. Lisää (Moodle, LearnWorlds) on tulossa.

Näin se toimii

1. Luot LMS:llesi yhteyden ja yhdistät jokaisen kurssin merkkiin, joka sen perusteella myönnetään.
2. LMS kutsuu yksityistä webhook-URL-osoitetta, kun oppija suorittaa kurssin.
3. badges.ninja varmentaa tapahtuman, löytää yhdistetyn merkin ja myöntää todistuksen oppijalle — joka voi lunastaa sen ilman tiliä, aivan kuten minkä tahansa muun palkinnon.

Yksi suoritus myöntää yhden todistuksen. Toimitukset ovat idempotentteja: jos LMS lähettää saman suorituksen kahdesti (ne yrittävät uudelleen), merkkiä ei myönnetä kahdesti. Myöntäminen kuluttaa pakettisi todistuskiintiötä kuten mikä tahansa muu palkinto.

Yhteyden määrittäminen

1. Avaa kojelaudalla Integrations ja valitse Add connection.
2. Valitse alustasi ja anna yhteydelle nimi.
3. Yhdistä kurssisi: syötä jokaisen kurssin kurssi-ID LMS:stäsi ja valitse myönnettävä merkki. Voit myös asettaa oletusmerkin kursseille, joita ei ole yhdistetty.
4. Tallenna. Näet webhook-URL-osoitteen ja allekirjoitussalaisuuden — ne näytetään vain kerran, joten kopioi ne nyt ja liitä ne LMS:ääsi (vaiheet alla).

Thinkific

1. Siirry Thinkificissä kohtaan Settings → Code & Analytics → Webhooks → New webhook.
2. Topic: enrollment.completed.
3. Target URL: yhteytesi webhook-URL.
4. Valitse signing secret ja liitä yhteytesi allekirjoitussalaisuus. Tallenna ja lähetä testi.

Thinkific allekirjoittaa jokaisen toimituksen, ja varmennamme sen ennen myöntämistä.

Teachable

1. Siirry Teachablessa (Growth-paketti tai korkeampi, joka vaaditaan webhookeihin) kohtaan Settings → Webhooks ja lisää webhook.
2. Event: Enrollment.completed.
3. URL: yhteytesi webhook-URL.
4. Koska Teachable ei allekirjoita webhookejaan, vahvistamme jokaisen suorituksen Teachablen API:sta ennen myöntämistä — siksi yhteys pyytää myös Teachable API -avaintasi. Liitä se yhteyttä luodessasi.

Varmista, että se toimii

Avaa yhteys ja laajenna Recent deliveries. Jokainen saapuva tapahtuma kirjataan seuraavin tiedoin:

• onko se varmennettu,
• LMS:si lähettämä tapahtumatyyppi,
• lopputulos — myönnetty tai ohitettu (esim. kurssia ei ollut yhdistetty) syineen,
• sekä raakadata (payload), jotta näet tarkalleen, mitä LMS toimitti.

Lähetä testisuoritus LMS:stäsi ja seuraa, kuinka se ilmestyy tänne. Tämä on nopein tapa varmistaa koko ketju ennen tuotantoon siirtymistä. Toimituslokeja säilytetään 7 päivää.

Hyvä tietää

• Kurssia ei ole yhdistetty? Tapahtuma kirjataan ja ohitetaan (LMS:lle ei palaudu virhettä, joten webhookia ei poisteta käytöstä). Lisää yhdistäminen, niin seuraava suoritus myöntää merkin.
• Kiintiö täynnä? Tapahtuma kirjataan ja ohitetaan, kunnes kiintiösi nollautuu tai päivität pakettisi.
• Keskeyttäminen: aseta yhteys keskeytetyksi lopettaaksesi myöntämisen poistamatta sen asetuksia.
• Yhteys voi myöntää vain oman tilisi merkkejä.

Liittyvää

• Integraatiot (Zapier, Make ja webhookit) — laukaisimiin/toimintoihin kurssin suorittamisen ulkopuolella.
• Merkkien myöntäminen · Jakaminen ja varmennus