Coexistence for WhatsApp — die vollständige Anleitung

Erfordert Odoo Enterprise 17, 18, 19 oder 20. Das Modul erweitert die native WhatsApp-App von Odoo, die es nur in Enterprise gibt; auf Odoo Community lässt es sich daher nicht installieren. Odoo.sh und On-Premise; nicht verfügbar auf Odoo Online. Die Instanz muss über HTTPS aus dem Internet erreichbar sein, weil Meta eingehende Nachrichten an einen Webhook auf Ihrer eigenen Domain zustellt.

Behalten Sie die Nummer auf dem Handy. Legen Sie Odoo darüber.

Der übliche Weg in die WhatsApp Cloud API verlangt, dass Sie Ihre Nummer aufgeben: Einmal migriert, funktioniert sie in der WhatsApp-Business-App auf dem Handy nicht mehr. Für ein Unternehmen, dessen gesamte Vertriebshistorie in dieser App liegt, ist das ein Ausschlusskriterium.

Coexistence ist Metas offizielle Antwort, und dieses Modul bringt sie nach Odoo. Sie scannen einen QR-Code, und ab diesem Moment funktioniert dieselbe Nummer an beiden Orten gleichzeitig: Ihr Team antwortet weiter vom Handy, und Odoo sieht alles.

So funktioniert es

• Nachrichten, die Ihr Team auf dem Handy tippt, erscheinen in Odoo als ausgehende Nachrichten im Thread des Kunden; der Gesprächsverlauf ist damit vollständig.
• Nachrichten von Kunden kommen über den Webhook in Odoo an, genau wie bei einer dedizierten Cloud-API-Nummer.
• Odoo kann auch senden: Antworten innerhalb des 24-Stunden-Fensters und freigegebene Vorlagen.
• Ihre Kontakte und bis zu sechs Monate Verlauf können einmalig beim Onboarding über Metas Einmal-Synchronisierung importiert werden.

Was Sie bekommen

• Die Nummer bleibt auf dem Handy. Ihr Team antwortet weiter aus der WhatsApp-Business-App. Nichts wird wegmigriert.
• QR-Onboarding. Metas Embedded Signup direkt in Odoo. Keine SMS, keine neue Nummer, keine IDs zum Abtippen.
• Handy-Antworten gespiegelt in Odoo. Ausgehende Echos landen im selben Thread, dedupliziert über die Nachrichten-ID, sodass nichts doppelt erscheint.
• Alles in Discuss. Ein- und ausgehend in normalen Discuss-Kanälen, auf normalen Kontakten.
• Einmaliger Verlaufsimport. Kontakte und bis zu sechs Monate Unterhaltungen, importiert beim Onboarding.
• Null Webhook-Konfiguration. Das Konto erzeugt seine eigene Callback-URL und sein Verify-Token und abonniert sich selbst.
• Mehrere Nummern, eine Datenbank. Jede Nummer ist ein eigenes Konto mit eigenen Benutzern und eigener Unternehmensbeschränkung.
• Sieben Sprachen. Englisch, Spanisch, Portugiesisch, Italienisch, Französisch, Deutsch und Arabisch.

Ein Rundgang in drei Bildern

Voraussetzungen

Zwei Wege, Coexistence nutzen zu dürfen

WhatsApp Coexistence wird über Metas Embedded Signup eingerichtet, und das funktioniert nur über eine App, die bei Meta als Tech Provider registriert und für die Funktion WhatsApp Business App Onboarding freigegeben ist. Eine gewöhnliche Meta-Entwickler-App kann das nicht. Es gibt zwei Wege, diese Anforderung zu erfüllen:

Mit einer RC-Studio-Lizenz. Sie kaufen einen Lizenzschlüssel, fügen ihn in Odoo ein und verbinden per QR-Code. Nichts bei Meta zu registrieren, keine App-Prüfung, keine Domain-Freigabe. Die Lizenz wird getrennt von diesem Modul abgerechnet und ist im Kauf nicht enthalten.

Mit Ihrer eigenen Tech-Provider-App oder der eines Dritten. Dieses Modul funktioniert mit jeder davon. Sie tragen App-ID, App-Secret und die Login-Konfiguration ein, die Ihr Anbieter Ihnen gibt, und die Verbindung läuft dann über dessen Meta-App statt über die von RC Studio. Diese Zugangsdaten stellt dieser Anbieter aus, nicht RC Studio. RC Studio kann sie nicht für Sie beschaffen und ist nicht verantwortlich, wenn Ihr Anbieter sie nicht herausgibt, widerruft, dafür extra berechnet oder von Meta nicht für WhatsApp Business App Onboarding freigegeben wurde. Klären Sie mit Ihrem Anbieter, dass Sie eine App-ID, ein App-Secret und eine Coexistence-Login-Konfiguration erhalten, bevor Sie dieses Modul kaufen.

Modus A · Coexistence mit RC-Studio-Lizenz (empfohlen)

Die gesamte Einrichtung: Schlüssel einfügen, auf Verbinden klicken, QR scannen. Nichts bei Meta zu registrieren, keine App-Prüfung und keine Domain freizugeben, weil der Facebook-Dialog auf der eigenen Seite von RC Studio läuft.

Die drei Schritte, die Sie tatsächlich sehen, im Lizenzmodus

Meta erlaubt pro Onboarding eine einzige Kontakt- und eine einzige Verlaufssynchronisierung. Schlagen sie fehl, lassen sie sich nur wiederholen, indem Sie die Nummer trennen und neu verbinden.

Modus B · Coexistence mit Ihrer eigenen Tech-Provider-App

Das funktioniert mit Ihrer eigenen App oder der eines beliebigen anderen Anbieters. In beiden Fällen muss die App von Meta für die Funktion WhatsApp Business App Onboarding freigegeben sein, und App-ID, App-Secret und Login-Konfiguration bekommen Sie von diesem Anbieter. RC Studio kann sie nicht beschaffen und ist nicht verantwortlich, wenn der Anbieter sie nicht liefert.

• Lassen Sie die RC-Studio-Lizenz leer.
• Tragen Sie App-ID und App-Secret Ihrer App ein.
• Tragen Sie unter Meta Login Configuration die ID Ihrer „Facebook Login for Business“-Konfiguration ein.
• Fügen Sie Ihre Odoo-Domain in der Meta-App unter App-Domains und Erlaubte Domains für das JavaScript-SDK hinzu. Dieser Schritt hat keine API und muss für jede Domain von Hand erledigt werden.
• Klicken Sie auf Über Coexistence verbinden und fahren Sie mit dem QR fort.

Im Modus B gibt es kein RC-Studio-Fenster: Der Facebook-Dialog öffnet sich direkt aus Ihrer eigenen Odoo-Seite, über Ihre eigene App.

Webhook

In keinem der beiden Modi muss etwas bei Meta eingetragen werden. Das Konto erzeugt seine eigene Callback-URL und sein Webhook-Verify-Token und registriert sie beim Verbinden der Nummer bei Meta, mit Abonnement des Feldes messages und von smb_message_echoes. Sollte sich Ihre Odoo-URL jemals ändern, richtet der Button Webhook neu abonnieren im Kontoformular Meta auf die neue Adresse aus, und Webhook-Override entfernen macht das rückgängig.

Rollen

Wo die Unterhaltungen liegen

In Discuss, genau dort, wo Odoos eigene WhatsApp-App sie ablegt: ein Kanal pro Kunde auf der Nummer, die die Nachricht empfangen hat. Sie antworten aus Discuss mit Anhängen, Emoji, Zitaten und Reaktionen. Dieses Modul ändert, wie die Nummer sich verbindet, nicht, wo Sie antworten.

Eine Gesprächsliste mit Suche, Ungelesen-Filter und Auswahl pro Nummer ist nicht Teil dieses Moduls. Sie kommt aus WhatsApp: Single Thread and Inbox, das separat verkauft und installiert wird; WhatsApp: Account Icon on Threads ergänzt das farbige Symbol pro Nummer. Coexistence funktioniert ohne beide.

Aus Discuss antworten

Dieselben Unterhaltungen erscheinen in Discuss unter der Kategorie WhatsApp — praktisch für alle, die ohnehin in Discuss arbeiten und den Bildschirm nicht wechseln wollen. Antwortet ein Kollege vom Handy, spiegelt Coexistence diese Nachricht als ausgehende Nachricht in denselben Kanal.

Eine Vorlage aus einem Dokument senden

Jedes Angebot, jede Rechnung, jeder Lieferauftrag und jeder Kontakt hat einen WhatsApp-Button im Chatter. Vorlage wählen, die Vorschau mit den bereits eingesetzten Daten prüfen, senden. Die Nachricht bleibt im Chatter des Dokuments und im Thread des Kunden erhalten.

Automatisierte Sendungen

Einstellungen → Technisch → Serveraktionen → Neu, Typ WhatsApp senden, Vorlage wählen. Auslösen über eine Automatisierungsregel — etwa bei Auftragsbestätigung — oder über das Aktionsmenü einer Listenansicht, um an viele Datensätze auf einmal zu senden.

Status und Wiederholungen

WhatsApp → Nachrichten bewahrt jede Nachricht mit ihrem Status auf: in Warteschlange, gesendet, zugestellt, gelesen, beantwortet, Fehler oder abgewiesen, mit Metas Fehlercode, falls vorhanden. Fehlgeschlagene können erneut gesendet werden, indem Sie sie markieren und WhatsApp: fehlgeschlagene Nachrichten erneut senden ausführen. Ein Cron wiederholt die Warteschlange stündlich.

Das 24-Stunden-Fenster und die Abmeldung

Vierundzwanzig Stunden nach der letzten Nachricht des Kunden erlaubt WhatsApp nur noch Vorlagen. Der Editor sperrt sich und bietet einen Button, um die Unterhaltung mit einer Vorlage wieder zu öffnen. Antwortet ein Kunde mit STOP, UNSUBSCRIBE oder STOP PROMOTIONS, setzt Odoo die Nummer auf die Sperrliste und sendet nichts mehr an sie. Das sind die Wörter, die Odoos WhatsApp-App erkennt.

Häufige Fragen

Muss ich RC Studio als meinen Tech Provider nutzen? Nein. Sie haben drei Möglichkeiten, und das Modul unterstützt alle. Erstens: Ihre eigene App — Sie registrieren sich bei Meta, lassen sie für die Funktion WhatsApp Business App Onboarding freigeben und werden selbst Tech Provider. Zweitens: ein beliebiger Tech Provider eines Dritten; das Modul funktioniert mit jedem. Drittens: der Tech-Provider-Dienst von RC Studio, der getrennt von diesem Modul abgerechnet wird. Entscheidend bei den ersten beiden Optionen ist, dass der Anbieter Ihnen eine App-ID, ein App-Secret und eine Coexistence-Login-Konfiguration aushändigt. Ohne diese drei Werte kann das Embedded Signup nicht laufen. RC Studio kann sie nicht für Sie beschaffen und ist nicht verantwortlich, wenn ein Drittanbieter sie verweigert, widerruft oder extra berechnet.

Funktioniert es auf Odoo Online (SaaS)? Nein. Odoo Online akzeptiert keine Module von Dritten. Enterprise läuft auf Odoo.sh und On-Premise. Ihre Instanz muss über öffentliches HTTPS erreichbar sein, weil Meta Nachrichten an einen Webhook auf Ihrer Domain zustellt.

Kann ich die Nummer weiter auf dem Handy nutzen? Ja — genau das ist der Sinn von Coexistence. Dieselbe Nummer lebt gleichzeitig in der WhatsApp-Business-App und in der Cloud API. Ihr Team antwortet weiter vom Handy, und Odoo sieht alles: eingehende Nachrichten und die am Handy getippten Antworten, die als Echos ankommen und im Thread als ausgehende Nachrichten erscheinen. Im dedizierten Cloud-API-Modus funktioniert die Nummer auf dem Handy nicht mehr.

Verliere ich beim Verbinden meinen Verlauf? Mit Coexistence lässt Meta Sie Ihre Kontakte und bis zu sechs Monate Verlauf einmal importieren, beim Onboarding. Meta erlaubt pro Onboarding eine einzige Kontakt- und eine einzige Verlaufssynchronisierung; schlagen sie fehl, lassen sie sich nur wiederholen, indem Sie die Nummer trennen und neu verbinden.

Gibt es eine Einschränkung, die ich vor dem Kauf kennen sollte? Ja, und sie stammt von Meta, nicht vom Modul. Nachrichten, die Ihr Team am Handy tippt, gehen unverändert raus und können nicht abgefangen oder umgeschrieben werden; die API erhält sie erst danach, als Echos. Wenn Sie 100 % des ausgehenden Verkehrs kontrollieren müssen, ist die dedizierte Cloud API die richtige Wahl, nicht Coexistence. Die Meta-App hat außerdem ein stündliches Aufrufkontingent: Ist es aufgebraucht, müssen Sie warten, und sofortiges Wiederholen verlängert nur das Fenster.

Was berechnet Meta für Nachrichten? Meta rechnet pro zugestellter Nachricht ab. Vorlagen-Nachrichten kosten je nach Kategorie (Marketing, Utility, Authentifizierung) und Land des Kunden unterschiedlich. Ab dem 1. Oktober 2026 berechnet Meta auch die freien Antworten, die Sie innerhalb des 24-Stunden-Fensters senden (Service-Nachrichten), zum selben Satz wie Utility- und Authentifizierungsnachrichten; bis dahin sind sie kostenlos. Empfangen bleibt kostenlos. Details und Preistabellen finden Sie auf Metas Preisseite. RC Studio berechnet nichts pro Nachricht.

Sendet das Modul meine Daten an einen Server von RC Studio? Nur bei der Anmeldung, und nur das Minimum. Nachrichten laufen nie über uns, weder die gesendeten noch die empfangenen. Das Business-Token liegt in Ihrer eigenen Datenbank, Ihr Odoo spricht also direkt mit Meta, und beim Verbinden der Nummer registriert unser Dienst die Adresse Ihres Odoo bei Meta als Zustellziel: Meta stellt direkt an Ihre Instanz zu, unter einer geheimen URL, die nur Meta und Ihr Odoo kennen. Unser Dienst hat nicht einmal einen Endpunkt zum Senden oder Empfangen von Nachrichten. Was über uns läuft, ist die Anmeldung: Das App-Secret von Meta ist unseres und wird nie in Ihre Datenbank kopiert; deshalb tauschen wir die Meta-Autorisierung gegen Ihr Zugriffstoken und übergeben es Ihnen. Das ist alles. Wenn RC Studio nicht einmal an der Anmeldung beteiligt sein soll, funktioniert das Modul mit Ihrer eigenen Meta-App genau gleich.

Welche Daten hält RC Studio? Drei Dinge, und nur solange die Nummer verbunden ist: das Meta-App-Secret (wir halten es genau deshalb, damit es nie in Ihre Datenbank kopiert werden muss), den Lizenzschlüssel, den wir Ihnen ausstellen, und eine verschlüsselte Kopie Ihres WABA-Tokens, die nötig ist, um den Webhook neu zu abonnieren, wenn sich Ihre Odoo-URL ändert, und um die erste Synchronisierung auszulösen. Wenn Sie uns bitten, die Nummer abzumelden, wird das Abonnement unserer App von Ihrer WABA entfernt und der gesamte Datensatz gelöscht, verschlüsseltes Token inklusive. Sie können den Webhook-Override auch jederzeit selbst entfernen, über den Button Webhook-Override entfernen im Kontoformular. Ihr Business-Token bleibt außerdem in Ihrem eigenen Odoo, und genau das macht den Nachrichtenversand direkt und unabhängig von unserem Dienst.

Bleiben unsere Nummer und unsere WABA in unserem eigenen Business Portfolio? Ja, immer. Nummer und WABA gehören Ihnen und bleiben in Ihrem Business Portfolio. Ein Tech Provider ist nur eine Brücke zwischen Ihrer WABA und Metas Diensten; er übernimmt nie Eigentum an irgendetwas. Auch die Meta Business Suite funktioniert normal weiter — Coexistence ergänzt die Cloud API neben Metas Werkzeugen, sie ersetzt sie nicht.

Können wir zuerst auf Staging testen und dann in Produktion gehen? Ja, und das ist die empfohlene Reihenfolge. Auf dem Handy gibt es keinerlei Unterbrechung. Auf der Odoo-Seite ändert der Wechsel in Produktion die URL Ihrer Instanz und damit die Adresse, an die Meta Ereignisse zustellt; die Lizenz muss also erneuert und der Webhook auf die neue URL neu abonniert werden — dafür hat das Modul einen Button. Für die paar Minuten, die das dauert, sendet und empfängt Odoo nicht; das Handy schon. Beachten Sie, dass der einmalige Verlaufsimport beim Umzug der Nummer nicht wiederholt wird.

Kann ich Vorlagen nutzen, die ich bei Meta bereits freigegeben hatte? Ja. Nutzen Sie den Button Vorlagen synchronisieren im Kontoformular.

Was, wenn Meta die Synchronisierung mit Fehler 133010 ablehnt? Das bedeutet, dass die Nummer nicht als Coexistence verknüpft wurde. Der Button Nummer diagnostizieren im Kontoformular prüft das mit einem einzigen Aufruf und sagt Ihnen, ob die Verbindung neu gemacht werden muss.

Welche Odoo-Versionen werden unterstützt, und in welchen Sprachen gibt es die Oberfläche? Odoo 17.0, 18.0, 19.0 und 20.0 — jede Version wird im Odoo-Store separat gekauft. Die Oberfläche gibt es auf Englisch, Spanisch, Portugiesisch, Italienisch, Französisch, Deutsch und Arabisch.

Support

Support ist für alle enthalten, die das Modul kaufen. Installation und die Konfiguration auf Meta-Seite können separat beauftragt werden. Nutzen Sie die Support-Seite dieses Moduls auf Odoo Apps für alles rund um Ihren Kauf: Sie erreicht uns direkt und hält den Vorgang mit Ihrer Lizenz verknüpft.

Datentransit: Nachrichten und Medien laufen direkt zwischen Ihrer Odoo-Instanz und Metas Cloud API, in jedem Verbindungsmodus. Mit RC-Studio-Lizenz ist der Tech-Provider-Dienst von RC Studio nur bei der Anmeldung der Nummer beteiligt: Er stellt das Meta-Zugriffstoken aus und registriert die Adresse Ihres Odoo als Zustellziel. RC Studio empfängt und speichert keine Nachrichteninhalte. Datenschutzerklärung.

WhatsApp ist eine Marke von Meta Platforms, Inc. RC Studio ist weder mit Meta verbunden noch von Meta unterstützt oder gesponsert. Dieses Modul wird unter der Odoo Proprietary License v1.0 (OPL-1) veröffentlicht.