Gå till huvudinnehållet

n8n arbetsflöden

AI-Corporate kan starta n8n-arbetsflöden via en produktions-webhook. Detta är praktiskt när du vill starta en automatiserad process utanför AI-Corporate, till exempel skapa en uppgift, uppdatera en CRM-post, starta en rapporteringsflöde eller överföra formulärdata till ett annat system.

Exempel: nyhetsartikel på företagswebbplatsen

Anta att organisationen har skapat ett n8n-arbetsflöde som publicerar en nyhetsartikel på företagets WordPress-webbplats. I AI-Corporate fyller du då bara i en kort textbit, till exempel några meningar om en kundcase, evenemang eller intern milstolpe. Med den texten startar du arbetsflödet i n8n.

Arbetsflödet i n8n kan sedan till exempel:

  1. Göra en snygg sammanfattning av den korta texten med en LLM-nod och en prompt som passar organisationens ton.
  2. Skapa en lämplig illustration med en andra LLM-nod, till exempel i varumärkets färger och i en igenkännbar illustrativ stil.
  3. Förbereda eller publicera text och bild som ett blogginlägg på WordPress-webbplatsen.

Så fungerar AI-Corporate och n8n tillsammans: i AI-Corporate väljer användaren arbetsflödet och fyller i nödvändig information. n8n utför sedan de automatiserade stegen och ser till att nyhetsartikeln hamnar snyggt på webbplatsen.

Vad gör denna integration?

Du startar ett n8n-arbetsflöde från arbetsflödesöversikten. Endast produktions-webhook, POST och Header Auth är obligatoriska. Fält och återkopplingar från n8n är valfria och kan konfigureras oberoende av varandra.

  • Om arbetsflödet inte har några fält anropas webhooken direkt.
  • Om arbetsflödet har fält öppnas först ett formulär. Användaren fyller i fälten och startar sedan arbetsflödet med knappen.
  • De ifyllda värdena skickas som JSON i ett POST-request till n8n-webhooken.
  • Utan återkopplingar bekräftar AI-Corporate bara att arbetsflödet har startat och fortsätter i n8n. Fönstret visar ingen spinner och kan stängas direkt.
  • Om detta har aktiverats i registreringen kan arbetsflödet skicka tillbaka mellanhandens steg eller slutet till AI-Corporate.
  • Om godkännande har aktiverats i registreringen kan användaren göra ett val direkt i AI-Corporate. Därefter fortsätter n8n från det väntande steget.

Skapa n8n-arbetsflöde i AI-Corporate

En administratör registrerar arbetsflödet så här:

  1. Gå till Assistenten.
  2. Öppna Arbetsflöden.
  3. Välj Nytt n8n-arbetsflöde.
  4. Ange namnet på arbetsflödet och n8n-produktions-URL.
  5. Konfigurera Header authentication med ett header-namn och hemligt header-värde.
  6. I avsnittet Återkopplingar från n8n markera endast delarna som verkligen byggts i detta n8n-arbetsflöde: framsteg, godkännande och/eller slutet av arbetsflödet.
  7. Lägg eventuellt till de fält som ska skickas i POST-request.
  8. Spara arbetsflödet.

Alla tre återkopplingsalternativ är avstängda som standard. Om du senare lägger till callbacks eller ett godkännandasteg i n8n, uppdatera även registreringen i AI-Corporate. Dialogrutan vet då om den bara ska visa en startbekräftelse eller om den ska vänta på vidare signaler.

Fält

  • Fält är valfria.
  • Varje fält har ett fältnamn och en typ.
  • Stödda fält-typer är kort text, lång text, tal, ja/nej, datum, en-val och flera-val.
  • För En val och Flera val lägger du till tillgängliga alternativ. En val visas som en kompakt urvalsliste; Flera val visar kryssrutor. Det valda värdet eller värdena skickas i JSON-kroppen.
  • Obligatoriska fält måste fyllas i innan arbetsflödet kan startas.
  • Fältnamnet blir nyckeln i JSON-kroppen som skickas till n8n.

Kompatibelt arbetsflöde i n8n

  1. Skapa ett nytt arbetsflöde i n8n.
  2. Lägg till första noden en Webhook.
  3. Ge den exakt namnet Start workflow. Exempelkonstruktionerna nedan använder detta namn.
  4. Ställ in HTTP MethodPOST.
  5. Välj Authentication: Header Auth och använd samma header-namn och hemliga värde som i AI-Corporate.
  6. Ställ in Respond eller Response Mode till Immediately.
  7. Kopiera Production URL till fältet n8n productie-url i AI-Corporate. Använd inte test-URL:en med /webhook-test/.
  8. Aktivera arbetsflödet.

Mottagna uppgifter finns under body; tekniska integrationsuppgifter finns under body.integration. Ta inte bort dem i en Edit Fields-, Set- eller Code-nod.

Exempel på JSON-kropp

Om du definierar fält med namnen prompt, kundnamn, målgrupper och datum, tar n8n emot följande JSON-kropp. AI-Corporate lägger automatiskt till objektet integration.

{
"prompt": "Gör en kort sammanfattning av begäran.",
"kundnamn": "Exempelorganisation",
"målgrupper": ["medarbetare", "kunder"],
"datum": "2026-09-22",
"integration": {
"runId": "chat-dokument-id",
"tenant": "default",
"callbackUrl": "https://europe-west1-ai-corporate.cloudfunctions.net/n8nWorkflowCallback",
"callbackToken": "tillfälligt-token-för-denna-utförande"
}
}

Callback-tokenet hör till en enskild körning. Spara det inte i loggar, fasta konfigurationer eller andra system.

Valfritt: skicka framsteg och slutförande

AI-Corporate kan endast visa vad n8n returnerar. Använd dessa callbacks endast om du i registreringen har aktiverat Meddelande om mellanliggande framsteg och/eller Meddela slutförandet av arbetsflödet.

Konfigurera varje callback-nod som följer:

  1. Välj Method: POST.

  2. Klicka i URLExpression och klistra in:

    {{ $('Start workflow').first().json.body.integration.callbackUrl }}
  3. Välj Authentication: None.

  4. Aktivera Send Headers och lägg till följande headers.

  5. Aktivera Send Body och välj Body Content Type: JSON och Specify Body: Using JSON.

Använd dessa headers:

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

Skicka till exempel detta meddelande när ett steg börjar:

{
"tenant": "{{ $('Start workflow').first().json.body.integration.tenant }}",
"runId": "{{ $('Start workflow').first().json.body.integration.runId }}",
"eventId": "dokument-skapande-startat",
"type": "progress",
"executionId": "{{ $execution.id }}",
"step": {
"id": "dokument_skapande",
"label": "Skapa dokument"
},
"message": "Dokumentet håller på att skapas."
}
  • Använd ett unikt eventId för varje händelse inom samma körning.
  • Använd en tydlig svensk step.label; denna text visas i appen.
  • Om du har aktiverat Meddela slutet av arbetsflödet, så skicka alltid type: "completed", type: "failed" eller type: "rejected" i slutet.
  • Omfatt därför i completed även ett eventuellt output-objekt med resultatet.
  • Vid failed ange ett begripligt felmeddelande. Körningen stoppas då även i appen.

Valfritt: begära godkännande i appen

Använd en n8n Wait-nod med On Webhook Call när arbetsflödet först kan fortsätta efter ett val. Skicka före Wait-noden en callback med type: "approval_required":

Ställ in Wait-noden på Resume: On Webhook Call, HTTP Method: POST och Authentication: Header Auth. Välj samma Header Auth-uppgift som vid Start workflow. Lägg till efter Wait-noden en Switch-nod och kontrollera i den {{ $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": "Kontrollera dokument"
},
"approval": {
"question": "Ska arbetsflödet fortsätta?",
"context": "Kontrollera det genererade dokumentet först.",
"resumeUrl": "{{ $execution.resumeUrl }}",
"choices": [
{ "value": "approve", "label": "Godkänn" },
{ "value": "reject", "label": "Avvisa" }
]
}
}

Användaren ser valen i körfönstret. Efter ett val får Wait-noden bland annat decision. Använd därefter till exempel en Switch-nod för att avgöra rätt uppföljning.

Ett valschema får bara innehålla bokstäver, siffror, _ och -. Etiketten får innehålla vanlig läsbar text.

Produktions callback-url: att ställa in

Produktions callback-url för AI-Corporate är:

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

Klistra inte in denna URL som vanlig text i varje callbacknod. Välj i URL-fältet för HTTP Request-noden Expression och använd:

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

AI-Corporate levererar därmed automatiskt rätt produktions-url vid varje start. Den fasta URL:en ovan används för att testa och kontrollera att uttrycket pekar mot AI-Corporate och inte mot AI-School eller AI-Public.

De anropbara funktionerna triggerCustomN8nWorkflow, triggerN8nWorkflow och resumeN8nWorkflow ges av appen själv. Dessa URL:er behöver du inte konfigurera i n8n.

Hantera fel

Skicka förväntade fel tillbaka med ett callback av typen failed. Skapa även ett centralt Error Workflow för oförutsedda nodfel:

  1. Skapa ett nytt arbetsflöde med en Error Trigger-nod.

  2. Lägg till en HTTP Request-nod med Method: POST.

  3. Ange i URL denna fasta produktions-URL:

    https://europe-west1-ai-corporate.cloudfunctions.net/n8nWorkflowExecutionFailed
  4. Välj Authentication: None och lägg till headern n8n-handihow-name med plattformens hemliga standardvärde.

  5. Välj en JSON-kropp och klistra in:

{
"executionId": "{{ $json.execution.id }}",
"workflowId": "{{ $json.workflow.id }}",
"workflowName": "{{ $json.workflow.name }}",
"lastNode": "{{ $json.execution.lastNodeExecuted }}",
"message": "{{ $json.execution.error.message }}"
}
  1. Aktivera fel-arbetsflödet.
  2. Öppna inställningarna för det vanliga arbetsflödet och välj detta under Error Workflow.

Skicka direkt efter Start workflow minst ett callback med executionId: "{{ $execution.id }}". Endast då kan AI-Corporate koppla ihop ett oväntat fel med rätt körning.

Viktiga begränsningar

  • Endast webhook-utlösare stöds.
  • Endast produktions-webhook-URL:er stöds.
  • Test-webhook-URL:er med /webhook-test/ avvisas.
  • Endast POST stöds.
  • Endast generisk header authentication stöds.
  • Header-värdet hanteras som hemligt i applikationen.
  • Callback-tokens och resume-url:er behandlas endast server-sidan och är inte direkt tillgängliga för användare.
  • Tenanted bestäms server-sidan från inloggad användare, inte från ett värde som webbläsaren skickar.

Problem att lösa

  • 404 eller webhook inte registrerad: aktivera arbetsflödet i n8n och använd produktions-URL:en.
  • Autentiseringsfel: kontrollera att header-namn och värde i båda systemen är exakt lika.
  • Saknade data: kontrollera att fältnamnen i applikationen överensstämmer med nycklarna som n8n förväntar.
  • Inget request i n8n: kontrollera att arbetsflödet börjar med en webhook-trigger och använder POST.
  • Körfönstret fortsätter snurra: om du aktiverat slutet av arbetsflödet, kontrollera då om n8n skickar en sista completed, failed eller rejected callback. Om du inte förväntar dig återkopplingar, stäng av samtliga tre alternativ i registreringen.
  • Ingen framsteg syns: kontrollera om Meddela mellanliggande framsteg är aktiverat i registreringen, eller om integration-objektet behålls och att varje callback har ett unikt eventId.
  • Godkännandeknappar fungerar inte: kontrollera Wait-noden, resumeUrl, header authentication och tillåtna tecken i choices[].value.
WhatsApp