Otomatiskan Open Badges dengan Zapier, Make, dan n8n (Resep No-Code)

Jika Anda menjalankan program pelatihan, kursus berbayar, atau daftar email bertingkat, momen ketika seseorang menyelesaikan, membeli, atau memenuhi syarat biasanya sudah terlacak di suatu tempat — respons formulir, tagihan Stripe, tag Mailchimp. Lencana seharusnya mengikuti secara otomatis dari peristiwa tersebut. Hal ini jarang terjadi, karena “menerbitkan credential” bukan tindakan bawaan di sebagian besar alat, dan membangun penerima webhook khusus untuk otomasi sekali pakai adalah hal yang berlebihan.

Inilah tepatnya kegunaan Zapier, Make, dan n8n. Ketiganya dapat memanggil API Badges Ninja secara langsung — tanpa plugin, tanpa server middleware, tanpa deployment kode. Di bawah ini ada tiga resep yang berfungsi dan bisa Anda salin hari ini, ditambah cara menangani API key dan perilaku error-retry yang perlu Anda atur dengan benar agar lencana tidak gagal diterbitkan secara diam-diam.

Apa yang sebenarnya Anda hubungkan

Setiap resep mengikuti bentuk yang sama: trigger → (opsional) pencarian penerima → HTTP POST ke /awards. Endpoint /awards inilah yang benar-benar menerbitkan lencana kepada penerima — Anda mengarahkannya ke badgeId yang sudah ada, dan endpoint ini membuat award unik dan dapat diverifikasi dengan URL verifikasi, kode QR, dan sertifikat PDF sendiri. Lihat panduan cepat API jika Anda belum membuat lencana; Anda memerlukan ID-nya sebelum salah satu dari otomasi ini bisa berjalan.

Autentikasi untuk ketiga platform ini sama: header X-Api-Key yang membawa key yang dihasilkan dari dasbor Anda. Platform otomasi tidak menangani alur OAuth dengan baik untuk REST API sembarangan, jadi API key adalah pilihan yang tepat di sini — berumur panjang, terikat pada akun Anda, dan bisa dicabut dengan satu klik jika suatu Zap pernah salah bekerja.

Buat API key terlebih dahulu

Dari dasbor Anda, buka Settings → API Keys, klik Create Key, dan beri nama yang sesuai dengan tugasnya — zapier-course-completions, bukan key1. Penamaan ini lebih penting daripada kedengarannya: jika enam bulan dari sekarang ada otomasi yang bermasalah, Anda ingin mencabut key itu saja tanpa merusak tiga integrasi lain yang kebetulan menggunakan key yang sama.

Key ditampilkan satu kali, secara lengkap, segera setelah dibuat. Segera salin ke penyimpanan credential aman milik platform otomasi Anda — “Connection” di Zapier, “Connection” di Make, atau credential di n8n — jangan pernah ke kolom teks biasa di dalam Zap/skenario/workflow itu sendiri.

Resep 1: Typeform → Badges Ninja (formulir penyelesaian kohort)

Kasus penggunaan: satu kohort menyelesaikan kursus dan mengisi formulir singkat “Saya sudah menyelesaikan ini” (atau Anda mengirim formulir sebagai langkah terakhir dari jalur belajar mandiri).

Di Zapier:

1. Trigger: Typeform — New Entry, dibatasi ke formulir penyelesaian Anda.
2. Action: Webhooks by Zapier — POST.
3. URL: https://api.badges.ninja/awards
4. Headers: X-Api-Key: bws_<key Anda>, Content-Type: application/json
5. Data (petakan dari kolom Typeform):

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

Itulah keseluruhan Zap-nya. Tidak perlu langkah filter jika formulir hanya terpicu pada penyelesaian yang sesungguhnya — tetapi jika ini formulir kontak umum, tambahkan langkah Filter by Zapier yang memeriksa kolom tersembunyi atau nilai jawaban sebelum webhook terpicu, agar Anda tidak menerbitkan lencana dari spam atau kiriman uji coba.

Resep 2: Stripe → Badges Ninja (pembelian = credential)

Kasus penggunaan: ujian sertifikasi berbayar, tingkat kursus premium, atau paket keanggotaan di mana lencana adalah bagian dari apa yang dibeli orang.

Di Zapier:

1. Trigger: Stripe — New Charge (atau New Invoice Payment Succeeded untuk langganan).
2. Filter: jumlah tagihan sama persis dengan harga produk yang mendapatkan credential — ini penting jika akun Stripe Anda menangani beberapa produk melalui satu webhook.
3. Action: Webhooks by Zapier — POST ke https://api.badges.ninja/awards, dengan headers yang sama seperti di atas.
4. Data: petakan charge.billing_details.email dan charge.billing_details.name ke recipient.email / recipient.name.

Bagian menariknya dari mengaitkan penerbitan dengan peristiwa pembayaran: secara alami hal ini mendekati sifat idempoten. ID tagihan Stripe bersifat unik, jadi jika Anda khawatir Zap akan terpicu ulang saat webhook dicoba lagi, tambahkan langkah Storage by Zapier yang memeriksa apakah ID tagihan tersebut sudah diproses sebelum memanggil /awards.

Resep 3: Tag Mailchimp → Badges Ninja

Kasus penggunaan: Anda memberi tag pada pelanggan secara manual (atau melalui otomasi lain) ketika mereka mencapai suatu tonggak — menghadiri webinar, menyelesaikan rangkaian email drip, mereferensikan tiga orang — dan ingin tag tersebut memicu lencana tanpa Anda perlu menyentuh API sendiri.

Di Zapier:

1. Trigger: Mailchimp — New Tag Added to Subscriber, disaring untuk tag tertentu (misalnya webinar-attended).
2. Action: Webhooks by Zapier — POST ke https://api.badges.ninja/awards.
3. Data: petakan subscriber.email_address dan subscriber.merge_fields.FNAME + LNAME ke kolom penerima.

Pola ini populer untuk program penghargaan — SPIFF penjualan, tonggak komunitas, kehadiran acara — di mana seseorang di tim sudah memiliki kebiasaan memberi tag pada kontak, dan Anda hanya ingin lencana muncul begitu saja dari kebiasaan itu tanpa usaha tambahan.

Menangani error dan percobaan ulang

Platform otomasi tidak bersifat transaksional terhadap data lencana Anda, jadi terapkan disiplin yang sama seperti yang Anda inginkan dari integrasi sungguhan:

• Periksa kode respons. 200 berarti award berhasil dibuat; 4xx biasanya berarti badgeId salah atau email tidak valid — itu adalah bug konfigurasi pada Zap, bukan sesuatu yang harus dicoba ulang begitu saja. 5xx aman untuk dicoba ulang.
• Zapier: proses Zap yang gagal akan muncul di Zap History lengkap dengan request/response-nya. Aktifkan Auto-Replay untuk kegagalan sementara, tetapi siapkan juga peringatan email/Slack untuk kegagalan berulang, agar Zap yang rusak diam-diam tidak berarti tiga bulan lencana yang hilang.
• Make: skenario mendukung rute Error Handler bawaan — pasang direktif Resume atau Rollback pada modul HTTP, dan arahkan kegagalan yang terus terjadi ke modul notifikasi alih-alih hanya membuangnya.
• n8n: karena bisa self-hosted atau cloud dengan kontrol yang lebih detail, bungkus node HTTP Request dalam workflow Error Trigger, dan pertimbangkan untuk menulis payload yang gagal ke penyimpanan cadangan ringan (Airtable, Google Sheets) yang bisa Anda putar ulang secara manual.

Di ketiganya, hindari jebakan “berjalan hijau berarti berhasil.” Respons yang tampak seperti 200 dari langkah webhook yang salah konfigurasi (URL salah, header hilang) tetap bisa gagal di sisi Badges Ninja. Periksa sesekali daftar award di dasbor setiap minggu selama bulan pertama dari otomasi baru mana pun.

Padanan di Make.com

Pembuat skenario visual Make hampir sepenuhnya sejajar dengan langkah-langkah Zapier di atas:

1. Trigger module — modul pengamat Typeform / Stripe / Mailchimp, sama seperti trigger di Zapier.
2. Modul HTTP → Make a Request — Method POST, URL https://api.badges.ninja/awards, headers diatur di tabel Headers (X-Api-Key, Content-Type: application/json), body sebagai raw JSON dengan variabel yang dipetakan dari trigger.
3. Filter opsional di antara modul untuk pemeriksaan jumlah Stripe atau penjagaan “penyelesaian sungguhan” pada Typeform.

Keunggulan Make di sini adalah visibilitas — editor skenario menunjukkan payload JSON yang sebenarnya di setiap langkah sebelum Anda mengaktifkannya, yang membuat debug pemetaan kolom yang salah jauh lebih cepat dibandingkan tampilan uji langkah-demi-langkah Zapier yang lebih linear.

Padanan di n8n

n8n adalah pilihan terbaik jika Anda ingin ini di-hosting sendiri, atau jika Anda sudah mengotomasikan bagian lain dari stack Anda di sana:

1. Trigger node — Typeform Trigger / Stripe Trigger / Mailchimp Trigger (semua node bawaan).
2. HTTP Request node — Method POST, URL https://api.badges.ninja/awards, autentikasi diatur ke Header Auth dengan X-Api-Key Anda disimpan sebagai credential n8n (bukan di-hardcode di node), body JSON dibangun dari ekspresi yang merujuk ke output node trigger.
3. IF node (opsional) — penjagaan penyelesaian/jumlah yang sama seperti di atas, ditempatkan sebelum node HTTP Request.

Karena credential n8n terenkripsi dan dapat digunakan kembali di berbagai workflow, ini adalah opsi yang lebih rapi jika Anda merencanakan lebih dari satu otomasi Badges Ninja — atur credential sekali, gunakan kembali di setiap workflow yang perlu menerbitkan lencana.

Mengapa langkah webhook generik, bukan aplikasi native

Zapier, Make, dan n8n semuanya memiliki marketplace aplikasi, dan naluri pertama biasanya adalah mencari aplikasi “Badges Ninja” sebelum beralih ke modul HTTP/webhook generik. Lewati pencarian itu — untuk REST API sekecil ini (buat penerbit, buat lencana, buat award, selesai), langkah webhook generik membuat Anda live dalam sepuluh menit tanpa ketergantungan sama sekali pada pengelola aplikasi pihak ketiga yang harus mengikuti perubahan API. Aplikasi khusus menambahkan lapisan abstraksi yang tidak Anda butuhkan: Anda tetap akan mengisi kolom badgeId, recipient.email, dan recipient.name yang sama, hanya lewat formulir alih-alih body JSON. Referensi API cukup singkat untuk dibaca dalam lima menit, dan setelah Anda melakukannya, pendekatan HTTP mentah justru lebih tidak rapuh — tidak ada siklus persetujuan app-store yang berdiri di antara perubahan API Badges Ninja dan otomasi Anda yang berfungsi kembali.

Uji sebelum Anda mengaktifkannya secara langsung

Setiap platform di atas memberi Anda cara untuk menjalankan satu eksekusi uji tanpa menunggu peristiwa trigger yang sesungguhnya:

• Zapier — gunakan “Test” pada langkah trigger untuk mengambil data contoh, lalu “Test” pada aksi webhook untuk mengirim tepat satu permintaan sungguhan. Periksa apakah award muncul di dasbor Anda sebelum mengaktifkan Zap.
• Make — jalankan skenario secara manual satu kali (tombol “Run once”) dengan sekumpulan data contoh, dan periksa gelembung output modul HTTP untuk melihat isi respons yang sebenarnya.
• n8n — gunakan “Execute Node” pada node HTTP Request dengan data input uji, yang memungkinkan Anda melihat request dan respons langsung di dalam editor.

Ada dua hal yang layak diperiksa pada uji coba pertama itu: apakah badgeId yang Anda hardcode benar-benar milik lencana yang Anda maksud (ID lama dari Zap yang terduplikasi adalah kesalahan umum), dan apakah kolom email penerima menarik alamat sungguhan, bukan placeholder seperti {{email}} yang tidak terselesaikan karena kesalahan ketik pemetaan. Kedua kesalahan ini tidak terlihat pada indikator “berhasil” milik platform otomasi — panggilan HTTP tetap mengembalikan 200 dalam kedua kasus — jadi satu-satunya pemeriksaan yang bisa diandalkan adalah membuka award di dasbor Anda dan memastikan penerimanya sesuai dengan yang Anda harapkan.

Menghindari lencana duplikat

Setiap sumber trigger di atas, dalam kondisi dunia nyata, bisa terpicu lebih dari sekali untuk peristiwa yang sama — Stripe mencoba ulang webhook saat timeout, Typeform bisa mengirim ganda pada koneksi yang lambat, otomasi Mailchimp bisa terpicu ulang jika tag dihapus lalu ditambahkan kembali. Jika penerbitan lencana Anda tidak idempoten, hal itu berubah menjadi penerima yang mendapatkan credential yang sama dua kali, yang terlihat ceroboh dan memicu email dukungan.

Penjagaan paling bersih adalah langkah cari-sebelum-buat: sebelum POST ke /awards, tambahkan aksi Search (di Zapier ini “Find Award” lewat permintaan GET, atau HTTP GET setara di Make/n8n) terhadap catatan award Anda sendiri — sebuah Google Sheet atau log Airtable ringan yang ditulis oleh Zap yang sama tepat setelah award berhasil sudah cukup baik untuk ini jika Anda tidak ingin melakukan query ke API. Jika sudah ada catatan untuk kombinasi penerima + lencana tersebut, arahkan ke cabang no-op alih-alih menerbitkan lagi. Ini adalah tambahan lima menit, dan menjadi pembeda antara otomasi yang Anda percayai tanpa pengawasan dan otomasi yang harus terus Anda awasi.

Ketika no-code saja tidak cukup

Resep-resep ini bekerja dengan baik untuk trigger peristiwa tunggal. Namun begitu Anda menerbitkan ratusan lencana dari satu ekspor CSV — sebuah kohort yang lulus, daftar peserta konferensi, pembaruan massal kredit CE — lewati platform otomasi dan gunakan langsung unggah lencana massal: fitur ini bisa dijeda dan dilanjutkan di tengah batch serta tetap bertahan meski tab browser ditutup, sesuatu yang tidak bisa ditangani dengan baik oleh loop webhook no-code pada volume besar.

---

Siap menerbitkan credential terverifikasi pertama Anda? Mulai gratis di badges.ninja — perancang visual, halaman verifikasi publik, sertifikat PDF, output Open Badge v2.0. Tidak perlu kartu kredit.