Kapitel 18/Free Rohtext.md aktualisiert

2025-10-19 20:15:37 +00:00
parent 10ae311dac
commit 089fa41ee6
1 changed files with 149 additions and 0 deletions
--- a/Rohtext.md
+++ b/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.
+
+---
+
+