Automatizujte Open Badges pomocou Zapier, Make a n8n (no-code recepty)

Ak vediete školiaci program, platený kurz alebo e-mailový zoznam s úrovňami, moment, keď niekto dokončí, kúpi alebo splní podmienky, sa väčšinou už niekde eviduje — odpoveď vo formulári, platba cez Stripe, tag v Mailchimpe. Odznak by mal nasledovať automaticky po tejto udalosti. Zriedkakedy sa tak stane, pretože „vydať poverenie” nie je natívna akcia vo väčšine nástrojov a stavať vlastný webhook prijímač pre jednorazovú automatizáciu je zbytočne veľa práce.

Presne na to slúžia Zapier, Make a n8n. Všetky tri vedia volať priamo Badges Ninja API — bez pluginu, bez middleware servera, bez nasadzovania kódu. Nižšie nájdete tri funkčné recepty, ktoré si môžete dnes skopírovať, plus zaobchádzanie s API kľúčom a správanie pri chybách a opakovaní pokusov, ktoré musíte zvládnuť, aby vám odznaky potichu nezlyhávali pri vydávaní.

Čo budete prepájať

Každý recept má rovnaký tvar: spúšťač → (voliteľné) vyhľadanie príjemcu → HTTP POST na /awards. Endpoint /awards je ten, ktorý reálne vydá odznak príjemcovi — nasmerujete ho na existujúce badgeId a on vytvorí jedinečné, overiteľné vydanie s vlastnou overovacou URL adresou, QR kódom a PDF certifikátom. Pozrite si rýchly štart API, ak ste ešte nevytvorili odznak — jeho ID budete potrebovať skôr, než ktorákoľvek z týchto automatizácií môže bežať.

Autentifikácia je pre všetky tri platformy rovnaká: hlavička X-Api-Key s kľúčom vygenerovaným z vášho dashboardu. Automatizačné platformy nezvládajú OAuth toky pre ľubovoľné REST API príliš dobre, takže API kľúče sú sem ideálne riešenie — dlhodobo platné, viazané na váš účet a jedným klikom odvolateľné, ak sa Zap niekedy pokazí.

Najprv vytvorte API kľúč

Vo vašom dashboarde otvorte Settings → API Keys, kliknite na Create Key a dajte mu meno, ktoré zodpovedá jeho úlohe — zapier-course-completions, nie key1. Toto pomenovanie má väčší význam, než sa zdá: ak sa automatizácia o šesť mesiacov pokazí, budete chcieť odvolať presne ten kľúč bez toho, aby ste zrušili tri ďalšie integrácie, ktoré ho náhodou zdieľajú.

Kľúč sa zobrazí len raz, v plnom znení, hneď po vytvorení. Skopírujte ho okamžite do bezpečného úložiska poverení vašej automatizačnej platformy — Zapierovho „Connection”, Makeovho „Connection” alebo n8n prihlasovacieho údaja — nikdy nie do obyčajného textového políčka priamo v Zape/scenári/workflowe.

Recept 1: Typeform → Badges Ninja (formulár o dokončení kohorty)

Prípad použitia: kohorta dokončí kurz a vyplní krátky formulár „Dokončil(a) som toto” (alebo formulár posielate ako posledný krok samoštudijnej trate).

V Zapieri:

1. Spúšťač: Typeform — New Entry, obmedzený na váš formulár o dokončení.
2. Akcia: Webhooks by Zapier — POST.
3. URL: https://api.badges.ninja/awards
4. Hlavičky: X-Api-Key: bws_<váš kľúč>, Content-Type: application/json
5. Dáta (mapované z polí Typeformu):

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

To je celý Zap. Krok s filtrom nie je potrebný, ak sa formulár spúšťa len pri reálnych dokončeniach — ak ide o všeobecný kontaktný formulár, pridajte krok Filter by Zapier, ktorý kontroluje skryté pole alebo hodnotu odpovede predtým, než sa spustí webhook, aby ste nevydávali odznaky zo spamu alebo testovacích odoslaní.

Recept 2: Stripe → Badges Ninja (nákup = poverenie)

Prípad použitia: platená certifikačná skúška, prémiová úroveň kurzu alebo členský plán, kde je odznak súčasťou toho, čo si ľudia kupujú.

V Zapieri:

1. Spúšťač: Stripe — New Charge (alebo New Invoice Payment Succeeded pri predplatných).
2. Filter: suma platby sa rovná presnej cene produktu, za ktorý sa udeľuje poverenie — to má význam, ak váš Stripe účet spracúva cez jeden webhook viacero produktov.
3. Akcia: Webhooks by Zapier — POST na https://api.badges.ninja/awards, rovnaké hlavičky ako vyššie.
4. Dáta: namapujte charge.billing_details.email a charge.billing_details.name na recipient.email / recipient.name.

Pekná vlastnosť naviazania vydávania na platobnú udalosť je, že je prirodzene takmer idempotentné. ID platieb v Stripe sú jedinečné, takže ak sa obávate, že sa Zap znova spustí pri opakovanom webhooku, pridajte krok Storage by Zapier, ktorý overí, či ste dané ID platby už spracovali, predtým než zavoláte /awards.

Recept 3: Tag v Mailchimpe → Badges Ninja

Prípad použitia: odberateľov označujete tagom manuálne (alebo cez inú automatizáciu), keď dosiahnu míľnik — zúčastnili sa webinára, dokončili drip sekvenciu, odporučili troch ľudí — a chcete, aby tento tag spustil odznak bez toho, aby ste sa sami dotkli API.

V Zapieri:

1. Spúšťač: Mailchimp — New Tag Added to Subscriber, filtrovaný na konkrétny tag (napr. webinar-attended).
2. Akcia: Webhooks by Zapier — POST na https://api.badges.ninja/awards.
3. Dáta: namapujte subscriber.email_address a subscriber.merge_fields.FNAME + LNAME na polia príjemcu.

Tento vzor je obľúbený pri programoch na oceňovanie — predajné súťaže (SPIFF), komunitné míľniky, účasť na podujatiach — kde má už niekto z tímu zvyk označovať kontakty tagmi a vy chcete, aby odznak z tohto zvyku vypadol úplne zadarmo.

Zvládanie chýb a opakovaní

Automatizačné platformy nie sú transakčné voči vašim dátam o odznakoch, takže si vybudujte rovnakú disciplínu, akú by ste chceli od skutočnej integrácie:

• Kontrolujte stavový kód odpovede. 200 znamená, že vydanie bolo vytvorené; 4xx obvykle znamená nesprávne badgeId alebo chybne formátovaný e-mail — to je chyba konfigurácie v Zape, nie niečo, čo treba slepo opakovať. 5xx je bezpečné opakovať.
• Zapier: neúspešné behy Zapu nájdete v Zap History s celou požiadavkou a odpoveďou. Zapnite Auto-Replay pre prechodné zlyhania, ale nastavte si e-mailové alebo Slack upozornenie na opakované zlyhania, aby vám ticho nefungujúci Zap neznamenal tri mesiace chýbajúcich odznakov.
• Make: scenáre podporujú natívnu vetvu Error Handler — pripojte k HTTP modulu direktívu Resume alebo Rollback a pretrvávajúce zlyhania nasmerujte do notifikačného modulu namiesto toho, aby ste ich jednoducho zahodili.
• n8n: keďže ide o self-hosted alebo cloud riešenie s podrobnejšou kontrolou, obaľte HTTP Request node do workflowu Error Trigger a zvážte zápis neúspešných payloadov do jednoduchého záložného úložiska (Airtable, Google Sheets), ktoré viete manuálne prehrať.

Vo všetkých troch prípadoch sa vyhnite pasci „bežalo to na zeleno, takže to fungovalo”. Odpoveď, ktorá vyzerá ako 200 z nesprávne nakonfigurovaného webhook kroku (zlá URL, chýbajúca hlavička), môže na strane Badges Ninja aj tak zlyhať. Počas prvého mesiaca každej novej automatizácie si týždenne namátkovo skontrolujte zoznam vydaní v dashboarde.

Ekvivalent v Make.com

Vizuálny tvorca scenárov v Make sa mapuje takmer priamo na kroky Zapieru vyššie:

1. Trigger modul — sledovací modul Typeform / Stripe / Mailchimp, rovnako ako spúšťač v Zapieri.
2. HTTP → Make a Request modul — metóda POST, URL https://api.badges.ninja/awards, hlavičky nastavené v tabuľke Headers (X-Api-Key, Content-Type: application/json), telo ako raw JSON s namapovanými premennými zo spúšťača.
3. Voliteľný Filter medzi modulmi pre kontrolu sumy pri Stripe alebo pre stráženie „reálneho dokončenia” pri Typeforme.

Výhodou Make je tu prehľadnosť — editor scenára vám pred zapnutím ukáže skutočný JSON payload pri každom kroku, čo výrazne zrýchľuje ladenie zlého mapovania poľa oproti lineárnejšiemu krokovému testovaciemu zobrazeniu v Zapieri.

Ekvivalent v n8n

n8n je najlepšia voľba, ak to chcete mať self-hosted, alebo ak už vo vašom stacku automatizujete iné časti práve tam:

1. Trigger node — Typeform Trigger / Stripe Trigger / Mailchimp Trigger (všetko vstavané nody).
2. HTTP Request node — metóda POST, URL https://api.badges.ninja/awards, autentifikácia nastavená na Header Auth s vaším X-Api-Key uloženým ako prihlasovací údaj n8n (nie natvrdo v node), JSON telo zostavené z výrazu odkazujúceho na výstup trigger nodu.
3. IF node (voliteľné) — rovnaká kontrola dokončenia/sumy ako vyššie, umiestnená pred HTTP Request node.

Keďže prihlasovacie údaje n8n sú šifrované a znovupoužiteľné naprieč workflowmi, je to čistejšia voľba, ak plánujete viac než jednu automatizáciu Badges Ninja — prihlasovací údaj nastavíte raz a znovu ho použijete v každom workflowe, ktorý potrebuje vydávať odznaky.

Prečo generický webhook krok namiesto natívnej appky

Zapier, Make aj n8n majú trhoviská appiek a inštinktívne by ste hľadali appku „Badges Ninja” skôr, než siahnete po generickom HTTP/webhook module. Toto hľadanie preskočte — pre takto malé REST API (vytvorte vydavateľa, vytvorte odznak, vytvorte vydanie, hotovo) vás generický webhook krok dostane naživo za desať minút bez akejkoľvek závislosti na tom, či tretia strana svojou appkou drží krok so zmenami API. Dedikovaná appka pridáva vrstvu abstrakcie, ktorú nepotrebujete: aj tak by ste vypĺňali rovnaké polia badgeId, recipient.email a recipient.name, len cez formulár namiesto JSON tela. Referencia API sa dá prečítať za päť minút, a keď ju raz zvládnete, priamy HTTP prístup je v skutočnosti menej krehký — medzi zmenou API Badges Ninja a fungovaním vašej automatizácie nestojí žiadny schvaľovací cyklus obchodu s appkami.

Otestujte, skôr než to pustíte naostro

Každá z platforiem vyššie vám dáva spôsob, ako spustiť jedno testovacie vykonanie bez čakania na skutočnú spúšťaciu udalosť:

• Zapier — použite „Test” na kroku spúšťača na stiahnutie vzorového záznamu, potom „Test” na webhook akcii na odoslanie presne jednej reálnej požiadavky. Pred zapnutím Zapu skontrolujte, či sa vydanie objavilo vo vašom dashboarde.
• Make — spustite scenár manuálne raz (tlačidlo „Run once”) so vzorovým balíkom a preskúmajte výstupovú bublinu HTTP modulu so skutočným telom odpovede.
• n8n — použite „Execute Node” na HTTP Request node s testovacími vstupnými dátami, čo vám umožní vidieť požiadavku aj odpoveď priamo v editore.

Na tomto prvom testovacom behu stojí za to skontrolovať dve veci: či badgeId, ktoré ste natvrdo zadali, naozaj patrí odznaku, o ktorom si myslíte, že patrí (zastarané ID zo skopírovaného Zapu je bežná chyba), a či pole e-mailu príjemcu ťahá skutočnú adresu, nie zástupný symbol ako {{email}}, ktorý zostal nevyriešený kvôli preklepu v mapovaní. Obe chyby sú v „úspešnom” indikátore automatizačnej platformy neviditeľné — HTTP volanie stále vráti 200 tak či onak — takže jediná spoľahlivá kontrola je otvoriť vydanie vo vašom dashboarde a overiť, že príjemca je ten, koho očakávate.

Ako sa vyhnúť duplicitným odznakom

Každý spúšťací zdroj vyššie sa v reálnych podmienkach môže spustiť viac než raz pre tú istú udalosť — Stripe opakuje webhooky pri timeoute, Typeform môže pri pomalom pripojení odoslať formulár dvakrát, automatizácie Mailchimpu sa môžu znovu spustiť, ak sa tag odstráni a znova pridá. Ak vaše vydávanie odznakov nie je idempotentné, zmení sa to na príjemcov, ktorí dostanú rovnaké poverenie dvakrát, čo pôsobí neupravene a generuje podporné e-maily.

Najčistejšou poistkou je krok vyhľadania pred vytvorením: pred POST na /awards pridajte akciu Search (Zapierovo „Find Award” cez GET požiadavku, alebo ekvivalentný HTTP GET v Make/n8n) voči vašim vlastným záznamom o vydaniach — na to celkom stačí ľahký Google Sheet alebo Airtable log, do ktorého ten istý Zap zapisuje hneď po úspešnom vydaní, ak nechcete kvôli tomu dopytovať API. Ak už pre danú kombináciu príjemca + odznak existuje záznam, vetvite do no-op namiesto opätovného vydania. Toto je päťminútové doplnenie a je to rozdiel medzi automatizáciou, ktorej dôverujete bez dozoru, a takou, ktorú musíte strážiť.

Keď no-code nestačí

Tieto recepty dobre pokrývajú spúšťače na jednu udalosť. Akonáhle vydávate stovky odznakov z jedného CSV exportu — kohorta, ktorá promuje, zoznam účastníkov konferencie, hromadné obnovenie kreditov ďalšieho vzdelávania — preskočte automatizačnú platformu a použite priamo hromadné nahrávanie odznakov: pozastaví sa a pokračuje uprostred dávky a prežije zatvorenú kartu prehliadača, čo no-code webhook slučky pri väčšom objeme nezvládajú elegantne.

---

Pripravení vydať svoje prvé overiteľné poverenie? Začnite zadarmo na badges.ninja — vizuálny dizajnér, verejná overovacia stránka, PDF certifikát, výstup Open Badge v2.0. Bez potreby kreditnej karty.