Skip to content

Mga LMS Connector — mag-issue pagkatapos makumpleto ang course ​

Ikonekta ang LMS mo nang isang beses at bawat learner na makakatapos ng course ay makakatanggap ng verifiable credential nang awtomatiko — walang Zapier, walang code, walang manual na pag-issue. I-set up ito sa pahina ng Integrations sa dashboard.

Mga suportadong platform sa ngayon: Thinkific at Teachable. Paparating pa ang iba (Moodle, LearnWorlds).

Paano ito gumagana ​

  1. Gagawa ka ng connection para sa LMS mo at imamapa ang bawat course sa badge na dapat i-issue.
  2. Tatawagin ng LMS mo ang isang pribadong webhook URL kapag natapos ng learner ang isang course.
  3. Vini-verify ng badges.ninja ang event, hinahanap ang naka-map na badge, at ini-issue ang credential sa learner — na puwedeng i-claim ito nang walang account, tulad ng alinmang award.

Ang isang pagkumpleto ay nag-iisyu ng isang credential. Idempotent ang mga delivery: kung dalawang beses ipadala ng LMS mo ang parehong pagkumpleto (nagre-retry sila), hindi ito mag-iisyu nang dalawang beses. Ang pag-issue ay binibilang sa credential allowance ng plan mo tulad ng alinmang award.

Mag-set up ng connection ​

  1. Sa dashboard, buksan ang Integrations at piliin ang Add connection.
  2. Piliin ang platform mo at bigyan ng pangalan ang connection.
  3. I-map ang mga course mo: ilagay ang bawat course ID mula sa LMS mo at piliin ang badge na i-issue. Puwede ka ring magtakda ng default badge para sa anumang course na hindi naka-map.
  4. I-save. Makikita mo ang webhook URL at signing secret — isang beses lang ipinapakita ang mga ito, kaya kopyahin na ngayon, at i-paste sa LMS mo (mga hakbang sa ibaba).

Thinkific ​

  1. Sa Thinkific, pumunta sa Settings → Code & Analytics → Webhooks → New webhook.
  2. Topic: enrollment.completed.
  3. Target URL: ang webhook URL mula sa connection mo.
  4. Piliin ang signing secret at i-paste ang signing secret mula sa connection mo. I-save at magpadala ng test.

Pinipirmahan ng Thinkific ang bawat delivery, at vini-verify namin ito bago mag-issue.

Teachable ​

  1. Sa Teachable (Growth plan o mas mataas, na kinakailangan para sa mga webhook), pumunta sa Settings → Webhooks at magdagdag ng webhook.
  2. Event: Enrollment.completed.
  3. URL: ang webhook URL mula sa connection mo.
  4. Dahil hindi pumipirma ng webhooks ang Teachable, kinukumpirma namin ang bawat pagkumpleto sa Teachable API bago mag-issue — kaya hinihingi rin ng connection ang Teachable API key mo. I-paste ito kapag gumagawa ng connection.

Kumpirmahin na gumagana ​

Buksan ang connection at i-expand ang Recent deliveries. Ang bawat papasok na event ay nilo-log kasama ang:

  • kung na-verify ba ito,
  • ang event type na ipinadala ng LMS mo,
  • ang resulta — na-issue, o nilaktawan (hal. hindi naka-map ang course), kasama ang dahilan,
  • at ang raw payload, para makita mo mismo kung ano ang ipinadala ng LMS mo.

Magpadala ng test completion mula sa LMS mo at panoorin itong dumating dito. Ito ang pinakamabilis na paraan para kumpirmahin ang end-to-end flow bago ka mag-live. Itinatago ang mga delivery log nang 7 araw.

Mahalagang malaman ​

  • Hindi naka-map ang course? Nilo-log at nilalaktawan ang event (walang error na ibabalik sa LMS mo, kaya hindi madi-disable ang webhook). Idagdag ang mapping at mag-iisyu na ang susunod na pagkumpleto.
  • Naabot na ang allowance? Nilo-log at nilalaktawan ang event hanggang mag-reset ang allowance mo o mag-upgrade ka.
  • Pag-pause: itakda ang connection sa paused para huminto sa pag-issue nang hindi binubura ang configuration nito.
  • Ang connection ay makakapag-issue lang ng mga badge ng sarili mong account.

Kaugnay ​

badges.ninja Documentation