Zum Hauptinhalt springen
Hebelki
Zurueck zur Uebersicht

WhatsApp

WhatsApp-Integration fuer automatische Kundenkommunikation ueber Twilio oder Meta Cloud API.

WhatsApp-Integration Uebersicht

Hebelki unterstuetzt zwei Wege, WhatsApp mit Ihrem Unternehmen zu verbinden:

  • Meta Cloud API (empfohlen) – Direkte Verbindung ueber Meta Embedded Signup. Einfachste Einrichtung mit einem Klick.
  • Twilio BYOT (Bring Your Own Twilio) – Fuer Unternehmen, die bereits ein Twilio-Konto nutzen.

Eingehende WhatsApp-Nachrichten von Kunden werden automatisch an den KI-Chatbot oder Live-Chat weitergeleitet. Der Chatbot kann Fragen beantworten, Verfuegbarkeiten pruefen und Termine buchen – alles direkt ueber WhatsApp.

Kanalidentitaet: Wenn eine eingehende Nachricht von einer Telefonnummer stammt, die einem Inhaber oder Admin zugeordnet ist, wird sie an den internen Assistenten statt an den Kunden-Chatbot weitergeleitet.

Meta Cloud API einrichten

Die schnellste Methode, WhatsApp zu verbinden:

  1. Navigieren Sie zu Mein Betrieb → Tab Kanaele.
  2. Scrollen Sie zur Karte WhatsApp.
  3. Klicken Sie auf Mit WhatsApp verbinden.
  4. Es oeffnet sich das Meta Embedded Signup-Fenster. Melden Sie sich mit Ihrem Facebook-Geschaeftskonto an.
  5. Waehlen Sie die WhatsApp-Geschaeftsnummer aus oder erstellen Sie eine neue.
  6. Bestaetigen Sie die Verbindung.
  7. Die Karte zeigt nun den Status Verbunden mit Ihrer WhatsApp-Nummer an.

Voraussetzung: Sie benoetigen ein Facebook-Geschaeftskonto (Meta Business Suite). Die Verifizierung Ihres Unternehmens bei Meta kann einige Tage dauern.

Twilio WhatsApp einrichten

Wenn Sie bereits ein Twilio-Konto haben:

  1. Navigieren Sie zu Mein Betrieb → Tab Kanaele.
  2. Oeffnen Sie die Karte Twilio / Telefonie.
  3. Geben Sie Ihre Twilio-Zugangsdaten ein:
    • Account SID – Ihre Twilio Account-SID
    • Auth Token – Ihr Twilio Auth Token
    • Telefonnummer – Ihre Twilio WhatsApp-Nummer (z. B. +4915123456789)
  4. Klicken Sie auf Speichern.
  5. Konfigurieren Sie in Ihrem Twilio-Dashboard den Webhook-URL:
    • Webhook-URL: https://www.hebelki.de/api/whatsapp/webhook

Hinweis: Twilio-Zugangsdaten werden verschluesselt gespeichert (AES-256-GCM). Sie werden auch fuer den Sprachassistenten (SIP-Trunk) verwendet.

WhatsApp-Chatbot und Routing

Sobald WhatsApp verbunden ist, funktioniert der Chatbot automatisch:

  • Kundennachrichten werden vom Webhook empfangen und an den KI-Chatbot weitergeleitet.
  • Der Chatbot hat Zugriff auf alle konfigurierten Tools: Dienstleistungen anzeigen, Verfuegbarkeit pruefen, Termine buchen.
  • Bei aktiviertem Live-Chat kann der Kunde zum Mitarbeiter eskalieren.
  • Inhaber/Admin-Erkennung: Nachrichten von hinterlegten Telefonnummern (Team-Telefone unter Kanaele) werden an den internen Assistenten geroutet, nicht an den Kunden-Chatbot.

Tipp: Tragen Sie die Telefonnummern aller Mitarbeiter im Bereich Team-Telefone ein, damit interne Nachrichten korrekt erkannt werden.

WhatsApp-Verbindung trennen

So trennen Sie die WhatsApp-Verbindung:

  1. Navigieren Sie zu Mein Betrieb → Tab KanaeleWhatsApp.
  2. Klicken Sie auf Verbindung trennen.
  3. Bestaetigen Sie die Trennung.

Nach der Trennung werden eingehende WhatsApp-Nachrichten nicht mehr verarbeitet. Bestehende Gespraechsverlaeufe bleiben in der Datenbank erhalten und koennen unter Chatbot & DatenGespraeche eingesehen werden.