WhatsApp Einrichtung

FRENZY.BOT enthält eine One-Click-WhatsApp-Integration, die von WAHA (WhatsApp HTTP API) unterstützt wird. Nach der Aktivierung kann Ihr KI-Assistent automatisch WhatsApp-Nachrichten empfangen und beantworten – inklusive Lead-Erfassung, Handoff-Unterstützung und Konversations-Tracking.

Voraussetzungen

WhatsApp-Kanal in Channels aktiviert
Eine WhatsApp-fähige Telefonnummer
WhatsApp-Dienst auf Ihrem Server aktiviert (erfolgt automatisch während des Setups)

Schritt-für-Schritt-Einrichtung

Schritt 1: Den WhatsApp-Kanal hinzufügen

Gehen Sie in der Sidebar des Dashboards auf Channels.
Klicken Sie im Bereich Catalog (linke Navigation) auf WhatsApp.
Schalten Sie den Kanal auf Active.

Automatische Installation

Der WhatsApp-Dienst ist vorinstalliert und bereit, sobald Ihr Server bereitgestellt wird. Außer der Aktivierung ist keine zusätzliche Einrichtung erforderlich.

Schritt 2: Den WhatsApp-Dienst starten

Nach der Aktivierung sehen Sie das Panel Service Status.
Das Dashboard zeigt den Dienststatus an:
- Running (grün): Der Dienst ist aktiv und bereit.
- Starting (gelb): Der Dienst fährt hoch. Warten Sie 10–30 Sekunden.
- Stopped (rot): Klicken Sie auf Start, um den Dienst zu starten.
Verwenden Sie die Schaltflächen Start / Stop / Restart, um den Dienst zu steuern.

Schritt 3: Ihr WhatsApp-Konto verbinden

Sobald der Dienst Running anzeigt und die API erreichbar ist, wird der WhatsApp-Bereich freigeschaltet.
Klicken Sie auf Connect WhatsApp.
Ein QR-Code erscheint auf dem Bildschirm.
Öffnen Sie WhatsApp auf Ihrem Telefon → Einstellungen → Verknüpfte Geräte → Gerät hinzufügen.
Scannen Sie den QR-Code.
Warten Sie, bis der Verbindungsstatus Connected anzeigt.

QR-Code-Timing

Der QR-Code wird alle 30 Sekunden aktualisiert. Wenn er abläuft, klicken Sie auf Refresh QR, um einen neuen zu generieren. Halten Sie Ihr Telefon während der Einrichtung bereit.

Schritt 4: Die Verbindung testen

Senden Sie eine Nachricht von einem anderen Telefon an Ihre WhatsApp-Nummer.
Der Bot sollte basierend auf Ihrer Wissensdatenbank und Ihrem KI-Modell antworten.
Überprüfen Sie die Seite Conversations im Dashboard, um zu bestätigen, dass die Nachricht erschienen ist.

Funktionsweise

Sobald die Verbindung hergestellt ist, übernimmt FRENZY.BOT die WhatsApp-Nachrichten von Anfang bis Ende:

Eingehende Nachricht → WAHA empfängt sie und leitet sie per Webhook an FRENZY.BOT weiter.
KI-Verarbeitung → Der Bot ruft relevante Inhalte aus der Wissensdatenbank ab und generiert eine Antwort.
Antwort gesendet → Die Antwort wird über WhatsApp an den Benutzer zurückgeschickt.
Lead-Erfassung → Wenn der Benutzer Kontaktdaten angibt, wird automatisch ein Lead erstellt.
Handoff → Wenn der Benutzer einen Menschen anfordert, wird die Konversation an Ihre Live-Chat-Agenten eskaliert.

Antwortstil des Kanals

WhatsApp-Antworten werden automatisch an das Messaging-Format angepasst:

Kürzere, dialogorientierte Antworten (standardmäßig unter 2 Sätzen).
Freundlicher Ton, passend für mobiles Messaging.
Sie können den WhatsApp-Antwortstil unter Settings → Channels anpassen.

Verwaltung des WhatsApp-Dienstes

Dienst-Steuerung

Das Dashboard bietet direkte Steuerelemente für den WhatsApp-Dienst:

Aktion	Funktion
Start	Startet den Dienst, falls er gestoppt ist
Stop	Beendet den Dienst ordnungsgemäß
Restart	Stoppt und startet neu (nützlich nach Konfigurationsänderungen)
Status	Zeigt den aktuellen Status + API-Health-Check

WhatsApp trennen

Um Ihr WhatsApp-Konto zu trennen, ohne das Modul zu entfernen:

Gehen Sie zu Settings → WhatsApp.
Klicken Sie auf Disconnect.
Der Bot empfängt ab sofort keine WhatsApp-Nachrichten mehr.
Historische Konversationen und Leads bleiben erhalten.

Um später eine Verbindung wiederherzustellen, scannen Sie einfach einen neuen QR-Code.

Sicherheit

Der WhatsApp-Dienst ist durch eine Firewall geschützt und nur von Ihrem Server aus zugänglich.
API-Keys werden automatisch generiert und sicher gespeichert.
WhatsApp-Nachrichten werden auf Ihrem privaten Server verarbeitet – sie fließen niemals über Cloud-Dienste von Drittanbietern.

FAQ

F: Der QR-Code lässt sich nicht scannen.

Stellen Sie sicher, dass der WAHA-Dienst Running anzeigt und der API-Health-Check grün ist.
Versuchen Sie, den QR-Code zu aktualisieren.
Stellen Sie sicher, dass Ihr Telefon eine stabile Internetverbindung hat.

F: Nachrichten werden nicht empfangen.

Überprüfen Sie, ob der WhatsApp-Sitzungsstatus Connected anzeigt.
Vergewissern Sie sich, dass die Webhook-URL korrekt konfiguriert ist (dies geschieht in den meisten Setups automatisch).
Kontaktieren Sie Ihren Account Manager, falls das Problem weiterhin besteht.

F: Kann ich stattdessen die WhatsApp Business API verwenden?

FRENZY.BOT verwendet derzeit WAHA (gerätebasiertes WhatsApp). Die Unterstützung der WhatsApp Business API (Cloud-basiert) steht auf der Roadmap.

F: Wie viele Konversationen kann WhatsApp bewältigen?

Die NOWEB-Engine ist ressourcenschonend und bewältigt Standard-Geschäftsvolumina effizient. Für sehr hohe Volumina (über 1000 gleichzeitige Chats) kontaktieren Sie bitte Ihren Account Manager für Skalierungsoptionen.

F: Verliere ich meinen WhatsApp-Chatverlauf, wenn ich den Dienst neu starte?

Nein. Ein Neustart des Dienstes bleibt die WhatsApp-Sitzung erhalten. Sie müssen den QR-Code nur dann neu scannen, wenn Sie die Verbindung explizit getrennt haben.