Skip to content

Конектори LMS — видача за завершення курсу ​

Підключіть свою LMS один раз, і кожен слухач, який завершить курс, автоматично отримає верифіковані облікові дані — без Zapier, без коду, без ручної видачі. Налаштування виконується на сторінці Integrations у панелі керування.

Підтримувані платформи на сьогодні: Thinkific і Teachable. Незабаром з'являться й інші (Moodle, LearnWorlds).

Як це працює ​

  1. Ви створюєте підключення для своєї LMS і зіставляєте кожен курс із цифровим значком, який потрібно видавати.
  2. Ваша LMS викликає приватну URL-адресу вебхука, коли слухач завершує курс.
  3. badges.ninja верифікує подію, знаходить зіставлений значок і видає облікові дані слухачеві, який може отримати їх без облікового запису, так само як і будь-яку іншу нагороду.

Одне завершення видає одні облікові дані. Доставки ідемпотентні: якщо ваша LMS надішле те саме завершення двічі (вони повторюють спроби), видачі вдруге не буде. Видача зараховується до ліміту облікових даних вашого тарифного плану, як і будь-яка інша нагорода.

Налаштування підключення ​

  1. У панелі керування відкрийте Integrations і виберіть Add connection.
  2. Оберіть свою платформу та вкажіть назву підключення.
  3. Зіставте курси: введіть ID курсу зі своєї LMS і виберіть значок для видачі. Також можна задати значок за замовчуванням для будь-якого курсу, який не зіставлено.
  4. Збережіть. Ви побачите URL-адресу вебхука та секрет підпису — вони показуються лише один раз, тому скопіюйте їх зараз і вставте у свою LMS (кроки нижче).

Thinkific ​

  1. У Thinkific перейдіть до Settings → Code & Analytics → Webhooks → New webhook.
  2. Topic: enrollment.completed.
  3. Target URL: URL-адреса вебхука з вашого підключення.
  4. Виберіть signing secret і вставте секрет підпису з вашого підключення. Збережіть і надішліть тест.

Thinkific підписує кожну доставку, і ми перевіряємо підпис перед видачею.

Teachable ​

  1. У Teachable (тариф Growth або вищий, який потрібен для вебхуків) перейдіть до Settings → Webhooks і додайте вебхук.
  2. Event: Enrollment.completed.
  3. URL: URL-адреса вебхука з вашого підключення.
  4. Оскільки Teachable не підписує свої вебхуки, ми підтверджуємо кожне завершення через API Teachable перед видачею — тому підключення також запитує ваш API-ключ Teachable. Вставте його під час створення підключення.

Перевірте, що все працює ​

Відкрийте підключення та розгорніть Recent deliveries. Кожна вхідна подія журналюється з такими даними:

  • чи її верифіковано,
  • тип події, який надіслала ваша LMS,
  • результат — видано або пропущено (наприклад, курс не зіставлено), із причиною,
  • і необроблене навантаження (raw payload), щоб ви бачили, що саме доставила ваша LMS.

Надішліть тестове завершення зі своєї LMS і спостерігайте, як воно з'явиться тут. Це найшвидший спосіб перевірити наскрізний процес перед запуском. Журнали доставок зберігаються 7 днів.

Корисно знати ​

  • Курс не зіставлено? Подію буде записано в журнал і пропущено (без помилки у відповідь вашій LMS, тож вебхук не вимкнеться). Додайте зіставлення, і наступне завершення буде видано.
  • Ліміт вичерпано? Подію буде записано в журнал і пропущено, доки ліміт не оновиться або ви не перейдете на вищий план.
  • Пауза: переведіть підключення в стан паузи, щоб зупинити видачу без видалення його конфігурації.
  • Підключення може видавати лише значки вашого власного облікового запису.

Пов'язане ​

badges.ninja Documentation