Automatizujte Open Badges pomocí Zapier, Make a n8n (recepty bez kódu)

Pokud provozujete školicí program, placený kurz nebo e-mailový seznam s úrovněmi, okamžik, kdy někdo něco dokončí, koupí nebo splní podmínky, už obvykle někde sledujete — odpověď ve formuláři, platbu ve Stripe, štítek v Mailchimpu. Odznak by měl z této události vyplynout automaticky. Málokdy se to tak děje, protože „vydat credential” není nativní akce ve většině nástrojů a stavět si vlastní webhook receiver kvůli jednorázové automatizaci je zbytečně složité.

Přesně od toho tu jsou Zapier, Make a n8n. Všechny tři dokážou volat Badges Ninja API přímo — bez pluginu, bez middleware serveru, bez nasazování kódu. Níže jsou tři funkční recepty, které si dnes můžete zkopírovat, plus zacházení s API klíčem a chování při opakování po chybě, které je potřeba zvládnout, aby odznaky potichu nepřestaly fungovat.

Co budete propojovat

Každý recept má stejnou strukturu: trigger → (volitelně) vyhledání příjemce → HTTP POST na /awards. Endpoint /awards je to, co odznak příjemci skutečně vydá — odkážete ho na existující badgeId a on vytvoří unikátní, ověřitelné ocenění s vlastní ověřovací URL, QR kódem a PDF certifikátem. Pokud jste ještě žádný odznak nevytvořili, podívejte se na rychlý start s API — jeho ID budete potřebovat dřív, než jakákoli z těchto automatizací poběží.

Autentizace je u všech tří platforem stejná: hlavička X-Api-Key s klíčem vygenerovaným z vašeho dashboardu. Automatizační platformy nezvládají OAuth flow pro libovolná REST API dobře, takže API klíče jsou tu správná volba — dlouhodobě platné, vázané na váš účet a jedním kliknutím odvolatelné, pokud se Zap někdy zachová špatně.

Nejdřív vytvořte API klíč

Ve svém dashboardu otevřete Settings → API Keys, klikněte na Create Key a dejte mu název, který odpovídá jeho účelu — zapier-course-completions, ne key1. Na tomhle pojmenování záleží víc, než by se zdálo: pokud se automatizace za šest měsíců začne chovat divně, budete chtít odvolat ten konkrétní klíč, aniž byste rozbili tři další integrace, které si ho náhodou dělí.

Klíč se zobrazí jednou, celý, hned po vytvoření. Zkopírujte ho ihned do bezpečného úložiště přihlašovacích údajů vaší automatizační platformy — do „Connection” v Zapieru, „Connection” v Make, nebo do credential v n8n — nikdy do prostého textového pole přímo v Zapu, scénáři nebo workflow.

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

Případ použití: kohorta dokončí kurz a vyplní krátký formulář „dokončil/a jsem to” (nebo takový formulář pošlete jako poslední krok samostudijní trasy).

V Zapieru:

1. Trigger: Typeform — New Entry, omezený na váš formulář o dokončení.
2. Akce: Webhooks by Zapier — POST.
3. URL: https://api.badges.ninja/awards
4. Hlavičky: X-Api-Key: bws_<your key>, Content-Type: application/json
5. Data (namapovaná z polí Typeformu):

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

To je celý Zap. Krok Filter není potřeba, pokud formulář spouští akci jen u skutečných dokončení — pokud jde o obecný kontaktní formulář, přidejte krok Filter by Zapier, který před spuštěním webhooku ověří skryté pole nebo hodnotu odpovědi, abyste nevydávali odznaky ze spamu nebo testovacích odeslání.

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

Případ použití: placená certifikační zkouška, prémiová úroveň kurzu nebo členský plán, kde je odznak součástí toho, co si lidé kupují.

V Zapieru:

1. Trigger: Stripe — New Charge (nebo New Invoice Payment Succeeded pro předplatná).
2. Filtr: částka platby odpovídá přesné ceně produktu, ke kterému se váže credential — to je důležité, pokud váš účet Stripe zpracovává více produktů přes jeden webhook.
3. Akce: Webhooks by Zapier — POST na https://api.badges.ninja/awards, stejné hlavičky jako výše.
4. Data: namapujte charge.billing_details.email a charge.billing_details.name do recipient.email / recipient.name.

Příjemná stránka vázání vydání na platební událost: je to přirozeně blízké idempotenci. ID plateb ve Stripe jsou unikátní, takže pokud se obáváte, že se Zap znovu spustí kvůli opakovanému webhooku, přidejte krok Storage by Zapier, který před voláním /awards zkontroluje, jestli už jste dané ID platby nezpracovali.

Recept 3: štítek v Mailchimpu → Badges Ninja

Případ použití: štítkujete odběratele ručně (nebo přes jinou automatizaci), když dosáhnou milníku — zúčastnili se webináře, dokončili drip sekvenci, doporučili tři lidi — a chcete, aby tento štítek spustil odznak, aniž byste sami sahali na API.

V Zapieru:

1. Trigger: Mailchimp — New Tag Added to Subscriber, filtrovaný na konkrétní štítek (např. webinar-attended).
2. Akce: Webhooks by Zapier — POST na https://api.badges.ninja/awards.
3. Data: namapujte subscriber.email_address a subscriber.merge_fields.FNAME + LNAME do polí příjemce.

Tento vzor je oblíbený u programů uznání — sales SPIFFy, komunitní milníky, účast na akcích — kde už má někdo v týmu zvyk kontakty štítkovat a vy prostě chcete, aby z tohoto zvyku odznak vypadl zadarmo.

Zvládání chyb a opakování

Automatizační platformy nejsou s vašimi daty o odznacích transakční, takže si vybudujte stejnou disciplínu, jakou byste chtěli od skutečné integrace:

• Kontrolujte stavový kód odpovědi. 200 znamená, že ocenění bylo vytvořeno; 4xx obvykle znamená špatné badgeId nebo špatně formátovaný e-mail — to je chyba v konfiguraci Zapu, ne něco, co se má slepě opakovat. 5xx je bezpečné opakovat.
• Zapier: neúspěšné běhy Zapu skončí v Zap History s celým požadavkem/odpovědí. Zapněte Auto-Replay pro dočasné výpadky, ale nastavte si e-mailové nebo Slack upozornění na opakované selhání, aby tiše rozbitý Zap neznamenal tři měsíce chybějících odznaků.
• Make: scénáře podporují nativní trasu Error Handler — připojte k HTTP modulu direktivu Resume nebo Rollback a trvalá selhání směřujte do notifikačního modulu místo jejich pouhého zahození.
• n8n: protože je self-hosted nebo cloudové s podrobnější kontrolou, obalte uzel HTTP Request workflow Error Trigger a zvažte zapisování neúspěšných payloadů do lehkého záložního úložiště (Airtable, Google Sheets), které pak můžete ručně přehrát.

Ve všech třech případech se vyhněte pasti „proběhlo to zeleně, takže to fungovalo”. Odpověď, která vypadá jako 200, ale pochází ze špatně nakonfigurovaného kroku webhooku (špatná URL, chybějící hlavička), přesto může na straně Badges Ninja selhat. Během prvního měsíce každé nové automatizace týdně namátkově kontrolujte seznam ocenění v dashboardu.

Ekvivalent v Make.com

Vizuální stavba scénářů v Make se téměř přímo mapuje na výše uvedené kroky Zapieru:

1. Trigger modul — sledovací modul Typeform / Stripe / Mailchimp, stejně jako trigger v Zapieru.
2. HTTP → Make a Request modul — metoda POST, URL https://api.badges.ninja/awards, hlavičky nastavené v tabulce Headers (X-Api-Key, Content-Type: application/json), tělo jako raw JSON s namapovanými proměnnými z triggeru.
3. Volitelný Filter mezi moduly pro kontrolu částky u Stripe nebo pojistku „skutečného dokončení” u Typeformu.

Výhodou Make je tu viditelnost — editor scénáře vám před zapnutím ukáže skutečný JSON payload v každém kroku, což ladění špatného mapování pole dělá mnohem rychlejším než lineárnější krok-za-krokem test v Zapieru.

Ekvivalent v n8n

n8n je nejlepší volba, pokud to chcete mít self-hosted, nebo pokud tam už automatizujete jiné části svého stacku:

1. Trigger node — Typeform Trigger / Stripe Trigger / Mailchimp Trigger (všechny jsou vestavěné uzly).
2. HTTP Request node — metoda POST, URL https://api.badges.ninja/awards, autentizace nastavená na Header Auth s vaším X-Api-Key uloženým jako credential n8n (ne natvrdo v uzlu), JSON tělo sestavené z výrazu odkazujícího na výstup trigger uzlu.
3. IF node (volitelně) — stejná pojistka na dokončení/částku jako výše, umístěná před uzel HTTP Request.

Protože credentials v n8n jsou šifrované a znovupoužitelné napříč workflow, je to čistší volba, pokud plánujete víc než jednu automatizaci Badges Ninja — nastavíte credential jednou a znovu ho použijete v každém workflow, které potřebuje vydávat odznaky.

Proč obecný webhook krok místo nativní aplikace

Zapier, Make i n8n mají tržiště aplikací a instinkt velí hledat aplikaci „Badges Ninja” dřív, než sáhnete po obecném HTTP/webhook modulu. Toto hledání přeskočte — u tak malého REST API (vytvořit vydavatele, vytvořit odznak, vytvořit ocenění, hotovo) vás obecný webhook krok dostane naživo za deset minut bez jakékoli závislosti na tom, jestli tvůrce aplikace třetí strany drží krok se změnami API. Vyhrazená aplikace přidává vrstvu abstrakce, kterou nepotřebujete: pořád byste vyplňovali stejná pole badgeId, recipient.email a recipient.name, jen skrz formulář místo JSON těla. API reference je dost krátká na to, aby se dala přečíst za pět minut, a jakmile to uděláte, přímý HTTP přístup je ve skutečnosti méně křehký — mezi změnou API Badges Ninja a fungováním vaší automatizace nestojí žádný schvalovací cyklus obchodu s aplikacemi.

Otestujte, než to pustíte naostro

Každá z výše uvedených platforem vám dává způsob, jak spustit jedno testovací provedení bez čekání na skutečnou spouštěcí událost:

• Zapier — použijte „Test” na kroku triggeru, abyste natáhli ukázkový záznam, pak „Test” na akci webhooku, abyste odeslali přesně jeden skutečný požadavek. Než Zap zapnete, zkontrolujte, že se ocenění objevilo ve vašem dashboardu.
• Make — spusťte scénář ručně jednou (tlačítko „Run once”) s ukázkovým bundlem a prohlédněte si výstupní bublinu HTTP modulu se skutečným tělem odpovědi.
• n8n — použijte „Execute Node” na uzlu HTTP Request s testovacími vstupními daty, což vám umožní vidět požadavek i odpověď přímo v editoru.

Při prvním testovacím běhu stojí za kontrolu dvě věci: že natvrdo zadané badgeId skutečně patří odznaku, o kterém si myslíte, že patří (zastaralé ID ze zduplikovaného Zapu je běžná chyba), a že pole e-mailu příjemce skutečně natahuje reálnou adresu, ne placeholder jako {{email}} nevyřešený kvůli překlepu v mapování. Obě chyby jsou v „úspěšném” indikátoru automatizační platformy neviditelné — HTTP volání stejně vrátí 200 — takže jediná spolehlivá kontrola je otevřít ocenění v dashboardu a ověřit, že příjemcem je opravdu ten, koho čekáte.

Jak se vyhnout duplicitním odznakům

Každý z výše uvedených zdrojů triggeru se v reálných podmínkách může spustit vícekrát pro tutéž událost — Stripe opakuje webhooky při timeoutu, Typeform se může při pomalém připojení odeslat dvakrát, automatizace Mailchimpu se mohou znovu spustit, pokud je štítek odebrán a znovu přidán. Pokud vaše vydávání odznaků není idempotentní, promění se to v příjemce, kteří dostanou stejný credential dvakrát, což vypadá neuspořádaně a generuje podporu e-mailem.

Nejčistší pojistkou je krok vyhledání-před-vytvořením: před POST na /awards přidejte akci Search (v Zapieru „Find Award” přes GET požadavek, nebo ekvivalentní HTTP GET v Make/n8n) proti vašim vlastním záznamům o oceněních — pro tento účel stačí odlehčený Google Sheet nebo Airtable log, do kterého stejný Zap zapisuje hned po úspěšném ocenění, pokud kvůli tomu nechcete dotazovat API. Pokud pro danou kombinaci příjemce a odznaku už záznam existuje, přesměrujte na no-op místo opětovného vydání. Je to pětiminutový doplněk a je to rozdíl mezi automatizací, které bez dohledu důvěřujete, a takovou, kterou musíte hlídat.

Když no-code nestačí

Tyto recepty dobře pokrývají triggery na jednu událost. Jakmile budete vydávat stovky odznaků z jediného CSV exportu — promující kohorta, seznam účastníků konference, hromadné prodloužení kreditů CE — přeskočte automatizační platformu a použijte přímo hromadné nahrání odznaků: dokáže se uprostřed dávky pozastavit a pokračovat a přežije zavřenou kartu prohlížeče, což webhook smyčky bez kódu při velkém objemu nezvládají tak elegantně.

---

Připraveni vydat svůj první ověřitelný credential? Začněte zdarma na badges.ninja — vizuální designér, veřejná ověřovací stránka, PDF certifikát, výstup Open Badge v2.0. Bez nutnosti kreditní karty.