Automatizirajte Open Badges pomoću Zapiera, Makea i n8n-a (recepti bez koda)

Ako vodite program obuke, plaćeni tečaj ili mailing listu s razinama, trenutak kad netko završi, kupi ili ispuni uvjete obično je već negdje zabilježen — u odgovoru na obrazac, naplati putem Stripea, oznaci u Mailchimpu. Značka bi trebala automatski slijediti iz tog događaja. Rijetko se to zaista dogodi, jer “izdavanje vjerodajnice” nije ugrađena radnja u većini alata, a izgradnja prilagođenog primatelja webhookova za jednokratnu automatizaciju predstavlja pretjeran trud.

Upravo za to postoje Zapier, Make i n8n. Sva tri alata mogu izravno pozvati Badges Ninja API — bez dodatka, bez posredničkog poslužitelja, bez implementacije koda. U nastavku su tri isprobana recepta koje danas možete kopirati, kao i pravilno rukovanje API ključem i ponovnim pokušajima nakon pogrešaka koje morate podesiti kako značke ne bi tiho prestale biti izdavane.

Što zapravo povezujete

Svaki recept slijedi isti obrazac: okidač → (neobavezno) pronalaženje primatelja → HTTP POST na /awards. Krajnja točka /awards zapravo izdaje značku primatelju — uputite je na postojeći badgeId, a ona stvara jedinstvenu, provjerljivu dodjelu s vlastitim URL-om za provjeru, QR kodom i PDF certifikatom. Pogledajte brzi vodič za API ako još niste izradili značku; trebat će vam njezin ID prije nego bilo koja od ovih automatizacija može proraditi.

Autentifikacija je ista na sve tri platforme: zaglavlje X-Api-Key s ključem generiranim iz vaše nadzorne ploče. Platforme za automatizaciju ne nose se dobro s OAuth tokovima za proizvoljne REST API-je, pa su ovdje API ključevi pravi izbor — dugovječni, vezani uz vaš račun i opozivi jednim klikom ako se neki Zap ikad pokvari.

Prvo izradite API ključ

Na svojoj nadzornoj ploči otvorite Postavke → API ključevi, kliknite Izradi ključ i dajte mu naziv koji odgovara njegovoj svrsi — zapier-course-completions, a ne key1. Taj detalj važniji je nego što zvuči: ako se automatizacija za šest mjeseci pokvari, htjet ćete opozvati baš taj ključ, a da pritom ne pokvarite tri druge integracije koje ga slučajno dijele.

Ključ se prikazuje samo jednom, u cijelosti, odmah nakon izrade. Odmah ga kopirajte u sigurnu pohranu vjerodajnica svoje platforme za automatizaciju — Zapierovu “vezu” (Connection), Makeovu “vezu” ili n8n vjerodajnicu — nikada u obično tekstualno polje unutar samog Zapa, scenarija ili tijeka rada.

Recept 1: Typeform → Badges Ninja (obrazac za završetak kohorte)

Slučaj uporabe: kohorta završava tečaj i ispunjava kratki obrazac “završio/-la sam ovo” (ili šaljete obrazac kao posljednji korak samostalnog tijeka učenja).

U Zapieru:

1. Okidač: Typeform — New Entry, ograničen na vaš obrazac za završetak.
2. Radnja: Webhooks by Zapier — POST.
3. URL: https://api.badges.ninja/awards
4. Zaglavlja: X-Api-Key: bws_<vaš ključ>, Content-Type: application/json
5. Podaci (preslikani iz polja Typeforma):

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

To je cijeli Zap. Nije potreban korak filtriranja ako se obrazac aktivira samo kod stvarnih završetaka — ako je riječ o općem kontaktnom obrascu, dodajte korak Filter by Zapier koji provjerava skriveno polje ili vrijednost odgovora prije nego se webhook aktivira, kako ne biste izdavali značke na temelju neželjene pošte ili testnih prijava.

Recept 2: Stripe → Badges Ninja (kupnja = vjerodajnica)

Slučaj uporabe: plaćeni certifikacijski ispit, premium razina tečaja ili plan članstva u kojem je značka dio onoga što ljudi kupuju.

U Zapieru:

1. Okidač: Stripe — New Charge (ili New Invoice Payment Succeeded za pretplate).
2. Filtar: iznos naplate mora biti jednak točnoj cijeni proizvoda za koji se izdaje vjerodajnica — to je važno ako vaš Stripe račun kroz jedan webhook obrađuje više proizvoda.
3. Radnja: Webhooks by Zapier — POST na https://api.badges.ninja/awards, s istim zaglavljima kao gore.
4. Podaci: preslikajte charge.billing_details.email i charge.billing_details.name u polja recipient.email / recipient.name.

Dobra strana povezivanja izdavanja s događajem plaćanja jest da je to prirodno gotovo idempotentno. ID-ovi naplate u Stripeu jedinstveni su, pa ako vas brine da bi se Zap mogao ponovno pokrenuti zbog ponovljenog webhooka, dodajte korak Storage by Zapier koji provjerava jeste li taj ID naplate već obradili prije poziva na /awards.

Recept 3: Oznaka u Mailchimpu → Badges Ninja

Slučaj uporabe: pretplatnike označavate ručno (ili putem druge automatizacije) kada dosegnu prekretnicu — prisustvovali su webinaru, završili niz e-poruka, preporučili troje ljudi — i želite da ta oznaka pokrene značku bez da sami dirate API.

U Zapieru:

1. Okidač: Mailchimp — New Tag Added to Subscriber, filtriran na određenu oznaku (npr. webinar-attended).
2. Radnja: Webhooks by Zapier — POST na https://api.badges.ninja/awards.
3. Podaci: preslikajte subscriber.email_address i subscriber.merge_fields.FNAME + LNAME u polja primatelja.

Ovaj obrazac popularan je za programe priznanja — SPIFF-ove za prodaju, prekretnice zajednice, prisutnost na događajima — gdje netko u timu već ima naviku označavati kontakte, a vi jednostavno želite da značka proizađe iz te navike bez dodatnog truda.

Rukovanje pogreškama i ponovnim pokušajima

Platforme za automatizaciju nisu transakcijske u odnosu na podatke vaših znački, pa primijenite istu disciplinu kakvu biste očekivali od prave integracije:

• Provjerite kôd odgovora. 200 znači da je dodjela stvorena; 4xx obično znači neispravan badgeId ili neispravno oblikovanu e-poštu — to je pogreška u konfiguraciji Zapa, a ne nešto što treba slijepo ponavljati. 5xx je sigurno ponoviti.
• Zapier: neuspjela izvršavanja Zapa nalaze se u Zap History s cijelim zahtjevom i odgovorom. Uključite Auto-Replay za privremene pogreške, ali postavite upozorenje putem e-pošte ili Slacka za ponovljene pogreške, kako tiho pokvaren Zap ne bi značio tri mjeseca nedostajućih znački.
• Make: scenariji podržavaju nativnu rutu Error Handler — dodajte direktivu Resume ili Rollback na HTTP modul te usmjerite trajne pogreške u modul obavijesti umjesto da ih jednostavno odbacite.
• n8n: budući da se hostira samostalno ili u oblaku s detaljnijom kontrolom, omotajte HTTP Request čvor u tijek rada Error Trigger i razmislite o zapisivanju neuspjelih podatkovnih paketa u lagano rezervno spremište (Airtable, Google Sheets) koje možete ručno ponovno pokrenuti.

U sva tri slučaja izbjegavajte zamku “izvršilo se zeleno, znači da je uspjelo”. Odgovor koji izgleda kao 200, a dolazi iz pogrešno konfiguriranog koraka webhooka (pogrešan URL, nedostajuće zaglavlje), i dalje može propasti na strani Badges Ninja. Provjeravajte popis dodjela na nadzornoj ploči jednom tjedno tijekom prvog mjeseca svake nove automatizacije.

Ekvivalent u Make.com

Makeov vizualni graditelj scenarija gotovo se izravno preslikava na gore navedene korake Zapiera:

1. Modul okidača — modul praćenja Typeform / Stripe / Mailchimp, isto kao okidač u Zapieru.
2. HTTP → Make a Request modul — metoda POST, URL https://api.badges.ninja/awards, zaglavlja postavljena u tablici Headers (X-Api-Key, Content-Type: application/json), tijelo kao sirovi JSON s preslikanim varijablama iz okidača.
3. Neobavezan Filter između modula za provjeru iznosa u Stripeu ili zaštitu “stvarnog završetka” u Typeformu.

Prednost Makea ovdje je vidljivost — uređivač scenarija prikazuje stvarni JSON teret na svakom koraku prije nego ga uključite, što uvelike ubrzava otklanjanje pogrešaka kod lošeg preslikavanja polja u odnosu na linearniji pogled testiranja korak po korak u Zapieru.

Ekvivalent u n8n-u

n8n je najbolji izbor ako želite da ovo bude samostalno hostirano ili ako već ondje automatizirate druge dijelove svog sustava:

1. Čvor okidača — Typeform Trigger / Stripe Trigger / Mailchimp Trigger (svi su ugrađeni čvorovi).
2. HTTP Request čvor — metoda POST, URL https://api.badges.ninja/awards, autentifikacija postavljena na Header Auth s vašim X-Api-Key pohranjenim kao n8n vjerodajnica (a ne tvrdo kodirana u čvoru), JSON tijelo izgrađeno iz izraza koji upućuje na izlaz čvora okidača.
3. IF čvor (neobavezno) — ista zaštita za završetak/iznos kao gore, smještena prije HTTP Request čvora.

Budući da su n8n vjerodajnice šifrirane i mogu se ponovno koristiti u više tijekova rada, ovo je čišća opcija ako planirate više od jedne Badges Ninja automatizacije — vjerodajnicu postavite jednom i ponovno je koristite u svakom tijeku rada kojem je potrebno izdavati značke.

Zašto generički korak webhooka umjesto izvorne aplikacije

Zapier, Make i n8n svi imaju tržišta aplikacija, a instinkt je potražiti aplikaciju “Badges Ninja” prije nego posegnete za generičkim HTTP/webhook modulom. Preskočite to pretraživanje — za ovako malen REST API (izradite izdavatelja, izradite značku, izradite dodjelu, gotovo), generički korak webhooka pušta vas u pogon za deset minuta, bez ikakve ovisnosti o održavatelju aplikacije treće strane koji mora pratiti promjene API-ja. Namjenska aplikacija dodaje sloj apstrakcije koji vam ne treba: i dalje biste popunjavali ista polja badgeId, recipient.email i recipient.name, samo kroz obrazac umjesto kroz JSON tijelo. Referentna dokumentacija API-ja dovoljno je kratka da je pročitate u pet minuta, a nakon što to učinite, pristup putem izravnog HTTP-a zapravo je manje osjetljiv na kvarove — ne postoji ciklus odobravanja u trgovini aplikacija između promjene Badges Ninja API-ja i ponovnog rada vaše automatizacije.

Testirajte prije nego pustite u pogon

Svaka gore navedena platforma daje vam način za pokretanje jednog testnog izvršavanja bez čekanja stvarnog okidačkog događaja:

• Zapier — upotrijebite “Test” na koraku okidača za dohvat primjera zapisa, a zatim “Test” na radnji webhooka da biste pokrenuli točno jedan stvaran zahtjev. Provjerite pojavljuje li se dodjela na vašoj nadzornoj ploči prije nego uključite Zap.
• Make — pokrenite scenarij ručno jednom (gumb “Run once”) s uzorkom paketa, a zatim pregledajte izlazni mjehurić HTTP modula za stvarno tijelo odgovora.
• n8n — upotrijebite “Execute Node” na HTTP Request čvoru s testnim ulaznim podacima, što vam omogućuje da vidite zahtjev i odgovor izravno u uređivaču.

Dvije su stvari vrijedne provjere kod tog prvog testnog izvršavanja: da badgeId koji ste tvrdo kodirali doista pripada znački za koju mislite da pripada (zastarjeli ID iz dupliciranog Zapa česta je pogreška) te da polje e-pošte primatelja doista povlači stvarnu adresu, a ne rezervirano mjesto poput {{email}} koje je ostalo neriješeno zbog pogreške u preslikavanju. Obje su pogreške nevidljive u pokazatelju “uspjeha” platforme za automatizaciju — HTTP poziv i dalje vraća 200 u oba slučaja — pa je jedina pouzdana provjera otvaranje dodjele na vašoj nadzornoj ploči i potvrda da je primatelj doista onaj koga očekujete.

Izbjegavanje duplih znački

Svaki od gore navedenih izvora okidača može se, u stvarnim uvjetima, aktivirati više od jednom za isti događaj — Stripe ponovno pokušava webhookove kod isteka vremena, Typeform može dvostruko poslati podatke kod spore veze, automatizacije u Mailchimpu mogu se ponovno pokrenuti ako se oznaka ukloni pa ponovno doda. Ako izdavanje vaše značke nije idempotentno, to se pretvara u primatelje koji dobivaju istu vjerodajnicu dvaput, što djeluje nemarno i stvara e-poruke korisničke podrške.

Najčišća zaštita jest korak pretrage prije stvaranja: prije POST poziva na /awards, dodajte radnju Search (Zapierov “Find Award” putem GET zahtjeva, ili ekvivalentan HTTP GET u Makeu/n8n-u) protiv vlastitih zapisa o dodjelama — jednostavan Google List ili Airtable dnevnik u koji isti Zap upisuje odmah nakon uspješne dodjele savršeno je dovoljan za ovo ako ne želite ispitivati API zbog toga. Ako zapis za tu kombinaciju primatelja i značke već postoji, preusmjerite na radnju bez učinka umjesto ponovnog izdavanja. To je dodatak od pet minuta, a razlika je između automatizacije kojoj vjerujete bez nadzora i one koju morate stalno paziti.

Kad rješenja bez koda nisu dovoljna

Ovi recepti dobro pokrivaju okidače s jednim događajem. Kad izdajete stotine znački iz jedne CSV izvezene datoteke — kohorta koja diplomira, popis sudionika konferencije, masovna obnova CE bodova — preskočite platformu za automatizaciju i upotrijebite masovno učitavanje znački izravno: ono pauzira i nastavlja usred serije te preživljava zatvorenu karticu preglednika, što petlje webhookova bez koda ne podnose graciozno pri velikom obujmu.

---

Spremni izdati svoju prvu provjerljivu vjerodajnicu? Počnite besplatno na badges.ninja — vizualni dizajner, javna stranica za provjeru, PDF certifikat, izlaz u formatu Open Badge v2.0. Kreditna kartica nije potrebna.