WhatsApp in Odoo: Einrichtung, Vorlagen, Kosten

Was Sie vorab brauchen

Die App WhatsApp verbindet Ihre Odoo-Datenbank mit einem Konto der WhatsApp Business Platform von Meta. Halten Sie zuerst bereit, was der Reihenfolge nach nötig ist:

• Odoo 20.0 in der Enterprise-Edition (Odoo Online, Odoo.sh oder On-Premise). In der Community-Edition gibt es die App nicht.
• Ein Meta-Geschäftskonto in der Meta Business Suite mit einem persönlichen Facebook-Konto als Administrator. Dieses Facebook-Konto muss laut Odoo-Dokumentation mindestens eine Stunde bestehen, bevor sich das Geschäftskonto anlegen lässt.
• Ein Konto der WhatsApp Business Platform mit einer Telefonnummer für den Versand. Eine Nummer, die schon in WhatsApp läuft, lässt sich nach Metas Anleitung zu einem Business-Konto migrieren.
• Eine Zahlungsmethode im Meta-Konto. Meta verlangt sie, bevor die Geschäftsnummer verbunden wird.
• Eine öffentlich erreichbare HTTPS-Adresse für die Callback-URL. Odoo Online und Odoo.sh bringen sie mit; bei On-Premise müssen Sie sie selbst bereitstellen.
• Rechte: In Odoo brauchen Sie Administratorrechte, um in einer Vorlage das Feld Gilt für zu setzen. Im Meta-Geschäftskonto braucht das Konto, mit dem die App erstellt wird, die Rolle Product Manager oder höher; sonst steht die Berechtigung business_management beim Token nicht zur Verfügung.

Schritt für Schritt: WhatsApp mit Odoo verbinden

Schritt 1: Meta-Geschäftskonto anlegen

Öffnen Sie die Meta Business Suite und wählen Sie Konto erstellen. Tragen Sie Geschäftsname, Name des Administrators und eine geschäftliche E-Mail-Adresse ein und bestätigen Sie den Anlegevorgang über den Link in der E-Mail von Meta. Verknüpfen Sie danach ein persönliches Facebook-Konto als Administrator des Geschäftskontos.

Schritt 2: Meta-App mit WhatsApp-Produkt erstellen

Melden Sie sich auf developers.facebook.com an und wählen Sie Meine Apps ‣ App erstellen. Füllen Sie den Abschnitt App-Details aus: Die Odoo-Dokumentation trägt in das Feld App-Name Odoo ein (der Name lässt sich später in den Einstellungen ändern), und in das Feld E-Mail-Adresse für App-Kontakt kommt die Entwickleradresse. Markenzeichen und markenbezogene Elemente dürfen laut Odoo-Dokumentation in den App-Details nicht verwendet werden; das schließt die Meta-Unternehmensgruppe ein. Das Wort WhatsApp kennzeichnet das System als Fehler. Wählen Sie unter den Anwendungsfällen Andere und dann den App-Typ Geschäftlich, verbinden Sie das Geschäftsportfolio und erstellen Sie die App. Gehen Sie danach unter Produkte zu Ihrer App hinzufügen auf WhatsApp und klicken Sie Einrichten. Meta stellt eine Testnummer bereit, die unbegrenzt an höchstens fünf verifizierte Empfänger senden kann.

Schritt 3: Geschäftsnummer und Zahlungsmethode hinterlegen

Unter WhatsApp ‣ API-Einrichtung fügen Sie eine Geschäftsnummer hinzu. Tragen Sie Geschäftsname und Website ein, wählen Sie das Land, füllen Sie Anzeigename, Zeitzone, Kategorie und optional die Beschreibung aus und bestätigen Sie die Nummer per SMS oder Anruf. Halten Sie dabei eine Zahlungsmethode im Meta-Konto bereit; ohne sie lässt sich die Nummer nach der Odoo-Dokumentation nicht verbinden. Bleibt der Status auf Ausstehend statt Verbunden, erzeugt die Odoo-Dokumentation dafür ein temporäres Zugriffstoken mit Zugriff auf alle WhatsApp-Konten.

Schritt 4: Business-Konto in Odoo anlegen

Navigieren Sie in Odoo zu WhatsApp ‣ Konfiguration ‣ WhatsApp-Business-Konten (WhatsApp ‣ Configuration ‣ WhatsApp Business Accounts) und klicken Sie Neu. Übernehmen Sie die Werte aus der Meta-Konsole in die gleichnamigen Felder: Phone Number ID, Access Token (zunächst das temporäre Token), App ID und Account ID. Das App Secret finden Sie in der Meta-App unter App-Einstellungen ‣ Allgemein; tragen Sie es im Feld App Secret ein. Klicken Sie Test Connection. Bei korrekter Eingabe erscheint rechts oben eine grüne Erfolgsmeldung, und Odoo füllt Callback URL und Webhook Verify Token bereits aus.

Schritt 5: Webhooks in Meta verbinden

Öffnen Sie in der Meta-Konsole WhatsApp ‣ API-Einrichtung und dort den Webhook-Schritt. Klicken Sie Edit und tragen Sie Callback URL und Webhook Verify Token aus Odoo ein, die Sie unter Receiving Messages im Business-Konto finden; klicken Sie Verify and save. Abonnieren Sie danach unter Webhook-Felder: account_update, message_template_quality_update, message_template_status_update, messages und template_category_update. Diese Felder erscheinen erst nach der Bestätigung der Callback-URL.

Schritt 6: Dauerhaftes Zugriffstoken erzeugen

Das temporäre Token läuft ab; Odoo meldet dann User Error 190. Legen Sie in der Meta Business Suite unter Geschäfts-Einstellungen ‣ Benutzer ‣ Systembenutzer einen Systembenutzer an, weisen Sie ihm die Odoo-App mit voller Kontrolle zu und erzeugen Sie ein Token mit Ablauf nach 60 Tagen oder Nie. Nötig sind die Berechtigungen business_management, whatsapp_business_messaging, whatsapp_business_management und whatsapp_business_manage_events. Tragen Sie den Tokenwert im Business-Konto unter Zugriffstoken ein.

Schritt 7: Meta-App auf Live setzen

Schalten Sie im Meta-Developer-Dashboard den App-Modus von Entwicklung auf Live. Vorher muss unter App-Einstellungen ‣ Allgemein eine Datenschutzrichtlinien-URL hinterlegt sein, sonst lässt sich die App nicht live schalten. Solange die App im Entwicklungsmodus steht, erreicht die Datenbank nur die Testnummern aus der Entwicklerkonsole.

Schritt 8: Vorlage erstellen und genehmigen lassen

Öffnen Sie WhatsApp ‣ Vorlagen (Templates) und klicken Sie Neu. Geben Sie Name und Sprache an, wählen Sie das Konto, und setzen Sie unter Gilt für das Odoo-Modell, aus dem die Platzhalter stammen. Wechseln Sie die Kategorie zwischen Marketing, Utility und Authentication; eine falsche Kategorie kann Meta im Genehmigungsverfahren bemängeln. Schreiben Sie den Text und setzen Sie Platzhalter der Form {{1}}, {{2}} an die Stellen, die Odoo später füllt; auf dem Reiter Variablen ordnen Sie jedem Platzhalter ein Feld des Modells zu. Danach klicken Sie Zur Genehmigung einreichen (Submit for approval): Der Status wechselt auf Ausstehend, und Meta prüft automatisch, laut seiner Dokumentation bis zu 24 Stunden.

Wie die Vorlagengenehmigung abläuft

Meta ist die genehmigende Stelle, nicht Odoo. Vorlagen werden bei der Anlage oder nach einer Änderung automatisch geprüft; nur der Status Genehmigt ist sendbar. Sie können Vorlagen in Odoo oder in der Meta Business Suite unter Konto-Tools ‣ Nachrichtenvorlagen erstellen. Nach der Genehmigung synchronisieren Sie sie in Odoo: WhatsApp ‣ Konfiguration ‣ WhatsApp-Business-Konten, Abschnitt Nachrichten senden, Schaltfläche Vorlagen synchronisieren; eine einzelne Vorlage über die Schaltfläche Vorlage synchronisieren in ihrem Formular. Ein nicht verifiziertes Geschäftsportfolio ist auf 250 Vorlagen je Konto begrenzt, ein verifiziertes auf bis zu 6.000, sofern mindestens ein Konto eine Nummer mit genehmigtem Anzeigenamen hat.

Meta verlangt vor dem Anschreiben von Personen eine Opt-in-Einwilligung. Laut der Entwicklerdokumentation darf sie allgemein sein und muss nicht eigens für WhatsApp erklärt werden, solange Sie die örtlichen Vorschriften einhalten. Wie das in Odoo aussieht und was datenschutzrechtlich gilt, steht im Artikel WhatsApp in Odoo und der Datenschutz.

Was WhatsApp kostet

Meta berechnet den Versand, Odoo die Nutzung der Datenbank. Die Rechnung besteht aus dem Odoo-Abonnement und Metas Gebühren:

Posten	Was Meta berechnet	EUR je zugestellter Nachricht, Empfänger in Deutschland (EUR-Rate-Card der Meta-Preisseite, abgerufen am 14. Oktober 2026)
Marketing-Vorlage	bei jeder zugestellten Nachricht, auch im offenen Kundendienstfenster	0,1131
Utility-Vorlage	außerhalb des Kundendienstfensters und seit 1. Oktober 2026 auch im offenen Kundendienstfenster	0,0456 in der Listenstufe bis 100.000 Nachrichten im Monat
Authentication-Vorlage	bei jeder zugestellten Nachricht, auch im offenen Kundendienstfenster	0,0456 in der Listenstufe bis 300.000 Nachrichten im Monat
Service-Nachricht (freie Antwort im offenen Kundendienstfenster)	seit 1. Oktober 2026 je zugestellter Nachricht, ohne Mengenrabatt	0,0456
Nachricht im Free-Entry-Point-Fenster (72 Stunden ab der Antwort des Unternehmens)	keine Berechnung	0,00
Nachricht des Kunden an das Unternehmen	keine Berechnung	0,00

Dazu kommt das Odoo-Abonnement. Die App WhatsApp gehört zum Enterprise-Umfang; die Odoo-Preisseite führt die Tarife Standard und Custom mit einem Preis je Benutzer und Monat und daneben den Tarif One App Free (eine App, unbegrenzte Benutzer, Odoo Online, 0 Euro). Diesem Artikel liegt die Annahme zugrunde, dass Sie die Datenbank in einem kostenpflichtigen Tarif betreiben.

Die Höhe der Meta-Gebühren folgt festen Regeln. Abgerechnet wird die zugestellte, nicht die gesendete Nachricht. Der Satz hängt von der Kategorie und vom Land der Empfängernummer ab; Meta ordnet jedem Land einen Markt oder eine Region zu und nennt die Sätze je Rate Card. Deutschland ist ein eigener Markt, Österreich und die Schweiz führt Metas Länderzuordnung in der Region Rest of Western Europe:

Markt (EUR-Rate-Card, abgerufen am 14. Oktober 2026)	Marketing	Utility	Authentication	Service
Deutschland (eigener Markt)	0,1131	0,0456	0,0456	0,0456
Rest of Western Europe (Österreich, Schweiz)	0,0490	0,0142	0,0142	0,0142

Alle Werte in Euro je zugestellter Nachricht in der Listenstufe; Änderungen behält sich Meta vor. Das Kundendienstfenster ist 24 Stunden offen und startet mit jeder Nachricht oder jedem Anruf des Kunden neu. Innerhalb des offenen Fensters dürfen Sie freie Nachrichten senden, außerhalb nur genehmigte Vorlagen. Marketing- und Authentication-Vorlagen werden immer berechnet, Utility-Vorlagen außerhalb des Fensters und seit 1. Oktober 2026 auch im offenen Fenster, Service-Nachrichten seit 1. Oktober 2026 je zugestellter Nachricht ohne Mengenrabatt. Ein Free-Entry-Point-Fenster entsteht, wenn ein Kunde über eine Click-to-WhatsApp-Anzeige oder eine Schaltfläche auf einer Facebook-Seite schreibt und Sie innerhalb des Kundendienstfensters antworten; die WhatsApp-App des Kunden muss dabei auf Android oder iOS laufen, Desktop und Web lösen kein solches Fenster aus. Es läuft 72 Stunden ab Ihrer Antwort, und in dieser Zeit berechnet Meta weder Vorlagen noch Service-Nachrichten. Mengenrabatte gibt es nur für Utility- und Authentication-Nachrichten, markt- und kategorieweise, gezählt über alle WhatsApp-Business-Konten eines Geschäftsportfolios und mit monatlichem Neustart; in die Stufen zählen nur berechnete Nachrichten. Preisänderungen nimmt Meta höchstens zum 1. Januar, 1. April, 1. Juli oder 1. Oktober vor; eine Änderung der Rate Card kündigt Meta mindestens einen Monat vorher an, eine Ergänzung des Preismodells drei Monate und ein Wechsel des Preismodells sechs Monate vorher.

Die folgende Rechnung ist eine Beispielrechnung mit angenommenen Mengen; sie nutzt die Listenpreise für Empfänger in Deutschland, abgelesen am 14. Oktober 2026 aus der EUR-Rate-Card der Meta-Preisseite (Änderungen vorbehalten):

Annahme	Rechnung	Betrag
1.000 Marketing-Vorlagen an Empfänger in Deutschland	1.000 × 0,1131 Euro	113,10 Euro
2.000 Utility-Vorlagen an Empfänger in Deutschland	2.000 × 0,0456 Euro	91,20 Euro
Summe Meta-Gebühren im Monat		204,30 Euro

Annahmen der Beispielrechnung: alle Nachrichten werden zugestellt, die Empfänger sitzen in Deutschland, der Versand erfolgt außerhalb eines Kundendienstfensters und außerhalb eines Free-Entry-Point-Fensters, die Utility-Nachrichten bleiben in der Listenstufe bis 100.000 Nachrichten im Monat (die Rabattstufe greift erst ab 100.001 Nachrichten im Monat), und es fallen keine Service-Nachrichten an. Das Odoo-Abonnement je Benutzer kommt hinzu; die aktuellen Odoo-Tarife stehen auf odoo.com/pricing.

So prüfen Sie das Ergebnis

• Odoo versendet eine genehmigte Vorlage an eine echte Empfängernummer, und die Nachricht kommt an.
• Antwortet der Kunde innerhalb von 15 Tagen, öffnet Odoo ein Chatfenster in der Unterhaltung im Dialog (Discuss); eine spätere Antwort nach 15 Tagen ohne Reaktion erreicht wieder alle im Kanal hinterlegten Benutzer.
• In der Meta-Konsole steht die Vorlage auf Genehmigt, und in Odoo erscheint sie nach dem Synchronisieren im Vorlagen-Dashboard.
• In der Meta-Konsole zeigt die Geschäftsnummer den Status Verbunden, nicht Ausstehend.

Wenn etwas nicht klappt

Symptom	Ursache	Lösung
User Error 190, Session abgelaufen	temporäres Token noch im Einsatz	dauerhaftes Token erzeugen und eintragen
User Error 100, Unsupported get request	Nicht-Administrator legt das Token an	Systembenutzer mit Administratorrolle verwenden
Keine eingehenden Nachrichten	Webhook-Felder fehlen oder Callback-URL nicht erreichbar	Felder abonnieren und die HTTPS-Adresse prüfen
Validierungsfehler beim Synchronisieren	doppelter Vorlagenname für dasselbe Meta-Konto	eine Vorlage umbenennen und erneut synchronisieren
Nummer bleibt Ausstehend	kein Zugriff auf alle WhatsApp-Konten	temporäres Token mit vollständigem Kontozugriff erzeugen

Wann Sie Hilfe holen sollten

Ziehen Sie Ihren Odoo-Partner oder den Odoo-Support hinzu, wenn eine On-Premise-Instanz keine öffentliche Callback-URL bereitstellt, wenn mehrere Abteilungen getrennte Nummern und Vorlagen brauchen oder wenn Vorlagen wiederholt abgelehnt werden. Das Anpassen von WhatsApp-Vorlagen fällt laut Odoo-Dokumentation nicht unter die Dienstleistungen des Odoo-Supports.