WhatsApp Business verbinden

Die WhatsApp Business Integration ermöglicht es Ihnen, WhatsApp-Unterhaltungen direkt aus Ihrem Deskwoot-Posteingang zu verwalten. Deskwoot nutzt die offizielle WhatsApp Cloud API von Meta, die kostenlos eingerichtet werden kann. So bündeln Sie Ihre Kundenkommunikation an einem zentralen Ort und können Anfragen schneller beantworten.

Voraussetzungen

• Ein Meta Business-Konto (business.facebook.com)
• Eine Telefonnummer, die noch nicht bei WhatsApp oder der WhatsApp Business App registriert ist
• Zugang zur WhatsApp Business API – verfügbar über die Meta-Entwicklerplattform ohne Einrichtungskosten

Schnellverbindung (empfohlen)

Der schnellste Weg ist die Schaltfläche „WhatsApp über Facebook verbinden":

1. Navigieren Sie zu Einstellungen > Posteingänge > Posteingang hinzufügen > WhatsApp.
2. Klicken Sie auf die Schaltfläche „WhatsApp über Facebook verbinden".
3. Melden Sie sich bei Ihrem Meta Business-Konto an.
4. Wählen Sie ein bestehendes WhatsApp Business-Konto aus oder erstellen Sie ein neues.
5. Verifizieren Sie Ihre Telefonnummer – Webhooks werden dabei automatisch konfiguriert.

Manuelle Einrichtung

Falls Sie die Verbindung manuell konfigurieren möchten, benötigen Sie drei Werte aus Ihrem Meta Developer Dashboard:

• Phone Number ID
• Ein permanentes Access Token – erstellen Sie dazu einen System User in den Meta Business-Einstellungen
• Ein Verify Token – eine beliebige, selbst gewählte Zeichenfolge

Geben Sie diese drei Werte in den WhatsApp-Posteingangs-Einstellungen von Deskwoot ein.

Webhook-Konfiguration

Bei der Schnellverbindung werden Webhooks automatisch eingerichtet. Bei manueller Einrichtung gehen Sie wie folgt vor:

1. Kopieren Sie die Webhook-URL und das Verify Token aus den Deskwoot-Einstellungen.
2. Fügen Sie beide Werte in die WhatsApp-Webhook-Einstellungen Ihrer Meta-App ein.
3. Abonnieren Sie das Webhook-Feld messages.

Nachrichtenvorlagen

WhatsApp erfordert vorab genehmigte Nachrichtenvorlagen für ausgehende Nachrichten außerhalb des 24-Stunden-Kundenservice-Fensters. Erstellen Sie diese Vorlagen im Meta Business Manager. Verwenden Sie sie aus Deskwoot heraus, wenn Sie neue Unterhaltungen starten oder Kunden nach Ablauf des Fensters erneut kontaktieren möchten.

Tipps für den Alltag

• Antworten Sie zeitnah: Innerhalb des 24-Stunden-Fensters können Sie frei antworten. Danach ist eine genehmigte Vorlage erforderlich.
• Halten Sie Vorlagen aktuell: Prüfen Sie regelmäßig den Genehmigungsstatus Ihrer Vorlagen im Meta Business Manager.
• Telefonnummer nicht doppelt verwenden: Eine Nummer, die bereits in der regulären WhatsApp-App aktiv ist, kann nicht für die API genutzt werden.

Fehlerbehebung

• Nachrichten kommen nicht an: Überprüfen Sie, ob der Webhook korrekt konfiguriert ist und das Feld messages abonniert wurde.
• Access Token ungültig: Stellen Sie sicher, dass Sie ein permanentes Token über einen System User erstellt haben. Temporäre Tokens laufen nach kurzer Zeit ab.
• Telefonnummer wird abgelehnt: Die Nummer darf nicht gleichzeitig in der WhatsApp- oder WhatsApp Business App registriert sein. Löschen Sie das bestehende Konto auf dem Gerät, bevor Sie die Nummer für die API verwenden.

Häufig gestellte Fragen

Ist die WhatsApp Cloud API kostenlos?

Die Einrichtung über Meta ist kostenlos. Meta berechnet jedoch Gebühren pro Unterhaltung gemäß dem aktuellen Preismodell. Details finden Sie in der offiziellen Meta-Dokumentation.

Kann ich eine bestehende WhatsApp-Business-App-Nummer verwenden?

Nein. Die Nummer darf nicht gleichzeitig in der WhatsApp Business App registriert sein. Sie müssen das bestehende Konto auf dem Gerät zunächst entfernen.

Was passiert nach Ablauf des 24-Stunden-Fensters?

Nach Ablauf des Fensters können Sie den Kunden nur über eine vorab genehmigte Nachrichtenvorlage erneut kontaktieren. Freie Textnachrichten sind dann nicht mehr möglich.