n8n
Installieren Sie den Community-Node, legen Sie die Zugangsdaten an, bauen Sie einen ersten Workflow und kennen Sie die Einschränkung mit dem einzelnen Webhook, bevor Sie einen Trigger hinzufügen.
WASync liefert einen Community-Node für n8n mit, veröffentlicht auf npm als
n8n-nodes-wasync. Er nutzt
dieselbe REST API, die in dieser Dokumentation beschrieben ist. Alles, was der Node kann, erledigen Sie also auch
mit curl – und was er noch nicht kann, ebenfalls.
Bevor Sie beginnen: ein Konto und eine verbundene Nummer
Der Node arbeitet mit Ihrem WASync-Konto. Falls Sie noch keines haben, legen Sie es zuerst an – das dauert eine Minute und kostet nichts:
Kostenloses Entwicklerkonto erstellen
Rufen Sie developers.wasync.app/register auf – Name, E-Mail, Passwort. Jedes neue Konto enthält einen eigenen Workspace: den Ort, an dem Ihre WhatsApp-Nummern und API keys liegen.
Eine WhatsApp-Nummer in diesen Workspace bringen
Es gibt zwei Ausgangslagen:
- Sie nutzen WASync bereits in Bitrix24 – melden Sie sich mit derselben E-Mail-Adresse an, die
Sie in Bitrix24 verwenden. Ihr Portal erscheint als Workspace, und die verbundenen Nummern
sind sofort einsatzbereit. Zum Senden über die API benötigt die Nummer das API-Add-on
(12 $ pro Nummer und Monat; ohne dieses antwortet der Sendeschritt des Nodes mit
addon_required). - Sie sind neu bei WASync – verbinden Sie eine Nummer mit Ihrem eigenen Workspace über einen einzigen API-Aufruf, der einen QR-Code zurückgibt (oder einen Kopplungscode, den Sie in WhatsApp eingeben). Die genauen Schritte finden Sie unter WhatsApp-Nummer verbinden. Jede Nummer startet mit einer 7-tägigen kostenlosen Testphase; die Tarife sind WAPP 19 $ oder WABA 29 $ pro Nummer und Monat, in USD.
API key erstellen
Dafür gibt es zwei Wege:
- Sie nutzen WASync bereits in Bitrix24? Öffnen Sie Settings → API & Agents →
API keys, benennen Sie die Integration und klicken Sie auf Create key. Dafür ist eine
Verbindung mit aktivem API-Add-on nötig. Der Schlüssel enthält die Scopes, die dieser
Workflow braucht (
whatsapp.read whatsapp.send) – die Scope-Auswahl weiter unten können Sie überspringen. - Andernfalls melden Sie sich an und öffnen developers.wasync.app/keys. Wählen Sie den Workspace, vergeben Sie einen Namen für den Schlüssel, haken Sie die unten genannten Scopes an und erstellen Sie ihn.
Kopieren Sie den Schlüssel in jedem Fall sofort – er wird nur einmal angezeigt. Das ist der Wert, den die n8n-Zugangsdaten abfragen.
Ein Konto, viele Nummern
Die Operation Connection → List des Nodes zeigt alle Nummern, die der Schlüssel erreichen kann. Ist die Liste leer, hat der Workspace noch keine verbundene Nummer – gehen Sie zurück zu Schritt 2.
1. Community-Node installieren
Von n8n verifiziert (7. Sep. 2026)
n8n-nodes-wasync ist ein verifizierter Community-Node – er trägt das Verifiziert-Siegel
überall dort, wo n8n eines anzeigt.
Es gibt zwei Wege zur Installation, je nachdem, wo Sie n8n betreiben:
-
n8n Cloud oder selbst gehostet – über das Node-Panel suchen. Öffnen Sie das Node-Panel, suchen Sie nach „WASync“ und fügen Sie den Node hinzu. Verifizierte Nodes lassen sich direkt dort installieren, ohne weitere Einrichtung.
-
Nur selbst gehostet – Einstellungen für Community-Nodes. Gehen Sie zu Settings → Community nodes → Install, geben Sie den Paketnamen ein und bestätigen Sie:
n8n-nodes-wasyncDieser Weg funktioniert auf jeder selbst gehosteten Instanz, ob verifiziert oder nicht.
Nach der Installation erscheinen die Nodes WASync und WASync Trigger im Node-Panel.
Fertige Startpunkte: Die kostenlosen Workflow-Vorlagen decken die häufigsten Abläufe ab – importieren Sie eine und passen Sie die Felder an, statt auf einer leeren Arbeitsfläche zu beginnen.
2. Zugangsdaten anlegen
Legen Sie Zugangsdaten vom Typ WASync API an. Sie enthalten nur ein Feld: Ihren API key,
der als Authorization: Bearer … gesendet wird.
Fügen Sie den oben erstellten Schlüssel ein (siehe Bevor Sie beginnen) – er wird nur einmal angezeigt. Geben Sie ihm nur die Scopes, die der Workflow braucht:
- Verbindungen auflisten und Nachrichten lesen →
whatsapp.read - Senden und als gelesen markieren →
whatsapp.send - der Trigger →
whatsapp.events
Siehe Scopes.
3. Ihr erster Workflow
Der einfachste nützliche Workflow besteht aus zwei Nodes: einem manuellen Trigger und einem Sendeschritt.
Verbindungs-ID finden. Fügen Sie einen WASync-Node hinzu, wählen Sie die Ressource
Connection → Operation List und führen Sie ihn aus. Kopieren Sie die id der Nummer, von der
Sie senden möchten.
Nachricht senden. Fügen Sie einen zweiten WASync-Node hinzu, Ressource Message → Operation Send. Füllen Sie aus:
| Field | Value |
|---|---|
connectionId | die ID, die Sie gerade kopiert haben |
to | internationale Ziffern, ohne + – z. B. 40712345678 |
text | der Nachrichtentext |
Ausführen. Der Node gibt die Nachrichten-ID zurück, über die Sie später verknüpfen können – siehe die zwei IDs.
Vom Node unterstützte Operationen
| Resource | Operation | Parameters |
|---|---|---|
| Connection | List | — |
| Message | Send | connectionId, to, text |
| Message | Get Many | connectionId, limit |
| Message | Mark as Read | — |
Nur Textversand. Das Senden eines WhatsApp-Modells (Template) und die Prüfung, ob eine Nummer bei WhatsApp registriert ist, sind über die API derzeit nicht verfügbar, daher bietet der Node sie nicht an – bauen Sie keinen Workflow, der davon ausgeht, dass es sie gibt.
4. Der Trigger
WASync Trigger startet einen Workflow, wenn in Ihrem Konto etwas passiert. Er unterstützt vier Ereignisse:
message.receivedmessage.statusconnection.connectedconnection.disconnected
Die Payloads sind genau die aus dem Webhooks-Leitfaden – dieselben Felder, dieselben IDs, derselbe
timestamp in Millisekunden.
Ein Webhook-Platz pro Konto – ein Trigger verschiebt ihn
Die API kennt pro Konto nur eine Webhook-URL (PUT /webhook,
POST /webhook/rotate, und kein Löschen). Wenn Sie einen WASync Trigger aktivieren, zeigt dieser
eine Platz auf n8n.
Das heißt: Hat Ihr eigenes Backend bisher Webhooks empfangen, hört es damit auf, sobald der Trigger übernimmt. Und zwei WASync Trigger können den Platz nicht beide belegen – der zweite gewinnt. Brauchen Sie Ereignisse an mehreren Stellen, empfangen Sie sie einmal und verteilen Sie sie selbst weiter: Lassen Sie n8n den Platz halten und aus einem Workflow weiterleiten, oder lassen Sie Ihr Backend ihn halten und einen n8n-Webhook-Node aufrufen.
Test- und Produktions-Trigger-URLs sind verschiedene URLs, daher verschiebt auch der Wechsel zwischen ihnen den Platz.
Da Zustellungen nach drei fehlgeschlagenen Versuchen verworfen werden, sollten Sie auch in n8n einen Abgleichsweg behalten: Ein geplanter Workflow, der alle 30–60 Sekunden Message → Get Many aufruft, fängt alles auf, was der Trigger verpasst hat, während die Instanz neu gestartet wurde.
Wenn der Node nicht ausreicht
Der Node deckt den üblichen Weg ab. Für Medienversand, Kopplungscodes, die Bereitstellung von Verbindungen,
die Verarbeitung von Idempotency-Key oder alles andere in der
API-Referenz nutzen Sie den HTTP Request-Node von n8n mit denselben
Zugangsdaten: Basis-URL https://developers.wasync.app/api/v1, Header
Authorization: Bearer <key>.