Appearance
WhatsApp verbinden
MessengerHub nutzt das Meta WhatsApp Business Cloud API. Gebühren für Gespräche werden direkt von Meta berechnet – MessengerHub erhebt keine zusätzlichen Nachrichtengebühren.
Es gibt zwei Wege, WhatsApp anzubinden — unter Einstellungen → Messaging finden Sie beide zur Auswahl:
- ⭐ Geführte Einrichtung (empfohlen) — MessengerHub führt Sie Schritt für Schritt durch die Verbindung mit Meta, kein technisches Vorwissen nötig. Für die meisten Kunden der richtige Weg.
- Manuelle Einrichtung (für Fortgeschrittene, BYOC) — Sie legen selbst eine eigene Meta-App an und tragen alle Zugangsdaten manuell ein. Sinnvoll bei bestehenden Meta-Entwicklerkonten oder besonderen Anforderungen.
Option A – Geführte Einrichtung (empfohlen)
- Öffnen Sie in MessengerHub Einstellungen → Messaging
- Klicken Sie im Bereich WhatsApp Business auf „Jetzt mit Meta verbinden →"
- Es öffnet sich ein Meta-Anmeldefenster — melden Sie sich mit Ihrem Facebook/Meta-Konto an und folgen Sie den Schritten (Unternehmen bestätigen, WhatsApp-Nummer anlegen oder eine bestehende Nummer verbinden)
- Nach Abschluss zeigt MessengerHub sofort Nummer, Anzeigename und Verbunden seit an — keine weiteren Zugangsdaten nötig
Bereits eine WhatsApp-Business-Nummer? Der geführte Weg unterstützt sowohl das Anlegen einer neuen Nummer als auch das Verbinden einer bereits bestehenden.
Die Verbindung lässt sich jederzeit über „Verbindung trennen" wieder lösen.
Option B – Manuelle Einrichtung (BYOC, für Fortgeschrittene)
Bei dieser Variante verwenden Sie Ihre eigene Meta-App und Ihre eigene WhatsApp Business-Nummer.
Voraussetzungen
Bevor Sie beginnen, benötigen Sie:
- Ein Meta Business Manager-Konto (business.facebook.com)
- Eine verifizierte WhatsApp Business-Telefonnummer
- Zugriff auf die Meta Developer Console (developers.facebook.com)
Schritt 1 – Meta Developer App anlegen
- Öffnen Sie developers.facebook.com und melden Sie sich an
- Klicken Sie oben rechts auf Meine Apps → App erstellen
- Wählen Sie als App-Typ: Business
- Vergeben Sie einen App-Namen (z. B. „Meine Firma WhatsApp")
- Wählen Sie Ihr Business Manager-Konto aus und klicken Sie auf App erstellen
Schritt 2 – WhatsApp-Produkt hinzufügen
- Im App-Dashboard klicken Sie auf Produkt hinzufügen
- Suchen Sie WhatsApp und klicken Sie auf Einrichten
- Wählen Sie Ihr WhatsApp Business-Konto aus
Schritt 3 – Zugangsdaten notieren
Im Bereich WhatsApp → API-Einrichtung finden Sie:
| Feld | Wo es zu finden ist |
|---|---|
| Phone Number ID | WhatsApp → API-Einrichtung → „Von" Nummer |
| Business Account ID | WhatsApp → API-Einrichtung → WhatsApp Business-Konto-ID |
| Access Token | Dauerhafter Token über Meta Business Manager → Systembenutzer (siehe unten) |
| App Secret | Ihre App → Einstellungen → Allgemein → App-Geheimnis → Anzeigen |
💡 Tipp: Sammeln Sie zuerst alle vier Werte — z. B. in einem Notizfeld —, bevor Sie zu MessengerHub wechseln und sie eintragen. Die Werte liegen an unterschiedlichen Stellen im Meta-Dashboard verteilt. Wer sie einzeln nacheinander kopiert und dabei länger zwischen den Tabs wechselt, läuft Gefahr, dass die MessengerHub-Sitzung zwischenzeitlich abläuft oder die Seite sich neu lädt — bereits eingetragene Felder sind dann weg und Sie müssten von vorne beginnen.
Dauerhaften Access Token erstellen (empfohlen):
- Öffnen Sie business.facebook.com
- Gehen Sie zu Einstellungen → Benutzer → Systembenutzer
- Legen Sie einen Systembenutzer an (Rolle: Administrator)
- Klicken Sie auf Assets zuweisen und wählen Sie Ihre WhatsApp-App
- Klicken Sie auf Token generieren, wählen Sie Ihre App und aktivieren Sie
whatsapp_business_messagingundwhatsapp_business_management - Kopieren Sie den generierten Token
Schritt 4 – Webhook konfigurieren
- Im Meta Developer Dashboard unter WhatsApp → Konfiguration → Webhook
- Klicken Sie auf Webhook bearbeiten
- Tragen Sie ein:
- Callback-URL:
https://api.messengerhub.de/webhooks/whatsapp - Verify Token: Den Token aus MessengerHub (siehe Schritt 5)
- Callback-URL:
- Klicken Sie auf Bestätigen und speichern
- Aktivieren Sie unter „Webhook-Felder" das Feld messages
⚠️ Weitere oder neue Telefonnummer hinzugefügt?
Das Webhook-Abo gilt pro WhatsApp Business-Konto. Wenn Sie zu einem bestehenden Konto eine weitere oder neue Nummer hinzufügen, wird das Abo für das Feld messages nicht automatisch mit übernommen. Prüfen Sie in diesem Fall erneut unter WhatsApp → Konfiguration → Webhook, ob „messages" noch aktiv abonniert ist.
Symptom bei fehlendem Abo: Meta zeigt die Nachricht in der eigenen Übersicht als zugestellt an, in MessengerHub kommt aber nichts an.
Schritt 5 – Zugangsdaten in MessengerHub eintragen
- Öffnen Sie in MessengerHub Einstellungen → Messaging
- Im Abschnitt WhatsApp Business:
- Kopieren Sie die Webhook URL und den Verify Token (für Schritt 4)
- Tragen Sie Phone Number ID, Business Account ID, Access Token und App Secret ein
- Klicken Sie auf Speichern
Der Status wechselt auf ✓ Konfiguriert sobald alle Pflichtfelder gespeichert sind.
WhatsApp API — Kosten verstehen
MessengerHub erhebt keine Nachrichtengebühren — Kosten entstehen ausschließlich direkt bei Meta.
⚠️ Wichtiger Hinweis zu Preisangaben
Die nachfolgenden Preise und Informationen zur WhatsApp Business Cloud API stammen von Meta und wurden zum Zeitpunkt der Dokumentation recherchiert. Meta kann Preise, Konversationskategorien und Abrechnungsmodelle jederzeit ohne Vorankündigung ändern.
Bitte informieren Sie sich vor der Einrichtung und regelmäßig danach direkt auf den offiziellen Meta-Seiten:
- Aktuelle Preise: developers.facebook.com/docs/whatsapp/pricing
- Konversationskategorien: Meta Business Help Center
MessengerHub übernimmt keine Haftung für die Aktualität oder Richtigkeit der hier genannten Preisinformationen. Maßgeblich sind ausschließlich die aktuellen Angaben auf den Seiten von Meta.
Das 24-Stunden-Service-Fenster
Wenn ein Kunde zuerst schreibt, öffnet sich automatisch ein 24-Stunden-Fenster:
- In diesem Zeitraum können Sie frei und kostenlos antworten
- Angebote, Rechnungen, Rückfragen, Bilder, PDFs — alles 0 €
- Das Fenster verlängert sich jedes Mal wenn der Kunde antwortet
Tipp: Fordern Sie den Kunden am Ende Ihrer Antwort zu einer Rückmeldung auf — so bleibt das Fenster offen und Sie sparen Kosten.
Kosten pro 24h-Unterhaltung (Deutschland, Stand bei Dokumentationserstellung)
| Kategorie | Preis (ca.) | Wann fällt es an? |
|---|---|---|
| Service | 0,00 € | Kunde schreibt zuerst — 24h-Fenster ist offen |
| Verwaltung | ≈ 0,05 € | Sie schreiben zuerst (Template: Rechnung, Status) |
| Authentifizierung | ≈ 0,05 € | Sie schreiben zuerst (Template: OTP, Zugangscode) |
| Marketing | ≈ 0,11 € | Sie schreiben zuerst (Template: Werbung, Angebote) |
Aktuelle Preise immer direkt bei Meta prüfen — siehe Hinweis oben.
Templates — wann nötig?
Nach Ablauf des 24h-Fensters (oder wenn Sie den Kunden zuerst kontaktieren) benötigen Sie vorab genehmigte Vorlagen. Diese reichen Sie direkt in MessengerHub unter Einstellungen → Templates → WhatsApp-Vorlagen (Meta) ein — die Genehmigung läuft im Hintergrund über Meta, ein zusätzlicher Login im Meta Business Manager ist dafür nicht nötig. Status (ausstehend/genehmigt/abgelehnt) wird automatisch aktualisiert.
Um einen Kunden proaktiv anzuschreiben, der schon länger nicht geschrieben hat, braucht es zusätzlich dessen ausdrückliche Erlaubnis — siehe Kontakte: Konversation starten.
Lesebestätigungen (blaue Haken)
Sobald ein Mitarbeiter eine Konversation in der Inbox öffnet, markiert MessengerHub die letzte eingehende Nachricht automatisch bei Meta als gelesen — der Kunde sieht in seiner eigenen WhatsApp-App die blauen Haken. Das passiert automatisch im Hintergrund, es ist keine Einstellung dafür nötig.
Testverbindung
Senden Sie eine Testnachricht von einem privaten WhatsApp-Account an Ihre Business-Nummer. Die Nachricht sollte innerhalb weniger Sekunden in der MessengerHub-Inbox erscheinen.
Hinweis (nur bei manueller Einrichtung): Der Access Token muss aktiv und die WhatsApp Business-Nummer muss für die Meta-App freigeschaltet sein, damit Nachrichten ankommen.