n8n-Integration

Senden Sie WhatsApp-Nachrichten aus Ihren n8n-Workflows. Schreiben Sie zum Beispiel einem neuen Lead aus einem Webhook, bestätigen Sie eine Bestellung aus Ihrem Shop oder senden Sie eine Warnung, wenn eine Prüfung fehlschlägt.

Es gibt zwei Möglichkeiten der Anbindung:

• Die Wbiztool-Community-Node (n8n-nodes-wbiztool): fertige Nodes mit Feldern für jede Option.
• Die integrierte HTTP-Request-Node: funktioniert auf jeder n8n-Instanz und bietet Zugriff auf jeden API-Endpoint. Siehe Die HTTP-Request-Node verwenden.

Bevor Sie beginnen#

• Ein Wbiztool-Konto mit einer verbundenen WhatsApp-Nummer in den WhatsApp-Einstellungen.
• Ihre Client-ID und Ihr API-Schlüssel aus Einstellungen → API-Schlüssel.
• Die WhatsApp-Client-ID der Absendernummer, angezeigt in den WhatsApp-Einstellungen.

Community-Node installieren#

1. Community-Nodes öffnen

   Gehen Sie in n8n zu Settings → Community Nodes (Einstellungen → Community-Nodes) und klicken Sie auf Install.

2. Paketnamen eingeben

   Geben Sie n8n-nodes-wbiztool ein, bestätigen Sie und installieren Sie. Starten Sie n8n neu, falls die Nodes nicht erscheinen.

Auf einer selbst gehosteten Instanz können Sie die Node auch mit npm in Ihrem Ordner für benutzerdefinierte n8n-Nodes installieren:

npm install n8n-nodes-wbiztool

Zugangsdaten anlegen#

Legen Sie neue Zugangsdaten (Credential) vom Typ WbizTool API an:

Beim Speichern testet n8n die Zugangsdaten mit Zugangsdaten prüfen.

Nodes#

Das Paket fügt diese Nodes hinzu. Jede ruft einen Wbiztool-API-Endpoint auf und gibt die API-Antwort aus.

WbizTool Send Message#

Die Node gibt messageId aus (die msg_id der API). Speichern Sie sie, wenn Sie später den Status prüfen oder die Nachricht stornieren möchten.

Beispiel-Workflow#

1. Eine Webhook-Node empfängt einen neuen Lead mit phone und name.
2. WbizTool Send Message: Setzen Sie Phone Number auf {{ $json.phone }} und Message Text auf Hi {{ $json.name }}, thanks for signing up!.
3. IF-Node: Prüfen Sie, ob {{ $json.messageId }} nicht leer ist, um mit dem nächsten Schritt fortzufahren, etwa dem Aktualisieren Ihres CRM.

Eine erfolgreiche WbizTool Send Message gibt ein Item wie dieses aus:

{
  "success": true,
  "messageId": 9817263,
  "status": 1,
  "message": "Created",
  "response": { "status": 1, "message": "Created", "msg_id": 9817263 }
}

Das Item enthält außerdem ein Objekt input mit den Werten, die die Node gesendet hat. Gibt die API einen Fehler zurück, stoppt die Node und zeigt die message der API. Aktivieren Sie Continue On Fail, um stattdessen ein Item mit success: false und dem Text in error zu erhalten.

Verwenden Sie für WbizTool WhatsApp Client Status die Prüfmethode General Status. Die Methode Status by ID liefert wegen eines Fehlers in diesem API-Endpoint für jede Nummer einen Fehler. Bei General Status stoppt eine nicht verbundene Nummer die Node ebenfalls, mit dem Fehler Disconnected. Aktivieren Sie daher in der Node die Einstellung Continue On Fail, wenn Sie anhand des Ergebnisses verzweigen möchten.

Die HTTP-Request-Node verwenden#

Fügen Sie eine HTTP Request-Node hinzu und konfigurieren Sie sie so:

Fügen Sie dann einen Body wie diesen ein und ordnen Sie die Werte mit Ausdrücken (Expressions) aus vorherigen Nodes zu:

{
  "client_id": 12345,
  "api_key": "YOUR_API_KEY",
  "whatsapp_client": 678,
  "msg_type": 0,
  "country_code": "91",
  "phone": "{{ $json.phone }}",
  "msg": "Hi {{ $json.name }}, thanks for signing up!"
}

Ein erfolgreicher Aufruf gibt {"status": 1, "message": "Created", "msg_id": 9817263} zurück. Alle Felder und Fehlermeldungen finden Sie unter Nachricht senden.

Um andere Endpoints aufzurufen, ändern Sie URL und Body. Um zum Beispiel eine Nachricht zu planen, verwenden Sie https://wbiztool.com/api/v1/schedule_msg/ und fügen date als DD/MM/YYYY, time als HH:MM und timezone hinzu. Siehe Nachricht planen.

Um dieselbe Nachricht mit einem einzigen Aufruf an mehrere Nummern oder Gruppen zu senden, verwenden Sie https://wbiztool.com/api/v1/send_msg/multi/ und übergeben die Empfänger in phone als einen kommagetrennten String. Siehe An mehrere Nummern senden.

{
  "client_id": 12345,
  "api_key": "YOUR_API_KEY",
  "whatsapp_client": 678,
  "msg_type": 1,
  "country_code": "91",
  "phone": "{{ $json.phones }}",
  "img_url": "https://example.com/offers/diwali-sale.jpg",
  "msg": "Our Diwali sale starts tomorrow!"
}

Tragen Sie in jede Nummer nur Ziffern ein. Alles, was keine ganze Zahl ist, etwa 98765 43210, wird als Gruppenname gesendet.

n8n-Ausdrücke funktionieren in jedem Textfeld. Zum Beispiel eine Begrüßung, die von der Tageszeit abhängt, oder ein Text, der von der Bestellsumme abhängt:

{
  "msg": "Good {{ $now.hour < 12 ? 'morning' : 'evening' }} {{ $json.name }}, your order total is {{ $json.total }}.{{ $json.total > 1000 ? ' Delivery is free.' : '' }}"
}

$now verwendet die Zeitzone des Workflows (Workflow settings → Timezone). Stellen Sie sie also ein, um festzulegen, wann „morning“ endet.

Benachrichtigung erhalten, wenn eine Nachricht gesendet wurde#

1. Webhook-Workflow erstellen

   Fügen Sie eine Webhook-Node mit der HTTP-Methode POST hinzu und kopieren Sie ihre Production-URL.

2. URL beim Senden übergeben

   Tragen Sie diese URL in die Option Webhook URL der Node oder in das Feld webhook Ihres HTTP-Request-Bodys ein.

3. Ergebnis auswerten

   Wbiztool ruft die URL auf, sobald die Nachricht gesendet wurde oder fehlgeschlagen ist. Der Body ist form-codiert und enthält nur msg_id und status, der SENT oder FAILED lautet.

Zu Wiederholungen und Zeitüberschreitungen siehe Webhook.

Fehlerbehebung#