WhatsApp¶

WhatsApp ist eine Direktnachrichten- und Voice-over-IP-App, mit der Sie Nachrichten senden, Anrufe tätigen sowie Inhalte teilen können. Unternehmen können WhatsApp Business verwenden, um mit seinen Kunden per Textnachricht zu kommunizieren, Dokumente zu versenden oder Support anzubieten.

Mit der Odoo-WhatsApp-App können Unternehmen ein WhatsApp Business Account (WABA) mit einer Odoo-Datenbank verknüpfen, was Folgendes ermögliocht:

• WhatsApp-Nachrichten direkt aus einer Odoo-Datenbank erhalten und beantworten

• Neue Vorlagen mit dynamischen Platzhaltern/Variablen erstellen

• Im Voraus genehmigte Vorlagen, die dynamische Variabeln versenden, wie:

  • Angebote aus der Verkaufsapp

  • Belege und Rechnungen aus der Kassensystem-App

  • Tickets aus der Veranstaltungsapp

WhatsApp ist ein von Meta, die Muttergesellschaft von Facebook, durchgeführter Nachrichtendienst. WhatsApp wird allgemein in vielen Ländern und vielen Unternehmen als Kommunikationstool verwendet. Diese Dokumentation umfasst die Integration eines WhatsApp-Business-Kontos mit Odoo. Das Meta-Konto des Unternehmens wird über eine API-Verbindung konfiguriert.

Der WhatsApp-Konnektor unterstützt zwei Abläufe: vom Unternehmen initiiert und vom Kunden initiiert. Ein Unternehmen kann eine Unterhaltung initiieren, indem es eine Vorlage an eine oder mehrere Personen sendet. Sobald die Vorlage versendet wurde, kann der Empfänger darauf antworten, um eine Unterhaltung zwischen dem Absender und dem Empfänger auszulösen (ein Dialog-Chatfenster wird angezeigt, wenn der Kunde innerhalb von 15 Tagen antwortet).

Wenn eine Unterhaltung vom Kunden initiiert wird (z. B. durch Versand einer Nachtricht an die öffentliche WhatsApp-Nummer des Unternehmens), öffnet Odoo einen Gruppenchat mit allen für diesen WhatsApp-Kanal verantwortlichen Bediener.

WhatsApp-Konfiguration in Meta¶

Eine WhatsApp-Integration mit Odoo-Benutzern verwendet eine API-Standardverbindung und wird in folgenden Schritten auf Meta konfiguriert:

1. Ein Meta-Business-Konto erstellen

2. Ein Meta-Developer-Konto erstellen

3. Eine App und ein WhatsApp-Produkt auf einer Entwicklerkonsole von Meta einrichten

4. Testen Sie die API-Verbindung.

Sobald die Verbindung hergestellt ist, werden die Nachrichten über die Dialog-App von Odoo mithilfe der WhatsApp-API gesendet und empfangen.

Einrichtung eines Meta-Geschäftskontos¶

Um ein Business-Konto mit Meta (Besitzer von Facebook) zu erstellen, navigieren Sie zu: Business Manager von Facebook. Klicken Sie auf Create account (Konto erstellen) und geben Sie den Namen des Betriebs, den Namen des Administrators und eine Arbeits-E-Mail-Adresse ein. Klicken Sie dann auf Next (Weiter) und ein Pop-up-Fenster zur Bestätigung der E-Mail-Adresse erscheint. Klicken Sie nach der Bestätigung auf Done (Erledigt, um das Fenster zu schließen.

Folgen Sie dann den Anweisungen in der von Facebook gesendeten E-Mail, um die Einrichtung des Business-Kontos zu bestätigen und den Einrichtungsprozess abzuschließen.

Wichtig

Wenn das Business-Konto mit einem persönlichen Facebook-Konto verknüpft ist, muss der Administrator für den Rest der Konfiguration zwischen dem persönlichen Konto und dem Business-Konto hin- und herschalten.

Um das Business-Konto zu aktivieren, navigieren Sie zur Facebook-Entwicklerkonsole und klicken Sie auf den Kontonamen oben rechts. Klicken Sie unter der Überschrift Business Accounts (Business-Konten) auf das gewünschte Unternehmen, in dem die WhatsApp-Konfiguration stattfinden soll. Dies wird das Konto sein, für das Odoo WhatsApp-Nchrichten sendet und empfängt.

App-Erstellung¶

Melden Sie sich auf dem Dashboard Meta for Developers (Meta für Entwickler), sign in mit dem Meta-Developer-Konto an. Wenn Sie noch kein Konto erstellt haben, verknüpfen Sie ein Facebook-Konto zur Erstellung eines Meta-Developer-Kontos.

Klicken Sie nach erfolgreicher Anmeldung bei dem Meta-Developer-Konto auf My Apps (Meine Apps) in der oberen rechten Ecke. Dadurch wird der Administrator zu allen Apps weitergeleitet, die der Entwickler in diesem speziellen Entwicklerkonto konfiguriert hat. Klicken Sie auf Create App (App erstellen), um den Prozess der Konfiguration einer neuen Meta-App zu beginnen.

App-Typ¶

Wählen Sie auf der Seite Create an app (Eine App erstellen) im Abschnitt Looking for something else? (Sie suchen nach etwas Anderem) auf Other (Andere) und klicken Sie dann auf Next (Weiter), um zu einer anderen Seite weitergeleitet zu werden, um den App-Typ auszuwählen. Klicken Sie auf die erste Option unter Select an app type (Einen App-Typ auswählen) mit der Bezeichnung Business. Diese Auswahl ermöglicht die Erstellung und Verwaltung der WhatsApp-API.

Klicken Sie dann auf Next (Weiter), um die App nach Ihren Wünschen zu konfigurieren. Wenn der App*-Typ* konfiguriert wurde, geht der Administrator zum Abschnitt zu den Details der App.

App-Details¶

Geben Sie im Abschnitt Details der Prozesses Create an app (Eine App erstellen) Odoo im Feld unter Add an app name (Einen App-Namen hinzufügen) ein.

Geben Sie als nächstes die E-Mail-Adresse des Entwicklers im Feld unter App contact email (App-Kontakt-E-Mail) ein.

Setzen Sie schlussendlich das Feld Business Account - Optional (Business-Konto - Optional) über das Dropdown-Menü auf das Meta-Business-Kontoprofil. Zum Abschluss klicken Sie auf Create app (App erstellen). Diese Aktion erstellt die App und öffnet die Vereinbarungen Meta Platform Terms (Meta-Plattform-Bedingungen) und Developer Policies (Entwicklerrichtlinien) an.

Um die Vereinbarungen zu akzeptieren, geben Sie zur Sicherheit das Facebook-Passwort ein und klicken Sie auf Submit (Absenden), um die Erstellung der App abzuschließen. Der Browser leitet Sie dann zum Dashboard Meta for Developers (Meta für Entwickler)weiter.

Ein WhatsApp-Produkt zur App hinzufügen¶

Nachdem nun die Grundstruktur der App erstellt wurde, müssen Sie der App ein Produkt hinzufügen. Rufen Sie zunächst das Meta-App-Dashboard auf, indem Sie zu https://developers.facebook.com/apps navigieren und auf die zu konfigurierende App klicken.

Auf der nächsten Seite: Da WhatsApp verwendet wird, klicken Sie auf Set up (Einrichten) neben dem Feld mit WhatsApp, das sich im unteren Teil der Seite befindet.

Die Seite leitet Sie dann auf die Konfigurationsseite für die WhatsApp-Business-Plattform-API weiter. Verwenden Sie das Dropdown-Menü, um das zu konfigurierende Meta-Unternehmen für die Option Select a Meta Business Account (Ein Meta-Business-Konto auswählen) auszuwählen, und klicken Sie dann auf Continue (Fortfahren), um die Auswahl zu bestätigen.

Die WhatsApp-API verwenden¶

Nachdem Sie den vorangegangenen WhatsApp-Produktassistenten abgeschlossen und auf Continue (Fortfahren) geklickt haben, sollte der Browser auf die WhatsApp-Seite Quickstart (Schnellstart) weitergeleitet haben. Auf dieser Seite Quickstart (Schnellstart) beginnen Sie mit der Konfiguration der WhatsApp-API, indem Sie eine Telefonnummer hinzufügen und dann eine erste Testnachricht senden.

API-Einrichtung¶

Nachdem Sie auf Start using the API (Verwendung der API starten) geklickt haben, navigiert die Seite zur API Setup (API-Einrichtung). Jetzt, da die Testnummer erstellt wurde, können Sie eine Testnachricht senden, um zu überprüfen, ob WhatsApp ordnungsgemäß funktioniert. Navigieren Sie dazu auf der Seite zu dem Abschnitt Send and receive messages (Nachrichten senden und empfangen) und klicken Sie auf das Dropdown-Menü neben To (An), unter Step 1 Select phone numbers (Schritt 1 Telefonnummern auswählen).

Wählen Sie nun die einzige verfügbare Option: Manage phone number list (Telefonnummernliste verwalten). Folgen Sie den Schritten und fügen Sie bis zu fünf Nummern hinzu, an die Sie die kostenlosen Testnachrichten senden möchten. Nachdem Sie die entsprechende Landesvorwahl und Telefonnummer eingegeben haben, klicken Sie auf Next (Weiter).

Ein Verifizierungscode von WhatsApp Business wird dann an die Telefonnummer gesendet, den Sie auf dem nächsten Bildschirm eingeben müssen, um den Besitz der Nummer zu verifizieren. Geben Sie den Verifizierungscode ein und klicken Sie auf Next (Weiter), um die Nummer zu verifizieren.

Eine Testnachtricht über das Terminal versenden¶

Senden Sie dann eine Testnachricht über das Terminal. Klicken Sie im Abschnitt Step 2 Send messages with the API (Schritt 2 Nachrichten mit der API senden) auf Send Message (Nachricht versenden). Dann wird eine Testnachricht an die Telefonnummer, dir im vorherigen Abschnitt eingerichtet wurde, versendet.

Gehen Sie beim erfolgreichen Empfang der Nachricht an die Nummer zum nächsten Abschnitt über, um Webhooks zu erstellen und zu konfigurieren.

WhatsApp-Konfiguration in Odoo¶

Die nächsten Schritte, die in diesem Abschnitt konfiguriert werden, finden alle innerhalb der Odoo-Datenbank statt. In Odoo müssen verschiedene Werte für ein Token, eine Telefonnummer und Konto-IDs konfiguriert werden. Diese Werte sind notwendig, um eine Rückruf-URL und ein Webhook-Verifizierungstoken zu erstellen, die dann zur Konfiguration der Webhooks verwendet werden (um Nachrichten zurück in die Datenbank zu empfangen).

Navigieren Sie in Odoo zu WhatsApp ‣ Konfiguration ‣ WhatsApp-Business-Konten. Klicken Sie dann auf Neu, um das WhatsApp-Business-Konto in Odoo zu konfigurieren.

Navigieren Sie in einem anderem Browserreiter zu https://developers.facebook.com ‣ My Apps ‣ WhatsApp ‣ API Configuration (Meine Apps –> WhatsApp –> API-Konfiguration) und kopieren Sie die folgenden Werte aus der Meta-Entwicklerkonsole in die entsprechenden Felder in Odoo.

Um das App-Geheimnis abzurufen, navigieren Sie zur Meta-Entwicklerkonsole, https://developers.facebook.com/apps und wählen Sie die App, in der Odoo konfiguriert ist. Wählen Sie dann im linken Seitenmenü unter App settings (App-Einstellungen) Basic.

Klicken Sie dann auf Show (Anzeigen) neben dem Feld App secret (App-Geheimnis) und geben Sie das Passwort des Kontos ein, um die Inhaberschaft zu überprüfen. Kopieren Sie das App secret (App-Geheimnis) und fügen Sie den kopierten Wert in das Feld App-Geheimnis auf dem Odoo-Konfigurationsdashboard WhatsApp-Business-Konto ein.

Um die Einrichtung des WhatsApp-Business-Kontos in Odoo abzuschließen, klicken Sie auf Verbindung testen. Eine erfolgreiche Nachricht in Grün erscheint oben rechts auf dem Dashboard, wenn die Konfiguration ordnungsgemäß ist.

Webhooks konfigurieren¶

Um die Webhooks für WhatsApp in Odoo zu konfigurieren, navigieren Sie zu https://developers.facebook.com/apps und wählen die App aus, in der Odoo konfiguriert wird. Als nächstes klicken Sie unter der Menüüberschrift WhatsApp auf der linken Seite des Bildschirms auf den Menüpunkt API Setup (API-Einrichtung). Gehen Sie schließlich zum Abschnitt mit der Bezeichnung Step 3: Configure webhooks to receive messages (Schritt 3: Webhooks für den Empfang von Nachrichten konfigurieren) und klicken Sie auf Configure webhooks (Webhooks konfigurieren).

Tipp

Webhooks können auch konfiguriert werden, indem Sie zu https://developers.facebook.com/apps navigieren und die App auszuwählen, in der Odoo konfiguriert wird. Wählen Sie dann Webhooks im linken Menü.

Auf der Seite Webhook configuration (Webhook-Konfiguration) klicken Sie auf Edit (Bearbeiten), wo die beiden Werte von Odoo Rückruf-URL und Webhook-Verifizierungstoken hinzugefügt werden.

Entnehmen Sie in einem separaten Broweser-Fenster die notwendigen Werte in Odoo, indem Sie zu WhatsApp ‣ Konfiguration ‣ WhatsApp-Business-Konten navigieren. Klicken Sie dann auf Neu, um das WhatsApp-Business-Konto in Odoo zu konfigurieren.

Kopieren Sie die Rückruf-URL aus Odoo und fügen Sie sie in das Feld Callback URL (Rückruf-URL) in Meta ein. Kopieren Sie auch das Webhook-Verifizierungstoken in das Feld Verify Token (Verifizierungstoken) in der Meta-Entwicklerkonsole und fügen Sie es ein.

Klicken Sie schließlich auf Verify and save (Verifizieren und speichern), um die Werte in der Meta-Entwicklerkonsole zu speichern.

Webhook-Felder¶

Geben Sie nun die einzelnen Webhook-Felder in der Meta-Entwicklerkonsole unter dem Abschnitt Webhook fields (Webhook-Felder) ein. Klicken Sie auf Manage (Verwalten) und wenn das Pop-up-Fenster erscheint, markieren Sie die Kästchen in der Spalte Subscribe (Abonnement) für die folgenden Feldnamen:

• account_update

• message_template_quality_update

• message_template_status_update

• messages

• template_category_update

Klicken Sie nach Ihrer Auswahl auf Erledigt.

Die abgeschlossene Webhooks-Konfiguration erscheint wie folgt in der Meta-Entwicklerkonsole:

Telefonnummer hinzufügen¶

Um die Telefonnummer zur Verwendung mit WhatsApp in Odoo zu konfigurieren, navigieren Sie zur Meta-Entwicklerkonsole (https://developers.facebook.com/apps) und wählen die App aus, in der Odoo konfiguriert wird. Klicken Sie unter der Menüüberschrift WhatsApp auf der linken Seite des Bildschirms auf den Menüpunkt API Setup (API-Einrichtung). Gehen Sie schließlich zum Abschnitt mit der Bezeichnung Step 5: Add a phone number (Schritt 5: Eine Telefonnummer hinzufügen) und klicken Sie auf Add phone number (Telefonnummer hinzufügen).

Geben Sie in den Feldern Business name (Unternehmensname) und Business website or profile page (Geschäftswebsite oder Profilseite) ein.

Füllen Sie die Geschäftsinformationen aus, indem Sie als nächstes das Land, in dem das Unternehmen tätig ist, aus dem Dropdown-Menü im Abschnitt Country (Land) auswählen. Fügen Sie, falls gewünscht, eine Adresse hinzu. Diese Angabe ist jedoch optional. Nachdem Sie den Standort eingegeben haben, klicken Sie auf Next (Weiter), um fortzufahren.

Die folgende Seite enthält die Informationen für WhatsApp Business profile (WhatsApp-Business-Profil). Füllen Sie die folgenden Abschnitte entsprechend aus:

• WhatsApp Business Profile Display Name (Anzeigename des WhatsApp-Business-Profils)

• Zeitzone

• Kategorie

• Business description (Geschäftsbeschreibung) (optional)

Sobald diese Abschnitte abgeschlossen sind, klicken Sie auf Next (Weiter). Die Seite wird aktualisiert und fordert den Administrator dann auf, Add a phone number for WhatsApp (Eine Telefonnummer für WhatsApp hinzufügen) in das entsprechende Feld einzugeben. Geben Sie hier die Telefonnummer ein, die in WhatsApp konfiguriert werden soll.

Als nächstes wählen Sie eine Verifizierungsmethode für die Telefonnummer. Wählen Sie entweder Text message (Textnachricht) oder Phone call (Telefonanruf), und klicken Sie dann auf Next (Weiter).

Die eingegebene Telefonnummer erhält entweder eine SMS oder einen Anruf von WhatsApp mit einem Code, je nach der gewählten Verifizierungsmethode. Geben Sie diesen Verifizierungscode in das Feld Verification code (Verifizierungscode) ein und klicken Sie zum Abschluss auf Next (Weiter).

Dauerhaftes Token¶

Nachdem die Konfiguration und die Tests abgeschlossen sind, sollte ein permanentes Token erstellt werden, das das Remporäre Token ersetzt.

Beginnen Sie mit der Navigation zu https://business.facebook.com/ und gehen Sie dann zu Business settings ‣ User ‣ System Users (Business-Einstellungen –> Benutzer –> Systembenutzer). Wählen Sie einen vorhandenen Systembenutzer aus oder erstellen Sie einen neuen Systembenutzer, indem Sie auf Add (Hinzufügen) klicken.

Assets müssen nun zum Systembenutzer hinzugefügt werden und dann kann ein permanentes Token generiert werden.

Klicken Sie auf Add assets (Assets hinzufügen) und wenn das Pop-up-Fenster erscheint, wählen Sie Apps unter dem Select asset type (Assettyp wählen). Wählen Sie dann die Odoo-App und schalten Sie die Berechtigungen unter der Option Full control (Vollständige Kontrolle) auf On (Ein). Legen Sie diese neue Berechtigungseinstellung fest, indem Sie auf Save Changes (Änderungen speichern) klicken, woraufhin ein Bestätigungsfenster erscheint, in dem bestätigt wird, dass das Asset dem Systembenutzer hinzugefügt wurde. Klicken Sie abschließend auf Done (Erledigt).

Als nächstes wird das permanente Token generiert. Klicken Sie auf Generate new token (Neues Token generieren). Daraufhin erscheint ein Pop-up-Fenster, in dem Sie gefragt werden, für welche App dieses Token generiert werden soll. Wählen Sie die App, für die dieses Token bestimmt ist. Legen Sie dann das Verfallsdatum fest, entweder 60 days (Tage) oder Never (Niemals).

Wenn Meta schlussendlich fragt, welche Berechtigungen dem Systembenutzer gegeben werden sollen, fügen Sie alle der folgenden Berechtigungen hinzu:

• WhatsApp_business_messaging

• WhatsApp_business_management

Wenn die Berechtigungen festgelegt sind, klicken Sie auf Generate token (Token generieren). Kopieren Sie den Wert des Tokens, der auf dem folgenden Bildschirm angezeigt wird.

Aktulisieren Sie das Feld Zugriffstoken im WhatsApp-Business-Konto in Odoo mit dem Tokenwert, indem Sie zu WhatsApp ‣ Konfiguration ‣ WhatsApp-Business-Konten navigieren.

Live gehen mit der Meta-App¶

Um die App schließlich zu starten, muss die Meta-App in der Meta-Entwicklerkonsole auf Live gesetzt werden. Navigieren Sie zu https://developers.facebook.com/apps und klicken Sie auf die App, die Sie konfigurieren möchten. Schalten Sie im oberen Menü das Feld App Mode (App-Modus) von Development (Entwicklung) auf Live um.

Sobald die App in der Meta-Entwicklerkonsole live geschaltet wurde, wird eine Bestätigungsmail an den Administrator gesendet.

WhatsApp-Vorlagen¶

WhatsApp-Vorlagen sind gespeicherte Nachrichten, die wiederholt zum Versenden von Nachrichten aus der Datenbank verwendet werden. Sie ermöglichen es den Benutzern, qualitativ hochwertige Mitteilungen zu versenden, ohne denselben Text wiederholt verfassen zu müssen.

Durch die Erstellung verschiedener Vorlagen, die auf bestimmte Situationen zugeschnitten sind, können Benutzer die richtige Nachricht für die richtige Zielgruppe auswählen. Dies erhöht die Qualität der Nachricht und die allgemeine Interaktionsrate mit dem Kunden.

WhatsApp-Vorlagen können sowohl in Odoo als auch in Meta-Konsolen erstellt werden. Der folgende Prozess erklärt den Vorgang zur Erstellung von Vorlagen in Odoo und dann in Meta.

Vorlagen in Odoo erstellen¶

Um auf WhatsApp-Vorlagen zuzugreifen und sie zu erstellen, gehen Sie zu WhatsApp ‣ Vorlagen.

Unten auf jedem Vorlagenformular befinden sich drei Reiter: Nachrichtentext, Schaltflächen und Variablen. Die Kombination dieser drei Reiter erstellt die WhatsApp-Vorlage.

Der Text wird auf der Registerkarte Nachrichtentext eingegeben und dynamische Inhalte, die im Reiter Nachrichtentext aufgerufen werden, werden im Reiter Variablen angegeben. Jeder dynamische Inhalt (z. B. Platzhalter) in der Nachricht (Text) wird im Reiter Variablen speziell aufgerufen und angegeben.

Vorlagen sind vorgefertigte Layouts, mit denen Benutzer professionell aussehende Nachrichten an Kunden senden können. Diese Vorlagen können dynamische Daten enthalten, die anhand von Variablen, die in der Vorlagenkonfiguration festgelegt wurden, in die Nachricht eingefügt werden. So können die Nachrichten beispielsweise den Namen des Endbenutzers enthalten, bestimmte Produkte nennen oder auf einen Verkaufsauftrag verweisen, um nur einige praktische und wirkungsvolle Variablen zu nennen.

Um eine WhatsApp-Vorlage zu erstellen, gehen Sie zum Dashboard WhatsApp ‣ Vorlagen und klicken Sie auf Neu. Geben Sie auf dem Formular den Namen für die Vorlage ein und wählen Sie eine Sprache.

Wählen Sie im Dropdown-Menü Konto das WhatsApp-Business-Konto in Odoo, mit dem diese Vorlage verknüpft werden soll. Als nächstes wählen Sie unter dem Feld Gilt für das Modell aus, für das die Serveraktion für diese Vorlage gelten soll.

Um die verfügbaren Felder zu durchsuchen, geben Sie einfach den Frontend-Namen das Kästchen Suchen … ein. Dadurch wird ein Ergebnis aus allen verfügbaren Feldern für das Modell (Gilt für) gefunden, für das die E-Mail-Vorlage erstellt wurde.

Ändern Sie die Kategorie so, dass sie entweder in die Kategorie Marketing, Nutzwert oder Authentifizierung passt. In den meisten Fällen werden die ersten beiden Optionen verwendet, es sei denn, der Benutzer möchte ein Passwort zurücksetzen oder etwas anderes sicherheitsrelevantes senden. Stellen Sie Marketing ein, wenn Sie etwas zu Werbezwecken versenden möchten, und stellen Sie Nutzwert ein, wenn Sie allgemeine Transaktionsnachrichten versenden möchten (z. B. ein Verkaufsauftrag, ein Veranstaltungsticket usw.).

Fügen Sie Benutzer hinzu, die diese Vorlage verwenden dürfen. In der rechten Spalte kann der Kopfzeilentyp sowie eine Fußzeilennachricht konfiguriert werden.

Die verfügbaren Kopfzeilentypen sind folgende:

• Text

• Bild

• Video

• Dokument

• Standort (es müssen Variablen eingerichtet werden)

Navigieren Sie zum Reiter Nachrichtentext, um die Hauptnachricht der Vorlage zu konfigurieren.

Wenn Sie alle notwendigen Änderungen an der Vorlage vorgenommen haben, klicken Sie auf die Schaltfläche Zur Genehmigung einreichen oben links. Dadurch ändert sich der Status der Vorlage auf Ausstehend.

Der Status bleibt auf Ausstehend, bis Meta eine Entscheidung getroffen hat. Dann wird eine Bestätigungsmail verschickt, die anzeigt, dass die Vorlage genehmigt (oder abgelehnt) worden ist. Die Vorlagen müssen dann aus der Odoo-Datenbank synchronisiert werden.

In diesem Abschnitt finden Sie weitere Informationen zur Synchronisierung von Vorlagen.

Schaltflächen¶

Im Reiter Schaltflächen können Sie Schaltflächen in die Nachricht einfügen. Geben Sie den Typ ein (entweder Website besuchen, Rufnummer oder Schnelle Antwort) und geben Sie dann den Schaltflächentext, die Rufnummer oder die Website-URL (einschließlich Url-Typ) an, je nach Typ der Schaltfläche.

Platzhalter und Variablen verwenden¶

Dynamische Variablen verweisen auf bestimmte Felder in der Odoo-Datenbank, um eindeutige Daten in der WhatsApp-Nachricht zu erzeugen, wenn Sie eine Vorlage verwenden. Dynamische Variablen werden codiert, um Felder aus der Datenbank anzuzeigen, die auf Felder aus einem Modell zu verweisen.

Dynamische Variablen können dem Nachrichtentext hinzugefügt werden, indem Sie Platzhalter in den Text einfügen. Um einen Platzhalter im Nachrichtentext einzufügen, geben Sie den folgenden Text ein: {{1}}. Für den zweiten Platzhalter geben Sie {{2}} ein und erhöhen den Wert schrittweise, wenn Sie weitere Platzhalter zum Text hinzufügen.

Diese Platzhalter müssen im Reiter Variablen der Vorlage konfiguriert werden, bevor sie zur Genehmigung durch Meta eingereicht werden. Um die dynamischen Variablen in einer Vorlage zu bearbeiten, ändern Sie zunächst den Typ in Feld des Modells. Dadurch kann Odoo auf ein Feld innerhalb eines Modells verweisen, um eindeutige Daten in der gesendeten Nachricht zu erzeugen.

Als nächstes bearbeiten Sie das Feld Field der dynamischen Variablen. Das Feld Gilt für in der Vorlage sollte vorher bearbeitet werden, um sicherzustellen, dass auf das richtige Modell und Feld verwiesen wird.

Um die verfügbaren Felder zu durchsuchen, geben Sie einfach den Frontend-Namen die Suchleiste ein. Dadurch wird ein Ergebnis aus allen verfügbaren Feldern für das Modell (Gilt für) gefunden, für das die Vorlage erstellt wurde. Es müssen gegebenenfalls mehrere Ebenen konfiguriert werden.

Genehmigung der Meta-Vorlage¶

Nach der Aktualisierung der dynamischen Variablen auf der Vorlage muss die Vorlage zur Genehmigung bei Meta eingereicht werden. Klicken Sie auf Zur Genehmigung einreichen, um den Genehmigungsprozess zu starten. Wenn die Vorlage genehmigt wurde, wird eine E-Mail an den Administrator des Meta-Kontos gesendet.

Synchronisieren Sie nach der Genehmigung von Meta die Vorlagen erneut in der Odoo-Datenbank: Siehe diese Dokumentation: Vorlagen synchronisieren.

Vorlagen synchronisieren¶

Vorlagen müssen mit der Odoo-Datenbank synchronisiert werden, sobald sie vom Meta-Team genehmigt wurden. Navigieren Sie dazu zunächst zu WhatsApp ‣ Konfiguration ‣ WhatsApp-Business-Konten und wählen Sie die Konfiguration, die synchronisiert werden soll. Unter dem Abschnitt Nachrichten versenden klicken Sie ganz unten auf Vorlagen synchronisieren. Meta aktualisiert die freigegebenen Vorlagen, sodass sie mit verschiedenen Apps in der Datenbank verwendet werden können.

Eine Erfolgsnachricht erscheint oben rechts in Grün mit der Anzahl der aktualisierten Vorlagen.

Vorlagen in Meta erstellen¶

Navigieren Sie zunächst zum WhatsApp-Vorlagendashboard von Meta und gehen Sie dann zu Account tools ‣ Message templates (Konto-Tools –> Nachrichtenvorlagen).

Um eine WhatsApp-Vorlage zu erstellen, klicken Sie auf die Schaltfläche Create template (Vorlage erstellen) und wählen Sie die Kategorie. Die verfügbaren Optionen sind: Marketing, Utility (Nutzwert) oder Authentication (Authentifizierung). In den meisten Fällen werden die ersten beiden Optionen verwendet, es sei denn, der Benutzer möchte ein Passwort zurücksetzen oder etwas anderes sicherheitsrelevantes senden.

Geben Sie den Namen der Vorlage ein und wählen Sie die Sprache für die Vorlage.

Nachdem Sie die entsprechende Auswahl getroffen haben, klicken Sie auf Continue (Fortfahren) in der oberen rechten Ecke. Die Seite leitet Sie auf die Seite Edit template (Vorlage bearbeiten) weiter. Hier werden Header (Kopfzeile), Body (Nachrichtentext), Footer (Fußzeile) und Buttons (Schaltflächen) konfiguriert. Rechts neben der Vorlage sehen Sie eine Vorschau darauf, wie die Vorlage in der Produktion aussehen wird.

Wenn Sie alle notwendigen Änderungen an der Vorlage vorgenommen haben, klicken Sie oben rechts auf die Schaltfläche Submit (Einreichen). Es erscheint ein Bestätigungsfenster, in dem Sie die Sprache bestätigen müssen. Klicken Sie auf Confirm (Bestätigen), um zu genehmigen, und dann erscheint ein weiteres Fenster, mit der Information, dass die Vorlage zur Überprüfung und Genehmigung an Meta übermittelt wird.

Der Status bleibt auf In review (Wird geprüft), bis Meta eine Entscheidung getroffen hat. Dann wird eine Bestätigungsmail verschickt, die anzeigt, dass die Vorlage genehmigt (oder abgelehnt) worden ist. Die Vorlagen müssen dann aus der Odoo-Datenbank synchronisiert werden.

Benachrichtigungen¶

Benachrichtigungen in WhatsApp werden ähnlich gehandhabt wie eine Nachrichtenunterhaltung in Odoo. Es erscheint ein Pop-up-Fenster mit der empfangenen Unterhaltung des Kunden. Standardmäßig sind die Benachrichtigungen in der Konfiguration des WhatsApp-Business-Kontos in Odoo eingestellt.

Die Benachrichtigungseinstellungen können angepasst werden, indem Sie zu WhatsApp ‣ Konfiguration ‣ WhatsApp-Business-Konten navigieren. Wählen Sie dort das Konto aus und scrollen Sie nach unten zum Abschnitt Kontrolle, in dem Benachrichtigungen verwaltet werden. Unter der Überschrift Benutzer benachrichtigen geben Sie in das Feld ein, welche(r) Benutzer für diesen bestimmten WhatsApp-Kanal benachrichtigt werden sollen.

Benutzer zum Chat hinzufügen¶

Benutzer können zu einem WhatsApp-Chat hinzugefügt werden, indem die das Pop-up-Fenster erweitern. WhatsApp-Unterhaltungen befinden sich in der Dialog-App. Klicken Sie auf das Symbol 👤+ (Benutzer hinzufügen) daneben und es erscheint ein Fenster zum Einladen von Benutzern zur Unterhaltung.

FAQ zur WhatsApp-API¶

Verifizierung¶

Ab dem 1. Februar 2023, wenn die Meta-App einen erweiterten Zugriff auf Berechtigungen erfordert, muss möglicherweise eine vollständige Unternehmensprüfung durchgeführt werden. Dazu gehört das Einreichen von Geschäftsdokumenten bei Meta. Siehe diese Dokumentation.

Vorlagenfehler¶

Die Bearbeitung von Vorlagen kann zu Tracebacks und Fehlern führen, wenn Sie den oben beschriebenen Prozess nicht befolgen: WhatsApp-Vorlagen

Validierungsfehler duplizieren¶

Bei der Synchronisierung der Vorlagen kann es vorkommen, dass es im Business Manager von Meta und in Odoo mehrere Vorlagen mit demselben Namen gibt. Dies führt zu einem Fehler bei der Validierung von Duplikaten. Um dieses Problem zu beheben, benennen Sie den doppelten Vorlagennamen in Odoo um und synchronisieren Sie die Vorlagen noch einmal, indem Sie die folgenden Schritte ausführen: Vorlagen synchronisieren.

Tokenfehler¶

Benutzerfehler¶

Wenn das temporäre Token nicht durch ein permanentes Token ersetzt wird, erscheint in Odoo eine Fehlermeldung, wenn Sie die Verbindung testen, nachdem das Senden fehlgeschlagen ist. Um dieses Problem zu beheben, siehe Dauerhaftes Token.

Systembenutzerfehler 100¶

Sollte der Systembenutzer beim Einrichten des permanenten Tokens ein Mitarbeiter sein, wird ein Benutzerfehler 100 angezeigt.

Um diesen Fehler zu beheben, erstellen Sie einen Systembenutzer Admin, indem Sie den hier beschriebenen Prozess befolgen: Dauerhaftes Token.