LMS 커넥터 — 과정 수료 시 자동 발급

LMS를 한 번만 연결하면 과정을 수료하는 모든 학습자가 검증 가능한 크리덴셜을 자동으로 받아요. Zapier도, 코드도, 수동 발급도 필요 없어요. 대시보드의 통합 페이지에서 설정하세요.

현재 지원하는 플랫폼은 Thinkific과 Teachable이에요. Moodle, LearnWorlds 등은 곧 추가될 예정이에요.

작동 방식

1. LMS용 연결을 만들고, 각 과정을 발급할 배지에 매핑해요.
2. 학습자가 과정을 마치면 LMS가 비공개 웹훅 URL을 호출해요.
3. badges.ninja가 이벤트를 검증하고, 매핑된 배지를 찾아 학습자에게 크리덴셜을 발급해요. 학습자는 다른 수여와 똑같이 계정 없이도 크리덴셜을 받을 수 있어요.

수료 한 번당 크리덴셜은 하나만 발급돼요. 전달은 멱등성을 갖춰요. LMS가 같은 수료 이벤트를 두 번 보내더라도(재시도할 때 그래요) 두 번 발급되지 않아요. 발급은 다른 수여와 마찬가지로 요금제의 크리덴셜 허용량에서 차감돼요.

연결 설정하기

1. 대시보드에서 통합을 열고 연결 추가를 선택하세요.
2. 플랫폼을 고르고 연결 이름을 입력하세요.
3. 과정을 매핑하세요. LMS의 각 과정 ID를 입력하고 발급할 배지를 선택해요. 매핑되지 않은 과정에 사용할 기본 배지도 지정할 수 있어요.
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은 웹훅에 서명하지 않으므로 발급 전에 Teachable API로 각 수료를 확인해요. 그래서 연결을 만들 때 Teachable API 키도 입력해야 해요. 연결을 만들 때 붙여 넣으세요.

작동 확인하기

연결을 열고 최근 전달을 펼치세요. 수신된 모든 이벤트가 다음 정보와 함께 기록돼요.

• 검증되었는지 여부,
• LMS가 보낸 이벤트 유형,
• 결과 — 발급되었는지, 또는 건너뛰었는지(예: 과정이 매핑되지 않음)와 그 이유,
• 그리고 LMS가 실제로 보낸 내용을 정확히 볼 수 있는 원본 페이로드.

LMS에서 테스트 수료를 보내고 여기에 도착하는지 확인해 보세요. 실제로 사용하기 전에 전체 흐름을 확인하는 가장 빠른 방법이에요. 전달 로그는 7일간 보관돼요.

알아 두면 좋은 점

• 과정이 매핑되지 않았나요? 이벤트는 기록되고 건너뛰어요(LMS에 오류를 돌려주지 않으므로 웹훅이 비활성화되지 않아요). 매핑을 추가하면 다음 수료부터 발급돼요.
• 허용량에 도달했나요? 허용량이 초기화되거나 업그레이드할 때까지 이벤트는 기록되고 건너뛰어요.
• 일시 중지: 연결을 일시 중지로 설정하면 구성을 삭제하지 않고 발급만 멈출 수 있어요.
• 연결은 내 계정의 배지만 발급할 수 있어요.

관련 문서

• 통합(Zapier, Make 및 웹훅) — 과정 수료 외의 트리거/액션을 다룹니다.
• 배지 수여 · 공유 및 검증