Uzol n8n

Overené k 17. októbra 2026

Komunitný uzol Dakoty pre n8n je balík n8n-nodes-dakoty na npm (open source, MIT, github.com/dakoty/dakoty-n8n-nodes). Obsahuje dva uzly a jedny prístupové údaje, všetko postavené na Developer API v1. Balík nie je samostatné API: každá operácia volá endpoint, ktorý môžeš volať aj z vlastného kódu. Referencia API je preto zdrojom pre to, čo uzol posiela a čo dostáva.

Krok za krokom nastavenie v n8n a v Dakoty nájdeš v článku Pomocníka Ako prepojiť Dakoty s n8n.

Inštalácia balíka do n8n

Vlastný (self-hosted) n8n: Settings → Community nodes → Install → n8n-nodes-dakoty. V n8n Cloud sa uzol objaví po tom, čo ho n8n overí. Dovtedy sa k rovnakým endpointom dostaneš uzlom HTTP Request s prístupovými údajmi Header Auth.

Prístupové údaje k API

Dakoty API si pýta API kľúč, ktorý začína dk_live_. n8n ho posiela ako Authorization: Bearer <kľúč> a overuje volaním GET /me; zlý alebo zrušený kľúč vráti 401 a n8n ukáže hlášku z API. Druhé pole, Base URL, má predvolenú hodnotu https://api.dakoty.com/api/v1/public a slúži len na skúšanie proti lokálnej Dakoty.

Kľúč vytvor v Dakoty v Integrácie → API kľúče a vyber predvoľbu Make / Zapier / n8n – bežné použitie. Predvoľba neobsahuje invoices:write ani bookings:write, takže Create pri faktúrach a rezerváciách a Cancel pri rezerváciách vrátia 403, kým tie oprávnenia nepridáš. Pravidlá oprávnení sú v Autentifikácia a oprávnenia.

Uzol Dakoty a operácie

Jeden uzol so siedmimi zdrojmi a 33 operáciami, rovnaký rozsah ako aplikácia Make.

Zdroj	Operácie
Lead	Create, Update, Get, Get Many, Find, Archive, Move to Stage
Company	Create, Update, Get, Get Many, Find
Contact	Create, Update, Get, Get Many, Find
Activity	Create, Update, Get, Get Many, Complete
Task	Create, Update, Get, Get Many
Invoice	Create, Get, Get Many
Booking	Create, Get, Get Many, Cancel

Každá operácia urobí jedno volanie a vráti záznamy z poľa data, jeden záznam ako jednu položku n8n.

Get Many používa kurzorové stránkovanie zoznamového endpointu. Pri Return All uzol žiada stránky po 100, kým has_more nie je false; inak Limit (1 až 100) určí počet vrátených záznamov.
Find volá endpointy …/find s presnou zhodou a keď nič nenájde, nevráti nič.
Create a ostatné zápisy majú pole Idempotency Key (hlavička Idempotency-Key), takže zopakovaný beh workflow nevytvorí záznam dvakrát.
Zoznamy vo výberoch (vlastník, pipeline, fáza, dôvod straty, typ aktivity, projekt, služba, personál) volajú v pozadí pomocné endpointy a potrebujú čítacie oprávnenie svojej oblasti, napríklad users:read pre zoznam vlastníkov.
Chyby ukážu správu z API a popis ako [403] FORBIDDEN. Pri 429 zapni v nastaveniach uzla Retry On Fail.

Uzol sa predstavuje hlavičkou User-Agent: n8n-nodes-dakoty/<verzia> (n8n).

Uzol Dakoty Trigger

Po zapnutí workflow trigger zaregistruje REST hook: POST /webhooks s adresou webhooku n8n, vybranými udalosťami a názvom n8n – <názov workflow>. Pri vypnutí alebo zmazaní workflow ho uzol zmaže cez DELETE /webhooks/{id}. Žiadne adresy nikam nevkladáš. Princíp opisujú REST hooky.

Môžeš vybrať ktorúkoľvek zo 41 udalostí katalógu. Kľúč potrebuje webhooks:manage a čítacie oprávnenie každej vybranej entity, napríklad leads:read pre lead.created.

Výstup. Simplified (predvolené) vráti všetky polia záznamu plus event_id, event_type, occurred_at, organization a test, rovnaký plochý tvar ako spúšťače v Make. Raw vráti celú obálku so záznamom v data.

Podpis. n8n odovzdá uzlu surové telo požiadavky, takže na rozdiel od Make trigger podpis overuje. Verify Signature je predvolene zapnuté: uzol skontroluje webhook-id, webhook-timestamp (tolerancia 5 minút) a webhook-signature (HMAC-SHA256 s tajomstvom whsec_…, ktoré Dakoty vrátilo pri vytvorení hooku). Požiadavka s chybným podpisom dostane 401 a nespustí workflow.

Adresa webhooku n8n musí byť dostupná z internetu cez https; Dakoty odmietne localhost a adresy z vnútornej siete.