Trình kết nối LMS — cấp chứng chỉ khi hoàn thành khóa học

Kết nối LMS của bạn một lần, và mỗi học viên hoàn thành khóa học sẽ tự động nhận được chứng chỉ có thể xác minh — không cần Zapier, không cần code, không cần cấp thủ công. Bạn thiết lập tại trang Integrations trong dashboard.

Các nền tảng được hỗ trợ hiện nay: Thinkific và Teachable. Sắp có thêm (Moodle, LearnWorlds).

Cách hoạt động

1. Bạn tạo một kết nối cho LMS và ánh xạ mỗi khóa học với huy hiệu kỹ thuật số cần cấp.
2. LMS của bạn gọi một URL webhook riêng tư khi học viên hoàn thành khóa học.
3. badges.ninja xác minh sự kiện, tìm huy hiệu đã ánh xạ và cấp chứng chỉ cho học viên — người này có thể nhận mà không cần tài khoản, giống như mọi giải thưởng khác.

Một lần hoàn thành cấp một chứng chỉ. Các lần gửi là idempotent: nếu LMS của bạn gửi cùng một lần hoàn thành hai lần (chúng có thử lại), hệ thống sẽ không cấp hai lần. Việc cấp được tính vào hạn mức chứng chỉ của gói của bạn như mọi giải thưởng khác.

Thiết lập kết nối

1. Trong dashboard, mở Integrations và chọn Add connection.
2. Chọn nền tảng của bạn và đặt tên cho kết nối.
3. Ánh xạ các khóa học: nhập ID khóa học từ LMS của bạn và chọn huy hiệu cần cấp. Bạn cũng có thể đặt một huy hiệu mặc định cho mọi khóa học chưa được ánh xạ.
4. Lưu lại. Bạn sẽ thấy một URL webhook và một khóa bí mật ký (signing secret) — chúng chỉ hiển thị một lần, vì vậy hãy sao chép ngay, rồi dán vào LMS của bạn (các bước bên dưới).

Thinkific

1. Trong Thinkific, vào Settings → Code & Analytics → Webhooks → New webhook.
2. Topic: enrollment.completed.
3. Target URL: URL webhook từ kết nối của bạn.
4. Chọn signing secret và dán khóa bí mật ký từ kết nối của bạn. Lưu lại và gửi thử.

Thinkific ký mọi lần gửi, và chúng tôi xác minh chữ ký trước khi cấp.

Teachable

1. Trong Teachable (gói Growth trở lên, bắt buộc để dùng webhook), vào Settings → Webhooks và thêm một webhook.
2. Event: Enrollment.completed.
3. URL: URL webhook từ kết nối của bạn.
4. Vì Teachable không ký webhook của mình, chúng tôi xác nhận mỗi lần hoàn thành với API Teachable trước khi cấp — nên kết nối cũng yêu cầu khóa API Teachable của bạn. Hãy dán khóa đó khi tạo kết nối.

Xác nhận mọi thứ hoạt động

Mở kết nối và mở rộng Recent deliveries. Mỗi sự kiện đến được ghi lại cùng với:

• việc nó có được xác minh hay không,
• loại sự kiện mà LMS của bạn gửi,
• kết quả — đã cấp hoặc bị bỏ qua (ví dụ: khóa học chưa được ánh xạ), kèm lý do,
• và payload thô, để bạn thấy chính xác những gì LMS của bạn đã gửi.

Hãy gửi một lần hoàn thành thử từ LMS của bạn và xem nó xuất hiện ở đây. Đây là cách nhanh nhất để xác nhận luồng đầu-cuối trước khi đưa vào hoạt động. Nhật ký gửi được lưu giữ trong 7 ngày.

Cần biết

• Khóa học chưa được ánh xạ? Sự kiện được ghi lại và bỏ qua (không trả lỗi về LMS của bạn, nên webhook sẽ không bị vô hiệu hóa). Hãy thêm ánh xạ và lần hoàn thành tiếp theo sẽ được cấp.
• Đã hết hạn mức? Sự kiện được ghi lại và bỏ qua cho đến khi hạn mức của bạn được đặt lại hoặc bạn nâng cấp.
• Tạm dừng: đặt kết nối ở trạng thái tạm dừng để ngừng cấp mà không xóa cấu hình.
• Một kết nối chỉ có thể cấp huy hiệu thuộc tài khoản của chính bạn.

Liên quan

• Tích hợp (Zapier, Make & webhooks) — cho các trigger/action ngoài việc hoàn thành khóa học.
• Trao huy hiệu · Chia sẻ & xác minh