WhatsApp Business einrichten

Für WhatsApp Business nutzt Deskwoot die offizielle WhatsApp Cloud API von Meta, deren Registrierung kostenlos ist: Du verbindest ein Meta-Business-Konto, verifizierst eine Telefonnummer, und die WhatsApp-Inbox empfängt Nachrichten neben deinen anderen Kanälen. So bearbeitest du WhatsApp-Konversationen zusammen mit E-Mail, Live-Chat und weiteren Kanälen an einem Ort.

Voraussetzungen

Bevor du loslegst, brauchst du:

• Ein Meta-Business-Konto unter business.facebook.com
• Eine verifizierte Telefonnummer, die nicht schon in der WhatsApp- oder WhatsApp-Business-App registriert ist
• Eine Facebook-App mit aktiviertem WhatsApp-Produkt im Meta-Entwickler-Dashboard (nur für die manuelle Einrichtung)

Schritt 1: API-Zugangsdaten besorgen

Öffne in deinem Meta-Entwickler-Dashboard die WhatsApp-Einstellungen deiner App und such diese Werte heraus:

1. Phone Number ID
2. Access Token. Meta stellt standardmäßig einen temporären Token bereit. Für den Livebetrieb erzeugst du in deinen Meta-Business-Einstellungen unter System Users einen dauerhaften System-User-Token.
3. App Secret (empfohlen), unter App Settings > Basic in deiner Meta-App. Damit prüft Deskwoot, dass eingehende Webhooks wirklich von Meta kommen.

Kopiere diese Zugangsdaten und halte sie für den nächsten Schritt bereit. Einen Verify Token legst du selbst fest, ein beliebiger Text reicht.

Schritt 2: Mit Deskwoot verbinden

1. Öffne in Deskwoot Einstellungen > Posteingänge > Posteingang hinzufügen.
2. Wähle WhatsApp als Kanal.
3. Öffne Erweitert: manuell mit den Zugangsdaten deiner eigenen Meta-App verbinden und trag Phone Number ID, Access Token, Verify Token und App Secret ein.
4. Klicke auf Posteingang erstellen.

Öffne danach in deiner Meta-App WhatsApp > Configuration, füge die Webhook-URL von Deskwoot aus der Einrichtung ein, trag denselben Verify Token ein, klicke auf Verify and Save und abonniere das Feld messages.

Schneller geht es ohne eigene Meta-App: Klicke stattdessen unter Mit Meta verbinden auf Mit WhatsApp verbinden, wähle im Fenster von Meta dein Konto und deine Nummer, und Deskwoot richtet den Webhook für dich ein. Eine Nummer, die schon über Twilio läuft, verbindest du mit Verbinde stattdessen deine Twilio-Nummer (Account SID, Auth Token, WhatsApp-Telefonnummer).

Schritt 3: Einrichtung testen

Schick von einem beliebigen privaten WhatsApp-Konto eine Nachricht an deine verbundene Nummer. Sie sollte nach wenigen Sekunden als neue Konversation in deiner Deskwoot-Inbox erscheinen. Antworte aus Deskwoot heraus, um zu prüfen, ob Nachrichten in beide Richtungen ankommen.

Häufige Probleme beheben

• Nachrichten kommen nicht an: Prüfe, ob dein Access Token noch gültig ist. Temporäre Tokens halten nur 24 Stunden. Wechsle zu einem dauerhaften System-User-Token, damit die Verbindung nicht abreißt.
• Telefonnummer schon registriert: Ist die Nummer mit der WhatsApp- oder WhatsApp-Business-App verknüpft, musst du sie dort löschen, bevor du sie mit der Cloud API nutzen kannst.
• Webhook-Fehler: Prüfe, ob deine Meta-App im Modus Live läuft und nicht im Entwicklungsmodus, und ob das WhatsApp-Produkt richtig zu deiner App hinzugefügt ist.

Tipps

• Nutze immer einen dauerhaften System-User-Token, damit die Verbindung nicht unerwartet abbricht.
• Richte in Deskwoot die automatische Zuweisung ein, damit eingehende WhatsApp-Konversationen beim richtigen Team oder Agenten landen.
• Denk an das 24-Stunden-Fenster von WhatsApp. Innerhalb von 24 Stunden nach der letzten Kundennachricht kannst du frei antworten. Danach stellt WhatsApp nur noch genehmigte Nachrichtenvorlagen zu, und Deskwoot zeigt einen Hinweis in der Konversation, statt deine Antwort zu senden.

Häufige Fragen