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

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

Сейчас поддерживаются платформы: Thinkific и Teachable. Скоро появятся и другие (Moodle, LearnWorlds).

Как это работает

1. Вы создаёте подключение для своей LMS и сопоставляете каждый курс со значком, который нужно выдавать.
2. Ваша LMS вызывает закрытый URL вебхука, когда учащийся завершает курс.
3. badges.ninja проверяет событие, находит сопоставленный значок и выдаёт удостоверение учащемуся — он может получить его без аккаунта, как и любую другую выдачу.

Одно завершение курса выдаёт одно удостоверение. Доставки идемпотентны: если ваша LMS отправит одно и то же завершение дважды (при повторных попытках), выдача не повторится. Выдача расходует квоту удостоверений вашего тарифа, как и любая другая выдача.

Настройка подключения

1. В панели управления откройте Integrations и выберите Add connection.
2. Выберите платформу и задайте название подключения.
3. Сопоставьте курсы: введите course 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,
• результат — выдано или пропущено (например, курс не был сопоставлен) с указанием причины,
• и исходный payload, чтобы вы видели, что именно доставила ваша LMS.

Отправьте тестовое завершение курса из LMS и посмотрите, как оно появится здесь. Это самый быстрый способ проверить весь процесс перед запуском. Журналы доставок хранятся 7 дней.

Полезно знать

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

Связанное

• Интеграции (Zapier, Make и вебхуки) — для триггеров и действий помимо завершения курса.
• Выдача значков · Публикация и верификация