n8n-workflows

AI-Corporate kan n8n-workflows starte via en produktions-webhook. Dette er nyttigt, når du uden for AI-Corporate vil starte en automatiseret proces, for eksempel oprettelse af en opgave, opdatering af en CRM-post, igangsættelse af en rapporteringsflow eller videresendelse af formularoplysninger til et andet system.

Eksempel: nyhedsartikel på virksomhedens hjemmeside

Antag at organisationen har lavet en n8n-workflow, der publicerer en nyhedsartikel på virksomhedens WordPress-hjemmeside. I AI-Corporate indtaster du så kun et kort tekststykke, for eksempel et par sætninger om en kundecase, begivenhed eller intern milepæl. Med den tekst starter du workflowet i n8n.

n8n-workflowet kan derefter for eksempel:

Tage den korte tekst og lave en pæn, concept-tekst ved hjælp af en LLM-node og en prompt, der passer godt til organisationens tone.
Få lavet en passende illustration med en anden LLM-node, for eksempel i brandfarverne og i en genkendelig illustrativ stil.
Forberede eller publicere teksten og billedet som blogindlæg på WordPress-hjemmesiden.

Sådan arbejder AI-Corporate og n8n sammen: i AI-Corporate vælger brugeren workflowet og indtaster de nødvendige oplysninger. n8n udfører herefter de automatiserede trin og sørger for, at nyhedsartiklen kommer pænt ud på hjemmesiden.

Hvad gør denne integration?

Du starter en n8n-workflow fra workflow-oversigten. Kun produktions-webhooken, POST og Header Auth er obligatoriske. Felter og tilbagemeldinger fra n8n er valgfrie og kan konfigureres uafhængigt af hinanden.

Har workflowet ingen felter, bliver webhooken kaldt med det samme.
Har workflowet felter, åbnes først en formular. Brugeren indtaster felterne og starter derefter workflowet med knappen.
De indtastede værdier sendes som JSON i en POST-anmodning til n8n-webhooken.
Uden tilbagemeldinger bekræfter AI-Corporate kun, at workflowet er startet og kører videre i n8n. Vinduet viser ingen spinner og kan lukkes med det samme.
Hvis dette er aktiveret ved registreringen, kan workflowet sende mellemtrin eller slutningen tilbage til AI-Corporate.
Hvis godkendelse ved registreringen er aktiveret, kan brugeren vælge direkte i AI-Corporate. n8n fortsætter herefter fra den ventende trin.

Oprettelse af n8n-workflow i AI-Corporate

En administrator registrerer workflowet som følger:

Gå til Assistenter.
Åbn Workflows.
Vælg Ny n8n-workflow.
Indtast navnet på workflowet og n8n-produktions-URL'en.
Indstil Header authentication med en header-navn og hemmelig header-værdi.
Kryds af under Retourmeldinger fra n8n kun de dele, der faktisk er bygget i denne n8n-workflow: fremskridt, godkendelse og/eller workflowens slutning.
Tilføj eventuelt felter, der skal sendes i POST-requesten.
Gem workflowet.

Alle tre tilbagemeldingsmuligheder er slået fra som standard. Hvis du senere tilføjer callbacks eller en godkendelsestrin i n8n, opdater da registreringen i AI-Corporate. Dialogen ved operatøren ved derfor, om den kun skal vise en startbekræftelse, eller om den skal vente på yderligere signaler.

Felter

Felter er valgfri.
Hvert felt har én feltnavn og én type.
Understøttede felttyper er kort tekst, lang tekst, tal, ja/nej, dato, ét valg og multiple valg.
Ved Én mulighed og Flere muligheder tilføjes de tilgængelige valgmuligheder. Én mulighed vises som kompakt valgliste; Flere muligheder viser afkrydsningsfelter. Den valgte værdi eller værdier sendes i JSON-kroppen.
Obligatoriske felter skal udfyldes, før workflowet kan startes.
Feltnavnet bliver nøglen i JSON-kroppen, der sendes til n8n.

Kompatibelt workflow i n8n

Lav i n8n en ny workflow.
Tilføj som første node en Webhook.
Giv denne node nøjagtigt navnet Start workflow. Eksempeludtrykene nedenfor bruger dette navn.
Indstil HTTP Method til POST.
Vælg Authentication: Header Auth og brug samme header-navn og hemmelige værdi som i AI-Corporate.
Indstil Respond eller Response Mode til Immediately.
Kopier Production URL til feltet n8n production-url i AI-Corporate. Brug ikke test-URL'en med /webhook-test/.
Aktiver workflowet.

De modtagne data fremgår under body; de tekniske integrationoplysninger fremgår under body.integration. Slet dem ikke i en Edit Fields-, Set- eller Code-node.

Eksempel på JSON-body

Hvis du definerer felter med navnene prompt, kundename, målgrupper og dato, modtager n8n f.eks. denne JSON-body. AI-Corporate tilføjer automatisk integration-objektet.

{
  "prompt": "Lav et kort resume af anmodningen.",
  "kundename": "Eksempelorganisation",
  "målgrupper": ["medarbejdere", "kunder"],
  "dato": "2026-09-22",
  "integration": {
    "runId": "chat-dokument-id",
    "tenant": "default",
    "callbackUrl": "https://europe-west1-ai-corporate.cloudfunctions.net/n8nWorkflowCallback",
    "callbackToken": "midlertidig-token-for-denne-udførelse"
  }
}

Callback-tokenet hører til én udførelse. Gem det ikke i logs, faste konfigurationer eller andre systemer.

Valgfrit: fremskridt og afslutning tilbage

AI-Corporate kan kun vise, hvad n8n returnerer. Brug disse callbacks kun, hvis du ved registreringen har aktiveret Undervejs fremskridt meldes og/eller Workflowens afslutning meldes.

Opsæt hver callback-node således:

Vælg Method: POST.

Klik på URL under Expression og indsæt:

{{ $('Start workflow').first().json.body.integration.callbackUrl }}

Vælg Authentication: None.
Slå Send Headers til og tilføj nedenstående headers.
Slå Send Body til og vælg Body Content Type: JSON og Specify Body: Using JSON.

Brug disse headers:

Authorization: Bearer {{ $('Start workflow').first().json.body.integration.callbackToken }}
Content-Type: application/json

Send f.eks. denne meddelelse, når et trin begynder:

{
  "tenant": "{{ $('Start workflow').first().json.body.integration.tenant }}",
  "runId": "{{ $('Start workflow').first().json.body.integration.runId }}",
  "eventId": "dokument-tilvirkning-startet",
  "type": "progress",
  "executionId": "{{ $execution.id }}",
  "step": {
    "id": "dokument_tilvirkning",
    "label": "Dokument laves"
  },
  "message": "Dokumentet bliver lavet."
}

Brug en unik eventId for hver begivenhed inden for samme udførelse.
Brug en tydelig dansk step.label; denne tekst vises i appen.
Hvis du har aktiveret “Meld workflowens afslutning”, så send altid type: "completed", type: "failed" eller type: "rejected" ved afslutningen.
Tilføj eventuelt en output-objekt med resultatet ved completed.
Ved failed skal du sende en forståelig fejlmeddelelse. Udførelsen stopper også i appen.

Valgfrit: godkendelse i appen

Brug en n8n Wait-node med On Webhook Call, når workflowet først må fortsætte efter et valg. Send før Wait-noden en callback med type: "approval_required":

Indstil Wait-noden til Resume: On Webhook Call, HTTP Method: POST og Authentication: Header Auth. Vælg samme Header Auth-kreditential som ved Start workflow. Tilføj efter Wait-noden en Switch-node og kontroller i den {{ $json.body.decision }}.

{
  "tenant": "{{ $('Start workflow').first().json.body.integration.tenant }}",
  "runId": "{{ $('Start workflow').first().json.body.integration.runId }}",
  "eventId": "kontrol-dokument",
  "type": "approval_required",
  "executionId": "{{ $execution.id }}",
  "step": {
    "id": "kontrol_dokument",
    "label": "Dokument kontrol"
  },
  "approval": {
    "question": "Må workflowet fortsætte?",
    "context": "Kontroller først det genererede dokument.",
    "resumeUrl": "{{ $execution.resumeUrl }}",
    "choices": [
      { "value": "approve", "label": "Godkend" },
      { "value": "reject", "label": "Afvis" }
    ]
  }
}

Brugeren ser valgene i udførelsesvinduet. Efter et valg modtager Wait-noden blandt andet decision. Brug derefter for eksempel en Switch-node til at bestemme den korrekte videre handling.

Et valg kan kun indeholde bogstaver, tal, _ og -. Labelen må gerne være almindelig læsbar tekst.

Produktions callback-url indstilling

Produktions callback-url for AI-Corporate er:

https://europe-west1-ai-corporate.cloudfunctions.net/n8nWorkflowCallback

Indsæt ikke denne URL som fast tekst i hver callback-node. Vælg i URL-feltet for HTTP Request-noden Expression og brug:

{{ $('Start workflow').first().json.body.integration.callbackUrl }}

AI-Corporate leverer dermed ved hver start automatisk den rette produktions-URL. Den faste URL ovenfor bruger du til at teste og sikre, at udtrykket henviser til AI-Corporate og ikke til AI-School eller AI-Public.

De kaldbare funktioner triggerCustomN8nWorkflow, triggerN8nWorkflow og resumeN8nWorkflow kaldes af appen selv. Disse URLs skal du ikke konfigurere i n8n.

Håndtering af fejl

Returner forventede fejl med en callback af typen failed. Opret også en central Error Workflow til uventede nodefejl:

Lav en ny workflow med en Error Trigger-node.
Tilføj derefter en HTTP Request-node med Method: POST.

Angiv ved URL denne faste produktions-URL:

https://europe-west1-ai-corporate.cloudfunctions.net/n8nWorkflowExecutionFailed

Vælg Authentication: None og tilføj headeren n8n-handihow-name sammen med den hemmelige standardværdi fra platformadministratoren.
Vælg en JSON-krop og indsæt:

{
  "executionId": "{{ $json.execution.id }}",
  "workflowId": "{{ $json.workflow.id }}",
  "workflowName": "{{ $json.workflow.name }}",
  "lastNode": "{{ $json.execution.lastNodeExecuted }}",
  "message": "{{ $json.execution.error.message }}"
}

Aktiver Error Workflow.
Åbn indstillingerne for den almindelige workflow og vælg denne som Error Workflow.

Send straks efter Start workflow mindst én callback med executionId: "{{ $execution.id }}". Kun da kan AI-Corporate koble en uventet fejl til den korrekte udførelse.

Vigtige begrænsninger

Kun webhook-udløser understøttes.
Kun produktions-webhook-URLs understøttes.
Test-webhook-URLs med /webhook-test/ afvises.
Kun POST understøttes.
Kun generic header authentication understøttes.
Header-værdien behandles som hemmelig i applikationen.
Callback-tokens og resume-URL'er behandles kun server-side og er ikke direkte tilgængelige for brugere.
Tenant bestemmes server-side ud fra den loginede bruger, ikke ud fra en værdi browseren sender med.

Problemløsning

404 eller webhook ikke registreret: aktiver workflowet i n8n og brug produktions-URL'en.
Autorisationsfejl: kontroller, at header-navn og værdi er helt identiske i begge systemer.
Mangel på data: kontroller, at feltnavnene i applikationen svarer til n8n's nøgler.
Ingen request i n8n: kontroller, at workflowet starter med en webhook-trigger og bruger POST.
Udførelsesvinduet bliver ved med at køre: har du aktiveret Meld workflowens afslutning, kontroller da, om n8n sender en sidste completed, failed eller rejected callback. Hvis du ikke forventer tilbagemeldinger, deaktiver alle tre muligheder ved registreringen.
Ingen fremskridt synligt: kontroller, om Undervejs fremskridt meldes ved registreringen er slået til, eller at integration-objektet beholdes, og at hver callback har en unik eventId.
Godkendelsesknapper virker ikke: kontroller Wait-noden, resumeUrl, header authentication og tilladte tegn i choices[].value.

Eksempel: nyhedsartikel på virksomhedens hjemmeside​

Hvad gør denne integration?​

Oprettelse af n8n-workflow i AI-Corporate​

Felter​

Kompatibelt workflow i n8n​

Eksempel på JSON-body​

Valgfrit: fremskridt og afslutning tilbage​

Valgfrit: godkendelse i appen​

Produktions callback-url indstilling​

Håndtering af fejl​

Vigtige begrænsninger​

Problemløsning​