n8n

Node Comers dla n8n pozwala workflowowi n8n odbierać obsługiwane Comers Events bez ręcznego tworzenia i utrzymywania subskrypcji webhooków.

Pakiet jest publikowany jako:

@comers/n8n-nodes-comers

Udostępnia node Comers Trigger oraz credential Comers API.

flowchart TD
    C[Comers Event] --> T[Comers Trigger]
    T --> N[Workflow n8n]
    N --> A[Kolejny node n8n]
    A --> X[Aplikacja zewnętrzna]

Zainstaluj community node

W instalacji n8n, która pozwala na community nodes:

1. otwórz Settings → Community nodes,
2. wybierz instalację community node,
3. wpisz @comers/n8n-nodes-comers.

Dostępność community nodes może zależeć od sposobu hostowania i administracji środowiskiem n8n.

Utwórz credential Comers

Node łączy się z Comers przez integrację maszynową.

Utwórz w Comers integrację z dostępem do zarządzania subskrypcją eventów wymaganym przez node n8n. Comers udostępni dane klienta potrzebne do połączenia.

Następnie utwórz credential Comers API w n8n i podaj:

• publiczny adres swojej instalacji Comers,
• client ID,
• client secret.

Client secret traktuj jako poufny. Przechowuj go wyłącznie w credentialu n8n i przeznaczonym do tego procesie integracji Comers.

Dodaj Comers Trigger

Dodaj Comers Trigger do workflowu i wybierz credential Comers API.

Node pobiera obsługiwane eventy z katalogu eventów Comers zamiast korzystać ze stałej listy wpisanej na sztywno w pakiecie.

Dzięki temu nowe obsługiwane typy eventów mogą pojawić się jako opcje bez konieczności umieszczania całego katalogu Comers bezpośrednio w node.

Wybierz eventy

Wskaż eventy, które mają uruchamiać workflow.

Wybieraj tylko zdarzenia rzeczywiście potrzebne danemu procesowi. Węższa subskrypcja ułatwia zrozumienie workflowu i ogranicza zbędne wykonania.

Dokładna lista zależy od katalogu udostępnianego przez Twoją instalację Comers.

Opublikuj workflow

Publikacja workflowu n8n tworzy lub aktualizuje produkcyjną subskrypcję eventów Comers zarządzaną przez dany node.

Wyłączenie publikacji lub usunięcie workflowu powoduje wycofanie subskrypcji obsługiwanej przez node.

To celowe zachowanie: nie musisz ręcznie kopiować produkcyjnego adresu webhooka do Comers ani pamiętać o jego późniejszym usunięciu.

flowchart TD
    D[Budowa workflowu] --> E[Wybór eventów Comers]
    E --> P[Publikacja workflowu]
    P --> S[Aktywna subskrypcja w Comers]
    S --> R[Zweryfikowany event uruchamia workflow]
    R --> U{Workflow wyłączony lub usunięty?}
    U -->|Nie| S
    U -->|Tak| A[Subskrypcja zarchiwizowana]

Eventy testowe

Podczas korzystania z trybu testowego nasłuchiwania n8n node może utworzyć osobną tymczasową subskrypcję dla testowego webhooka edytora.

Subskrypcja testowa jest oddzielona od produkcyjnej, dzięki czemu test nie przejmuje ani nie zastępuje subskrypcji aktywnego workflowu.

Zweryfikowane dostarczenia

Comers Trigger weryfikuje obsługiwane podpisane dostarczenia przed uruchomieniem workflowu.

Dzięki temu logika weryfikacji podpisu pozostaje w konektorze i nie trzeba odtwarzać jej osobno w każdym workflow przy użyciu ogólnych node’ów n8n.

Prawidłowe uruchomienie triggera oznacza, że n8n zaakceptował zweryfikowane dostarczenie Comers. Nie gwarantuje to powodzenia dalszej części workflowu.

Buduj workflowy idempotentne

Dostarczenie eventu Comers może zostać ponowione albo odtworzone.

Ten sam event biznesowy może więc dotrzeć do workflowu więcej niż raz. Jeżeli podwójne przetworzenie byłoby szkodliwe, deduplikuj zdarzenia na podstawie stabilnego identyfikatora eventu dostarczonego w envelope.

Nie używaj numeru próby dostarczenia jako identyfikatora zdarzenia biznesowego.

Co otrzymuje workflow

Trigger udostępnia podpisany envelope eventu Comers wraz z informacjami o dostarczeniu.

Event zawiera identyfikator i kontekst zdarzenia biznesowego przekazany przez Comers. Pola mogą ewoluować wraz z wersjami eventów, dlatego kolejne kroki workflowu powinny korzystać z pól wymaganych przez konkretny kontrakt eventu zamiast zakładać identyczny payload dla wszystkich zdarzeń.

Kiedy używać n8n

n8n jest dobrym wyborem, gdy chcesz:

• połączyć event Comers z aplikacją już dostępną w n8n,
• transformować lub wzbogacać dane eventu,
• kierować różne zdarzenia do różnych procesów,
• dodać automatyzację specyficzną dla klienta bez budowania natywnego konektora Comers,
• szybko zbudować workflow integracyjny przed decyzją o dedykowanej usłudze.

Model bazowy opisuje strona Eventy i webhooki.