Automatiseeri Open Badges väljastamine Zapieri, Make'i ja n8n-iga (No-Code retseptid)

Kui sa juhid koolitusprogrammi, tasulist kursust või tasandiga e-posti nimekirja, on hetk, mil keegi lõpetab, ostab või kvalifitseerub, tavaliselt juba kuskil jälgitav — vormivastus, Stripe’i tehing, Mailchimpi silt. Märk peaks sellest sündmusest automaatselt järgnema. Harva see nii juhtub, sest „väljasta tunnistus” ei ole enamikus tööriistades sisseehitatud tegevus ning ühekordse automatiseerimise jaoks kohandatud veebihaagi (webhook) vastuvõtja ehitamine on liialt keerukas.

Just selleks on olemas Zapier, Make ja n8n. Kõik kolm saavad kutsuda Badges Ninja API-t otse — ilma pluginata, vaheserverita ja koodi juurutamiseta. Allpool on kolm toimivat retsepti, mida saad juba täna kopeerida, ning lisaks API-võtme käsitlus ja vigade-kordusürituste (retry) käitumine, mille pead paika saama, et märgid vaikimisi ei jääks väljastamata.

Mida sa omavahel ühendad

Iga retsept järgib sama skeemi: käivitaja → (valikuline) saaja otsing → HTTP POST päringule /awards. /awards lõpp-punkt ongi see, mis tegelikult väljastab märgi saajale — sa suunad selle olemasolevale badgeId-le ja see loob unikaalse, kinnitatava väljastuse koos oma kinnituse URL-i, QR-koodi ja PDF-sertifikaadiga. Kui sa pole märki veel loonud, vaata API kiirjuhendit — vajad selle ID-d, enne kui ükski neist automatiseeringutest saab tööle hakata.

Autentimine on kõigil kolmel platvormil sama: X-Api-Key päis, mis kannab sinu töölaualt genereeritud võtit. Automatiseerimisplatvormid ei käsitle suvaliste REST API-de puhul OAuth-vooge kuigi hästi, seega sobivad API-võtmed siin ideaalselt — need kehtivad pikalt, on seotud sinu kontoga ning tühistatavad ühe klõpsuga, kui mõni Zap peaks kunagi valesti käituma.

Loo kõigepealt API-võti

Ava oma töölaual Settings → API Keys, klõpsa Create Key ja anna sellele nimi, mis vastab selle ülesandele — zapier-course-completions, mitte key1. See nimetamine on olulisem, kui kõlab: kui automatiseering kuue kuu pärast valesti käitub, tahad tühistada just selle võtme, ilma et lõhuksid kolme teist integratsiooni, mis juhtumisi sama võtit kasutavad.

Võti kuvatakse täies mahus vaid üks kord, kohe pärast loomist. Kopeeri see kohe oma automatiseerimisplatvormi turvalisse mandaatide hoidlasse — Zapieri „Connection”, Make’i „Connection” või n8n mandaat (credential) —, mitte kunagi lihttekstivälja Zapi/stsenaariumi/töövoo enda sisse.

Retsept 1: Typeform → Badges Ninja (kohordi lõpetamise vorm)

Kasutusjuht: kohort lõpetab kursuse ja täidab lühikese „Ma sain sellega valmis” vormi (või saadad vormi iseseisva kursuse viimase sammuna).

Zapieris:

1. Käivitaja: Typeform — New Entry, piiratud sinu lõpetamisvormiga.
2. Tegevus: Webhooks by Zapier — POST.
3. URL: https://api.badges.ninja/awards
4. Päised: X-Api-Key: bws_<sinu võti>, Content-Type: application/json
5. Andmed (kaardista Typeformi väljadelt):

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

See ongi kogu Zap. Filtrisammu pole vaja, kui vorm käivitub ainult tegelike lõpetamiste korral — kui tegu on üldise kontaktvormiga, lisa enne veebihaagi käivitumist Filter by Zapier samm, mis kontrollib peidetud välja või vastuse väärtust, et sa ei väljastaks märke rämpsust või testesitustest.

Retsept 2: Stripe → Badges Ninja (ost = tunnistus)

Kasutusjuht: tasuline sertifitseerimiseksam, premium-kursuse tase või liikmelisuse pakett, kus märk on osa sellest, mida inimesed ostavad.

Zapieris:

1. Käivitaja: Stripe — New Charge (või tellimuste puhul New Invoice Payment Succeeded).
2. Filter: tehingu summa võrdub tunnistusega toote täpse hinnaga — see on oluline, kui sinu Stripe’i konto käitleb mitut toodet ühe veebihaagi kaudu.
3. Tegevus: Webhooks by Zapier — POST aadressile https://api.badges.ninja/awards, samad päised nagu eespool.
4. Andmed: kaardista charge.billing_details.email ja charge.billing_details.name väljadeks recipient.email / recipient.name.

Väljastamise sidumisel maksesündmusega on üks tore boonus: see on oma olemuselt peaaegu idempotentne. Stripe’i tehingu ID-d on unikaalsed, seega kui kardad, et Zap käivitub uuesti korduva veebihaagi peale, lisa Storage by Zapier samm, mis kontrollib enne /awards kutsumist, kas see tehingu ID on juba töödeldud.

Retsept 3: Mailchimpi silt → Badges Ninja

Kasutusjuht: sa märgistad tellijaid käsitsi (või mõne teise automatiseeringu kaudu), kui nad jõuavad verstapostini — osalesid veebiseminaril, lõpetasid tilkkampaania (drip-kirjade jada), tõid kolm uut liituvat —, ja soovid, et see silt käivitaks märgi väljastamise ilma, et pead ise API-ga tegelema.

Zapieris:

1. Käivitaja: Mailchimp — New Tag Added to Subscriber, filtreeritud konkreetse sildi järgi (nt webinar-attended).
2. Tegevus: Webhooks by Zapier — POST aadressile https://api.badges.ninja/awards.
3. Andmed: kaardista subscriber.email_address ning subscriber.merge_fields.FNAME + LNAME saaja väljadeks.

See muster on populaarne tunnustusprogrammides — müügi-SPIFF-id, kogukonna verstapostid, ürituste osalus —, kus keegi meeskonnast juba harjumuspäraselt märgistab kontakte ja sa tahad lihtsalt, et märk sünniks sellest harjumusest justkui iseenesest.

Vigade ja kordusürituste käsitlemine

Automatiseerimisplatvormid ei ole sinu märgiandmetega tehinguliselt (transactional) seotud, seega raja sisse sama distsipliin, mida ootaksid päris integratsioonilt:

• Kontrolli vastuskoodi. 200 tähendab, et väljastus loodi; 4xx tähendab tavaliselt vigast badgeId-d või vigaselt vormistatud e-posti aadressi — see on Zapi seadistusviga, mitte miski, mida pimesi uuesti proovida. 5xx on ohutu uuesti proovida.
• Zapier: ebaõnnestunud Zapi käivitused jõuavad Zap History vaatesse koos kogu päringu/vastusega. Lülita mööduvate tõrgete jaoks sisse Auto-Replay, kuid sea korduvate tõrgete puhuks üles e-posti/Slacki hoiatus, et vaikselt katkine Zap ei tähendaks kolme kuud puuduolevaid märke.
• Make: stsenaariumid toetavad sisseehitatud Error Handler haru — lisa HTTP-moodulile Resume või Rollback direktiiv ning suuna püsivad tõrked teavitusmoodulisse selle asemel, et need lihtsalt kõrvale heita.
• n8n: kuna see on ise majutatav või pilvepõhine, aga täpsema kontrolliga, mähi HTTP Request sõlm Error Trigger töövoogu ning kaalu ebaõnnestunud kasulike koormate (payload) kirjutamist kergesse varusalvestisse (Airtable, Google Sheets), mida saad käsitsi uuesti käivitada.

Kõigi kolme puhul väldi lõksu „see jooksis roheliselt, seega töötas”. Valesti seadistatud veebihaagi sammu (vale URL, puuduv päis) 200-taoline vastus võib Badges Ninja poolel siiski ebaõnnestuda. Iga uue automatiseeringu esimesel kuul kontrolli iganädalaselt pistelisi väljastusi töölaua märkide nimekirjas.

Make.com vaste

Make’i visuaalne stsenaariumiehitaja vastab peaaegu üks-ühele eespool toodud Zapieri sammudele:

1. Käivitusmoodul (Trigger module) — Typeformi / Stripe’i / Mailchimpi jälgimismoodul, sama mis Zapieri käivitaja.
2. HTTP → Make a Request moodul — meetod POST, URL https://api.badges.ninja/awards, päised seatud Headers tabelis (X-Api-Key, Content-Type: application/json), keha toore JSON-ina koos käivitajalt kaardistatud muutujatega.
3. Valikuline Filter moodulite vahel Stripe’i summa kontrolliks või Typeformi „tegeliku lõpetamise” kaitseks.

Make’i eelis siin on nähtavus — stsenaariumiredaktor näitab sulle iga sammu tegelikku JSON-kasulikku koormat enne, kui selle sisse lülitad, mis teeb vigase väljakaardistuse silumise palju kiiremaks kui Zapieri lineaarsem samm-sammult testivaade.

n8n vaste

n8n sobib kõige paremini, kui soovid seda ise majutada või kui automatiseerid seal juba muid oma tehnoloogiapaki osi:

1. Käivitussõlm (Trigger node) — Typeform Trigger / Stripe Trigger / Mailchimp Trigger (kõik sisseehitatud sõlmed).
2. HTTP Request sõlm — meetod POST, URL https://api.badges.ninja/awards, autentimine seatud Header Auth-ile, kus sinu X-Api-Key on salvestatud n8n mandaadina (mitte sõlme sisse kõvakodeeritud), JSON-keha ehitatud avaldisest, mis viitab käivitussõlme väljundile.
3. IF-sõlm (valikuline) — sama lõpetamise/summa kaitse nagu eespool, paigutatud enne HTTP Request sõlme.

Kuna n8n mandaadid on krüpteeritud ja korduvkasutatavad kõigis töövoogudes, on see puhtam valik, kui plaanid rohkem kui ühte Badges Ninja automatiseeringut — sea mandaat üks kord üles ja kasuta seda igas töövoos, mis peab märke väljastama.

Miks üldine veebihaagi samm, mitte natiivne rakendus

Zapieril, Make’il ja n8n-il on kõigil rakenduste turuplatsid ning esimene tung on otsida „Badges Ninja” rakendust, enne kui haarad üldise HTTP/veebihaagi mooduli järele. Jäta see otsing vahele — nii väikese REST API jaoks (loo väljaandja, loo märk, loo väljastus, valmis) viib üldine veebihaagi samm sind kümne minutiga tööle, ilma et sõltuksid kolmanda osapoole rakenduse hooldajast, kes peab API muudatustega sammu pidama. Pühendatud rakendus lisab abstraktsioonikihi, mida sul vaja ei ole: sisestaksid ikkagi samu badgeId, recipient.email ja recipient.name välju, lihtsalt vormi, mitte JSON-keha kaudu. API viide on piisavalt lühike, et lugeda viie minutiga, ja kui see on tehtud, on toores HTTP-lähenemine tegelikult vähem haavatav — Badges Ninja API muudatuse ja sinu automatiseeringu uuesti töölehakkamise vahel ei seisa ühtegi rakenduste poe heakskiiduprotsessi.

Testi enne, kui lased käiku

Iga eespool nimetatud platvorm annab sulle võimaluse käivitada üks testkäitus, ilma et peaksid ootama päris käivitajasündmust:

• Zapier — kasuta käivitaja sammul „Test”, et tõmmata näidiskirje, seejärel „Test” veebihaagi tegevusel, et saata täpselt üks päris päring. Enne Zapi sisselülitamist kontrolli, et väljastus ilmub sinu töölauale.
• Make — käivita stsenaarium käsitsi üks kord (nupp „Run once”) näidiskimbuga ning kontrolli HTTP-mooduli väljundmullis tegelikku vastuse keha.
• n8n — kasuta HTTP Request sõlmel „Execute Node” koos testsisendandmetega, mis näitab sulle päringut ja vastust otse redaktoris.

Sellel esimesel testkäitusel tasub kontrollida kahte asja: kas sinu kõvakodeeritud badgeId kuulub tõesti sellele märgile, mida sa arvad (vananenud ID dubleeritud Zapist on levinud viga), ning kas saaja e-posti väli tõmbab päris aadressi, mitte täitmata kohatäidet nagu {{email}}, mis on jäänud lahenduseta kaardistuse kirjaviga tõttu. Mõlemad vead on automatiseerimisplatvormi „edu” indikaatoris nähtamatud — HTTP-kutse tagastab ikkagi 200 — seega ainus usaldusväärne kontroll on avada väljastus oma töölaual ja veenduda, et saaja on see, keda ootasid.

Duplikaatmärkide vältimine

Iga eespool nimetatud käivitajaallikas võib päriselus sama sündmuse peale käivituda rohkem kui korra — Stripe proovib veebihaake ajalõpu korral uuesti, Typeform võib aeglase ühenduse korral topelt esitada, Mailchimpi automatiseeringud võivad uuesti käivituda, kui silt eemaldatakse ja uuesti lisatakse. Kui sinu märgi väljastamine pole idempotentne, tähendab see, et saajad saavad sama tunnistuse kaks korda, mis näeb lohakas välja ja tekitab tugikirju.

Kõige puhtam kaitse on „otsi enne loomist” samm: enne /awards POST-i lisa Search tegevus (Zapieri „Find Award” GET-päringu kaudu või vastav Make/n8n HTTP GET) oma väljastuste andmete vastu — kui sa ei taha selleks API-t pärida, sobib selleks hästi ka kerge Google Sheeti või Airtable’i logi, kuhu sama Zap kirjutab kohe pärast õnnestunud väljastust. Kui saaja + märgi kombinatsiooni jaoks on juba kirje olemas, hargne no-op tegevuse peale, selle asemel et uuesti väljastada. See on viieminutiline lisandus ning see teeb vahe automatiseeringu vahel, mida usaldad ilma järelevalveta, ja sellise vahel, mida pead pidevalt jälgima.

Kui no-code enam ei piisa

Need retseptid katavad üksiksündmuste käivitajaid hästi. Kui aga väljastad sadu märke ühest CSV-ekspordist — kohort lõpetab, konverentsi osalejate nimekiri, hulgi täienduskrediitide uuendamine —, jäta automatiseerimisplatvorm kõrvale ja kasuta otse hulgi märkide üleslaadimist: see peatub ja jätkab keset partiid ning jääb töösse ka suletud brauseriaknaga, millega no-code veebihaagi tsüklid suure mahu juures graatsiliselt hakkama ei saa.

---

Valmis väljastama oma esimest kinnitatavat tunnistust? Alusta tasuta badges.ninjas — visuaalne disainer, avalik kinnituslehekülg, PDF-sertifikaat, Open Badge v2.0 väljund. Krediitkaarti pole vaja.