WhatsApp Coexistence API — die vollständige Anleitung

Odoo Community, On-Premise. Odoo Online (SaaS) akzeptiert keine Module von Dritten. Die Instanz muss über HTTPS aus dem Internet erreichbar sein, weil Meta eingehende Nachrichten an einen Webhook auf Ihrer eigenen Domain zustellt. Nichts aus Enterprise wird benötigt: keine native WhatsApp-App, kein Enterprise-Abonnement. Es läuft auch auf Enterprise, ist aber für Community gebaut.

Eine WABA-API-Verbindung braucht keinen Tech Provider: Ihre eigene Meta-Entwickler-App genügt, und nichts läuft über RC Studio.

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

Was Sie bekommen

• Coexistence oder eine WABA-API-Verbindung. Verbinden Sie die Nummer Ihrer WhatsApp-Business-App per QR-Code, oder eine WABA-API-Verbindung mit Ihrer eigenen Meta-App. Mehrere Nummern in einer Datenbank, jede mit eigenen Bearbeitern und Unternehmen.
• Ein Posteingang zum Antworten. Filter für Suche, Ungelesen, Meine und Geschlossen, eine Auswahl pro Nummer, Live-Aktualisierung, Zustellhäkchen, Medien, zitierte Antworten, Reaktionen, Zuweisung, und die Nachrichten, die Ihr Team vom Handy sendet, gespiegelt im selben Thread.
• Dokumente aus jedem Datensatz. Eine Aktion Per WhatsApp senden auf Kontakten, Angeboten, Rechnungen, Lieferungen, Leads, Aufgaben, Veranstaltungen, Terminen, Einkaufs- und Kassenaufträgen. Die Vorlage wird aus dem Datensatz befüllt und der PDF-Bericht reist als Dokumentkopf mit.
• Mit Meta synchronisierte Vorlagen. Kopf, Text, Fuß und Buttons, wie Meta sie definiert. Jeder Platzhalter wird einem Feld des Datensatzes, einem festen Wert, einem beim Senden abgefragten Wert oder dem Portal-Link zugeordnet. Eine Beispielbibliothek für die installierten Apps.
• Automatische Sendungen. Eine Serveraktion WhatsApp-Vorlage senden, die Sie aus jeder Automatisierungsregel auslösen.
• Rollen, Abmeldung, Wiederholungen. Bearbeiter sehen nur die Nummern, denen sie zugewiesen sind. Ein Kunde, der STOP antwortet, kommt auf die Sperrliste. Fehlgeschlagene Sendungen werden wiederholt, und jede Nachricht behält ihren Meta-Status und Fehlercode. Nichts wird je gelöscht.

Ein Rundgang in fünf Bildern

Mehrere Nummern in einem Posteingang, das Symbol, das sie unterscheidet, der Filter pro Nummer und eine aus einem Angebot gesendete Vorlage.

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-Konfigurations-ID ein, die Ihr Anbieter Ihnen gibt, und die Verbindung läuft ü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.

Das Modul installieren

• Stellen Sie sicher, dass die Python-Pakete phonenumbers und requests für Odoo verfügbar sind. Beide sind Teil von Odoos eigener requirements.txt, eine Standardinstallation hat sie also bereits; fehlen sie, verweigert Odoo die Installation des Moduls (ein Odoo-Modul kann pip nicht für Sie ausführen). Bei Bedarf installieren Sie sie in der Umgebung, in der Odoo läuft, und starten Odoo neu.
• Entpacken Sie das Modul in Ihren Addons-Ordner und starten Sie den Odoo-Dienst neu.
• Einstellungen → Apps → App-Liste aktualisieren, nach „WhatsApp“ suchen und WhatsApp Coexistence API installieren.
• Geben Sie Ihren Benutzern das Zugriffsrecht WhatsApp / Operator oder Manager.

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 Bilder, 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 mit einem neuen QR-Code 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-Konfigurations-ID bekommen Sie von diesem Anbieter. RC Studio kann sie nicht beschaffen und ist nicht verantwortlich, wenn der Anbieter sie nicht liefert.

• Wählen Sie Coexistence und Ihre eigene Meta-Tech-Provider-App.
• Tragen Sie App-ID, App-Secret und Login-Konfigurations-ID Ihrer App 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.

Modus C · WABA-API-Verbindung

Kein Tech Provider nötig. Kopieren Sie aus Ihrer Meta-Entwickler-App mit dem WhatsApp-Produkt App-ID, App-Secret, WhatsApp Business Account ID, Phone Number ID und ein dauerhaftes Access Token (ein Systembenutzer-Token mit den WhatsApp-Berechtigungen) in die Nummer, wählen Sie WABA-API-Verbindung (Cloud API) und klicken Sie auf Verbindung testen.

Webhook

Jede Nummer hat ihre eigene Callback-URL und ihr Verify-Token auf dem Reiter Webhook. Im Coexistence-Modus registriert Odoo sie beim Verbinden der Nummer bei Meta. Bei einer WABA-API-Verbindung klicken Sie entweder auf Webhook abonnieren, damit Odoo sie am WhatsApp-Business-Konto registriert, oder Sie tragen sie von Hand in der Meta-App unter WhatsApp → Konfiguration → Webhooks ein und abonnieren die Felder messages und message_template_status_update. Zustellungen werden gegen Metas Signatur (Ihr App-Secret) geprüft oder, im Lizenzmodus, gegen die geheime URL, die nur Meta und Ihr Odoo kennen.

Vorlagen

Klicken Sie auf einer verbundenen Nummer auf Vorlagen synchronisieren, um die bei Meta freigegebenen Vorlagen zu importieren, oder auf Beispielvorlagen laden, um Entwürfe für die installierten Apps zu erhalten (Angebot gesendet, Auftrag bestätigt, Rechnung verfügbar, Lieferung unterwegs, Veranstaltungsanmeldung, Terminerinnerung, Beleg, Bestellung, Lead- und Aufgaben-Nachfassungen). Prüfen Sie einen Entwurf, ordnen Sie seine Platzhalter auf dem Reiter Platzhalter zu und klicken Sie auf An Meta übermitteln; das Ergebnis der Prüfung erfährt Odoo über den Webhook.

Rollen

Der Posteingang

WhatsApp → Posteingang. Unterhaltungen links, neueste Aktivität zuerst, mit Suchfeld, den Filtern Alle / Ungelesen / Meine / Geschlossen und, bei mehr als einer Nummer, einer Auswahl. Der Thread rechts: Antworten mit Text, Emoji und Anhängen, eine Nachricht zitieren und die Zustellhäkchen sehen.

Ohne Text wird der Senden-Button zum Mikrofon: Drücken Sie ihn, um eine Sprachnotiz aufzunehmen; der Kunde erhält sie als Sprachnachricht, mit Mikrofonsymbol und Ihrem Profilbild, direkt aus der Sprechblase abgespielt und nicht als herunterladbare Datei. Das Einzige, was kein API-Sender hinzufügen kann, ist die Wellenform, die nur das aufnehmende Telefon berechnet. Chrome, Edge und Firefox brauchen nichts installiert; auf Safari muss der Server ffmpeg haben. Sprachnotizen des Kunden werden im Thread abgespielt.

Neue Nachrichten kommen live an; das WhatsApp-Symbol in der oberen Leiste zeigt, wie viele Unterhaltungen warten. Mir zuweisen und Schließen halten die Liste sauber; der Kontakt und die Dokumente, aus denen dem Kunden geschrieben wurde, sind einen Klick entfernt.

Eine Unterhaltung pro Kunde und Nummer

Was immer ein Kunde schreibt und was immer Sie ihm senden, aus dem Posteingang, aus einem Angebot oder aus einer Automatisierung, landet im selben Thread dieser Geschäftsnummer. Der Kontakt wird über die Telefonnummer zugeordnet; schreibt der Kunde an zwei Ihrer Nummern, sind das absichtlich zwei Threads, unterschieden durch das Symbol der Nummer. Im Coexistence-Modus erscheinen die Antworten, die Ihr Team vom Handy sendet, im Thread mit der Markierung „vom Handy“.

Mehrere Nummern, ein Posteingang

Geben Sie jeder Geschäftsnummer im Formular ein Symbol. Das Symbol erscheint als Abzeichen auf jeder Unterhaltung dieser Nummer, sodass ein Vertriebs- und ein Support-Thread mit demselben Kunden auf einen Blick zu unterscheiden sind. Die Auswahl oben in der Liste zeigt alle Nummern oder nur eine, und Bearbeiter sehen nur die Nummern, bei denen sie eingetragen sind.

Ein Dokument senden

Öffnen Sie auf einem Kontakt, Angebot, einer Rechnung, Lieferung, einem Lead, einer Aufgabe, einer Veranstaltungsanmeldung, einem Termin, einer Bestellung oder einem Beleg das Menü Aktion und wählen Sie Per WhatsApp senden; derselbe Schnellzugriff sitzt neben jedem Telefonfeld. Wählen Sie Nummer und Vorlage, füllen Sie die von der Vorlage abgefragten Werte aus, prüfen Sie die Vorschau und senden Sie. Der PDF-Bericht der Vorlage reist als Dokument mit, und im Chatter des Datensatzes bleibt eine Notiz mit Link zur Unterhaltung. In einer Listenansicht markieren Sie mehrere Datensätze, und dieselbe Aktion sendet an alle.

Automatische Sendungen

Fügen Sie unter Einstellungen → Technisch → Automatisierungsregeln eine Aktion vom Typ WhatsApp-Vorlage senden hinzu und wählen Sie die Vorlage. Jeder Datensatz, der die Regel erfüllt, erhält seine Nachricht, befüllt aus dem Datensatz, ohne dass jemand klickt.

Das 24-Stunden-Fenster und die Abmeldung

Vierundzwanzig Stunden nach der letzten Nachricht des Kunden erlaubt WhatsApp nur noch freigegebene Vorlagen. Der Editor sagt das und bietet Vorlage senden an, was die Unterhaltung wieder öffnet. Antwortet ein Kunde mit STOP, UNSUBSCRIBE oder BAJA (die Liste ändern Sie in den Einstellungen), kommt die Nummer auf die Sperrliste und erhält nichts mehr, bis sie entfernt wird.

Status und Wiederholungen

WhatsApp → Nachrichtenprotokoll bewahrt jede Nachricht mit ihrem Status auf: in Warteschlange, gesendet, zugestellt, gelesen oder fehlgeschlagen, mit Metas Fehlercode, falls vorhanden. Vorübergehende Fehler wiederholt ein Cron alle fünf Minuten; endgültige lassen sich aus der Liste erneut senden. Nachrichten werden nie gelöscht: Das Protokoll und die Unterhaltungen sind Ihr Verlauf.

Häufige Fragen

Muss ich Meta Tech Provider sein? Nur für Coexistence. Metas Embedded Signup für die WhatsApp-Business-App läuft über eine für WhatsApp Business App Onboarding freigegebene Tech-Provider-App. Nutzen Sie entweder die App von RC Studio mit einem Lizenzschlüssel, registrieren Sie sich selbst als Tech Provider oder nutzen Sie einen anderen Anbieter, der Ihnen App-ID, App-Secret und Login-Konfiguration aushändigt. Eine WABA-API-Verbindung braucht nichts davon: Ihre eigene Meta-Entwickler-App genügt.

Funktioniert es auf Odoo Online (SaaS) oder auf Odoo.sh? Odoo Online akzeptiert keine Module von Dritten, also nein. Dieses Modul ist für Odoo Community On-Premise gedacht. Es hängt nur von Community-Modulen ab und installiert sich daher auch in einem Odoo.sh-Projekt; Odoo.sh-Support gehört jedoch nicht zu dem, was wir testen.

Funktioniert das Handy nach dem Verbinden weiter? Ja, genau das bedeutet Coexistence. Die Nummer bleibt in der WhatsApp-Business-App aktiv; Odoo empfängt alles über die Cloud API und kann auch senden. Vom Handy gesendete Nachrichten werden nach Odoo gespiegelt.

Wo liegen die Unterhaltungen? Ist Discuss beteiligt? In den modul-eigenen Unterhaltungs- und Nachrichtenmodellen, angezeigt im eigenen Posteingang. Discuss wird für WhatsApp-Threads nicht genutzt.

Laufen meine Daten über RC Studio? Nein. In allen drei Modi laufen Nachrichten direkt zwischen Meta und Ihrem Odoo. Mit einer RC-Studio-Lizenz ist unser Dienst nur bei der Anmeldung einer Nummer beteiligt: Er tauscht die Meta-Autorisierung gegen das Zugriffstoken, übergibt es Ihrem Odoo und registriert die Adresse Ihres Odoo bei Meta als Zustellziel. Von da an stellt Meta jede Nachricht direkt an Ihre Instanz zu, und das Senden geht von Ihrem Odoo zu Meta mit Ihrem eigenen Token. RC Studio empfängt und speichert keine Nachrichteninhalte; es behält nur eine verschlüsselte Kopie des Tokens und die Verbindungsdaten der Nummer, bis Sie sie trennen.

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 (die Ihr Team im Posteingang tippt), zum selben Satz wie Utility- und Authentifizierungsnachrichten in diesem Land; bis dahin sind sie kostenlos. Empfangen bleibt kostenlos. Die genauen Sätze finden Sie auf Metas Preisseite. RC Studio berechnet nichts pro Nachricht.

Kann ich ein PDF senden? Einen Standort? Eine Sprachnotiz? Aus dem Posteingang, innerhalb des 24-Stunden-Fensters: Text, Bilder, Videos, Audio, Dokumente und zitierte Antworten. Aus einem Datensatz: eine Vorlage, deren Dokumentkopf der PDF-Bericht des Datensatzes ist, oder eine feste Datei. Standorte, Sticker, Reaktionen und Kontaktkarten werden empfangen und angezeigt; ausgehende Standorte sind nur als Vorlagenkopf möglich.

Mehrere Nummern, mehrere Unternehmen? Ja. Jede Geschäftsnummer hat eigene Bearbeiter und erlaubte Unternehmen, eigene Vorlagen und eigene Unterhaltungen. Bearbeiter sehen nur die Nummern, bei denen sie eingetragen sind.

Welche Odoo-Versionen werden unterstützt, und in welchen Sprachen gibt es die Oberfläche? Odoo Community 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.

Ist Support enthalten? Ja, für alle, die das Modul kaufen. Fehler werden kostenlos behoben; neue Funktionen und die Einrichtung auf Meta-Seite werden separat angeboten.

Support

Support ist für alle enthalten, die das Modul kaufen. Installation, die Konfiguration auf Meta-Seite und die Tech-Provider-Lizenz von RC Studio 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.