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:
- Göra en snygg sammanfattning av den korta texten med en LLM-nod och en prompt som passar organisationens ton.
- Skapa en lämplig illustration med en andra LLM-nod, till exempel i varumärkets färger och i en igenkännbar illustrativ stil.
- 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:
- Gå till Assistenten.
- Öppna Arbetsflöden.
- Välj Nytt n8n-arbetsflöde.
- Ange namnet på arbetsflödet och n8n-produktions-URL.
- Konfigurera Header authentication med ett header-namn och hemligt header-värde.
- 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.
- Lägg eventuellt till de fält som ska skickas i POST-request.
- 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
- Skapa ett nytt arbetsflöde i n8n.
- Lägg till första noden en Webhook.
- Ge den exakt namnet Start workflow. Exempelkonstruktionerna nedan använder detta namn.
- Ställ in HTTP Method på POST.
- Välj Authentication: Header Auth och använd samma header-namn och hemliga värde som i AI-Corporate.
- Ställ in Respond eller Response Mode till Immediately.
- Kopiera Production URL till fältet n8n productie-url i AI-Corporate. Använd inte test-URL:en med
/webhook-test/. - 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:
-
Välj Method: POST.
-
Klicka i URL på Expression och klistra in:
{{ $('Start workflow').first().json.body.integration.callbackUrl }} -
Välj Authentication: None.
-
Aktivera Send Headers och lägg till följande headers.
-
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
eventIdfö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"ellertype: "rejected"i slutet. - Omfatt därför i
completedäven ett eventuelltoutput-objekt med resultatet. - Vid
failedange 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:
-
Skapa ett nytt arbetsflöde med en Error Trigger-nod.
-
Lägg till en HTTP Request-nod med Method: POST.
-
Ange i URL denna fasta produktions-URL:
https://europe-west1-ai-corporate.cloudfunctions.net/n8nWorkflowExecutionFailed -
Välj Authentication: None och lägg till headern
n8n-handihow-namemed plattformens hemliga standardvärde. -
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 }}"
}
- Aktivera fel-arbetsflödet.
- Ö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,failedellerrejectedcallback. 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 unikteventId. - Godkännandeknappar fungerar inte: kontrollera Wait-noden,
resumeUrl, header authentication och tillåtna tecken ichoices[].value.