Open Badges automatizálása Zapierrel, Make-kel és n8n-nel (kódolás nélküli receptek)

Ha képzési programot, fizetős kurzust vagy szintekre bontott e-mail listát üzemeltetsz, az a pillanat, amikor valaki befejez, vásárol vagy megfelel egy feltételnek, általában már valahol nyomon van követve — egy űrlapválaszban, egy Stripe-terhelésben, egy Mailchimp-címkében. A jelvénynek automatikusan következnie kellene ebből az eseményből. Ez ritkán történik meg, mert a legtöbb eszközben a „credential kiadása” nem natív művelet, és egy egyedi automatizáláshoz saját webhook-fogadót építeni túlzás.

Pontosan erre való a Zapier, a Make és az n8n. Mindhárom közvetlenül képes hívni a Badges Ninja API-t — plugin, middleware szerver és kódtelepítés nélkül. Alább három működő recept található, amelyeket ma átvehetsz, plusz az API-kulcs kezelése és a hibaesetén történő újrapróbálkozás viselkedése, amit jól kell megoldani, hogy a jelvények ne hulljanak ki csendben a kiadásból.

Amit összekötsz

Minden recept ugyanazt a felépítést követi: trigger → (opcionális) címzett-keresés → HTTP POST a /awards végpontra. A /awards végpont az, ami ténylegesen kiad egy jelvényt egy címzettnek — megadsz neki egy meglévő badgeId-t, ő pedig létrehoz egy egyedi, ellenőrizhető kiadást a saját ellenőrző URL-jével, QR-kódjával és PDF-tanúsítványával. Nézd meg az API gyorsindítót, ha még nem hoztál létre jelvényt — annak azonosítójára szükséged lesz, mielőtt bármelyik automatizálás elindulhatna.

Mindhárom platformon ugyanaz a hitelesítés: egy X-Api-Key fejléc, amely a dashboardodból generált kulcsot hordozza. Az automatizálási platformok nem kezelik jól az OAuth-folyamatokat tetszőleges REST API-khoz, így itt az API-kulcsok a megfelelő választás — hosszú élettartamúak, a fiókodhoz kötöttek, és egy kattintással visszavonhatók, ha egy Zap valaha félremenne.

Először hozd létre az API-kulcsot

A dashboardodban nyisd meg a Settings → API Keys menüt, kattints a Create Key gombra, és adj neki a feladatához illő nevet — zapier-course-completions, ne key1. Ez a névadás fontosabb, mint amennyire hangzik: ha egy automatizálás fél év múlva rosszul kezd viselkedni, azt a konkrét kulcsot szeretnéd visszavonni anélkül, hogy három másik, ugyanazt a kulcsot használó integrációt tönkretennél.

A kulcs egyszer, teljes egészében jelenik meg, közvetlenül a létrehozás után. Másold be azonnal az automatizálási platform biztonságos hitelesítő adat tárolójába — a Zapier „Connection”-jébe, a Make „Connection”-jébe, vagy egy n8n credentialbe —, sose sima szövegmezőbe magán a Zapen, forgatókönyvön vagy workflow-n belül.

1. recept: Typeform → Badges Ninja (kohorsz-befejezési űrlap)

Felhasználási eset: egy kohorsz befejez egy kurzust, és kitölt egy rövid „ezt elvégeztem” űrlapot (vagy egy önálló ütemű tanulási út utolsó lépéseként küldesz ki egy ilyen űrlapot).

Zapierben:

1. Trigger: Typeform — New Entry, a befejezési űrlapodra szűkítve.
2. Akció: Webhooks by Zapier — POST.
3. URL: https://api.badges.ninja/awards
4. Fejlécek: X-Api-Key: bws_<your key>, Content-Type: application/json
5. Adatok (a Typeform mezőiből leképezve):

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

Ennyi az egész Zap. Nincs szükség Filter lépésre, ha az űrlap csak valódi befejezéskor indul — ha ez egy általános kapcsolatfelvételi űrlap, adj hozzá egy Filter by Zapier lépést, amely egy rejtett mezőt vagy válaszértéket ellenőriz a webhook elindítása előtt, hogy ne adj ki jelvényt spamből vagy teszt-beküldésekből.

2. recept: Stripe → Badges Ninja (vásárlás = credential)

Felhasználási eset: fizetős vizsga, prémium kurzusszint vagy tagsági csomag, ahol a jelvény azoknak a dolgoknak a része, amiket az emberek megvásárolnak.

Zapierben:

1. Trigger: Stripe — New Charge (vagy New Invoice Payment Succeeded előfizetésekhez).
2. Filter: a terhelés összege megegyezik a credentiallel járó termék pontos árával — ez akkor számít, ha a Stripe-fiókod egyetlen webhookon keresztül több terméket is kezel.
3. Akció: Webhooks by Zapier — POST a https://api.badges.ninja/awards címre, ugyanazokkal a fejlécekkel, mint fent.
4. Adatok: képezd le a charge.billing_details.email és charge.billing_details.name mezőket a recipient.email / recipient.name mezőkbe.

A kiadás fizetési eseményhez kötésének kellemes oldala: természeténél fogva közel áll az idempotenciához. A Stripe terhelés-azonosítói egyediek, szóval ha attól tartasz, hogy egy Zap egy megismételt webhook miatt újra elindul, adj hozzá egy Storage by Zapier lépést, amely a /awards hívása előtt ellenőrzi, hogy azt a terhelés-azonosítót már feldolgoztad-e.

3. recept: Mailchimp-címke → Badges Ninja

Felhasználási eset: kézzel (vagy egy másik automatizáláson keresztül) címkézel fel feliratkozókat, amikor elérnek egy mérföldkövet — részt vettek egy webináriumon, befejeztek egy drip-sorozatot, ajánlottak három embert —, és azt szeretnéd, hogy ez a címke jelvényt indítson el anélkül, hogy neked magadnak kellene az API-hoz nyúlnod.

Zapierben:

1. Trigger: Mailchimp — New Tag Added to Subscriber, az adott címkére szűrve (pl. webinar-attended).
2. Akció: Webhooks by Zapier — POST a https://api.badges.ninja/awards címre.
3. Adatok: képezd le a subscriber.email_address és subscriber.merge_fields.FNAME + LNAME mezőket a címzett mezőire.

Ez a minta népszerű elismerési programoknál — sales SPIFF-ek, közösségi mérföldkövek, eseményen való részvétel —, ahol a csapatból valaki már megszokásból címkéz kontaktokat, és te csak azt szeretnéd, hogy a jelvény ingyen essen ki ebből a szokásból.

Hibák és újrapróbálkozások kezelése

Az automatizálási platformok nem tranzakciósak a jelvényadataiddal, ezért építs be ugyanolyan fegyelmet, amilyet egy valódi integrációtól elvárnál:

• Ellenőrizd a válaszkódot. A 200 azt jelenti, hogy a kiadás létrejött; a 4xx általában rossz badgeId-t vagy hibás formátumú e-mailt jelent — ez konfigurációs hiba a Zapben, nem valami, amit vakon újra kell próbálni. Az 5xx biztonságosan újrapróbálható.
• Zapier: a sikertelen Zap-futások a Zap History-ban landolnak a teljes kéréssel/válasszal együtt. Kapcsold be az Auto-Replay-t az átmeneti hibákra, de állíts be e-mail/Slack riasztást ismétlődő hibákra, hogy egy csendben elromlott Zap ne jelentsen három hónapnyi hiányzó jelvényt.
• Make: a forgatókönyvek támogatnak egy natív Error Handler útvonalat — csatolj egy Resume vagy Rollback direktívát a HTTP modulhoz, és a tartós hibákat irányítsd egy értesítő modulba, ahelyett hogy egyszerűen eldobnád őket.
• n8n: mivel önhosztolt vagy felhő alapú, finomabb szabályozással, csomagold a HTTP Request node-ot egy Error Trigger workflow-ba, és fontold meg a sikertelen payload-ok kiírását egy könnyű tartalék tárolóba (Airtable, Google Sheets), amit manuálisan újra le tudsz játszani.

Mindhárom esetben kerüld el a „zölden lefutott, tehát működött” csapdát. Egy rosszul konfigurált webhook-lépésből (hibás URL, hiányzó fejléc) származó, 200-nak tűnő válasz még mindig elbukhat a Badges Ninja oldalán. Minden új automatizálás első hónapjában hetente ellenőrizd szúrópróbaszerűen a dashboard kiadás-listáját.

A Make.com megfelelője

A Make vizuális forgatókönyv-építője szinte közvetlenül leképezhető a fenti Zapier-lépésekre:

1. Trigger modul — Typeform / Stripe / Mailchimp figyelő modul, ugyanúgy, mint a Zapier triggere.
2. HTTP → Make a Request modul — POST metódus, https://api.badges.ninja/awards URL, fejlécek a Headers táblázatban beállítva (X-Api-Key, Content-Type: application/json), a törzs nyers JSON, a triggerből leképezett változókkal.
3. Opcionális Filter a modulok között a Stripe-összeg ellenőrzéséhez vagy a „valódi befejezés” biztosítékhoz a Typeformnál.

A Make előnye itt a láthatóság — a forgatókönyv-szerkesztő minden lépésnél megmutatja a tényleges JSON payloadot, mielőtt bekapcsolnád, ami sokkal gyorsabbá teszi egy rossz mezőleképezés hibakeresését, mint a Zapier lineárisabb, lépésről lépésre haladó tesztnézete.

Az n8n megfelelője

Az n8n a legjobb választás, ha ezt önhosztolva szeretnéd, vagy ha a stackod más részeit már ott automatizálod:

1. Trigger node — Typeform Trigger / Stripe Trigger / Mailchimp Trigger (mindegyik beépített node).
2. HTTP Request node — POST metódus, https://api.badges.ninja/awards URL, a hitelesítés Header Auth-ra állítva, az X-Api-Key-eddel n8n credentialként tárolva (nem a node-ba kódolva), a JSON törzs egy, a trigger node kimenetére hivatkozó kifejezésből felépítve.
3. IF node (opcionális) — ugyanaz a befejezési/összeg biztosíték, mint fent, a HTTP Request node elé helyezve.

Mivel az n8n credentialjai titkosítottak és workflow-k között újrafelhasználhatók, ez a tisztább megoldás, ha egynél több Badges Ninja automatizálást tervezel — a credentialt egyszer állítod be, és minden olyan workflow-ban újrahasznosítod, amelynek jelvényt kell kiadnia.

Miért egy generikus webhook-lépés a natív alkalmazás helyett

A Zapiernek, a Make-nek és az n8n-nek is van alkalmazás-piactere, és az ösztön az, hogy egy „Badges Ninja” alkalmazást keress, mielőtt egy generikus HTTP/webhook modulhoz nyúlnál. Hagyd ki ezt a keresést — egy ekkora REST API-nál (issuer létrehozása, jelvény létrehozása, kiadás létrehozása, kész) egy generikus webhook-lépés tíz perc alatt élesbe visz, teljesen függetlenül attól, hogy egy harmadik féltől származó alkalmazás karbantartója lépést tart-e az API változásaival. Egy dedikált alkalmazás olyan absztrakciós réteget ad hozzá, amire nincs szükséged: ugyanazokat a badgeId, recipient.email és recipient.name mezőket töltenéd ki, csak egy űrlapon keresztül egy JSON törzs helyett. Az API-referencia elég rövid ahhoz, hogy öt perc alatt elolvasd, és ha ezt megtetted, a nyers HTTP-megközelítés valójában kevésbé törékeny — nincs app store jóváhagyási ciklus egy Badges Ninja API-változás és az automatizálásod újbóli működése között.

Teszteld, mielőtt élesbe kapcsolod

A fenti platformok mindegyike lehetőséget ad arra, hogy lefuttass egyetlen tesztvégrehajtást anélkül, hogy egy valódi triggerelő eseményre kellene várnod:

• Zapier — használd a „Test”-et a trigger lépésen egy minta rekord lehívásához, majd a „Test”-et a webhook akción, hogy pontosan egy valódi kérést küldj el. Ellenőrizd, hogy a kiadás megjelenik-e a dashboardodban, mielőtt bekapcsolod a Zapet.
• Make — futtasd le manuálisan egyszer a forgatókönyvet (a „Run once” gombbal) egy minta bundle-lel, és vizsgáld meg a HTTP modul kimeneti buborékját a tényleges válasz törzséért.
• n8n — használd az „Execute Node”-ot a HTTP Request node-on tesztbemeneti adatokkal, ami lehetővé teszi, hogy közvetlenül a szerkesztőben lásd a kérést és a választ.

Két dolgot érdemes ellenőrizni azon az első tesztfuttatáson: hogy a hardkódolt badgeId valóban ahhoz a jelvényhez tartozik-e, amelyikre gondolsz (egy elavult azonosító egy duplikált Zapből gyakori hiba), és hogy a címzett e-mail mezője valódi címet húz-e le, nem egy olyan helykitöltőt, mint a {{email}}, amely egy leképezési elírás miatt maradt feloldatlanul. Mindkét hiba láthatatlan az automatizálási platform „sikeres” jelzőjében — a HTTP-hívás mindenképp 200-et ad vissza —, így az egyetlen megbízható ellenőrzés az, ha megnyitod a kiadást a dashboardban, és megerősíted, hogy a címzett tényleg az, akire számítasz.

Duplikált jelvények elkerülése

A fenti trigger-források bármelyike valós körülmények között akár többször is elsülhet ugyanarra az eseményre — a Stripe időtúllépéskor újrapróbálja a webhookokat, a Typeform lassú kapcsolatnál duplán is beküldhet, a Mailchimp-automatizálások újraindulhatnak, ha egy címkét eltávolítanak, majd újra hozzáadnak. Ha a jelvénykiadásod nem idempotens, ez abból lesz, hogy a címzettek kétszer kapják meg ugyanazt a credentialt, ami hanyagnak tűnik, és support-e-maileket generál.

A legtisztább biztosíték egy keresés-létrehozás-előtt lépés: a /awards POST előtt adj hozzá egy Search akciót (Zapierben a „Find Award” egy GET kérésen keresztül, vagy a Make/n8n megfelelő HTTP GET-je) a saját kiadás-nyilvántartásod ellen — egy könnyű Google Sheets vagy Airtable napló, amelybe ugyanaz a Zap ír közvetlenül egy sikeres kiadás után, ehhez tökéletesen megfelel, ha nem akarod erre lekérdezni az API-t. Ha már létezik rekord az adott címzett + jelvény kombinációra, ágazz egy no-op felé az újbóli kiadás helyett. Ez egy ötperces kiegészítés, és ez a különbség egy olyan automatizálás között, amelyben felügyelet nélkül is megbízol, és egy olyan között, amit dajkálnod kell.

Amikor a no-code nem elég

Ezek a receptek jól lefedik az egyetlen eseményhez kötött triggereket. Amint egyetlen CSV-exportból kezdesz több száz jelvényt kiadni — egy végző kohorsz, egy konferencia résztvevőlistája, tömeges CE-kredit-megújítás — hagyd ki az automatizálási platformot, és használd közvetlenül a tömeges jelvényfeltöltést: képes megállni és folytatni a köteg közepén, és túlél egy bezárt böngészőfület, amit a kódolás nélküli webhook-hurkok nagy volumen mellett nem kezelnek ilyen elegánsan.

---

Készen állsz kiadni az első ellenőrizhető credentialodat? Kezdd ingyen a badges.ninja-n — vizuális tervező, nyilvános ellenőrző oldal, PDF-tanúsítvány, Open Badge v2.0 kimenet. Bankkártya nem szükséges.