WhatsApp

Die Nachrichten gehen von Ihrer Nummer aus, über Ihr Konto bei Meta. Ohne die Integration verschickt die App nichts per WhatsApp: Der Bildschirm kann den Knopf haben, aber der Versand wird mit dem Hinweis abgelehnt, dass WhatsApp in dieser App nicht eingerichtet ist.

Bevor Sie anfangen

• Tarif: Builder. Der Tarif wird bei jedem Versand geprüft: Verlässt das Konto den Builder, hört die App auf zu senden;
• Konto bei Meta for Developers und, für die Produktion, ein Meta-Unternehmenskonto mit einer eigenen Telefonnummer für WhatsApp;
• Kosten: Meta berechnet die Nachrichten nach der eigenen Preisliste über Ihr Konto. Zusätzlich verbraucht jede von der App gesendete Nachricht Integrations-Credits der Plattform, und zwar nur, wenn Meta den Versand annimmt.

Was die App mit der Integration macht

• eine Textnachricht an eine Nummer senden;
• eine Vorlagennachricht (Template) senden, die Meta freigegeben hat, in der Sprache der Vorlage;
• Nachrichten empfangen und Automationen auslösen, wenn jemand an die Nummer schreibt. Dafür sind die letzten beiden Felder der Karte da (siehe Ende dieses Leitfadens).

Die Nummern stehen im internationalen Format, mit Ländervorwahl: +5511999999999.

Schritt für Schritt

Felder der Karte: Phone Number ID, Access Token, Verify Token (Webhook) und App Secret (Webhook-Signatur).

1. legen Sie in developers.facebook.com eine App vom Typ Business an;
2. fügen Sie der App das Produkt WhatsApp hinzu. Meta stellt bereits eine Testnummer bereit;
3. kopieren Sie unter WhatsApp → API Setup die Phone number ID und den Zugriffstoken;
4. zeigen Sie unter Einstellungen → Allgemeines das App Secret an und kopieren Sie es;
5. denken Sie sich einen Verify Token aus: einen beliebigen geheimen Text, den Sie im Meta-Panel wiederverwenden, wenn Sie Nachrichten empfangen wollen;
6. öffnen Sie im Editor der App, Tab Integrationen, Kategorie Benachrichtigungen, die Karte WhatsApp;
7. füllen Sie die vier Felder aus und klicken Sie auf Speichern und aktivieren.

Testtoken und dauerhafter Token

Der Token, der unter API Setup erscheint, ist vorläufig und läuft nach etwa 24 Stunden ab. Er reicht für den ersten Test und sonst nichts. Für die App im Einsatz erzeugen Sie einen dauerhaften Token mit einem Systemnutzer, unter Unternehmenseinstellungen → Systemnutzer, und geben ihm Zugriff auf die App und auf WhatsApp. Öffnen Sie danach die Karte, fügen Sie den neuen Token in sein Feld ein und speichern Sie. Die anderen Felder können leer bleiben: Der gespeicherte Wert bleibt erhalten.

Zielnummern im Testmodus

Solange die Meta-App im Testmodus ist, sendet sie nur an Nummern, die im API Setup selbst als erlaubte Empfänger eingetragen sind, und Meta begrenzt diese Liste auf wenige Nummern. Tragen Sie Ihre eigene zum Testen ein.

Nachrichtenvorlagen (Templates)

Die Regel stammt von Meta, nicht von der Plattform: Ein Unternehmen darf freien Text nur an Menschen senden, die in den letzten 24 Stunden an die Nummer geschrieben haben. Außerhalb dieses Fensters muss die erste Nachricht eine freigegebene Vorlage sein.

In der Praxis brauchen Erinnerungen und Benachrichtigungen, die die App von sich aus sendet (eine Terminerinnerung, eine Bestellbestätigung), fast immer eine Vorlage. Der Weg:

1. legen Sie im WhatsApp Manager Ihres Unternehmenskontos die Vorlage an, mit Text und Variablen;
2. reichen Sie sie zur Freigabe ein und warten Sie, bis Meta sie freigibt;
3. bitten Sie im Chat darum, dass die App diese Vorlage nutzt, und nennen Sie den genauen Namen der Vorlage und die Sprache. Ohne Sprachangabe nutzt die App pt_BR, geben Sie für deutsche Vorlagen also de an.

Woran Sie erkennen, dass es funktioniert

Die WhatsApp-Karte testet die Zugangsdaten beim Speichern nicht: Verbunden bedeutet, dass die Felder gespeichert wurden, nicht, dass der Token gültig ist. Der Beweis ist ein echter Versand:

1. bitten Sie im Chat um einen Testknopf, der eine Nachricht an Ihre Nummer schickt (das verbraucht KI-Credits, wie jedes Bauen);
2. nutzen Sie den Knopf und prüfen Sie, ob die Nachricht angekommen ist;
3. ist sie nicht angekommen, enthält der angezeigte Fehler die Meldung von Meta selbst.

Nachrichten empfangen

Die Felder Verify Token (Webhook) und App Secret (Webhook-Signatur) sind dafür da, dass die App Nachrichten empfängt: Der Verify Token bestätigt Meta, dass die Adresse Ihnen gehört, und das App Secret beweist, dass jede empfangene Nachricht wirklich von Meta kommt. Ohne App Secret wird jede empfangene Nachricht abgelehnt.

Die Rückrufadresse, die Meta in diesem Schritt verlangt, erscheint derzeit nicht auf der Karte. Wenn Ihre App Nachrichten empfangen muss, wenden Sie sich an den Support, um die Adresse Ihres Projekts zu erhalten.

Häufige Probleme

• Gestern ging es, heute sendet es nicht. Das ist der vorläufige Token, der abgelaufen ist. Erzeugen Sie den dauerhaften (siehe oben);
• Fehler wegen eines nicht erlaubten Empfängers. Die Meta-App ist im Testmodus, und die Zielnummer steht nicht auf der Liste der erlaubten;
• Die Erinnerung kommt nicht an, die Antwort an einen Kunden schon. Das ist das 24-Stunden-Fenster: Außerhalb davon nur freigegebene Vorlagen;
• Fehler zur Vorlage. Name oder Sprache passen nicht zur freigegebenen Vorlage, oder sie wurde noch nicht freigegeben;
• Der Versand wird mangels Credits abgelehnt. Das Guthaben an Integrations-Credits ist aufgebraucht. Sehen Sie im Panel unter Abrechnung nach.