n8n arbeidsflyter

AI-Corporate kan n8n-arbeidsflyter starte via en produksjons-webhook. Dette er praktisk når du utenfor AI-Corporate ønsker å starte en automatisert prosess, for eksempel å opprette en oppgave, oppdatere en CRM-post, starte en rapportsdrift eller overføre skjemadata til et annet system.

Eksempel: nyhetsartikkel på bedriftsnettstedet

Anta at organisasjonen har laget en n8n-arbeidsflyt som publiserer en nyhetsartikkel på bedriftens WordPress-nettsted. I AI-Corporate fyller du da bare inn en kort tekst, for eksempel et par setninger om en kundehistorie, arrangement eller intern milepæl. Med den teksten starter du arbeidsflyten i n8n.

n8n-arbeidsflyten kan deretter gjøre for eksempel:

1. Gjøre den korte teksten om til en flott konsepttekst med en LLM-node og en prompt som passer tone til organisasjonen.
2. Lage et passende illustrasjonsbilde med en andre LLM-node, for eksempel i merkevarens farger og i en gjenkjennelig illustrativ stil.
3. Gjøre teksten og bildet klare for blogginnlegg eller publisere på WordPress-nettstedet.

Slik fungerer AI-Corporate og n8n sammen: i AI-Corporate velger brukeren arbeidsflyten og fyller inn nødvendig informasjon. n8n utfører deretter de automatiserte trinnene og sørger for at nyhetsartikkelen kommer pent på nettstedet.

Hva gjør denne integrasjonen?

Du starter en n8n-arbeidsflyt fra arbeidsflytoversikten. Kun produksjons-webhook, POST og Header Auth er obligatorisk. Felt og tilbakemeldinger fra n8n er valgfritt og kan konfigureres uavhengig av hverandre.

• Hvis arbeidsflyten ikke har felter, blir webhooken umiddelbart kalt opp.
• Hvis arbeidsflyten har felter, åpnes først et skjema. Brukeren fyller ut feltene og starter deretter arbeidsflyten med knappen.
• De utfylte verdiene sendes som JSON i en POST-forespørsel til n8n-webhooken.
• Uten tilbakemeldinger bekrefter AI-Corporate bare at arbeidsflyten er startet og fortsetter i n8n. Vinduet viser ingen spinner og kan lukkes umiddelbart.
• Hvis dette er aktivert ved registreringen, kan arbeidsflyten sende mellomliggende trinn eller slutten tilbake til AI-Corporate.
• Hvis godkjenning er aktivert ved registreringen, kan brukeren velge direkte i AI-Corporate. n8n fortsetter deretter fra ventende trinn.

Opprette n8n-arbeidsflyt i AI-Corporate

En administrator registrerer arbeidsflyten slik:

1. Gå til Assistenter.
2. Åpne Arbeidsflyter.
3. Velg Ny n8n-arbeidsflyt.
4. Skriv inn navn på arbeidsflyten og n8n produksjons-URL.
5. Still inn Header authentication med et header-navn og hemmelig header-verdi.
6. Under Tilbakemeldinger fra n8n merk kun delene som faktisk er bygget i denne n8n-arbeidsflyten: fremdrift, godkjenning og/eller slutten av arbeidsflyten.
7. Legg eventuelt til feltene som skal sendes i POST-forespørselen.
8. Lagre arbeidsflyten.

Alle tre tilbakemeldingsalternativene er avaktiverte som standard. Hvis du senere setter inn callbacks eller et godkjenningssteg i n8n, oppdater registreringen i AI-Corporate. Dialogen vet dermed om den bare skal vise en startbekreftelse eller vente på videre signaler.

Felter

• Felter er valgfritt.
• Hvert felt har et feltnavn og en type.
• Støttede felttyper er kort tekst, lang tekst, tall, ja/nei, dato, ett valg og flere valg.
• Ved Étt valg og Flere valg legger du til de tilgjengelige alternativene. Étt valg vises som en kompakt rullegardin; Flere valg viser avkrysningsfelt. Valgte verdi(er) sendes i JSON-kroppen.
• Obligatoriske felter må fylles ut før arbeidsflyten kan startes.
• Felt-namnet blir nøkkelen i JSON-kroppen som sendes til n8n.

Kompatibel arbeidsflyt i n8n

1. Lag en ny arbeidsflyt i n8n.
2. Legg som første node til en Webhook.
3. Gi denne noden nøyaktig navnet Start workflow. Eksempeluttrykkene nedenfor bruker dette navnet.
4. Sett HTTP Method til POST.
5. Velg Authentication: Header Auth og bruk samme header-navn og hemmelige verdi som i AI-Corporate.
6. Sett Respond eller Response Mode til Immediately.
7. Lim inn Production URL i feltet n8n produksjons-url i AI-Corporate. Ikke bruk test-URL-en med /webhook-test/.
8. Aktiver arbeidsflyten.

De mottatte dataene ligger under body; de tekniske integrasjonsdataene ligger under body.integration. Ikke fjern det i en Rediger Felt-, Sett- eller Kode-node.

Eksempel på JSON-body

Hvis du definerer felter med navnene prompt, kundeNavn, målgrupper og dato, mottar n8n for eksempel denne JSON-bodyen. AI-Corporate legger til integration-objektet automatisk.

{
  "prompt": "Lag en kort oppsummering av forespørselen.",
  "kundeNavn": "Eksempelorganisasjon",
  "målgrupper": ["ansatte", "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-dennekjøringen"
  }
}

Callback-tokenet hører til én kjøring. Ikke lagre det i logger, faste konfigurasjoner eller andre systemer.

Valgfritt: Rückmeldinger om fremdrift og avslutning

AI-Corporate kan bare vise hva n8n tilbakemelder. Bruk disse callbacks bare hvis du ved registreringen har aktivert Meld mellomliggende fremdrift og/eller Meld slutt på arbeidsflyten.

Still inn hver callback-node slik:

1. Velg Method: POST.

2. Klikk på URL under Expression og lim inn:

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

3. Velg Authentication: None.

4. Slå på Send Headers og legg til følgende headers.

5. Slå på Send Body og velg Body Content Type: JSON og Specify Body: Using JSON.

Bruk disse headerne:

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

Send for eksempel denne meldingen når et trinn begynner:

{
  "tenant": "{{ $('Start workflow').first().json.body.integration.tenant }}",
  "runId": "{{ $('Start workflow').first().json.body.integration.runId }}",
  "eventId": "document-lage-startet",
  "type": "progress",
  "executionId": "{{ $execution.id }}",
  "step": {
    "id": "document_lage",
    "label": "Dokument lage"
  },
  "message": "Dokumentet blir laget."
}

• Bruk en unik eventId for hver hendelse innen samme kjøring.
• Bruk et tydelig norsk step.label; denne teksten vises i appen.
• Har du aktivert Meld slutt på arbeidsflyten, send da alltid ved slutten type: "completed", type: "failed" eller type: "rejected".
• Legg ved et eventuelt output-objekt med resultatet ved completed.
• Send ved failed en forståelig feilmelding. Utførelsen stopper da også i appen.

Valgfritt: godkjenning i appen

Bruk en n8n Wait-node med On Webhook Call når arbeidsflyten først kan fortsette etter et valg. Send før Wait-noden en callback med type: "approval_required":

Still Wait-noden inn på Resume: On Webhook Call, HTTP Method: POST og Authentication: Header Auth. Velg samme Header Auth-legitimasjon som ved Start workflow. Legg til etter Wait-noden en Switch-node og kontroller der {{ $json.body.decision }}.

{
  "tenant": "{{ $('Start workflow').first().json.body.integration.tenant }}",
  "runId": "{{ $('Start workflow').first().json.body.integration.runId }}",
  "eventId": "kontroll-dokument",
  "type": "approval_required",
  "executionId": "{{ $execution.id }}",
  "step": {
    "id": "kontroll_dokument",
    "label": "Dokument kontrollere"
  },
  "approval": {
    "question": "Skal arbeidsflyten fortsette?",
    "context": "Kontroller først det genererte dokumentet.",
    "resumeUrl": "{{ $execution.resumeUrl }}",
    "choices": [
      { "value": "approve", "label": "Godkjenne" },
      { "value": "reject", "label": "Forkaste" }
    ]
  }
}

Brukeren ser valgene i kjøre-vinduet. Etter et valg mottar Wait-noden blant annet decision. Bruk deretter for eksempel en Switch-node for å bestemme riktig fortsettelse.

Et valgalternativ må kun inneholde bokstaver, tall, _ og -. Et label kan inneholde vanlig lesbar tekst.

Produktions callback-url innstilling

Produktions callback-url for AI-Corporate er:

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

Lim inn ikke denne URL-en som fast tekst i hver callback-node. Velg i URL-feltet for HTTP Request-noden Expression og bruk:

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

AI-Corporate leverer dermed ved hver start automatisk riktig produksjons-url. Den faste URL-en ovenfor bruker du for å sjekke under testing at uttrykket peker til AI-Corporate og ikke til AI-School eller AI-Public.

De kallbare triggerCustomN8nWorkflow, triggerN8nWorkflow og resumeN8nWorkflow blir kalt av selve appen. Du trenger ikke å konfigurere disse URL-ene i n8n.

Feilhåndtering

Send forventede feil tilbake med en callback av typen failed. Opprett også en sentral Error-arbeidsflyt for uventede node-feil:

1. Lag en ny arbeidsflyt med en Error Trigger-node.

2. Legg deretter til en HTTP Request-node med Method: POST.

3. Fyll inn i URL denne faste produksjons-URL-en:

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

4. Velg Authentication: None og legg til headeren n8n-handihow-name med den hemmelige standardverdien til plattformadministratoren.

5. Velg en JSON-kropp og lim inn:

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

6. Aktiver Error-arbeidsflyten.
7. Åpne innstillingene til den vanlige arbeidsflyten og velg denne under Error Workflow.

Send umiddelbart etter Start workflow minst én callback med executionId: "{{ $execution.id }}". Først da kan AI-Corporate koble en uventet feil til riktig kjøring.

Viktige begrensninger

• Kun webhook-utløsere støttes.
• Kun produksjons-webhook-URL-er støttes.
• Test-webhook-URL-er med /webhook-test/ avvises.
• Kun POST støttes.
• Kun generell header authentication støttes.
• Header-verdien behandles som hemmelig i applikasjonen.
• Callback-tokens og resume-url-er behandles kun server-side og er ikke direkte tilgjengelige for brukere.
• Tenant bestemmes server-side fra innlogget bruker, ikke fra en verdi som nettleseren sender.

Problemløsning

• 404 eller webhook ikke registrert: aktiver arbeidsflyten i n8n og bruk produksjons-URL-en.
• Autentiseringsfeil: kontroller at header-navn og verdi er identiske i begge systemene.
• Manglende data: kontroller at feltnavnene i applikasjonen samsvarer med nøklene som n8n forventer.
• Ingen forespørsel i n8n: kontroller at arbeidsflyten begynner med en webhook-trigg og bruker POST.
• Kjøre-vinduet fortsetter å kjøre: hvis du har aktivert Meld slutt på arbeidsflyten, kontroller da om n8n sender en siste completed, failed eller rejected-callback. Hvis du ikke venter tilbakemeldinger, slå av alle tre alternativene ved registrering.
• Ingen synlig fremdrift: kontroller at Meld mellomliggende fremdrift er aktivert ved registrering, eller at integration-objektet beholdes og at hver callback har unik eventId.
• Godkjenningsknapper fungerer ikke: kontroller Wait-noden, resumeUrl, header authentication og tillatte tegn i choices[].value.