Konektory LMS — vydání při dokončení kurzu

Připojte svůj LMS jednou a každý student, který dokončí kurz, automaticky získá ověřitelný přihlašovací údaj — bez Zapieru, bez kódu, bez ručního vydávání. Nastavení provedete na stránce Integrace v dashboardu.

Aktuálně podporované platformy: Thinkific a Teachable. Další (Moodle, LearnWorlds) připravujeme.

Jak to funguje

1. Vytvoříte připojení pro svůj LMS a každému kurzu přiřadíte odznak, který se má vydat.
2. Váš LMS zavolá soukromou adresu webhooku, když student kurz dokončí.
3. badges.ninja událost ověří, najde přiřazený odznak a vydá přihlašovací údaj studentovi — ten si ho může převzít bez účtu, stejně jako jakékoli jiné udělení.

Jedno dokončení vydá jeden přihlašovací údaj. Doručení jsou idempotentní: pokud váš LMS pošle totéž dokončení dvakrát (opakuje odeslání), nevydá se dvakrát. Vydání se počítá do limitu přihlašovacích údajů vašeho tarifu stejně jako jakékoli jiné udělení.

Nastavení připojení

1. V dashboardu otevřete Integrace a zvolte Přidat připojení.
2. Vyberte svou platformu a pojmenujte připojení.
3. Přiřaďte kurzy: zadejte ID kurzu z vašeho LMS a vyberte odznak, který se má vydat. Můžete také nastavit výchozí odznak pro každý kurz, který není přiřazen.
4. Uložte. Zobrazí se adresa webhooku a podpisové tajemství — ty se zobrazují jen jednou, proto je hned zkopírujte a vložte do svého LMS (kroky níže).

Thinkific

1. V Thinkificu přejděte do Settings → Code & Analytics → Webhooks → New webhook.
2. Topic: enrollment.completed.
3. Target URL: adresa webhooku z vašeho připojení.
4. Zvolte signing secret a vložte podpisové tajemství z vašeho připojení. Uložte a odešlete test.

Thinkific podepisuje každé doručení a my podpis před vydáním ověřujeme.

Teachable

1. V Teachable (tarif Growth nebo vyšší, který je pro webhooky nutný) přejděte do Settings → Webhooks a přidejte webhook.
2. Event: Enrollment.completed.
3. URL: adresa webhooku z vašeho připojení.
4. Protože Teachable své webhooky nepodepisuje, každé dokončení před vydáním potvrzujeme přes API Teachable — připojení proto vyžaduje také váš API klíč Teachable. Vložte jej při vytváření připojení.

Ověření, že to funguje

Otevřete připojení a rozbalte Poslední doručení. Každá příchozí událost se zaznamená s:

• informací, zda byla ověřena,
• typem události, který váš LMS poslal,
• výsledkem — vydáno, nebo přeskočeno (např. kurz nebyl přiřazen), včetně důvodu,
• a surovým payloadem, takže přesně vidíte, co váš LMS doručil.

Pošlete z LMS testovací dokončení a sledujte, jak se zde objeví. Je to nejrychlejší způsob, jak před spuštěním ověřit celý průběh. Logy doručení se uchovávají 7 dní.

Dobré vědět

• Kurz není přiřazen? Událost se zaznamená a přeskočí (váš LMS nedostane žádnou chybu, takže webhook nezakáže). Přidejte přiřazení a další dokončení se vydá.
• Dosažen limit? Událost se zaznamená a přeskočí, dokud se limit neobnoví nebo dokud tarif nezvýšíte.
• Pozastavení: nastavte připojení jako pozastavené, abyste zastavili vydávání bez smazání jeho konfigurace.
• Připojení může vydávat jedině odznaky vašeho vlastního účtu.

Související

• Integrace (Zapier, Make a webhooky) — pro spouštěče/akce nad rámec dokončení kurzu.
• Udělování odznaků · Sdílení a ověření