MessengerHub

Appearance

WhatsApp verbinden ​

MessengerHub nutzt das Meta WhatsApp Business Cloud API (BYOC-Modell). Das bedeutet: Sie verwenden Ihre eigene Meta-App und Ihre eigene WhatsApp Business-Nummer. Gebühren für Gespräche werden direkt von Meta berechnet – MessengerHub erhebt keine zusätzlichen Nachrichtengebühren.

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 ​

  1. Öffnen Sie developers.facebook.com und melden Sie sich an
  2. Klicken Sie oben rechts auf Meine Apps → App erstellen
  3. Wählen Sie als App-Typ: Business
  4. Vergeben Sie einen App-Namen (z. B. „Meine Firma WhatsApp")
  5. Wählen Sie Ihr Business Manager-Konto aus und klicken Sie auf App erstellen

Schritt 2 – WhatsApp-Produkt hinzufügen ​

  1. Im App-Dashboard klicken Sie auf Produkt hinzufügen
  2. Suchen Sie WhatsApp und klicken Sie auf Einrichten
  3. Wählen Sie Ihr WhatsApp Business-Konto aus

Schritt 3 – Zugangsdaten notieren ​

Im Bereich WhatsApp → API-Einrichtung finden Sie:

FeldWo es zu finden ist
Phone Number IDWhatsApp → API-Einrichtung → „Von" Nummer
Business Account IDWhatsApp → API-Einrichtung → WhatsApp Business-Konto-ID
Access TokenDauerhafter Token über Meta Business Manager → Systembenutzer (siehe unten)
App SecretIhre 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):

  1. Öffnen Sie business.facebook.com
  2. Gehen Sie zu Einstellungen → Benutzer → Systembenutzer
  3. Legen Sie einen Systembenutzer an (Rolle: Administrator)
  4. Klicken Sie auf Assets zuweisen und wählen Sie Ihre WhatsApp-App
  5. Klicken Sie auf Token generieren, wählen Sie Ihre App und aktivieren Sie whatsapp_business_messaging und whatsapp_business_management
  6. Kopieren Sie den generierten Token

Schritt 4 – Webhook konfigurieren ​

  1. Im Meta Developer Dashboard unter WhatsApp → Konfiguration → Webhook
  2. Klicken Sie auf Webhook bearbeiten
  3. Tragen Sie ein:
    • Callback-URL: https://api.messengerhub.de/webhooks/whatsapp
    • Verify Token: Den Token aus MessengerHub (siehe Schritt 5)
  4. Klicken Sie auf Bestätigen und speichern
  5. 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 ​

  1. Öffnen Sie in MessengerHub Einstellungen → Messaging
  2. 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
  3. 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:

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) ​

KategoriePreis (ca.)Wann fällt es an?
Service0,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 Templates. Diese erstellen und verwalten Sie direkt im Meta Business Manager. In MessengerHub können Sie Templates für häufige Antworten unter Einstellungen → Templates speichern.

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: Der Access Token muss aktiv und die WhatsApp Business-Nummer muss für die Meta-App freigeschaltet sein, damit Nachrichten ankommen.