Automatizējiet Open Badges izdošanu ar Zapier, Make un n8n (bezkoda receptes)

Ja jūs vadāt apmācību programmu, maksas kursu vai e-pasta sarakstu ar līmeņiem, brīdis, kad kāds pabeidz, pērk vai kvalificējas, parasti jau tiek izsekots kaut kur — veidlapas atbildē, Stripe maksājumā, Mailchimp atzīmē. Digitālajai nozīmei būtu jāseko automātiski no šī notikuma. Tas reti notiek, jo „izdot akreditāciju” nav dabiska darbība lielākajā daļā rīku, un pielāgota webhook uztvērēja būvēšana vienreizējai automatizācijai ir pārspīlēti sarežģīti.

Tieši tam ir domāti Zapier, Make un n8n. Visas trīs platformas var tieši izsaukt Badges Ninja API — bez spraudņa, bez starpservera, bez koda izvietošanas. Tālāk ir trīs darboties spējīgas receptes, ko varat kopēt jau šodien, kā arī API atslēgas apstrāde un kļūdu atkārtošanas uzvedība, kas jāsakārto pareizi, lai digitālās nozīmes klusībā neciestu neveiksmi izdošanā.

Ko jūs sasaistāt kopā

Katra recepte seko vienai un tai pašai shēmai: trigeris → (pēc izvēles) saņēmēja meklēšana → HTTP POST uz /awards. /awards galapunkts ir tas, kas faktiski izdod digitālo nozīmi saņēmējam — jūs norādāt uz esošu badgeId, un tas izveido unikālu, verificējamu apbalvojumu ar savu verifikācijas URL, QR kodu un PDF sertifikātu. Skatiet API ātro sākumu, ja vēl neesat izveidojis digitālo nozīmi — tās ID būs nepieciešams, pirms jebkura no šīm automatizācijām var darboties.

Autentifikācija visās trīs platformās ir vienāda: X-Api-Key galvene, kas satur jūsu vadības panelī izveidotu atslēgu. Automatizācijas platformas patvaļīgiem REST API nespēj labi apstrādāt OAuth plūsmas, tāpēc šeit API atslēgas ir pareizais risinājums — ilgtermiņa, piesaistītas jūsu kontam un atceļamas ar vienu klikšķi, ja kāds Zap kādreiz sāk darboties nepareizi.

Vispirms izveidojiet API atslēgu

Savā vadības panelī atveriet Settings → API Keys, noklikšķiniet Create Key un piešķiriet nosaukumu, kas atbilst tās uzdevumam — zapier-course-completions, nevis key1. Šis nosaukums ir svarīgāks, nekā šķiet: ja pēc sešiem mēnešiem kāda automatizācija sāk darboties nepareizi, jūs vēlaties atcelt tieši šo atslēgu, nesabojājot trīs citas integrācijas, kas to nejauši izmanto kopīgi.

Atslēga tiek parādīta vienu reizi, pilnā veidā, uzreiz pēc izveides. Nekavējoties kopējiet to savas automatizācijas platformas drošajā akreditācijas datu krātuvē — Zapier „Connection”, Make „Connection” vai n8n akreditācijas datos — nekad vienkāršā teksta laukā paša Zap/scenārija/darbplūsmas iekšienē.

1. recepte: Typeform → Badges Ninja (grupas pabeigšanas veidlapa)

Lietošanas gadījums: grupa pabeidz kursu un aizpilda īsu „Es to pabeidzu” veidlapu (vai jūs nosūtāt veidlapu kā pēdējo soli pašpiepūles kursā).

Zapier vidē:

1. Trigeris: Typeform — New Entry, attiecināts uz jūsu pabeigšanas veidlapu.
2. Darbība: Webhooks by Zapier — POST.
3. URL: https://api.badges.ninja/awards
4. Galvenes: X-Api-Key: bws_<jūsu atslēga>, Content-Type: application/json
5. Dati (kartējiet no Typeform laukiem):

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

Tas ir viss Zap. Filtra solis nav nepieciešams, ja veidlapa aktivizējas tikai pēc reālas pabeigšanas — ja tā ir vispārīga kontaktu veidlapa, pievienojiet Filter by Zapier soli, kas pirms webhook aktivizēšanas pārbauda slēptu lauku vai atbildes vērtību, lai neizdotu digitālās nozīmes no surogātpasta vai testa iesniegumiem.

2. recepte: Stripe → Badges Ninja (pirkums = akreditācija)

Lietošanas gadījums: maksas sertifikācijas eksāmens, prēmijas kursa līmenis vai dalības plāns, kurā digitālā nozīme ir daļa no tā, ko cilvēki pērk.

Zapier vidē:

1. Trigeris: Stripe — New Charge (vai New Invoice Payment Succeeded abonementiem).
2. Filtrs: maksājuma summa atbilst tieši akreditētā produkta cenai — tas ir svarīgi, ja jūsu Stripe konts caur vienu webhook apstrādā vairākus produktus.
3. Darbība: Webhooks by Zapier — POST uz https://api.badges.ninja/awards, tās pašas galvenes kā iepriekš.
4. Dati: kartējiet charge.billing_details.email un charge.billing_details.name uz recipient.email / recipient.name.

Izdošanas piesaistīšanai maksājuma notikumam ir jauka priekšrocība: tā pēc būtības ir tuvu idempotencei. Stripe maksājumu ID ir unikāli, tāpēc, ja uztraucaties par Zap atkārtotu aktivizēšanos pie atkārtota webhook mēģinājuma, pievienojiet Storage by Zapier soli, kas pirms /awards izsaukšanas pārbauda, vai šis maksājuma ID jau nav apstrādāts.

3. recepte: Mailchimp atzīme → Badges Ninja

Lietošanas gadījums: jūs manuāli (vai izmantojot citu automatizāciju) atzīmējat abonentus, kad viņi sasniedz atzīmi — apmeklē tīmekļa semināru, pabeidz secīgu e-pastu sēriju, uzaicina trīs cilvēkus — un vēlaties, lai šī atzīme aktivizētu digitālās nozīmes izdošanu, jums pašiem nepieskaroties API.

Zapier vidē:

1. Trigeris: Mailchimp — New Tag Added to Subscriber, filtrēts uz konkrētu atzīmi (piem., webinar-attended).
2. Darbība: Webhooks by Zapier — POST uz https://api.badges.ninja/awards.
3. Dati: kartējiet subscriber.email_address un subscriber.merge_fields.FNAME + LNAME uz saņēmēja laukiem.

Šis modelis ir populārs atzinības programmām — pārdošanas veicināšanas akcijām, kopienas atzīmēm, pasākumu apmeklējumam — kur kāds komandā jau ir ieradis atzīmēt kontaktus, un jūs vienkārši vēlaties, lai digitālā nozīme rastos no šī ieraduma bez papildu piepūles.

Kļūdu un atkārtotu mēģinājumu apstrāde

Automatizācijas platformas nav transakcionālas attiecībā uz jūsu digitālo nozīmju datiem, tāpēc iestrādājiet tādu pašu disciplīnu, kādu vēlētos no īstas integrācijas:

• Pārbaudiet atbildes kodu. 200 nozīmē, ka apbalvojums ir izveidots; 4xx parasti nozīmē nederīgu badgeId vai nepareizi formētu e-pastu — tā ir konfigurācijas kļūda Zap iestatījumos, nevis kaut kas, kas jāatkārto akli. 5xx ir droši atkārtot.
• Zapier: neveiksmīgi Zap izpildījumi nonāk sadaļā Zap History ar pilnu pieprasījumu/atbildi. Ieslēdziet Auto-Replay īslaicīgām kļūdām, taču iestatiet e-pasta/Slack brīdinājumu par atkārtotām kļūdām, lai klusi sabojāts Zap nenozīmētu trīs mēnešus iztrūkstošu digitālo nozīmju.
• Make: scenāriji atbalsta iebūvētu Error Handler maršrutu — pievienojiet Resume vai Rollback direktīvu HTTP modulim un novirziet pastāvīgas kļūdas uz paziņojumu moduli, nevis vienkārši tās ignorējiet.
• n8n: tā kā to var izvietot pašiem vai izmantot mākonī ar detalizētāku kontroli, ietveriet HTTP Request mezglu Error Trigger darbplūsmā un apsveriet neveiksmīgo datu ierakstīšanu vieglā rezerves krātuvē (Airtable, Google Sheets), ko varat manuāli atkārtot.

Visās trīs platformās izvairieties no slazda „tas nostrādāja zaļi, tātad izdevās”. Uz 200 līdzīga atbilde no nepareizi konfigurēta webhook soļa (nepareizs URL, trūkstoša galvene) joprojām var neizdoties Badges Ninja pusē. Ik nedēļu pirmajā mēnesī pēc jaunas automatizācijas izveides izlases veidā pārbaudiet vadības paneļa apbalvojumu sarakstu.

Make.com ekvivalents

Make vizuālais scenāriju veidotājs gandrīz tieši atbilst iepriekš minētajiem Zapier soļiem:

1. Trigger module — Typeform / Stripe / Mailchimp novērošanas modulis, tāds pats kā Zapier trigeris.
2. HTTP → Make a Request module — metode POST, URL https://api.badges.ninja/awards, galvenes iestatītas Headers tabulā (X-Api-Key, Content-Type: application/json), pamatteksts kā neapstrādāts JSON ar no trigera kartētiem mainīgajiem.
3. Pēc izvēles Filter starp moduļiem Stripe summas pārbaudei vai „reālas pabeigšanas” aizsardzībai Typeform gadījumā.

Make priekšrocība šeit ir pārskatāmība — scenāriju redaktors katrā solī parāda faktisko JSON datu paketi, pirms to ieslēdzat, kas padara nepareiza lauka kartējuma atkļūdošanu daudz ātrāku nekā Zapier lineārākais soli pa solim testēšanas skats.

n8n ekvivalents

n8n ir vislabākā izvēle, ja vēlaties to izvietot pašu spēkiem vai ja jūs jau automatizējat citas sava tehnoloģiju kopuma daļas tur:

1. Trigger node — Typeform Trigger / Stripe Trigger / Mailchimp Trigger (visi iebūvētie mezgli).
2. HTTP Request node — metode POST, URL https://api.badges.ninja/awards, autentifikācija iestatīta uz Header Auth, ar X-Api-Key saglabātu kā n8n akreditācijas datus (nevis iekodētu mezglā), JSON pamatteksts izveidots no izteiksmes, kas atsaucas uz trigera mezgla izvadi.
3. IF node (pēc izvēles) — tāda pati pabeigšanas/summas aizsardzība kā iepriekš, novietota pirms HTTP Request mezgla.

Tā kā n8n akreditācijas dati ir šifrēti un atkārtoti izmantojami dažādās darbplūsmās, šī ir tīrāka izvēle, ja plānojat vairāk nekā vienu Badges Ninja automatizāciju — iestatiet akreditācijas datus vienreiz un atkārtoti izmantojiet tos katrā darbplūsmā, kurai jāizdod digitālās nozīmes.

Kāpēc vispārīgs webhook solis, nevis vietējā lietotne

Zapier, Make un n8n visiem ir lietotņu tirdzniecības vietas, un instinkts liek meklēt „Badges Ninja” lietotni, pirms ķerties pie vispārīga HTTP/webhook moduļa. Izlaidiet šo meklēšanu — tik nelielam REST API (izveidot izdevēju, izveidot digitālo nozīmi, izveidot apbalvojumu, gatavs), vispārīgs webhook solis jūs darbībā ievieto desmit minūtēs bez jebkādas atkarības no trešās puses lietotnes uzturētāja spējas sekot līdzi API izmaiņām. Speciāla lietotne pievieno abstrakcijas slāni, kas jums nav vajadzīgs: jūs joprojām aizpildītu tos pašus badgeId, recipient.email un recipient.name laukus, tikai caur formu, nevis JSON pamattekstu. API atsauce ir pietiekami īsa, lai to izlasītu piecās minūtēs, un, to izdarījuši, jūs sapratīsiet, ka neapstrādātā HTTP pieeja patiesībā ir mazāk trausla — starp Badges Ninja API izmaiņu un jūsu automatizācijas atkalatgriešanos darba kārtībā nestāv nekāds lietotņu veikala apstiprināšanas cikls.

Testējiet, pirms to palaižat dzīvē

Katra no iepriekš minētajām platformām sniedz iespēju palaist vienu testa izpildi, negaidot reālu trigera notikumu:

• Zapier — izmantojiet „Test” trigera solī, lai iegūtu parauga ierakstu, tad „Test” webhook darbībā, lai nosūtītu tieši vienu reālu pieprasījumu. Pirms Zap ieslēgšanas pārbaudiet, vai apbalvojums parādās jūsu vadības panelī.
• Make — vienu reizi manuāli palaidiet scenāriju (poga „Run once”) ar parauga datu kopu un pārbaudiet HTTP moduļa izvades burbulī faktisko atbildes pamattekstu.
• n8n — izmantojiet „Execute Node” HTTP Request mezglā ar testa ievades datiem, kas ļauj redzēt pieprasījumu un atbildi tieši redaktorā.

Divas lietas ir vērts pārbaudīt šajā pirmajā testa palaišanā: vai iekodētais badgeId patiešām pieder tai digitālajai nozīmei, par kuru jūs domājat (novecojis ID no dublēta Zap ir bieža kļūda), un vai saņēmēja e-pasta lauks izgūst reālu adresi, nevis neatrisinātu vietturi, piemēram, {{email}}, kas radies kartēšanas kļūdas dēļ. Abas kļūdas ir neredzamas automatizācijas platformas „veiksmes” indikatorā — HTTP izsaukums abos gadījumos joprojām atgriež 200 — tāpēc vienīgā uzticamā pārbaude ir atvērt apbalvojumu savā vadības panelī un pārliecināties, ka saņēmējs ir tas, kuru gaidījāt.

Dublēto digitālo nozīmju novēršana

Katrs no iepriekš minētajiem trigera avotiem reālos apstākļos var aktivizēties vairāk nekā vienu reizi vienam un tam pašam notikumam — Stripe atkārto webhook mēģinājumus noildzes gadījumā, Typeform lēna savienojuma gadījumā var iesniegt datus divreiz, Mailchimp automatizācijas var aktivizēties atkārtoti, ja atzīme tiek noņemta un pievienota no jauna. Ja jūsu digitālo nozīmju izdošana nav idempotenta, tas nozīmē, ka saņēmēji divreiz saņem to pašu akreditāciju, kas izskatās nekārtīgi un rada atbalsta pieprasījumus.

Tīrākā aizsardzība ir meklēšanas solis pirms izveides: pirms /awards POST pievienojiet Search darbību (Zapier „Find Award” ar GET pieprasījumu vai līdzvērtīgu Make/n8n HTTP GET) pret saviem apbalvojumu ierakstiem — vieglai Google Sheet vai Airtable žurnāls, kuram tas pats Zap raksta uzreiz pēc veiksmīga apbalvojuma, šim nolūkam der lieliski, ja nevēlaties par to vaicāt API. Ja saņēmēja + digitālās nozīmes kombinācijai ieraksts jau pastāv, novirziet uz tukšu darbību, nevis izdodiet atkārtoti. Šī ir piecu minūšu papildinājums, un tā ir atšķirība starp automatizāciju, kurai uzticaties bez uzraudzības, un tādu, kura jāaukle.

Kad bezkoda risinājums nav pietiekams

Šīs receptes labi aptver vienreizēju notikumu trigerus. Tiklīdz izdodat simtiem digitālo nozīmju no viena CSV eksporta — grupas izlaidums, konferences dalībnieku saraksts, masveida CE kredītpunktu atjaunošana — izlaidiet automatizācijas platformu un izmantojiet masveida digitālo nozīmju augšupielādi tieši: tā pauzē un atsāk vidū partijas apstrādi un izdzīvo aizvērtu pārlūka cilni, ar ko bezkoda webhook cilpas lielā apjomā netiek galā.

---

Vai esat gatavi izdot savu pirmo verificējamo akreditāciju? Sāciet bez maksas badges.ninja platformā — vizuālais dizaineris, publiska verifikācijas lapa, PDF sertifikāts, Open Badge v2.0 izvade. Kredītkarte nav nepieciešama.