Zautomatyzuj swoje podpisy za pomocą n8n
n8n jest platformą automatyzacji open source, którą można hostować samodzielnie. Dwie ścieżki do Certyneo: zaimportuj nasz gotowy przepływ pracy, który używa tylko węzłów Webhook i HTTP Request dostarczanych z n8n i nie wymaga żadnej instalacji, lub zainstaluj węzeł społeczności n8n-nodes-certyneo, jeśli wolisz węzeł Certyneo w swoim panelu. W obu przypadkach wklej swój klucz API i zdarzenia podpisu sterują resztą Twojego stosu.
Przepływ pracy nie wymaga instalacji: używa tylko węzłów dostarczanych z n8n, więc działa wszędzie, w tym na n8n Cloud. Węzeł społeczności n8n-nodes-certyneo jest publikowany na npm i instaluje się z Settings → Community nodes na samodzielnie hostowanej instancji; n8n Cloud oferuje tylko węzły, które n8n weryfikuje.
Dlaczego połączyć Certyneo z n8n
n8n daje Ci wybór: usługa zarządzana lub Twój własny serwer. W obu przypadkach integracja Certyneo używa publicznego API i webhooków, bez zastrzeżonego pośrednika między Twoimi umowami a Twoimi narzędziami.
11 zdarzeń, nie cztery
Węzeł Webhook otrzymuje pełny cykl życia kopert — tworzenie, wysyłanie, otwarcie, podpisanie, odmowę, anulowanie, wygaśnięcie, zwrot do nadawcy. Żaden wyzwalacz nie jest pomijany, w przeciwieństwie do łączników z ustaloną listą.
Całe API, bez czekania
Węzeł HTTP Request wywołuje dowolny punkt wejścia API Certyneo natychmiast po jego udostępnieniu: utwórz kopertę, wyślij ją, złóż dokument, pobierz podpisane pliki PDF lub folder dowodowy.
Możliwość samodzielnego hostowania
Na instancji n8n, którą hosujesz, metadane Twoich umów nie przechodzą przez żaden trzeci podmiot: ruch idzie z Twojego serwera do Certyneo i nigdzie indziej. Ważny argument dla zespołów prawnych i dyrektorów ds. IT.
Klucz API i podpis HMAC
Połączenie uwierzytelnia się za pomocą klucza API o ograniczonym zakresie, możliwego do odwołania w każdej chwili. Każde zdarzenie przychodzące jest podpisane HMAC-SHA256: Twój workflow może sprawdzić, czy naprawdę pochodzi z Certyneo.
Dostępne zdarzenia
Subskrybuj węzeł Webhook do zdarzeń swojego wyboru. Przybyają w czasie rzeczywistym z nagłówkiem sygnatury X-Certyneo-Signature do weryfikacji po stronie n8n.
| Zdarzenie | Wyzwala się, gdy… |
|---|---|
Koperta utworzonaenvelope.created | Koperta właśnie została utworzona, wciąż w stanie roboczym. |
Odebrane pudełko wysłaneenvelope.sent | Koperta opuszcza wersję roboczą i kieruje się do swoich odbiorców. |
Podpisane pudełkoenvelope.completed | Wszyscy odbiorcy podpisali: koperta jest sfinalizowana, z linkiem do pobrania podpisanego pliku PDF. |
Odebrane pudełko odrzuconeenvelope.declined | Odbiorca odmawia podpisania, podając przyczynę, którą wskazał. |
Koperta anulowanaenvelope.voided | Nadawca anuluje kopertę już wysłaną: linki do podpisu stają się bezużyteczne. |
Koperta wygasłaenvelope.expired | Termin upłynął, zanim wszyscy adresaci podpisali. |
Koperta zwrócona nadawcyenvelope.returned_to_sender | Adresat zwraca kopertę do poprawy zamiast ją podpisać. |
Koperta przesłana ponownieenvelope.resubmitted | Nadawca poprawia i ponownie wysyła kopertę, która mu została zwrócona. |
Odbiorca podpisałrecipient.signed | Odbiorca kończy swój podpis. Uruchamia się raz na osobę podpisującą, nie tylko na koniec. |
Adresat otworzyłrecipient.viewed | Odbiorca otwiera kopertę po raz pierwszy — przydatne do wysłania przypomnienia we właściwym momencie. |
Odbiorca zatwierdziłrecipient.approved | Odbiorca, którego rola to "zatwierdzający", zatwierdza kopertę bez składania podpisu. |
Adres niedostępnyrecipient.bounced | Adres odbiorcy zwraca błąd trwały (skrzynka nieistniejąca, domena martwa). Ponowne próby się zatrzymują: popraw adres i wyślij ponownie kopertę. |
Co możesz kontrolować
Każdy wiersz to wywołanie węzła HTTP Request z uwierzytelnianiem Header Auth i Twoim kluczem Certyneo.
Stworzenie pudełka
POST /envelopes — tworzy kopertę na podstawie szablonu Certyneo lub już przesłanych dokumentów, wraz z odbiorcami.
Wyślij kopertę
POST /envelopes/:id/send — usuwa kopertę z roboczych i wysyła zaproszenia do podpisania.
Wypisz koperty
GET /envelopes — lista stronicowana, najnowsze na pierwszym miejscu, z opcjonalnym filtrem statusu.
Przesłanie dokumentu
POST /documents — wysyła plik PDF z dowolnego węzła n8n, w tym załącznika e-mail lub pliku z Dysku.
Wyświetl listę szablonów
GET /templates — pobiera identyfikatory Twoich szablonów, aby nie trzeba było kodować ich na sztywno w workflow.
Pobierz podpisany PDF
GET /envelopes/:id/signed-document — pobiera podpisany dokument, a /audit-trail dla pliku dowodu.
Zainstalowanie integracji
Workflow, który dostarczamy, już zawiera webhook, routing według zdarzeń, wywołanie subskrypcji i przykład wysłania. Liczcie na pięć minut.
- 1
Importuj workflow
W n8n otwórz menu workflow, następnie « Import from URL… » i wklej adres naszego szablonu. Możesz też pobrać plik i upuścić go na kanwę.
- 2
Wygeneruj klucz API
Otwórz Certyneo → Ustawienia → API REST i utwórz klucz z zakresom kopert i webhooks. Skopiuj go: jest wyświetlany tylko raz.
- 3
Utwórz identyfikator Header Auth
W n8n dodaj identyfikator « Header Auth »: nazwa « Authorization », wartość « Bearer » następnie Twój klucz. Wybierz go w węzłach HTTP Request workflow.
- 4
Subskrybuj i aktywuj
Skopiuj URL produkcji węzła Webhook, wklej go w wywołanie subskrypcji, wykonaj je raz, następnie aktywuj workflow. Zachowaj « secret » zwrócony: służy do weryfikacji sygnatury zdarzeń.
- 5
Połącz Google Drive
Model umieszcza podpisany plik PDF i jego dowód audytu na Twoim dysku: wybierz swoje konto Google w obu węzłach archiwizacji. Możesz je zastąpić rozwiązaniami S3, SharePoint lub innym magazynem — zużywają to samo pole binarne.
Bezpieczeństwo i zgodność
Integracja n8n opiera się na publicznym API Certyneo, z tym samym poziomem wymagań co reszta platformy.
- Szyfrowana wymiana danych w HTTPS end-to-end.
- Klucze API o ograniczonym zakresie: przyznawaj tylko niezbędne uprawnienia.
- Każde zdarzenie jest podpisane w HMAC-SHA256 — zweryfikuj je przed działaniem.
- Odwołaj klucz w dowolnym momencie z pulpitu nawigacyjnego.
Często zadawane pytania
Czy trzeba zainstalować węzeł Certyneo w n8n?
To nie jest obowiązkowe. Przepływ pracy, który publikujemy, używa tylko węzłów Webhook i HTTP Request dostarczanych z n8n: nic do zainstalowania i działa równie dobrze na n8n Cloud. Węzeł społeczności istnieje, jeśli go wolisz — n8n-nodes-certyneo na npm, z węzłem akcji, węzłem wyzwalającym i jego identyfikatorem — i instaluje się z Settings → Community nodes na samodzielnie hostowanej instancji. Dokumentacja n8n rezerwuje n8n Cloud dla węzłów, które weryfikuje.
Jaka subskrypcja Certyneo jest wymagana do użycia n8n?
Prawdziwy klucz (sk_live_…) wymaga planu zawierającego dostęp do API (Standard i wyżej). Plany Bezpłatny i Osobisty mają klucz piaskownicy (sk_test_…) do przejścia całej ścieżki na testowych kopertach, bez e-maila wysyłanego do sygnatariuszy.
Jak mogę uzyskać moją klucz API?
Z Certyneo przejdź do Ustawienia → API REST i utwórz klucz z zakresami envelopes:read, envelopes:write i webhooks:write. Zaczyna się od sk_live_ (lub sk_test_ w piaskownicy) i jest wyświetlany tylko raz: skopiuj go natychmiast.
Czy działa to na samodzielnie hostowanej instancji n8n?
Tak, i to jest najciekawszy przypadek użycia. Twoja instancja musi być dostępna z Internetu, aby otrzymać nasze webhooki: wystarczy publiczny adres URL w HTTPS. Żadne dane nie przechodzą przez usługę trzeciej strony.
Jakie zdarzenia podpisu są objęte?
Jedenaście zdarzeń cyklu życia: koperta utworzona, wysłana, podpisana, odrzucona, anulowana, wygasła, zwrócona do nadawcy, ponownie przesłana, oraz adresat otworzył, podpisał lub zatwierdził. Wybierasz te, na które się subskrybujesz.
Jak sprawdzić, czy zdarzenie pochodzi rzeczywiście z Certyneo?
Każda dostawa zawiera nagłówek X-Certyneo-Signature, który zawiera HMAC-SHA256 treści żądania, obliczony za pomocą tajemnicy zwróconej przy tworzeniu subskrypcji. Porównaj go w węźle Code przed przetworzeniem zdarzenia.
Czy integracja n8n jest płatna?
Certyneo nie pobiera dodatkowych opłat. Po stronie n8n instancja samodzielnie hostowana jest bezpłatna; w n8n Cloud każde wykonanie konsumuje limit z Twojego planu.
Poszukiwanie dalszych kierunków
Automatyzuj swoje umowy już dzisiaj
Zaimportuj przepływ pracy, wklej swój klucz API i pozwól swoim podpisom wyzwolić resztę.