Аутоматизујте Open Badges помоћу Zapier-а, Make-а и n8n-а (рецепти без кода)

Ако водите програм обуке, плаћени курс или мејлинг листу са нивоима, тренутак у ком неко заврши, купи или испуни услове обично је већ негде забележен — у одговору на образац, наплати преко Stripe-а, ознаци у Mailchimp-у. Значка би требало аутоматски да следи из тог догађаја. То се ретко заиста деси, јер „издавање уверења” није уграђена радња у већини алата, а изградња прилагођеног пријемника за webhook-ове ради једнократне аутоматизације је претеран труд.

Управо за то служе Zapier, Make и n8n. Сва три алата могу директно да позову Badges Ninja API — без додатка, без посредничког сервера, без имплементације кода. У наставку су три проверена рецепта која данас можете да копирате, плус правилно руковање API кључем и понашање при поновним покушајима после грешака које морате да подесите како значке не би тихо престале да се издају.

Шта заправо повезујете

Сваки рецепт прати исту шему: окидач → (опционо) проналажење примаоца → HTTP POST на /awards. Крајња тачка /awards је та која заправо издаје значку примаоцу — усмерите је на постојећи badgeId, а она ствара јединствену, проверљиву доделу са сопственим URL-ом за верификацију, QR кодом и PDF сертификатом. Погледајте брзи водич за API ако још нисте направили значку; биће вам потребан њен ID пре него што било која од ових аутоматизација може да проради.

Аутентификација је иста на све три платформе: заглавље X-Api-Key са кључем генерисаним са ваше контролне табле. Платформе за аутоматизацију се не носе добро са OAuth токовима за произвољне REST API-је, па су овде API кључеви прави избор — дуговечни, везани за ваш налог и опозиви једним кликом ако се неки Zap икада поквари.

Прво направите API кључ

На својој контролној табли отворите Подешавања → API кључеви, кликните Направи кључ и дајте му назив који одговара његовој сврси — zapier-course-completions, а не key1. Тај детаљ значи више него што звучи: ако се аутоматизација за шест месеци поквари, желећете да опозовете баш тај кључ, а да не покваритe три друге интеграције које га случајно деле.

Кључ се приказује само једном, у целости, одмах након прављења. Одмах га копирајте у безбедно складиште акредитива своје платформе за аутоматизацију — Zapier-ову „Connection”, Make-ову „Connection” или n8n акредитив — никада у обично текстуално поље унутар самог Zap-а, сценарија или радног тока.

Рецепт 1: Typeform → Badges Ninja (образац за завршетак кохорте)

Случај употребе: кохорта завршава курс и попуњава кратак образац „завршио/ла сам ово” (или шаљете образац као последњи корак самосталне путање учења).

У Zapier-у:

1. Окидач: Typeform — New Entry, ограничен на ваш образац за завршетак.
2. Радња: Webhooks by Zapier — POST.
3. URL: https://api.badges.ninja/awards
4. Заглавља: X-Api-Key: bws_<ваш кључ>, Content-Type: application/json
5. Подаци (мапирани из поља Typeform-а):

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

То је цео Zap. Није потребан корак филтрирања ако се образац покреће само код стварних завршетака — ако је реч о општем контакт обрасцу, додајте корак Filter by Zapier који проверава скривено поље или вредност одговора пре него што се webhook покрене, како не бисте издавали значке из спама или тестних пријава.

Рецепт 2: Stripe → Badges Ninja (куповина = уверење)

Случај употребе: плаћени сертификациони испит, премијум ниво курса или план чланства у ком је значка део онога што људи купују.

У Zapier-у:

1. Окидач: Stripe — New Charge (или New Invoice Payment Succeeded за претплате).
2. Филтер: износ наплате мора бити једнак тачној цени производа за који се издаје уверење — то је важно ако ваш Stripe налог обрађује више производа преко једног webhook-а.
3. Радња: Webhooks by Zapier — POST на https://api.badges.ninja/awards, са истим заглављима као горе.
4. Подаци: мапирајте charge.billing_details.email и charge.billing_details.name у поља recipient.email / recipient.name.

Добра страна повезивања издавања са догађајем плаћања јесте да је то природно скоро идемпотентно. ID-еви наплате у Stripe-у су јединствени, па ако вас брине да би се Zap могао поново покренути због поновљеног webhook-а, додајте корак Storage by Zapier који проверава да ли сте тај ID наплате већ обрадили пре позива на /awards.

Рецепт 3: Ознака у Mailchimp-у → Badges Ninja

Случај употребе: означавате претплатнике ручно (или преко друге аутоматизације) када достигну прекретницу — присуствовали су вебинару, завршили низ мејлова, препоручили троје људи — и желите да та ознака покрене значку а да сами не дирате API.

У Zapier-у:

1. Окидач: Mailchimp — New Tag Added to Subscriber, филтриран на конкретну ознаку (нпр. webinar-attended).
2. Радња: Webhooks by Zapier — POST на https://api.badges.ninja/awards.
3. Подаци: мапирајте subscriber.email_address и subscriber.merge_fields.FNAME + LNAME у поља примаоца.

Овај образац је популаран за програме признања — подстицаје за продају, прекретнице заједнице, присуство на догађајима — где неко у тиму већ има навику да означава контакте, а ви једноставно желите да значка произађе из те навике без додатног труда.

Руковање грешкама и поновним покушајима

Платформе за аутоматизацију нису трансакционе у односу на податке ваших значки, па примените исту дисциплину какву бисте очекивали од праве интеграције:

• Проверите код одговора. 200 значи да је додела направљена; 4xx обично значи неисправан badgeId или лоше форматиран имејл — то је грешка у конфигурацији Zap-а, а не нешто што треба слепо понављати. 5xx је безбедно поновити.
• Zapier: неуспела извршавања Zap-а завршавају у Zap History са целим захтевом и одговором. Укључите Auto-Replay за пролазне грешке, али подесите обавештење путем имејла или Slack-а за понављане грешке, како тихо покварен Zap не би значио три месеца недостајућих значки.
• Make: сценарији подржавају native руту Error Handler — прикачите директиву Resume или Rollback на HTTP модул и усмерите трајне грешке ка модулу за обавештавање уместо да их једноставно одбацујете.
• n8n: пошто се самостално хостује или у облаку са детаљнијом контролом, обмотајте HTTP Request чвор у радни ток Error Trigger и размотрите уписивање неуспелих payload-ова у лако резервно складиште (Airtable, Google Sheets) које можете ручно поново покренути.

У сва три случаја избегавајте замку „извршило се зелено, значи да је успело”. Одговор који изгледа као 200, а долази из лоше конфигурисаног корака webhook-а (погрешан URL, недостајуће заглавље), ипак може да не успе на страни Badges Ninja. Проверавајте листу додела на контролној табли једном недељно током првог месеца сваке нове аутоматизације.

Еквивалент на Make.com

Make-ов визуелни градитељ сценарија скоро директно одговара горњим корацима у Zapier-у:

1. Модул окидача — модул праћења Typeform / Stripe / Mailchimp, исто као окидач у Zapier-у.
2. HTTP → Make a Request модул — метода POST, URL https://api.badges.ninja/awards, заглавља постављена у табели Headers (X-Api-Key, Content-Type: application/json), тело као сирови JSON са мапираним варијаблама из окидача.
3. Опциони Filter између модула за проверу износа у Stripe-у или заштиту „стварног завршетка” у Typeform-у.

Make-ова предност овде је видљивост — уређивач сценарија приказује стварни JSON терет на сваком кораку пре него што га укључите, што чини отклањање грешака код лошег мапирања поља много бржим у односу на линеарнији поглед тестирања корак по корак у Zapier-у.

Еквивалент у n8n-у

n8n је најбољи избор ако желите да ово буде самостално хостовано или ако тамо већ аутоматизујете друге делове своје инфраструктуре:

1. Чвор окидача — Typeform Trigger / Stripe Trigger / Mailchimp Trigger (сви су уграђени чворови).
2. HTTP Request чвор — метода POST, URL https://api.badges.ninja/awards, аутентификација постављена на Header Auth са вашим X-Api-Key сачуваним као n8n акредитив (а не тврдо кодиран у чвору), JSON тело изграђено из израза који упућује на излаз чвора окидача.
3. IF чвор (опционо) — иста заштита за завршетак/износ као горе, постављена пре HTTP Request чвора.

Пошто су n8n акредитиви шифровани и могу се поново користити у више радних токова, ово је чистија опција ако планирате више од једне Badges Ninja аутоматизације — акредитив подесите једном и поново га користите у сваком радном току којем је потребно издавање значки.

Зашто генерички корак webhook-а уместо native апликације

Zapier, Make и n8n сви имају тржишта апликација, а инстинкт је да потражите апликацију „Badges Ninja” пре него што посегнете за генеричким HTTP/webhook модулом. Прескочите то претраживање — за оволико мали REST API (направите издаваоца, направите значку, направите доделу, готово), генерички корак webhook-а вас пушта у погон за десет минута, без икакве зависности од одржаваоца апликације треће стране који мора да прати темпо промена API-ја. Наменска апликација додаје слој апстракције који вам није потребан: и даље бисте попуњавали иста поља badgeId, recipient.email и recipient.name, само кроз образац уместо кроз JSON тело. Референца API-ја довољно је кратка да је прочитате за пет минута, а када то урадите, приступ путем директног HTTP-а заправо је мање осетљив на кварове — не постоји циклус одобравања у продавници апликација између промене Badges Ninja API-ја и поновног рада ваше аутоматизације.

Тестирајте пре него што пустите у погон

Свака горе наведена платформа даје вам начин да покренете једно тестно извршавање без чекања стварног окидачког догађаја:

• Zapier — користите „Test” на кораку окидача да бисте добили пример записа, а затим „Test” на радњи webhook-а да бисте покренули тачно један стваран захтев. Проверите да ли се додела појављује на вашој контролној табли пре него што укључите Zap.
• Make — покрените сценарио ручно једном (дугме „Run once”) са узорком пакета, а затим прегледајте излазни балон HTTP модула за стварно тело одговора.
• n8n — користите „Execute Node” на HTTP Request чвору са тестним улазним подацима, што вам омогућава да видите захтев и одговор директно у уређивачу.

Две ствари вреди проверити код тог првог тестног извршавања: да ли badgeId који сте тврдо кодирали заиста припада значки за коју мислите да припада (застарели ID из дуплираног Zap-а честа је грешка), и да ли поље имејла примаоца заиста повлачи стварну адресу, а не резервисано место попут {{email}} које је остало неразрешено због грешке у мапирању. Обе грешке су невидљиве у показатељу „успеха” платформе за аутоматизацију — HTTP позив ипак враћа 200 у оба случаја — па је једина поуздана провера да отворите доделу на својој контролној табли и потврдите да је прималац заиста онај кога очекујете.

Избегавање дуплих значки

Сваки од горе наведених извора окидача може се, у стварним условима, покренути више од једном за исти догађај — Stripe понавља webhook-ове код истека времена, Typeform може двоструко послати податке код спore везе, аутоматизације у Mailchimp-у могу се поново покренути ако се ознака уклони па поново дода. Ако издавање ваше значке није идемпотентно, то се претвара у примаоце који добијају исто уверење двапут, што делује немарно и ствара имејлове ка подршци.

Најчистија заштита је корак претраге пре прављења: пре POST позива на /awards, додајте радњу Search (Zapier-ов „Find Award” преко GET захтева, или еквивалентан HTTP GET у Make-у/n8n-у) према сопственим записима о доделама — једноставан Google Sheet или Airtable дневник у који исти Zap уписује одмах после успешне доделе сасвим је довољан за ово ако не желите да испитујете API због тога. Ако запис за ту комбинацију примаоца и значке већ постоји, преусмерите на радњу без ефекта уместо поновног издавања. То је додатак од пет минута, а разлика је између аутоматизације којој верујете без надзора и оне коју морате стално да пазите.

Када решења без кода нису довољна

Ови рецепти добро покривају окидаче са једним догађајем. Када издајете стотине значки из једног CSV извоза — кохорта која дипломира, листа учесника конференције, масовна обнова CE бодова — прескочите платформу за аутоматизацију и користите директно масовно отпремање значки: оно паузира и наставља усред серије и преживљава затворену картицу прегледача, нешто што петље webhook-ова без кода не подносе елегантно при великом обиму.

---

Спремни да издате своје прво проверљиво уверење? Почните бесплатно на badges.ninja — визуелни дизајнер, јавна страница за верификацију, PDF сертификат, излаз у формату Open Badge v2.0. Кредитна картица није потребна.