LMS конектори — издаване при завършване на курс

Свържете своята LMS веднъж и всеки обучаем, който завърши курс, получава верифицируема квалификация автоматично — без Zapier, без код, без ръчно издаване. Настройката се прави на страницата Integrations в таблото.

Поддържани платформи към момента: Thinkific и Teachable. Скоро ще има и други (Moodle, LearnWorlds).

Как работи

1. Създавате връзка за вашата LMS и свързвате всеки курс със значката, която трябва да се издаде.
2. Вашата LMS извиква частен уебхук адрес, когато обучаем завърши курс.
3. badges.ninja проверява събитието, намира свързаната значка и издава квалификацията на обучаемия — който може да я получи без акаунт, точно както всяка друга награда.

Едно завършване издава една квалификация. Доставките са идемпотентни: ако вашата LMS изпрати едно и също завършване два пъти (при повторен опит), то няма да бъде издадено два пъти. Издаването се отчита към квотата за квалификации на вашия план като всяка друга награда.

Настройване на връзка

1. В таблото отворете Integrations и изберете Add connection.
2. Изберете платформата си и дайте име на връзката.
3. Свържете курсовете: въведете ID на курса от вашата LMS и изберете значката, която да се издава. Можете да зададете и значка по подразбиране за всеки курс, който не е свързан.
4. Запазете. Ще видите адрес на уебхука и таен ключ за подпис — те се показват само веднъж, затова ги копирайте веднага и ги поставете във вашата LMS (стъпките са по-долу).

Thinkific

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

Thinkific подписва всяка доставка и ние проверяваме подписа, преди да издадем.

Teachable

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

Проверете дали работи

Отворете връзката и разгънете Recent deliveries. Всяко входящо събитие се записва със:

• статус дали е верифицирано,
• типа на събитието, изпратен от вашата LMS,
• резултата — издадено или пропуснато (напр. курсът не е свързан), с причината,
• и суровите данни (payload), за да видите точно какво е доставила вашата LMS.

Изпратете тестово завършване от вашата LMS и вижте как се появява тук. Това е най-бързият начин да потвърдите цялостния процес, преди да преминете към реална работа. Записите за доставки се пазят 7 дни.

Добре е да знаете

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

Вижте също

• Интеграции (Zapier, Make и уебхукове) — за тригери/действия извън завършването на курс.
• Награждаване със значки · Споделяне и верификация