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:
- Navigieren Sie zu Mein Betrieb → Tab Kanaele.
- Scrollen Sie zur Karte WhatsApp.
- Klicken Sie auf Mit WhatsApp verbinden.
- Es oeffnet sich das Meta Embedded Signup-Fenster. Melden Sie sich mit Ihrem Facebook-Geschaeftskonto an.
- Waehlen Sie die WhatsApp-Geschaeftsnummer aus oder erstellen Sie eine neue.
- Bestaetigen Sie die Verbindung.
- 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:
- Navigieren Sie zu Mein Betrieb → Tab Kanaele.
- Oeffnen Sie die Karte Twilio / Telefonie.
- 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)
- Klicken Sie auf Speichern.
- Konfigurieren Sie in Ihrem Twilio-Dashboard den Webhook-URL:
- Webhook-URL:
https://www.hebelki.de/api/whatsapp/webhook
- Webhook-URL:
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:
- Navigieren Sie zu Mein Betrieb → Tab Kanaele → WhatsApp.
- Klicken Sie auf Verbindung trennen.
- 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 & Daten → Gespraeche eingesehen werden.