Steg 2: Anslut VerifiEmail och validera indata

Validera mottagarens e-postadress och säkerställ att obligatoriska fält finns innan certifikatet genereras.

1. Lägg till Validate Email Address och ställ in Email till ={{ $json.body.email }}.
2. Autentisering krävs: Anslut era verifiEmailApi-uppgifter till Validate Email Address.
3. Konfigurera Validation Branch med följande villkor (kombinator and): ={{ $('Incoming Certificate Hook').item.json.body.name }} är inte tomt, ={{ $('Incoming Certificate Hook').item.json.body.course }} är inte tomt, ={{ $('Incoming Certificate Hook').item.json.body.date }} är inte tomt och ={{ $json.valid }} är true.
4. Koppla true-output från Validation Branch till Merge Request Data, och false-output till Abort with Error.
5. Ställ in Abort with Error Error Message till ="Missing required fields: name, course, date, or valid email".

Steg 3: Sätt upp databehandling och rendering för certifikat

Slå ihop förfrågningsdata, bygg HTML-certifikatet och rendera det till en bild för e-postleverans.

1. I Merge Request Data behåll den medföljande JavaScript-koden för att slå ihop webhook-data med resultaten från e-postvalideringen. Den här noden hämtar från Incoming Certificate Hook och använder standardvärden som Program Director för instruktör.
2. I Build Certificate HTML behåll JavaScript-mallen som genererar ett komplett HTML-certifikat och formaterar datumet.
3. Lägg till Render HTML to Image och ställ in HTML Content till ={{ $json.html }}.
4. Autentisering krävs: Anslut era htmlcsstoimgApi-uppgifter till Render HTML to Image.

Steg 4: Konfigurera e-postleverans och loggning

Skicka certifikatmejlet och logga leveransdetaljerna i Google Sheets.

1. I Dispatch Certificate Email ställ in Send To till ={{ $('Merge Request Data').item.json.email }}.
2. Ställ in Subject till 🎓 Congratulations! Your Certificate of Completion och behåll HTML-e-postmallen i Message (den använder uttryck som {{ $('Build Certificate HTML').item.json.name }} och {{ $json.image_url }}).
3. Autentisering krävs: Anslut era gmailOAuth2-uppgifter till Dispatch Certificate Email.
4. I Record to Sheets ställ in Operation till appendOrUpdate och mappa kolumnerna exakt som konfigurerat, inklusive Email ={{ $('Build Certificate HTML').item.json.email }}, Certificate URL ={{ $('Render HTML to Image').item.json.image_url }} och Generated At ={{ $now.toISO() }}.
5. Autentisering krävs: Anslut era googleSheetsOAuth2Api-uppgifter till Record to Sheets.

Steg 5: Lägg till felhantering och aviseringar

Fånga upp arbetsflödesfel och skicka aviseringar för övervakning.

1. Säkerställ att Workflow Error Trigger är kopplad till Assemble Error Report för att formatera detaljerad felinformation.
2. Behåll JavaScript-koden i Assemble Error Report för att inkludera felmeddelande, nodnamn, exekverings-ID och användardetaljer.
3. Konfigurera Post Slack Alert med den medföljande meddelandemallen som använder uttryck som {{ $json.errorMessage }} och {{ $json.workflowName }}.
4. Autentisering krävs: Anslut era Slack-uppgifter i Post Slack Alert (den här noden har för närvarande inga autentiseringsuppgifter konfigurerade).
5. Aktivera Post Slack Alert om ni vill att aviseringar ska skickas (noden är inaktiverad som standard).

Steg 6: Testa och aktivera ert arbetsflöde

Verifiera end-to-end-körning innan ni slår på arbetsflödet.

1. Klicka på Execute Workflow och skicka en POST-förfrågan till test-URL:en för Incoming Certificate Hook med giltiga JSON-data.
2. Bekräfta att flödet körs från Validate Email Address → Validation Branch → Merge Request Data → Build Certificate HTML → Render HTML to Image → Dispatch Certificate Email → Record to Sheets.
3. Kontrollera att mottagaren får mejlet med en giltig nedladdningslänk för image_url och att en ny rad visas i Google Sheet.
4. Trigga ett fel (t.ex. utelämna email) för att verifiera Abort with Error och fel-flödet som använder Workflow Error Trigger och Post Slack Alert.
5. Växla arbetsflödet till Active när testerna passerar för produktionsbruk.