n8n, Make och Zapier

WORK³ har egna appar för n8n, Make och Zapier. De använder REST API med en API-nyckel, så ett flöde kan göra precis det nyckelns roll tillåter, och det som görs syns under nyckelns namn.

n8n

Öppna Inställningar → Integrationer → n8n i WORK³. Sidan visar paketnamnet och din WORK³-adress, båda med en kopieringsknapp.
Gå till Settings → Community nodes → Install i n8n, skriv @nod3solutions/n8n-nodes-work3 och installera.
Tillbaka i WORK³ klickar du på Ny nyckel under Nycklar för n8n. Den föreslår namnet “n8n” och rollen Admin, som triggers behöver. Kopiera nyckeln, eftersom den bara visas en gång.
Lägg till en WORK³ API-credential i n8n med nyckeln och adressen.
Lägg till WORK³ Trigger eller WORK³-noden i ett workflow och välj credential.

Nycklar som skapas på n8n-sidan hör till n8n. De listas och återkallas där, inte under REST API, och n8n visas som Kopplad så länge en av dem fungerar.

Det n8n gör i WORK³ visas under nyckelns namn, till exempel API · n8n. Kommenterar det på din uppgift hamnar notisen i din Inkorg under det namnet. Svara på uppgiften, eftersom du inte kan skriva till en nyckel. Ge varje workflow en egen nyckel med ett tydligt namn (“n8n säljflöde”) så att du kan skilja dem åt.

Make

WORK³-appen för Make väntar på granskning hos Make och finns därför inte i Makes applista än. Tills den är godkänd installerar du den med inbjudningslänken, som också finns på Make-sidan i WORK³:

https://www.make.com/en/hq/app-invitation/8503c36d0f6d1581dec84f4df7115497

Öppna länken inloggad i Make och installera appen i er organisation.
Öppna Inställningar → Integrationer → Make i WORK³. Sidan visar din WORK³-adress med en kopieringsknapp.
Klicka på Ny nyckel under Nycklar för Make. För triggers behåller du en roll som får koppla integrationer (till exempel Admin) och ingen projektbegränsning. Kopiera nyckeln, eftersom den bara visas en gång.
Lägg till en WORK³-modul i ett Make-scenario och klicka på Add bredvid Connection. Klistra in nyckeln. Om din adress inte är https://work.nod3.se öppnar du Show advanced settings och fyller i den under Address.
Välj vad modulen ska göra. Projekt, statusar, personer och taggar kommer som listor.

Nycklar som skapas på Make-sidan hör till Make. De listas och återkallas där, och Make visas som Kopplad så länge en av dem fungerar.

Zapier

WORK³-appen för Zapier är bara för inbjudna tills Zapier har granskat den, och finns därför inte i Zapiers appkatalog än. Tills den är godkänd lägger du till den med inbjudningslänken, som också finns på Zapier-sidan i WORK³:

https://zapier.com/developer/public-invite/249078/523f2ed6f59755664a55a0267ca916e0/

Öppna inbjudningslänken inloggad i Zapier och acceptera inbjudan.
Öppna Inställningar → Integrationer → Zapier i WORK³. Sidan visar din WORK³-adress med en kopieringsknapp.
Klicka på Ny nyckel under Nycklar för Zapier. För triggers behåller du en roll som får koppla integrationer (till exempel Admin) och ingen projektbegränsning. Kopiera nyckeln; den visas bara en gång.
Välj WORK³ som app i en Zap, välj en trigger eller action under Event och klicka på Sign in. Klistra in nyckeln. Om din adress inte är https://work.nod3.se anger du den under Address.
Ställ in steget. Projekt, statusar, personer och taggar kommer som listor.

Nycklar som skapas på Zapier-sidan hör till Zapier: de listas och återkallas där, och Zapier visas som Ansluten så länge en av dem fungerar.

Triggers

Trigger	Startar när
Nytt ärende	Ett ärende skapas
Ärende ändrat	Ett ärende ändras. Du kan välja att bara reagera på vissa fält, som status eller ansvarig
Ärende klart	Ett ärende flyttas till en klar-status
Ärende förfaller i morgon	En gång, dagen innan ett öppet ärende förfaller, kl. 08:00 i workspacets tidszon (i Make väljer du timme under Time of day). Ett ärende som får förfallodag i morgon senare samma dag triggar direkt; ett som är klart eller arkiverat innan dess triggar inte
Ny kommentar	Någon kommenterar ett ärende
Nytt projekt	Ett projekt skapas
Projekt ändrat	Ett projekt ändras
Projekt arkiverat	Ett projekt arkiveras

I n8n och Zapier kan ärendetriggers begränsas till vissa projekt, personer och statusar, och Ärende ändrat till vissa fält. I Zapier väljer du timme för Ärende förfaller i morgon under Time of Day.

I Zapier

Zapier visar samma fält som Make, med namnet bredvid id:t: till exempel Item Status, Item Status ID, Item Project Name och Item Project Key. Datum ligger samlade (Item Due Date, Item Created), och ett projekts ansvarig, kund, kontakt och värde är också par. Ändringstriggers ger Changes med bara fälten som ändrades (till exempel Changes: Status from och Changes: Status to), varje trigger ger vem som gjorde det (till exempel Changed by, med användar-id) och Event ID, som är detsamma om en leverans skickas igen. Actions och sökningar ger ärenden och projekt i samma form. I uppdaterings-actions lämnas tomma fält orörda.

I Make

Makes triggers har inga egna inställningar. Lägg ett filter efter triggern för att smalna av dem, till exempel på Item: Project: Key, Item: Assignee: Name, Item: Status: Name eller Changes: Status: To: Name. I Make kommer allt som har ett id som en liten grupp med namnet bredvid id:t (till exempel Status: Name, Category, ID), datum ligger samlade under Dates, och ett projekts kund, kontakt och värde är också grupper. Varje trigger ger ärendet, projektet eller kommentaren, på ändringstriggers Changes (bara fälten som ändrades, vart och ett med From och To, båda med namn och id där det finns), Done by (namn och användar-id) och Event (händelse-id, som är detsamma om en leverans skickas igen så att du kan hoppa över dubbletter, typ och tid). Makes nya utdatapanel sorterar fälten på sitt eget sätt; grupperna håller ihop det som hör ihop. Datum som förfallodatum är text i formen YYYY-MM-DD. Använd formatDate(date; YYYY-MM-DD) för att mappa ett Make-datum dit. I uppdateringsmoduler lämnas tomma fält orörda; använd Erase för att tömma ett fält.

När du slår på ett flöde registrerar appen en egen webhook i WORK³, och när du slår av det tas den bort. Du ser dem också under Inställningar → Integrationer → Webhooks. Om API-nyckeln återkallas eller går ut slutar dess webhooks att skicka och tas bort.

Actions och sökningar

Skapa ärende och Ändra ärende: titel, beskrivning, typ, status, prioritet, ansvarig, förälder, förfallodatum och taggar. Ändra ärende kan också arkivera eller återställa ärendet.
Arkivera ärende: döljer ett ärende och dess underärenden från tavlor och listor. Det går att återställa i WORK³. Apparna arkiverar ärenden men raderar dem aldrig.
Lägg till kommentar på ett ärende.
Skapa projekt, med mall och taggar om du vill, och Ändra projekt, även arkivera.
Skicka chattmeddelande i ett projekts chatt. Nyckeln kan skriva där men aldrig läsa chatten.
Ladda upp fil till ett ärende eller ett projekt. Samma filtyper och storleksgräns som i appen gäller.
Hämta ärende, Sök ärenden (alla ord i titel eller beskrivning, eller en referens som WEB-12), Hitta projekt (på nyckel eller namn) och Search people (på namn, e-post eller användar-id, eller alla; Find person i Zapier), som gör om ett användar-id till namn och e-post.
I Make skickar Make an API call valfritt anrop till REST API med anslutningens nyckel, för det som de andra modulerna inte täcker. Den når bara din WORK³-adress.

Projekt, statusar, typer, prioriteter, personer och taggar väljs i listor, så du behöver inte kopiera id:n.

Säkerhet

Varje leverans signeras med en hemlighet som bara appen känner till. n8n och Zapier kontrollerar signaturen och nekar leveranser äldre än 5 minuter innan flödet startar.
Make låter inte appar kontrollera signaturer. Dess webhookadress är hemlig och hör till din nyckel, men läs ärendet igen med Hämta ärende före steg som spelar roll, som betalningar eller mejl till kunder.
Använd en nyckel per verktyg, så ser du vad vart och ett gjort och kan återkalla dem var för sig.
Om ett flöde både reagerar på ändringar och gör ändringar kan det trigga sig självt. Hoppa över händelser där den som gjorde ändringen är nyckelns egen användare.