Avtomatizirajte Open Badges z Zapierjem, Make in n8n (recepti brez kode)

Če vodite izobraževalni program, plačljiv tečaj ali e-poštni seznam s stopnjami, je trenutek, ko nekdo zaključi, kupi ali izpolni pogoje, običajno že nekje zabeležen — odgovor na obrazec, Stripe plačilo, oznaka v Mailchimpu. Značka bi morala samodejno slediti temu dogodku. A redko se to zgodi, ker »izdaja poverila« v večini orodij ni vgrajeno dejanje, izdelava lastnega sprejemnika za spletne kavlje (webhook) za enkratno avtomatizacijo pa je pretiran vložek.

Prav za to so tu Zapier, Make in n8n. Vsi trije lahko neposredno kličejo API Badges Ninja — brez vtičnika, brez vmesnega strežnika, brez uvajanja kode. Spodaj so trije delujoči recepti, ki jih lahko še danes prekopirate, poleg tega pa tudi ravnanje z API ključem in obnašanje ob napakah/ponovnih poskusih, ki ga morate pravilno nastaviti, da značke ne bi tiho odpovedale pri izdaji.

Kaj pravzaprav povežete

Vsak recept sledi isti obliki: sprožilec → (neobvezno) iskanje prejemnika → HTTP POST na /awards. Končna točka /awards je tista, ki dejansko izda značko prejemniku — nanjo pošljete obstoječi badgeId, ona pa ustvari edinstveno, preverljivo podelitev z lastnim URL-jem za preverjanje, QR kodo in PDF potrdilom. Če značke še niste ustvarili, si oglejte hitri začetek API-ja — njen ID boste potrebovali, preden lahko katera koli od teh avtomatizacij sploh steče.

Avtentikacija je pri vseh treh platformah enaka: glava X-Api-Key, ki nosi ključ, ustvarjen v vaši nadzorni plošči. Avtomatizacijske platforme se s poljubnimi REST API-ji in OAuth tokovi ne ujemajo najbolje, zato so tu API ključi pravi izbor — dolgo veljavni, vezani na vaš račun in z enim klikom preklicljivi, če se kateri Zap kdaj obnaša narobe.

Najprej ustvarite API ključ

V nadzorni plošči odprite Settings → API Keys, kliknite Create Key in mu dajte ime, ki ustreza njegovi nalogi — zapier-course-completions, ne key1. To poimenovanje je pomembnejše, kot se sliši: če avtomatizacija čez šest mesecev začne nagajati, boste želeli preklicati ta ključ, ne da bi s tem podrli še tri druge integracije, ki bi si ga po nesreči delile.

Ključ se v celoti prikaže samo enkrat, takoj po ustvarjanju. Takoj ga prekopirajte v varno shrambo poverilnic svoje avtomatizacijske platforme — Zapierjevo »Connection«, Makeovo »Connection« ali n8n poverilnico — nikoli pa v navadno besedilno polje znotraj samega Zapa/scenarija/poteka dela.

Recept 1: Typeform → Badges Ninja (obrazec za dokončanje skupine)

Primer uporabe: skupina zaključi tečaj in izpolni kratek obrazec »Zaključil/-a sem« (ali pa obrazec pošljete kot zadnji korak samostojno vodenega tečaja).

V Zapierju:

1. Sprožilec: Typeform — New Entry, omejen na vaš obrazec za dokončanje.
2. Dejanje: Webhooks by Zapier — POST.
3. URL: https://api.badges.ninja/awards
4. Glave: X-Api-Key: bws_<vaš ključ>, Content-Type: application/json
5. Podatki (preslikani iz polj Typeform):

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

To je celoten Zap. Če se obrazec sproži le ob resničnih zaključkih, korak filtriranja ni potreben — če pa gre za splošen kontaktni obrazec, dodajte korak Filter by Zapier, ki pred sprožitvijo spletnega kavlja preveri skrito polje ali vrednost odgovora, da značk ne izdajate na podlagi neželene pošte ali testnih oddaj.

Recept 2: Stripe → Badges Ninja (nakup = poverilo)

Primer uporabe: plačljiv certifikacijski izpit, vrhunska stopnja tečaja ali članski paket, pri katerem je značka del tega, kar ljudje dejansko kupujejo.

V Zapierju:

1. Sprožilec: Stripe — New Charge (ali New Invoice Payment Succeeded za naročnine).
2. Filter: znesek plačila je enak natančni ceni produkta, za katerega se podeljuje poverilo — to je pomembno, če vaš Stripe račun prek enega spletnega kavlja obravnava več izdelkov.
3. Dejanje: Webhooks by Zapier — POST na https://api.badges.ninja/awards, z istimi glavami kot zgoraj.
4. Podatki: preslikajte charge.billing_details.email in charge.billing_details.name v recipient.email / recipient.name.

Lepa stran vezave izdaje na plačilni dogodek je, da je po naravi skoraj idempotentna. ID-ji Stripe plačil so edinstveni, zato lahko, če vas skrbi, da bi se Zap znova sprožil ob ponovljenem spletnem kavlju, dodate korak Storage by Zapier, ki pred klicem /awards preveri, ali je bil ta ID plačila že obdelan.

Recept 3: oznaka v Mailchimpu → Badges Ninja

Primer uporabe: naročnike ročno (ali prek druge avtomatizacije) označite, ko dosežejo mejnik — udeležba na webinarju, zaključena kapljična serija e-pošt, priporočitev treh oseb — in želite, da ta oznaka sproži izdajo značke, ne da bi sami kdaj koli posegli v API.

V Zapierju:

1. Sprožilec: Mailchimp — New Tag Added to Subscriber, filtriran na določeno oznako (npr. webinar-attended).
2. Dejanje: Webhooks by Zapier — POST na https://api.badges.ninja/awards.
3. Podatki: preslikajte subscriber.email_address ter subscriber.merge_fields.FNAME in LNAME v polja prejemnika.

Ta vzorec je priljubljen pri programih priznanj — prodajnih spodbudah (SPIFF), skupnostnih mejnikih, udeležbi na dogodkih — kjer nekdo v ekipi že ima navado označevanja stikov, vi pa želite, da značka nastane kot stranski produkt te navade, brez dodatnega dela.

Obravnava napak in ponovnih poskusov

Avtomatizacijske platforme niso transakcijske v odnosu do podatkov o vaših značkah, zato vgradite enako disciplino, kot bi jo pričakovali od prave integracije:

• Preverite kodo odgovora. 200 pomeni, da je bila podelitev ustvarjena; 4xx običajno pomeni napačen badgeId ali nepravilno oblikovan e-poštni naslov — to je napaka v nastavitvi Zapa, ne nekaj, kar bi slepo ponavljali. 5xx je varno ponoviti.
• Zapier: neuspešni zagoni Zapa pristanejo v Zap History s celotno zahtevo/odgovorom. Za prehodne napake vklopite Auto-Replay, za ponavljajoče se napake pa nastavite e-poštno ali Slack obvestilo, da tiho pokvarjen Zap ne pomeni treh mesecev manjkajočih značk.
• Make: scenariji podpirajo vgrajeno vejo Error Handler — na HTTP modul pripnite direktivo Resume ali Rollback in trajne napake usmerite v modul za obveščanje, namesto da bi jih preprosto zavrgli.
• n8n: ker gre za samostojno gostovano ali oblačno rešitev z bolj podrobnim nadzorom, ovijte vozlišče HTTP Request v potek dela Error Trigger in razmislite o zapisovanju neuspelih tovorov v lahek rezervni shrambni sistem (Airtable, Google Sheets), ki ga lahko pozneje ročno ponovite.

Pri vseh treh se izogibajte pasti »teklo je zeleno, torej je delovalo«. Odgovor, ki je videti kot 200, iz napačno nastavljenega koraka s spletnim kavljem (napačen URL, manjkajoča glava) lahko na strani Badges Ninja kljub temu odpove. Prvi mesec vsake nove avtomatizacije tedensko na hitro preverite seznam podelitev v nadzorni plošči.

Ustreznik za Make.com

Makeov vizualni graditelj scenarijev se skoraj neposredno preslika na zgornje korake iz Zapierja:

1. Modul sprožilca — modul za spremljanje Typeform / Stripe / Mailchimp, enako kot sprožilec v Zapierju.
2. HTTP → modul Make a Request — metoda POST, URL https://api.badges.ninja/awards, glave nastavljene v tabeli Headers (X-Api-Key, Content-Type: application/json), telo kot surov JSON s preslikanimi spremenljivkami iz sprožilca.
3. Neobvezen Filter med moduli za preverjanje zneska pri Stripeu ali zaščito pred »lažnim dokončanjem« pri Typeformu.

Makeova prednost je tu preglednost — urejevalnik scenarijev vam pri vsakem koraku pokaže dejanski JSON tovor, še preden ga vklopite, kar odpravljanje napačne preslikave polj naredi precej hitrejše kot Zapierjev bolj linearen pogled testiranja korak za korakom.

Ustreznik za n8n

n8n je najboljša izbira, če želite rešitev gostovati sami ali če tam že avtomatizirate druge dele svojega tehnološkega sklada:

1. Vozlišče sprožilca — Typeform Trigger / Stripe Trigger / Mailchimp Trigger (vsa so vgrajena vozlišča).
2. Vozlišče HTTP Request — metoda POST, URL https://api.badges.ninja/awards, avtentikacija nastavljena na Header Auth, pri čemer je X-Api-Key shranjen kot n8n poverilnica (ne trdo zakodiran v vozlišču), JSON telo pa zgrajeno iz izraza, ki se sklicuje na izhod vozlišča sprožilca.
3. Vozlišče IF (neobvezno) — ista zaščita glede dokončanja/zneska kot zgoraj, postavljena pred vozlišče HTTP Request.

Ker so n8n poverilnice šifrirane in jih je mogoče znova uporabiti v več potekih dela, je to čistejša izbira, če načrtujete več kot eno avtomatizacijo za Badges Ninja — poverilnico nastavite enkrat in jo znova uporabite v vsakem poteku dela, ki mora izdajati značke.

Zakaj splošen korak s spletnim kavljem namesto vgrajene aplikacije

Zapier, Make in n8n imajo vsi svoje tržnice aplikacij, prvi nagon pa je poiskati aplikacijo »Badges Ninja«, še preden posežete po splošnem HTTP/webhook modulu. Ta korak preskočite — pri tako majhnem REST API-ju (ustvarite izdajatelja, ustvarite značko, ustvarite podelitev, konec) vas splošen korak s spletnim kavljem v desetih minutah spravi v živo, brez kakršne koli odvisnosti od tega, ali vzdrževalec zunanje aplikacije sledi spremembam API-ja. Namenska aplikacija doda plast abstrakcije, ki je ne potrebujete: še vedno bi izpolnjevali ista polja badgeId, recipient.email in recipient.name, le prek obrazca namesto prek JSON telesa. Referenca API-ja je dovolj kratka, da jo preberete v petih minutah, in ko to storite, je pristop s surovim HTTP dejansko manj krhek — med spremembo API-ja Badges Ninja in ponovnim delovanjem vaše avtomatizacije ni nobenega odobritvenega cikla trgovine z aplikacijami.

Preizkusite, preden greste v živo

Vsaka od zgornjih platform vam omogoča izvedbo enega testnega zagona, ne da bi morali čakati na resničen sprožilni dogodek:

• Zapier — uporabite »Test« pri koraku sprožilca, da pridobite vzorčni zapis, nato še »Test« pri dejanju s spletnim kavljem, da sprožite točno eno resnično zahtevo. Preden Zap vklopite, preverite, ali se je podelitev pojavila v vaši nadzorni plošči.
• Make — scenarij enkrat ročno zaženite (gumb »Run once«) z vzorčnim svežnjem in v izhodnem oblačku HTTP modula preglejte dejansko telo odgovora.
• n8n — uporabite »Execute Node« na vozlišču HTTP Request s testnimi vhodnimi podatki, kar vam omogoča, da zahtevo in odgovor vidite neposredno v urejevalniku.

Pri tem prvem testnem zagonu velja preveriti dve stvari: da trdo zakodirani badgeId res pripada znački, za katero mislite, da ji pripada (zastarel ID iz podvojenega Zapa je pogosta napaka), in da polje z e-poštnim naslovom prejemnika dejansko vsebuje pravi naslov, ne pa nerazrešenega ograde, kot je {{email}}, ki ostane zaradi tipkarske napake pri preslikavi. Obe napaki sta v kazalniku »uspeha« avtomatizacijske platforme nevidni — HTTP klic v obeh primerih vseeno vrne 200 — zato je edino zanesljivo preverjanje odpiranje podelitve v vaši nadzorni plošči in potrditev, da je prejemnik res tisti, ki ga pričakujete.

Preprečevanje podvojenih značk

Vsak od zgornjih virov sprožilcev se lahko v resničnih razmerah sproži več kot enkrat za isti dogodek — Stripe ob časovni prekoračitvi ponovi spletni kavelj, Typeform lahko ob počasni povezavi obrazec odda dvakrat, Mailchimpove avtomatizacije pa se lahko znova sprožijo, če se oznaka odstrani in znova doda. Če izdaja vaših značk ni idempotentna, to pomeni, da prejemniki isto poverilo dobijo dvakrat, kar je videti neurejeno in ustvarja dodatna sporočila v podpori.

Najčistejša zaščita je korak »preveri, preden ustvariš«: pred POST zahtevo na /awards dodajte dejanje Search (Zapierjev »Find Award« prek GET zahteve, ali ustrezen HTTP GET v Make/n8n) nad lastnimi zapisi o podelitvah — če za to ne želite poizvedovati po API-ju, povsem zadostuje lahek dnevnik v Google Sheets ali Airtable, v katerega isti Zap zapiše takoj po uspešni podelitvi. Če za to kombinacijo prejemnika in značke zapis že obstaja, razvejite potek na ničelno dejanje namesto ponovne izdaje. Gre za dodatek petih minut, ki pa je razlika med avtomatizacijo, ki ji zaupate brez nadzora, in tako, ki jo morate ves čas pestovati.

Kadar brez-kode pristop ne zadostuje

Ti recepti dobro pokrijejo sprožilce za posamezne dogodke. Ko pa izdajate na stotine značk iz enega samega izvoza CSV — diplomiranje skupine, seznam udeležencev konference, množično podaljšanje kreditnih točk (CE) — avtomatizacijsko platformo preskočite in namesto tega uporabite množično nalaganje značk neposredno: postopek se lahko sredi paketa ustavi in nadaljuje ter preživi zaprt zavihek brskalnika, kar brez-kode zanke s spletnimi kavlji pri večjem obsegu ne zmorejo enako elegantno.

---

Ste pripravljeni izdati svoje prvo preverljivo poverilo? Začnite brezplačno na badges.ninja — vizualni oblikovalnik, javna stran za preverjanje, PDF potrdilo, izpis v obliki Open Badge v2.0. Brez kreditne kartice.