diff --git a/Kapitel 18/Free Rohtext.md b/Kapitel 18/Free Rohtext.md index 6884b92..22ef3ba 100644 --- a/Kapitel 18/Free Rohtext.md +++ b/Kapitel 18/Free Rohtext.md @@ -523,3 +523,152 @@ Damit ist der Dauerbetrieb von WAHA gewährleistet. Der Container startet automatisch, hält die Verbindung dauerhaft aktiv und bleibt über die Proxy-Domain `https://waha.deinedomain.tld` sicher erreichbar. +### Schritt 8 – Webhook und automatische Antwort einrichten + +Ziel dieses Schritts ist ein vollständig funktionierender Workflow: +Wenn eine WhatsApp-Nachricht bei **WAHA** eingeht, empfängt **n8n** sie automatisch, +analysiert den Inhalt und sendet sofort eine Antwort an den Absender zurück. + +👉 **Screenshot geeignet:** Übersicht WAHA → n8n → WAHA-Rückkanal + +> [!NOTE] +> Alle hier verwendeten Nodes sind in der Community-Version von n8n enthalten. +> Für diesen Basis-Workflow wird keine externe API oder kostenpflichtige Integration benötigt. + +#### Workflow in n8n erstellen + +Öffne dein n8n-Dashboard und lege einen neuen Workflow an. + +##### Node 1 – Webhook (Trigger) + +**Zweck:** +Empfängt eingehende WhatsApp-Nachrichten direkt von WAHA als JSON-Payload. + +**Node-Typ:** Webhook +**Name:** Eingang – WhatsApp + +**Parameter:** +- **HTTP Method:** POST +- **Path:** `whatsapp` + → ergibt: + ``` + https://n8n.deinedomain.tld/webhook/whatsapp + ``` +- **Response Mode:** On Received +- **Response Code:** 200 + +👉 **Screenshot geeignet:** n8n-Webhook-Node mit sichtbarer URL `https://n8n.deinedomain.tld/webhook/whatsapp` + +##### Node 2 – Function (Nachricht analysieren) + +**Zweck:** +Extrahiert Absender und Nachrichtentext aus dem empfangenen JSON, +damit sie in der Antwort verwendet werden können. + +**Node-Typ:** Function +**Name:** Nachricht analysieren + +**Verbindung:** +Eingang von **Node 1 (Webhook)** + +**Code:** +```javascript +return [{ + chatId: $json["from"], + text: $json["text"] +}]; +``` + +👉 **Screenshot geeignet:** Function-Node mit sichtbaren Variablen `chatId` und `text` + +> [!NOTE] +> WAHA übergibt den Absender im Format `491701234567@c.us`. +> Diese Schreibweise wird in der Antwort unverändert benötigt. + +##### Node 3 – HTTP Request → Antwort senden + +**Zweck:** +Sendet über die WAHA-API eine automatische Antwort an den Absender der eingegangenen Nachricht. + +**Node-Typ:** HTTP Request +**Name:** Antwort senden → WAHA + +**Verbindung:** +Eingang von **Node 2 (Function)** + +**Parameter:** +- **Method:** POST +- **URL:** + ``` + https://waha.deinedomain.tld/api/sendText + ``` +- **Authentication:** keine +- **Header Parameter:** + - `Content-Type`: `application/json` +- **Body:** + ```json + { + "chatId": "={{$json["chatId"]}}", + "text": "Hallo! Vielen Dank für deine Nachricht. Dies ist eine automatische Antwort – eine persönliche Rückmeldung folgt so schnell wie möglich." + } + ``` + +👉 **Screenshot geeignet:** HTTP-Request-Node mit Ziel-URL `/api/sendText` und markiertem JSON-Body + +> [!TIP] +> Du kannst den Antworttext jederzeit anpassen oder später dynamisch durch eine KI oder Datenquelle ersetzen. +> Wichtig ist, dass die Variable `chatId` exakt aus der eingehenden Nachricht übernommen wird. + +##### Node 4 – Respond to Webhook + +**Zweck:** +Bestätigt gegenüber WAHA, dass die Nachricht erfolgreich verarbeitet wurde. + +**Node-Typ:** Respond to Webhook +**Name:** Bestätigung an WAHA + +**Verbindung:** +Eingang von **Node 1 (Webhook)** + +**Parameter:** +- **Response Code:** 200 +- **Response Body:** + ```json + { "status": "ok" } + ``` + +👉 **Screenshot geeignet:** Respond-Node mit Body `{ "status": "ok" }` + +#### Test + +1. Aktiviere den Workflow (**Activate Workflow**). +2. Sende vom verbundenen WhatsApp-Gerät eine Nachricht, z. B. + ``` + Hallo aus dem Kontrollzentrum! + ``` +3. n8n zeigt das empfangene Event im Webhook-Node an. +4. Innerhalb weniger Sekunden erhältst du auf dem Handy automatisch folgende Antwort: + ``` + Hallo! Vielen Dank für deine Nachricht. Dies ist eine automatische Antwort – eine persönliche Rückmeldung folgt so schnell wie möglich. + ``` + +👉 **Screenshot geeignet:** WhatsApp-Chat mit empfangener automatischer Antwort + +> [!NOTE] +> Wenn keine Antwort ankommt, prüfe: +> – WAHA-Container läuft und ist „connected“ +> – n8n-Workflow aktiv +> – HTTPS-Zertifikate gültig +> – Logs: +> ```bash +> docker compose logs -f waha +> ``` +> anzeigen + +Damit ist die erste bidirektionale Integration zwischen **WAHA** und **n8n** abgeschlossen. +Das System empfängt WhatsApp-Nachrichten automatisch und reagiert selbstständig – +die Grundlage für spätere erweiterte Automatisierungen oder KI-gesteuerte Antworten. + +--- + +