Gå til hovedinnhold

n8n arbeidsflyter

AI-Public kan n8n-arbeidsflyter starte via en produksjons-webhook. Dette er praktisk når du utenfor AI-Public vil starte en automatisert prosess, for eksempel opprette en oppgave, oppdatere en CRM-post, starte en rapporteringsflyt eller videresende skjemadetaljer til et annet system.

Eksempel: nyhetsartikkel på organisasjonens nettsted​

Anta at organisasjonen har laget en n8n-arbeidsflyt som publiserer en nyhetsartikkel på WordPress-nettstedet. I AI-Public fyller du da bare inn en kort tekstbit, for eksempel et par setninger om et møte, prosjekt eller offentlig kunngjøring. Med den teksten starter du arbeidsflyten i n8n.

Arbeidsflyten i n8n kan deretter for eksempel:

  1. Gjøre den korte teksten om til et hyggelig utkast ved hjelp av en LLM-nod og en prompt som passer godt til organisasjonens tone.
  2. La det lages et passende illustrasjonsbilde med en andre LLM-nod, for eksempel i husstilfarger og i en gjenkjennelig illustrativ stil.
  3. Klargjøre eller publisere teksten og bildet som blogginnlegg på WordPress-nettstedet.

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

Hva gjør denne integrasjonen?​

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

  • Har arbeidsflyten ikke felter, blir webhooken umiddelbart kjørt.
  • Har arbeidsflyten felter, åpnes først et skjema. Brukeren fyller feltene ut og starter deretter arbeidsflyten med knappen.
  • De fylt inn verdiene sendes som JSON i et POST-forespørsel til n8n webhook.
  • Uten tilbakemeldinger bekrefter AI-Public kun 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 midlertidige trinn eller slutten tilbake til AI-Public.
  • Hvis godkjenning ved registreringen er aktivert, kan brukeren gjøre et valg direkte i AI-Public. n8n fortsetter deretter fra ventetrinnet.

n8n-arbeidsflyt opprettes i AI-Public​

En administrator registrerer arbeidsflyten slik:

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

Alle tre tilbakemeldingsalternativene står som standard av. Hvis du senere legger til callbacks eller et godkjenningssteg i n8n, oppdater også registreringen i AI-Public. Dialogen vet da om den bare skal vise en startbekreftelse eller vente på ytterligere signaler.

Felter​

  • Felter er valgfri.
  • Hvert felt har ett feltnavn og en type.
  • Støttede felttyper er kort tekst, lang tekst, tall, ja/nei, dato, ett valg og flere valg.
  • Under Én valg og Flere valg legger du til tilgjengelige alternativer. Én valg vises som en kompakt nedtrekksliste; Flere valg viser avkrysningsbokser. Valget som tas sendes i JSON-kroppen.
  • Obligatoriske felter må fylles ut før arbeidsflyten kan startes.
  • FELTNAVNET blir nøkkelen i JSON-kroppen som sendes til n8n.

Kompatibel arbeidsflyt laget i n8n​

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

Mottatte data ligger under body; tekniske integrasjonsdata ligger under body.integration. Ikke fjern dette i en Edit Fields-, Set- eller Code-node.

Eksempel på JSON-body​

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

{
  "prompt": "Lag en kort oppsummering av forespørselen.",
  "kundename": "Eksempelorganisasjon",
  "målgrupper": ["innbyggere", "ansatte"],
  "dato": "2026-09-22",
  "integration": {
    "runId": "chat-document-id",
    "tenant": "default",
    "callbackUrl": "https://europe-west1-ai-public-pro.cloudfunctions.net/n8nWorkflowCallback",
    "callbackToken": "midlertidig-token-for-denne-utførelsen"
  }
}

Tilbakemeldings-tokenet gjelder for hver utførelse. Ikke lagre det i logger, faste konfigurasjoner eller andre systemer.

Valgfritt: sende fremdrift og ferdigstillelse tilbake​

AI-Public kan kun vise hva n8n returnerer. Bruk disse callbacksene kun hvis du i registreringen har aktivert Melde mellomliggende fremdrift og/eller Melde slutt på arbeidsflyten.

Konfigurer hver callback-node slik:

  1. Velg Method: POST.

  2. Klikk på URL på 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 starter:

{
  "tenant": "{{ $('Start workflow').first().json.body.integration.tenant }}",
  "runId": "{{ $('Start workflow').first().json.body.integration.runId }}",
  "eventId": "document-maken-startet",
  "type": "progress",
  "executionId": "{{ $execution.id }}",
  "step": {
    "id": "document_maken",
    "label": "Dokument laget"
  },
  "message": "Dokumentet blir laget."
}
  • Bruk en unik eventId for hver hendelse innen samme utførelse.
  • Bruk en tydelig norsk step.label; denne teksten vises i appen.
  • Hvis du har aktivert Melde slutt på arbeidsflyten, send alltid type: "completed", type: "failed" eller type: "rejected" mot slutten.
  • Legg ved et eventuelt output-objekt med resultatet ved completed.
  • Send ved failed en forståelig feilmelding. Utførelsen stopper 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 inn Wait-noden på Resume: On Webhook Call, HTTP Method: POST og Authentication: Header Auth. Velg samme Header Auth-credential som ved Start workflow. Legg etter Wait-noden til 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": "Kontrollere dokument"
  },
  "approval": {
    "question": " Skal arbeidsflyten fortsette?",
    "context": "Kontroller først det genererte dokumentet.",
    "resumeUrl": "{{ $execution.resumeUrl }}",
    "choices": [
      { "value": "approve", "label": " Godkjenn" },
      { "value": "reject", "label": " Avslå" }
    ]
  }
}

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

Et valgverdi kan bare inneholde bokstaver, tall, _ og -. Et label kan inneholde ren lesbar tekst.

Produksjons callback-url å sette opp​

Produksjons callback-url for AI-Public er:

https://europe-west1-ai-public-pro.cloudfunctions.net/n8nWorkflowCallback

Lim ikke inn denne URL-en som fast tekst i alle callback-noder. Velg i URL-feltet til HTTP Request-noden Expression og bruk:

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

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

Kallbare funksjoner triggerCustomN8nWorkflow, triggerN8nWorkflow og resumeN8nWorkflow blir kalt av appen selv. Disse URL-ene trenger du ikke å konfigurere i n8n.

Feilhåndtering​

Send forventede feil tilbake med en callback av typen failed. Lag også en sentral Error Workflow for uforutsette 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 ved URL denne faste produksjons-URL-en:

    https://europe-west1-ai-public-pro.cloudfunctions.net/n8nWorkflowExecutionFailed

  4. Velg Authentication: None og legg til headeren n8n-handihow-name med standard hemmelige verdi fra plattformadministratoren.

  5. Velg en JSON-body og lim inn:

{
  "executionId": "{{ $json.execution.id }}",
  "workflowId": "{{ $json.workflow.id }}",
  "workflowName": "{{ $json.workflow.name }}",
  "lastNode": "{{ $json.execution.lastNodeExecuted }}",
  "message": "{{ $json.execution.error.message }}"
}
  1. Aktiver Error-Workflow.
  2. Åpne innstillingene for den vanlige arbeidsflyten og velg denne som Error Workflow.

Send umiddelbart etter Start workflow minst én callback med executionId: "{{ $execution.id }}". Bare da kan AI-Public koble en uventet feil til riktig utførelse.

Viktige begrensninger​

  • Bare webhook-triggere støttes.
  • Bare produksjons-webhook-URL-er støttes.
  • Test-webhook-URL-er med /webhook-test/ blir avvist.
  • Bare POST støttes.
  • Bare generisk header authentication støttes.
  • Header-verdien behandles som hemmelig i applikasjonen.
  • Callback-tokens og resume-url-er håndteres kun server-side og er ikke direkte tilgjengelige for brukere.
  • Leietaker bestemmes server-side ut fra innlogget bruker, ikke ut fra en verdi som nettleseren sender.

Problemløsning​

  • 404 eller webhook ikke registrert: aktiver arbeidsflyten i n8n og bruk produksjons-URL-en.
  • Autentiseringsfeil: sjekk at header-navn og verdi er identiske i begge systemer.
  • Mangel på data: sjekk at feltnavnene i applikasjonen samsvarer med nøklene som n8n forventer.
  • Ingen forespørsel i n8n: sjekk at arbeidsflyten starter med en webhook-trigger og bruker POST.
  • Kjørselsvinduet løper rundt: hvis du har aktivert Melde slutt på arbeidsflyten, sjekk om n8n sender en siste completed, failed eller rejected callback. Hvis du ikke forventer tilbakemeldinger, slå alle tre alternativene i registreringen av.
  • Ingen fremdrift synlig: sjekk om Melde mellomliggende fremdrift er aktiv i registreringen, eller at integration-objektet beholdes og at hver callback har unik eventId.
  • Godkjenningsknapper fungerer ikke: sjekk Wait-noden, resumeUrl, header authentication og tillatt tegn i choices[].value.
WhatsApp