n8n
Zainstaluj węzeł społecznościowy, utwórz dane uwierzytelniające, zbuduj pierwszy workflow i poznaj ograniczenie jednego webhooka, zanim dodasz trigger.
WASync udostępnia węzeł społecznościowy dla n8n, opublikowany w npm jako
n8n-nodes-wasync. Opakowuje
to samo REST API, które opisuje ta dokumentacja, więc wszystko, co robi węzeł, możą Państwo zrobić
także przez curl — a to, czego węzeł jeszcze nie obsługuje, również.
Zanim zaczniesz: konto i połączony numer
Węzeł komunikuje się z Państwa kontem WASync. Jeśli jeszcze go nie macie, utwórzcie je najpierw — zajmuje to minutę i nic nie kosztuje:
Utwórz bezpłatne konto developera
Przejdź na developers.wasync.app/register — imię i nazwisko, e-mail, hasło. Każde nowe konto otrzymuje własną przestrzeń roboczą: miejsce, w którym znajdują się Państwa numery WhatsApp i klucze API.
Dodaj numer WhatsApp do tej przestrzeni roboczej
Możliwe są dwie sytuacje:
- Korzystasz już z WASync w Bitrix24 — zaloguj się tym samym adresem e-mail,
którego używasz w Bitrix24. Państwa portal pojawi się jako przestrzeń robocza,
a połączone numery będą gotowe do użycia. Wysyłanie przez API wymaga dodatku API add-on
dla danego numeru (12 USD za numer miesięcznie; bez niego krok wysyłania w węźle
zwraca
addon_required). - Dopiero zaczynasz z WASync — połącz numer z własną przestrzenią roboczą jednym wywołaniem API, które zwraca kod QR (lub kod parowania wpisywany w WhatsApp). Dokładne kroki znajdziesz w Połącz numer WhatsApp. Każdy numer zaczyna od 7-dniowego bezpłatnego okresu próbnego; plany to WAPP 19 USD lub WABA 29 USD za numer miesięcznie.
Utwórz API key
Są dwa sposoby:
- Korzystasz już z WASync w Bitrix24? Przejdź do Ustawienia → API i agenci →
API keys, nazwij integrację i kliknij Utwórz klucz. Wymaga to
połączenia z aktywnym dodatkiem API, a klucz otrzymuje zakresy potrzebne w tym
workflow (
whatsapp.read whatsapp.send) — pomiń poniższy wybór zakresów. - W przeciwnym razie zaloguj się i otwórz developers.wasync.app/keys. Wybierz przestrzeń roboczą, nadaj kluczowi nazwę, zaznacz poniższe zakresy i utwórz go.
Tak czy inaczej, skopiuj klucz od razu — jest wyświetlany tylko raz. To wartość, o którą prosi poświadczenie n8n.
Jedno konto, wiele numerów
Operacja Connection → List w węźle pokazuje każdy numer, do którego klucz ma dostęp. Jeśli lista jest pusta, przestrzeń robocza nie ma jeszcze połączonego numeru — wróć do kroku 2.
1. Zainstaluj węzeł społecznościowy
Zweryfikowany przez n8n (7 września 2026)
n8n-nodes-wasync jest zweryfikowanym węzłem społecznościowym — nosi odznakę
weryfikacji wszędzie tam, gdzie n8n ją pokazuje.
Są dwa sposoby instalacji, zależnie od tego, gdzie działa n8n:
-
n8n Cloud lub instancja własna — wyszukaj w panelu węzłów. Otwórz panel węzłów, wyszukaj „WASync” i dodaj węzeł. Zweryfikowane węzły instalują się bezpośrednio stamtąd, bez dodatkowej konfiguracji.
-
Tylko instancja własna — ustawienia Community Nodes. Przejdź do Settings → Community nodes → Install, wpisz nazwę pakietu i potwierdź:
n8n-nodes-wasyncTa ścieżka działa na każdej instancji własnej, zweryfikowanej lub nie.
Po instalacji w panelu węzłów pojawią się węzły WASync i WASync Trigger.
Gotowe punkty wyjścia: bezpłatne szablony workflow obejmują najczęstsze przepływy — zaimportuj jeden z nich i dostosuj pola zamiast budować od pustego płótna.
2. Utwórz dane uwierzytelniające
Dodaj poświadczenie typu WASync API. Ma jedno pole: Państwa API key,
wysyłany jako Authorization: Bearer ….
Wklej klucz utworzony wcześniej (zob. Zanim zaczniesz) — jest wyświetlany tylko raz. Nadaj mu wyłącznie zakresy potrzebne w workflow:
- wyświetlanie połączeń i odczyt wiadomości →
whatsapp.read - wysyłanie i oznaczanie jako przeczytane →
whatsapp.send - trigger →
whatsapp.events
Zobacz Zakresy.
3. Pierwszy workflow
Najprostszy użyteczny workflow składa się z dwóch węzłów: ręcznego triggera i wysyłki.
Znajdź identyfikator połączenia. Dodaj węzeł WASync, wybierz zasób
Connection → operację List i uruchom. Skopiuj id numeru, z którego
chcesz wysyłać.
Wyślij wiadomość. Dodaj drugi węzeł WASync, zasób Message → operacja Send. Wypełnij:
| Pole | Wartość |
|---|---|
connectionId | skopiowany przed chwilą identyfikator |
to | cyfry w formacie międzynarodowym, bez + — np. 40712345678 |
text | treść wiadomości |
Wykonaj. Węzeł zwraca identyfikator wiadomości, po którym możesz później łączyć dane — zob. dwa identyfikatory.
Operacje obsługiwane przez węzeł
| Zasób | Operacja | Parametry |
|---|---|---|
| Connection | List | — |
| Message | Send | connectionId, to, text |
| Message | Get Many | connectionId, limit |
| Message | Mark as Read | — |
Obsługiwane jest tylko wysyłanie tekstu. Wysyłanie szablonu WhatsApp oraz sprawdzanie, czy numer jest w WhatsApp, nie są obecnie dostępne przez API, więc węzeł ich nie oferuje — nie buduj workflow zakładającego, że istnieją.
4. Trigger
WASync Trigger uruchamia workflow, gdy coś wydarzy się na Państwa koncie. Obsługuje cztery zdarzenia:
message.receivedmessage.statusconnection.connectedconnection.disconnected
Payloady są dokładnie takie, jak w przewodniku po
webhookach — te same pola, te same identyfikatory, ten sam
timestamp w milisekundach.
Jeden slot webhooka na konto — trigger go przenosi
API ma jeden adres URL webhooka na konto (PUT /webhook,
POST /webhook/rotate, bez usuwania). Aktywacja WASync Trigger kieruje ten
jedyny slot do n8n.
Zatem: jeśli Państwa własny backend odbierał dotąd webhooki, przestanie je odbierać w chwili, gdy trigger przejmie slot. Dwa WASync Trigger nie mogą też jednocześnie zajmować slotu — wygrywa drugi. Jeśli potrzebujesz zdarzeń w więcej niż jednym miejscu, odbieraj je raz i rozsyłaj samodzielnie: niech slot zajmuje n8n i przekazuje dalej z workflow albo niech zajmuje go Państwa backend i wywołuje węzeł Webhook w n8n.
Adresy URL triggera testowego i produkcyjnego są różne, więc przełączanie między nimi również przenosi slot.
Ponieważ dostawy są porzucane po trzech nieudanych próbach, zachowaj ścieżkę uzgadniania także w n8n: zaplanowany workflow wywołujący Message → Get Many co 30–60 sekund wychwyci wszystko, czego trigger nie odebrał, gdy instancja się restartowała.
Gdy węzeł nie wystarcza
Węzeł obejmuje najczęstszą ścieżkę. Do wysyłania multimediów, kodów parowania, provisioningu
połączeń, obsługi Idempotency-Key lub czegokolwiek innego z
dokumentacji API użyj węzła HTTP Request w n8n z tym
samym poświadczeniem: bazowy URL https://developers.wasync.app/api/v1, nagłówek
Authorization: Bearer <key>.