Automasikan Open Badges dengan Zapier, Make, dan n8n (Resipi Tanpa Kod)

Jika anda menjalankan program latihan, kursus berbayar, atau senarai e-mel dengan peringkat, saat seseorang menyelesaikan, membeli, atau melayakkan diri biasanya sudah dijejaki di suatu tempat — respons borang, caj Stripe, tag Mailchimp. Lencana itu sepatutnya mengikuti secara automatik daripada peristiwa tersebut. Ini jarang berlaku, kerana “mengeluarkan kelayakan” bukan tindakan asli dalam kebanyakan alat, dan membina penerima webhook tersuai untuk automasi sekali sahaja adalah berlebihan.

Ini tepat untuk apa Zapier, Make, dan n8n wujud. Ketiga-tiganya boleh memanggil API Badges Ninja secara terus — tiada plugin, tiada pelayan perisian tengah, tiada penggunaan kod. Di bawah ialah tiga resipi berfungsi yang boleh anda salin hari ini, ditambah pengendalian kunci API dan gelagat cuba semula ralat yang perlu anda betulkan supaya lencana tidak gagal dikeluarkan secara senyap.

Apa yang anda sambungkan

Setiap resipi mengikuti bentuk yang sama: pencetus → carian penerima (pilihan) → HTTP POST ke /awards. Titik akhir /awards ialah yang sebenarnya mengeluarkan lencana kepada penerima — anda mengarahkannya ke badgeId sedia ada dan ia mencipta anugerah unik yang boleh disahkan dengan halaman pengesahan, kod QR, dan sijil PDF sendiri. Lihat panduan pantas API jika anda belum mencipta lencana; anda memerlukan ID-nya sebelum mana-mana automasi ini boleh berjalan.

Pengesahan untuk ketiga-tiga platform adalah sama: pengepala X-Api-Key yang membawa kunci yang dijana daripada papan pemuka anda. Platform automasi tidak mengendalikan aliran OAuth dengan baik untuk API REST sewenang-wenangnya, jadi kunci API adalah pilihan yang tepat di sini — tahan lama, terikat kepada akaun anda, dan boleh dibatalkan dengan satu klik jika mana-mana Zap tersasar.

Cipta kunci API dahulu

Daripada papan pemuka anda, buka Settings → API Keys, klik Create Key, dan berikan nama yang sepadan dengan tugasnya — zapier-course-completions, bukan key1. Penamaan itu penting lebih daripada yang kedengarannya: jika automasi berkelakuan buruk enam bulan dari sekarang, anda mahu membatalkan kunci itu tanpa merosakkan tiga integrasi lain yang kebetulan berkongsinya.

Kunci itu dipaparkan sekali, secara penuh, sejurus selepas dicipta. Salin ke dalam storan kelayakan selamat platform automasi anda dengan segera — “Connection” Zapier, “Connection” Make, atau kelayakan n8n — jangan sekali-kali ke dalam medan teks biasa di dalam Zap/senario/aliran kerja itu sendiri.

Resipi 1: Typeform → Badges Ninja (borang penyelesaian kohort)

Kes penggunaan: satu kohort menyelesaikan kursus dan mengisi borang “saya telah menyelesaikan ini” yang ringkas (atau anda menghantar borang sebagai langkah terakhir dalam trek kendiri).

Dalam Zapier:

1. Pencetus: Typeform — New Entry, terhad kepada borang penyelesaian anda.
2. Tindakan: Webhooks by Zapier — POST.
3. URL: https://api.badges.ninja/awards
4. Pengepala: X-Api-Key: bws_<kunci anda>, Content-Type: application/json
5. Data (dipetakan daripada medan Typeform):

{
  "badgeId": "bdg_9f2a1c",
  "recipient": {
    "name": "{{typeform_name}}",
    "email": "{{typeform_email}}"
  },
  "issuedOn": "2026-08-27"
}

Itulah keseluruhan Zap. Tiada langkah penapis diperlukan jika borang itu hanya tercetus pada penyelesaian sebenar — jika ia borang hubungan umum, tambah langkah Filter by Zapier yang menyemak medan tersembunyi atau nilai jawapan sebelum webhook tercetus, supaya anda tidak mengeluarkan lencana daripada spam atau penyerahan ujian.

Resipi 2: Stripe → Badges Ninja (pembelian = kelayakan)

Kes penggunaan: peperiksaan pensijilan berbayar, peringkat kursus premium, atau pelan keahlian di mana lencana itu sebahagian daripada apa yang orang beli.

Dalam Zapier:

1. Pencetus: Stripe — New Charge (atau New Invoice Payment Succeeded untuk langganan).
2. Penapis: jumlah caj sama dengan harga tepat produk berkelayakan — ini penting jika akaun Stripe anda mengendalikan pelbagai produk melalui satu webhook.
3. Tindakan: Webhooks by Zapier — POST ke https://api.badges.ninja/awards, pengepala sama seperti di atas.
4. Data: petakan charge.billing_details.email dan charge.billing_details.name ke dalam recipient.email / recipient.name.

Bahagian yang bagus tentang mengikat pengeluaran kepada peristiwa pembayaran: ia secara semula jadi hampir idempoten. ID caj Stripe adalah unik, jadi jika anda risau tentang Zap tercetus semula pada webhook yang dicuba semula, tambah langkah Storage by Zapier yang menyemak sama ada anda sudah memproses ID caj tersebut sebelum memanggil /awards.

Resipi 3: Tag Mailchimp → Badges Ninja

Kes penggunaan: anda menandakan pelanggan secara manual (atau melalui automasi lain) apabila mereka mencapai pencapaian penting — menghadiri webinar, menyelesaikan urutan titisan, merujuk tiga orang — dan mahu tag itu mencetuskan lencana tanpa anda menyentuh API sendiri.

Dalam Zapier:

1. Pencetus: Mailchimp — New Tag Added to Subscriber, ditapis kepada tag tertentu (cth. webinar-attended).
2. Tindakan: Webhooks by Zapier — POST ke https://api.badges.ninja/awards.
3. Data: petakan subscriber.email_address dan subscriber.merge_fields.FNAME + LNAME ke dalam medan penerima.

Corak ini popular untuk program pengiktirafan — SPIFF jualan, pencapaian komuniti, kehadiran acara — di mana seseorang dalam pasukan sudah mempunyai tabiat menandakan kenalan, dan anda hanya mahu lencana itu terhasil daripada tabiat tersebut secara percuma.

Mengendalikan ralat dan cubaan semula

Platform automasi tidak bersifat transaksi dengan data lencana anda, jadi bina disiplin yang sama seperti yang anda mahukan daripada integrasi sebenar:

• Semak kod respons. 200 bermakna anugerah telah dicipta; 4xx biasanya bermakna badgeId yang tidak sah atau e-mel yang salah bentuk — itu pepijat konfigurasi dalam Zap, bukan sesuatu untuk dicuba semula secara membuta tuli. 5xx selamat untuk dicuba semula.
• Zapier: larian Zap yang gagal mendarat dalam Zap History dengan permintaan/respons penuh. Hidupkan Auto-Replay untuk kegagalan sementara, tetapi sediakan amaran e-mel/Slack untuk kegagalan berulang supaya Zap yang rosak secara senyap tidak bermakna tiga bulan lencana hilang.
• Make: senario menyokong laluan Error Handler asli — lampirkan arahan Resume atau Rollback pada modul HTTP, dan halakan kegagalan berterusan ke modul pemberitahuan dan bukannya hanya membuangnya.
• n8n: kerana ia dihoskan sendiri atau awan dengan kawalan lebih terperinci, bungkus nod HTTP Request dalam aliran kerja Error Trigger, dan pertimbangkan untuk menulis muatan yang gagal ke storan sandaran ringan (Airtable, Google Sheets) yang boleh anda mainkan semula secara manual.

Dalam ketiga-tiganya, elakkan perangkap “ia berjalan hijau jadi ia berfungsi”. Respons yang kelihatan seperti 200 daripada langkah webhook yang salah konfigurasi (URL salah, pengepala hilang) masih boleh gagal di pihak Badges Ninja. Semak secara rawak senarai anugerah papan pemuka setiap minggu semasa bulan pertama mana-mana automasi baharu.

Setara Make.com

Pembina senario visual Make hampir dipetakan secara terus kepada langkah Zapier di atas:

1. Modul Trigger — modul pemantauan Typeform / Stripe / Mailchimp, sama seperti pencetus Zapier.
2. Modul HTTP → Make a Request — Kaedah POST, URL https://api.badges.ninja/awards, pengepala ditetapkan dalam jadual Headers (X-Api-Key, Content-Type: application/json), badan sebagai JSON mentah dengan pemboleh ubah dipetakan daripada pencetus.
3. Filter pilihan antara modul untuk semakan jumlah Stripe atau penjagaan “penyelesaian sebenar” pada Typeform.

Kelebihan Make di sini ialah keterlihatan — editor senario menunjukkan muatan JSON sebenar pada setiap langkah sebelum anda menghidupkannya, yang menjadikan penyahpepijatan pemetaan medan yang salah jauh lebih pantas daripada paparan ujian langkah demi langkah Zapier yang lebih linear.

Setara n8n

n8n adalah pilihan terbaik jika anda mahu ini dihoskan sendiri, atau jika anda sudah mengautomasikan bahagian lain timbunan anda di sana:

1. Nod Trigger — Typeform Trigger / Stripe Trigger / Mailchimp Trigger (semua nod terbina dalam).
2. Nod HTTP Request — Kaedah POST, URL https://api.badges.ninja/awards, pengesahan ditetapkan kepada Header Auth dengan X-Api-Key anda disimpan sebagai kelayakan n8n (bukan dikodkan keras dalam nod), badan JSON dibina daripada ungkapan yang merujuk kepada output nod pencetus.
3. Nod IF (pilihan) — penjagaan penyelesaian/jumlah yang sama seperti di atas, diletakkan sebelum nod HTTP Request.

Kerana kelayakan n8n disulitkan dan boleh digunakan semula merentas aliran kerja, ini adalah pilihan yang lebih kemas jika anda merancang lebih daripada satu automasi Badges Ninja — tetapkan kelayakan sekali, gunakan semula dalam setiap aliran kerja yang perlu mengeluarkan lencana.

Mengapa langkah webhook generik dan bukannya aplikasi asli

Zapier, Make, dan n8n semuanya mempunyai pasaran aplikasi, dan naluri adalah untuk mencari aplikasi “Badges Ninja” sebelum menggunakan modul HTTP/webhook generik. Langkau carian itu — untuk API REST sekecil ini (cipta pengeluar, cipta lencana, cipta anugerah, selesai), langkah webhook generik membolehkan anda beroperasi dalam sepuluh minit tanpa sebarang pergantungan kepada penyenggara aplikasi pihak ketiga yang perlu mengikuti perubahan API. Aplikasi khusus menambah lapisan abstraksi yang anda tidak perlukan: anda masih akan mengisi medan badgeId, recipient.email, dan recipient.name yang sama, hanya melalui borang dan bukannya badan JSON. Rujukan API cukup pendek untuk dibaca dalam lima minit, dan setelah anda melakukannya, pendekatan HTTP mentah sebenarnya kurang rapuh — tiada kitaran kelulusan kedai aplikasi yang berdiri antara perubahan API Badges Ninja dan automasi anda berfungsi semula.

Uji sebelum anda menghidupkannya

Setiap platform di atas memberi anda cara untuk menjalankan satu pelaksanaan ujian tanpa menunggu peristiwa pencetus sebenar:

• Zapier — gunakan “Test” pada langkah pencetus untuk menarik rekod sampel, kemudian “Test” pada tindakan webhook untuk mencetuskan tepat satu permintaan sebenar. Semak anugerah muncul dalam papan pemuka anda sebelum menghidupkan Zap.
• Make — jalankan senario secara manual sekali (butang “Run once”) dengan bungkusan sampel, dan periksa gelembung output modul HTTP untuk badan respons sebenar.
• n8n — gunakan “Execute Node” pada nod HTTP Request dengan data input ujian, yang membolehkan anda melihat permintaan dan respons terus dalam editor.

Dua perkara berbaloi untuk disemak pada larian ujian pertama itu: bahawa badgeId yang anda kodkan keras sebenarnya milik lencana yang anda fikir ia dimiliki (ID lapuk daripada Zap yang diduplikasi adalah kesilapan biasa), dan bahawa medan e-mel penerima menarik alamat sebenar dan bukannya ruang letak seperti {{email}} yang tidak diselesaikan kerana kesilapan pemetaan. Kedua-dua kesilapan tidak kelihatan dalam penunjuk “kejayaan” platform automasi — panggilan HTTP masih memulangkan 200 walau apa pun — jadi satu-satunya semakan yang boleh dipercayai ialah membuka anugerah dalam papan pemuka anda dan mengesahkan penerima adalah yang anda jangkakan.

Mengelakkan lencana pendua

Setiap sumber pencetus di atas boleh, di bawah keadaan dunia sebenar, tercetus lebih daripada sekali untuk peristiwa yang sama — Stripe mencuba semula webhook apabila tamat masa, Typeform boleh menghantar dua kali pada sambungan perlahan, automasi Mailchimp boleh tercetus semula jika tag dibuang dan ditambah semula. Jika pengeluaran lencana anda tidak idempoten, itu bertukar menjadi penerima mendapat kelayakan yang sama dua kali, yang kelihatan cuai dan menjana e-mel sokongan.

Perlindungan paling bersih ialah langkah carian-sebelum-cipta: sebelum POST /awards, tambah tindakan Search (“Find Award” Zapier melalui permintaan GET, atau HTTP GET Make/n8n yang setara) terhadap rekod anugerah anda sendiri — Google Sheet atau log Airtable ringan yang ditulis oleh Zap yang sama sejurus selepas anugerah berjaya berfungsi dengan baik untuk ini jika anda tidak mahu menyoal API untuknya. Jika rekod sudah wujud untuk gabungan penerima + lencana itu, cabangkan kepada no-op dan bukannya mengeluarkan semula. Ini adalah tambahan lima minit, dan ia adalah perbezaan antara automasi yang anda percayai tanpa pengawasan dan satu yang anda perlu jaga.

Apabila tanpa kod tidak mencukupi

Resipi ini meliputi pencetus peristiwa tunggal dengan baik. Sebaik sahaja anda mengeluarkan ratusan lencana daripada satu eksport CSV — kohort yang bergraduasi, senarai peserta persidangan, pembaharuan kredit CE pukal — langkau platform automasi dan gunakan muat naik lencana pukal secara terus: ia menjeda dan menyambung semula di tengah-tengah kelompok dan bertahan daripada tab pelayar yang ditutup, sesuatu yang gelung webhook tanpa kod tidak kendalikan dengan lancar pada jumlah besar.

---

Bersedia untuk mengeluarkan kelayakan boleh disahkan pertama anda? Mulakan percuma di badges.ninja — pereka visual, halaman pengesahan awam, sijil PDF, output Open Badge v2.0. Tiada kad kredit diperlukan.