WhatsApp¶
WhatsApp is een instant messaging en voice-over-IP app waarmee gebruikers berichten kunnen versturen, bellen en content kunnen delen. Bedrijven kunnen WhatsApp Business gebruiken om met hun klanten te communiceren via sms, documenten te versturen en ondersteuning te bieden.
Waarschuwing
WhatsApp is een Odoo Enterprise-applicatie die niet werkt in Odoo Community-editie. Als je je wilt aanmelden voor Odoo Enterprise edition, klik je hier: Odoo Gratis Proefversie.
Zie ook
Voor meer informatie over het migreren van Odoo Community versie naar Odoo Enterprise versie zie deze documentatie: Schakel over van Community naar Enterprise.
Met de app Odoo WhatsApp kan een bedrijf een WhatsApp Business Account (WABA) koppelen aan een Odoo-database, waardoor het volgende mogelijk wordt:
WhatsApp-berichten rechtstreeks ontvangen en beantwoorden vanuit een Odoo-database
Nieuwe sjablonen maken met dynamische plaatshouders/variabelen
Verzend vooraf goedgekeurde sjablonen die dynamische variabelen gebruiken, zoals:
Quotations from the Sales app
Receipts and invoices from the Point of Sale app
Tickets from the Events app
Zie ook
Meta Business: berichtsjablonen maken voor het WhatsApp Business-account.
meta Business: een telefoonnummer verbinden met het WhatsApp Business-account <https://www.facebook.com/business/help/456220311516626>`_.
meta Business: de weergavenaam van WhatsApp Business wijzigen <https://www.facebook.com/business/help/378834799515077>`_.
WhatsApp is een berichtendienst die wordt beheerd door Meta, het moederbedrijf van Facebook. WhatsApp wordt in veel landen en door veel bedrijven gebruikt als communicatiemiddel. Deze documentatie behandelt de integratie van een WhatsApp Business-account met Odoo. Het Meta-account van het bedrijf wordt geconfigureerd in Odoo via een API verbinding.
The WhatsApp connector supports two flows: company initiated, and customer initiated. A company can initiate a discussion by sending a template to one or more people. Once the template is sent, the recipient can answer in order to trigger a discussion between the sender and the receiver (a Discuss chat window appears if the customer answers within 15 days).
Als de discussie wordt gestart door de klant (bijvoorbeeld door te sturen naar het openbare WhatsApp-nummer van het bedrijf), opent Odoo een groepschat met alle operators die verantwoordelijk zijn voor dit WhatsApp-kanaal.
Tip
Het is aan te raden om meerdere WhatsApp-accounts in te stellen voor verschillende afdelingen. Het helpdeskteam en de verkoopteams kunnen bijvoorbeeld chatten op verschillende kanalen.
WhatsApp-configuratie in een Meta¶
Een WhatsApp-integratie met Odoo maakt gebruik van een standaard API verbinding en wordt in de volgende stappen geconfigureerd op Meta:
Maak een Meta-bedrijfsaccount
Maak een Meta-ontwikkelaarsaccount
Stel een app en WhatsApp product in op Meta’s ontwikkelaarsconsole
Test de API-verbinding.
Nadat je verbinding hebt gemaakt, worden berichten verzonden en ontvangen via de applicatie Discuss van Odoo met behulp van de WhatsApp API.
Meta zakelijke account instellen¶
Om een Business account aan te maken bij Meta (eigenaar van Facebook) ga je naar: Facebook Bedrijfsmanager. Klik eerst op Account aanmaken en voer dan de bedrijfsnaam, de naam van de beheerder en een e-mailadres voor het werk in. Klik dan op Volgende en er verschijnt een pop-upvenster waarin je het e-mailadres moet bevestigen. Klik na bevestiging op Done om het venster te sluiten.
Volg vervolgens de instructies in de e-mail die Facebook stuurt om het aanmaken van de zakelijke account te bevestigen en het installatieproces af te ronden.
Zie ook
Belangrijk
Als het zakelijke account is gekoppeld aan een persoonlijk Facebook-account, dan moet de beheerder voor de rest van de configuratie schakelen tussen het persoonlijke account en het zakelijke account.
To toggle to the business account navigate to the Facebook Developer Console and click on the account name in the upper right corner. Under the Business Accounts heading, click on the desired business that the WhatsApp configuration should take place in. This is the account for which Odoo will send and receive WhatsApp messages.
Belangrijk
Om een Meta business account aan te maken, moet de gebruiker al een persoonlijk Facebook account hebben dat minimaal één uur bestaat voordat het Facebook Business account wordt aangemaakt. Als je het zakelijke account probeert aan te maken voordat deze tijd verstreken is, resulteert dit in een foutmelding.
App maken¶
Meld je op het Meta voor Ontwikkelaars dashboard aan met het Meta ontwikkelaarsaccount. Als er nog geen account is geconfigureerd, koppel dan een Facebook account om een Meta ontwikkelaarsaccount te maken.
Notitie
Een Facebook ontwikkelaars account is anders dan een Facebook zakelijk account. Terwijl ontwikkelaarsaccounts bestaan uit persoonlijke Facebookaccounts, zijn zakelijke accounts dat niet, omdat ze een bedrijf vertegenwoordigen en alle bedrijfsmiddelen in Meta beheren, zoals apps.
Zie ook
stel het WhatsApp Business Platform in <https://www.facebookblueprint.com/student/collection/409587/path/360218>`_.
Click on My Apps in the top-right corner after successfully signing in to the Meta developer account. This will redirect the administrator to all the apps the developer has configured in this specific developer account. Click on Create App to begin the process of configuring a new Meta application.
Type app¶
Selecteer op de pagina Other onder het gedeelte Op zoek naar iets anders? en klik vervolgens op Next om naar een andere pagina te worden geleid waar je het type app kunt selecteren. Klik vervolgens op de eerste optie onder het Selecteer een app type label, getiteld Business. Met deze selectie kun je de WhatsApp API maken en beheren.
Klik nu op Next om de app naar wens te configureren. Als het app type is geconfigureerd, gaat de beheerder naar de sectie details van de app.
App details¶
In het Details gedeelte van het Een app maken proces, voer je Odoo in in het veld onder het Een app naam toevoegen label.
Notitie
De naam van de app kan indien nodig later worden gewijzigd in de instellingen.
Waarschuwing
Handelsmerken en merkelementen mogen niet worden gebruikt in dit tekstgedeelte. Hieronder valt ook de Meta bedrijvengroep. Gebruik niet het woord: WhatsApp of het systeem zal dit als fout markeren.
Voer vervolgens het e-mailadres van de ontwikkelaar in het veld onder het App contact email label in.
Stel ten slotte het Business Account - Optioneel veld in op het Meta business account profiel met behulp van het dropdown menu. Om te eindigen klik je op App maken. Deze actie maakt de app aan en geeft de Meta Platformvoorwaarden en Ontwikkelaarsbeleid overeenkomsten weer.
Om de overeenkomsten te accepteren, voer je het Facebook wachtwoord in voor veiligheidsdoeleinden en klik je op Submit om het maken van de app af te ronden. De browser gaat dan naar het Meta voor ontwikkelaars dashboard.
Notitie
If the Meta business account is prohibited from advertising, claiming an app is not allowed. To resolve this issue navigate to https://business.facebook.com/business for assistance.
Zie voor meer informatie Meta’s documentatie over advertentiebeperkingen.
Een WhatsApp-product toevoegen aan de app¶
Nu de basisstructuur van de app is gemaakt, moet er een product aan de app worden toegevoegd. Begin met het openen van het Meta app dashboard door te navigeren naar https://developers.facebook.com/apps en klik op de app die wordt geconfigureerd.
On the next page: since WhatsApp is used, click Set up next to the box containing WhatsApp, located towards the bottom of the page.
De pagina leidt dan naar de configuratiepagina voor de WhatsApp Business Platform API. Gebruik het vervolgkeuzemenu om de Meta Business te selecteren die geconfigureerd moet worden voor de Selecteer een Meta Business Account optie en klik dan op Doorgaan om de selectie te bevestigen.
Notitie
Als er op Doorgaan wordt geklikt, gaat de beheerder akkoord met de algemene voorwaarden van Meta, zoals gelinkt op het Meta App Dashboard.
Notitie
Zodra het WhatsApp-product is toegevoegd aan de app, biedt Meta een WhatsApp-testtelefoonnummer met 5 testberichten.
Begin met het gebruik van de WhatsApp API¶
Nadat je de vorige WhatsApp-productwizard hebt voltooid en op Doorgaan hebt geklikt, moet de browser je naar de WhatsApp Quickstart-pagina hebben geleid. Op deze Quickstart-pagina begin je met het configureren van de WhatsApp API door een telefoonnummer toe te voegen en vervolgens een eerste testbericht te verzenden.
Notitie
If the browser is not on the Quickstart page for WhatsApp, navigate to
https://developers.facebook.com/apps and click on the app that is being configured, (the
app name is Odoo if the instructions above were followed).
Klik vervolgens in het menu aan de linkerkant van de pagina op het v (menu toggle) pictogram naast de WhatsApp sectiekop. Er wordt een klein menu geopend met de volgende opties:
Snelstart
API Instellingen
Configuratie
Klik op de optie Snelstart en klik vervolgens op Start met de API.
API-Setup¶
Nadat je op Start using the API hebt geklikt, navigeert de pagina naar de API Setup. Nu het testnummer is aangemaakt, kun je een testbericht verzenden om te bevestigen dat WhatsApp naar behoren werkt. Om te beginnen, navigeer je naar het gedeelte op de pagina met het label Berichten verzenden en ontvangen en klik je op het vervolgkeuzemenu naast Aan, onder Stap 1 Selecteer telefoonnummers.
Selecteer nu de enige beschikbare optie: Beheer lijst met telefoonnummers. Volg de stappen en voeg maximaal vijf nummers toe om de gratis testberichten naartoe te sturen. Nadat je de juiste landcode en het juiste telefoonnummer hebt ingevoerd, klik je op Next.
Belangrijk
Door in deze stap een telefoonnummer toe te voegen om naar te verzenden, kan een succesvolle test worden verzonden door de terminal. Dit is van cruciaal belang om ervoor te zorgen dat de WhatsApp API werkt.
Er wordt dan een verificatiecode van WhatsApp Business naar het telefoonnummer verzonden. Deze code moet op het volgende scherm worden ingevoerd om het eigendom van het nummer te verifiëren. Voer de verificatiecode in en klik op Volgende om het nummer te verifiëren.
Stuur een testbericht via terminal¶
Stuur vervolgens een testbericht via de terminal. Klik onder het gedeelte Stap 2 Berichten verzenden met de API op Bericht verzenden. Er wordt dan een testbericht verzonden naar het telefoonnummer dat in de vorige sectie is ingesteld.
Nadat het bericht met succes is ontvangen op het nummer, ga je naar het volgende gedeelte om webhooks te maken en configureren.
WhatsApp-configuratie in Odoo¶
De volgende stappen die in dit gedeelte worden geconfigureerd zijn allemaal binnen de Odoo database. Een paar verschillende waarden voor een token, telefoonnummer en account-ID’s moeten allemaal worden geconfigureerd in Odoo; deze waarden zijn nodig om een Callback URL en Webhook Verify Token te maken, die vervolgens worden gebruikt om de webhooks te configureren (om berichten terug te ontvangen in de database).
Navigeer in Odoo naar :menuselectie:`WhatsApp-app --> Configuratie --> WhatsApp Bedrijfsaccounts`. Klik vervolgens op Nieuw om het zakelijke WhatsApp-account in Odoo te configureren.
Navigeer in een ander browsertabblad naar :menuselectie:`https://developers.facebook.com --> Mijn Apps --> WhatsApp --> API-configuratie` en kopieer vervolgens de volgende waarden van de Meta developer console naar de overeenkomstige velden in Odoo:
Naam |
Meta Console |
Odoo-interface |
|---|---|---|
Telefoon |
Telefoonnummer-ID |
Telefoonnummer-ID |
Token |
tijdelijk toegangstoken |
Toegangskenmerk |
App ID |
App ID |
App ID |
Account ID |
WhatsApp Bedrijfsaccount-ID |
Rekening-ID |
Om het App Secret op te vragen, navigeer je naar de Meta developer console, https://developers.facebook.com/apps en selecteer je de app waarin Odoo wordt geconfigureerd. Selecteer dan in het menu aan de linkerkant, onder App settings, Basic.
Klik vervolgens op Toon naast het veld App secret en voer het accountwachtwoord in om het eigendom te verifiëren. Kopieer het Appgeheim en plak de gekopieerde waarde in het Appgeheim veld op het Odoo WhatsApp Business Account configuratiedashboard.
Klik op Testverbinding om de instelling van het WhatsApp-bedrijfsaccount in Odoo te voltooien. Als de configuratie correct is ingesteld, verschijnt er een groen bericht in de rechterbovenhoek van het dashboard.
Webhooks configureren¶
Om de webhooks voor WhatsApp te configureren in Odoo, navigeer je naar https://developers.facebook.com/apps en selecteer je de app waarin Odoo wordt geconfigureerd. Klik vervolgens onder de WhatsApp menukop aan de linkerkant van het scherm op het API Setup menu-item. Ga tenslotte naar het gedeelte gemarkeerd met Stap 3: Configureer webhooks om berichten te ontvangen en klik op Configureer webhooks.
Tip
Een andere manier om Webhooks te configureren is door te navigeren naar https://developers.facebook.com/apps en de app te selecteren waarin Odoo wordt geconfigureerd. Selecteer vervolgens Webhooks in het linker menu.
On the page, click on Edit, where both the Callback URL and Webhook Verify Token values from Odoo are added.
Notitie
Zowel de Callback URL en Webhook Verify Token waarden werden automatisch ingevuld na het klikken op Test Connection in de vorige stap.
Haal in een apart browservenster de benodigde waarden op in Odoo door te navigeren naar :menuselectie:`WhatsApp app --> Configuratie --> WhatsApp Bedrijfsaccounts` en selecteer het account dat wordt geconfigureerd. Zoek de waarden in de sectie met het label Messages ontvangen.
Kopieer en plak de Callback URL van Odoo in het Callback URL veld in Meta. Kopieer en plak ook de Webhook Verify Token in het Verify Token veld op de Meta ontwikkelaarsconsole.
Klik tenslotte op Verifieer en sla op om de waarden op te slaan in de Meta ontwikkelaarsconsole.
Webhook velden¶
Now input individual webhook fields into Meta’s developer console, under the Webhook fields section. Click Manage and when the pop-up window appears, check the boxes in the Subscribe column for the following field names:
account_updatemessage_template_quality_updatemessage_template_status_updatemessagestemplate_category_update
Klik na het maken van de selecties op Done.
De voltooide Webhooks configuratie ziet er als volgt uit in de Meta ontwikkelaarsconsole:
Belangrijk
De Webhook velden verschijnen pas als het abonnement is bevestigd met behulp van de Callback URL en Webhook Verify Token.
Telefoonnummer toevoegen¶
Om het telefoonnummer te configureren dat moet worden gebruikt voor WhatsApp in Odoo, navigeer je terug naar de Meta ontwikkelaarsconsole (https://developers.facebook.com/apps) en selecteer je opnieuw de app waarin Odoo wordt geconfigureerd. Klik onder de menutitel WhatsApp aan de linkerkant van het scherm op het menu-item API Setup. Ga van daaruit naar het gedeelte gemarkeerd als: Stap 5: Een telefoonnummer toevoegen, en klik op Telefoonnummer toevoegen.
Voer in de velden een Zakelijke naam en een Zakelijke website of profielpagina in.
Tip
Het Bedrijfswebsite of profielpagina veld kan de URL van een social media pagina zijn.
Voltooi het invullen van de bedrijfsinformatie door vervolgens het land waarin het bedrijf zaken doet te selecteren in het vervolgkeuzemenu in het Land gedeelte. Voeg desgewenst een adres toe, maar deze informatie is optioneel. Klik na het toevoegen van de locatie op Next om verder te gaan.
De volgende pagina bevat informatie voor het WhatsApp Bedrijfsprofiel. Vul de volgende secties dienovereenkomstig in:
WhatsApp bedrijfsprofiel weergavenaam
Tijdzone
categorie
Bedrijfsomschrijving (optioneel)
Zodra deze secties zijn voltooid, klik je op Volgende. De pagina wordt vernieuwd en vraagt de beheerder vervolgens om Een telefoonnummer voor WhatsApp toevoegen in het desbetreffende veld. Voer hier het telefoonnummer in dat je wilt configureren in WhatsApp.
Kies vervolgens een verificatiemethode voor het telefoonnummer. Kies Tekstbericht of Telefoongesprek en klik dan op Volgende doorgaan.
Het ingevoerde telefoonnummer ontvangt een sms of een telefoontje van WhatsApp met een code, afhankelijk van de gekozen verificatiemethode. Voer die verificatiecode in het veld Verificatiecode in en klik op Volgende om te voltooien.
Waarschuwing
If a payment method has not been added, this is necessary to proceed. Visit Meta’s documentation on how to add a payment method in Meta’s Business Manager. This is part of Meta’s fraud detection system, in order to ensure that the account/company are real a payment method is required to proceed.
Permanente penning¶
Nadat de configuratie en het testen zijn voltooid, moet er een permanent token worden aangemaakt om het Tijdelijk token te vervangen.
Navigeer eerst naar https://business.facebook.com/ en ga dan naar . Selecteer een bestaande systeemgebruiker of maak een nieuwe systeemgebruiker aan door op Toevoegen te klikken.
Activa moeten nu worden toegevoegd aan de systeemgebruiker en dan kan er een permanent token worden gegenereerd.
Waarschuwing
This is a mandatory step. If the permanent token is not added, the Odoo database shows a token error.
Klik op Assets toevoegen en selecteer Apps onder de Selecteer activa type wanneer het pop-up venster verschijnt. Selecteer vervolgens de Odoo app en zet de rechten op Aan onder de Volledige controle optie. Stel deze nieuwe instelling in door te klikken op Save Changes, waarna een bevestigingsvenster verschijnt waarin de toevoeging van het bedrijfsmiddel aan de systeemgebruiker wordt bevestigd. Sluit af door op Done te klikken.
Next, the permanent token gets generated. Click on Generate new token, and a pop-up window will appear asking which app this token should be generated for. Select the App that this token is for. Then determine the expiration date of either 60 days or Never.
Tenslotte, wanneer Meta vraagt welke permissies de systeemgebruiker moet toestaan, voeg dan alle volgende permissies toe:
business_managementwhatsapp_business_messagingwhatsapp_business_management
Wanneer de rechten zijn ingesteld, klik je op Generate token. Kopieer de tokenwaarde die op het volgende scherm verschijnt.
Met die tokenwaarde werk je het Access Token-veld bij in het zakelijke WhatsApp-account in Odoo door te navigeren naar .
Ga live met de Meta-app¶
Om de app te starten, moet de Meta-app worden ingesteld op Live in de Meta-ontwikkelaarsconsole. Navigeer naar https://developers.facebook.com/apps en klik op de app die wordt geconfigureerd. Schakel in het bovenste menu het App Mode veld van Development naar Live.
Belangrijk
Als de status van de app niet is ingesteld op live, dan kan de database alleen contact maken met de testnummers die zijn opgegeven in de ontwikkelaarsconsole.
Waarschuwing
Er moet een URL voor het privacybeleid worden ingesteld om de app live te kunnen zetten. Ga naar de Meta developer console, https://developers.facebook.com/apps en selecteer de app waarin Odoo wordt geconfigureerd. Ga dan via het menu aan de linkerkant van het scherm naar . Voer vervolgens het adres van de hyperlink naar het privacybeleid in in het Privacy Policy URL veld van het formulier. Klik op Wijzigingen opslaan om het privacybeleid toe te passen op de app.
Zodra de app live is gegaan in de Meta ontwikkelaarsconsole, wordt er een bevestigingsmail naar de beheerder gestuurd.
WhatsApp-sjablonen¶
WhatsApp-sjablonen zijn opgeslagen berichten die herhaaldelijk worden gebruikt om berichten uit de database te versturen. Ze stellen gebruikers in staat om berichten van hoge kwaliteit te versturen zonder steeds dezelfde tekst te moeten samenstellen.
Gebruikers kunnen verschillende sjablonen opstellen voor specifieke situaties en zo het juiste bericht voor het juiste publiek kiezen. Dit verhoogt de kwaliteit van het bericht en de algehele betrokkenheid bij de klant.
WhatsApp-sjablonen kunnen worden gemaakt in zowel Odoo als Meta. Het volgende proces geeft een overzicht van het proces voor het maken van sjablonen in Odoo en daarna in Meta.
Belangrijk
WhatsApp heeft een goedkeuringsproces dat moet worden voltooid voordat de sjabloon kan worden gebruikt. Goedkeuring meta-sjabloon.
Sjablonen maken in Odoo¶
Om toegang te krijgen tot WhatsApp-sjablonen en deze te maken, begin je met navigeren naar het dashboard :menuselectie:`WhatsApp-app --> Sjablonen`.
Onderaan het formulier van een individuele sjabloon bevinden zich drie tabbladen: Body, Buttons en Variabelen. Samen vormen deze drie tabbladen de WhatsApp-sjabloon.
De tekst wordt ingevoerd in het Body tabblad en dynamische inhoud die wordt genoemd in het Body tabblad wordt gespecificeerd in het Variabelen tabblad. Elk stukje dynamische inhoud (bijvoorbeeld plaatshouders) in het bericht (body) wordt specifiek genoemd en gespecificeerd in het Variabelen tabblad.
Sjablonen zijn geprefabriceerde lay-outs waarmee gebruikers professioneel uitziende berichten naar klanten kunnen sturen. Deze sjablonen kunnen dynamische gegevens bevatten die in het uiteindelijke bericht worden ingevuld met behulp van variabelen die zijn ingesteld in de sjabloonconfiguratie. Berichten kunnen bijvoorbeeld de naam van de eindgebruiker bevatten, specifieke producten noemen of verwijzen naar een verkooporder, om maar een paar handige en impactvolle variabelen te noemen.
Om een WhatsApp-sjabloon te maken, ga je naar het dashboard en klik je op Nieuw. Voer op het formulier een Naam in voor de sjabloon en selecteer een Taal.
Belangrijk
Om deze volgende taak uit te voeren, heb je beheerdersrechten nodig om het Toepassing op veld te bewerken. Zie deze documentatie over toegangsrechten voor meer informatie.
Selecteer in het Account uitklapmenu de WhatsApp business account in Odoo waar deze sjabloon aan gekoppeld moet worden. Selecteer vervolgens onder Toepassing op het model waarop de serveractie voor deze sjabloon van toepassing is.
Tip
These models can also be accessed in developer mode. On a contact form (or similar relevant form in Odoo), navigate to the model that is referenced, and hover over any field name. A box of backend information will reveal itself with the specific Odoo Model name in the backend. Search (using the front-end name) for this model in the Applies to drop-down menu in the WhatsApp template.
Waarschuwing
Vaak kan bij het wijzigen van het model of het Gebruikt op veld, het Telefoonveld een fout opleveren Het Telefoonveld moet altijd worden ingesteld op het Telefoon of Mobiel model.
To search available fields, type in the front-end name in the search box. This finds a result from all of the available fields for the model (Applies to) that the template is created for.
Notitie
Om specifieke velden te vinden, kan het nodig zijn om op meerdere niveaus in het zoekresultatenvenster te navigeren. Gebruik de > (rechter chevron) en ⬅️ (linker pijl) pictogrammen om tussen de menuniveaus te navigeren.
Change the Category to fit either a Marketing, Utility, or Authentication category. In most instances the first two options are used, unless the user would like to send a password reset or something security related. Set to Marketing should there be anything promotional being sent and set to Utility should there be general transactional messages being sent (i.e., sales order, event ticket, etc).
Belangrijk
Het opgeven van een onjuiste categorie kan leiden tot een vlag/afkeurstatus van Meta tijdens het goedkeuringsproces.
Voeg alle Gebruikers toe die deze sjabloon mogen gebruiken. In de rechterkolom kan ook een Headertype worden ingesteld, samen met een Headerbericht.
De beschikbare Header-types zijn als volgt:
Tekst
Afbeelding
Video
Document
Locatie (variabelen moeten worden ingesteld)
Navigeer naar het tabblad Body om het hoofdbericht van de sjabloon te configureren.
Als alle benodigde wijzigingen in de sjabloon zijn aangebracht, klik je op de Inzenden ter goedkeuring knop in de linkerbovenhoek. Hierdoor verandert de status van de sjabloon in In behandeling.
De status blijft in Pending totdat Meta een beslissing heeft genomen. Er wordt dan een bevestigingsmail verstuurd waarin staat dat de sjabloon is goedgekeurd (of afgekeurd). De sjablonen moeten dan worden gesynchroniseerd vanuit de Odoo database.
Zie deze sectie voor meer informatie over synchronisatiesjablonen.
Tip
Consider the preconfigured demo data templates available in Odoo to use or modify. These templates can be used as-is or modified to suit a specific business need.
To use these templates, navigate to and select a preconfigured template. Click Submit for Approval to start the approval process. An email gets sent to the administrator of the Meta account when the template has been approved.
Plaatshouders en variabelen gebruiken¶
Dynamische variabelen verwijzen naar bepaalde velden in de Odoo-database om unieke gegevens te produceren in het WhatsApp-bericht wanneer je een sjabloon gebruikt. Dynamische variabelen zijn gecodeerd om velden weer te geven vanuit de database, waarbij wordt verwezen naar velden vanuit een model.
Example
Veel bedrijven willen hun WhatsApp-berichten aanpassen met een persoonlijk stukje klantinformatie om de aandacht te trekken. Dit kan in Odoo worden bereikt door te verwijzen naar een veld binnen een model door een dynamische variabele in te stellen. Zo kan in de e-mail worden verwezen naar de naam van een klant vanuit het Klant-veld in het Verkooporder-model.
Dynamische variabelen kunnen worden toegevoegd aan de Body door placeholders toe te voegen in de tekst. Om een plaatshouder toe te voegen in de berichttekst voer je de volgende tekst {{1}} in. Voor de tweede plaatsaanduiding voer je {{2}} in en verhoog je de waarde stapsgewijs naarmate er meer plaatsaanduidingen aan de tekst worden toegevoegd.
Example
Het volgende is de tekst uit de template van de betalingsontvangst:
Beste {{1}},
Bedankt
Zie ook
productiviteit/whatsapp/templates.
Deze plaatshouders moeten geconfigureerd worden op het Variabelen tabblad van de sjabloon voordat deze ter goedkeuring naar Meta gestuurd wordt. Om de dynamische variabelen op een sjabloon te bewerken, moet je eerst het Type veranderen in Veld van model. Hierdoor kan Odoo verwijzen naar een veld binnen een model om unieke gegevens te produceren in het bericht dat wordt verzonden.
Bewerk vervolgens het Veld van de dynamische variabelen. Het Toepassing op veld in de sjabloon moet eerst bewerkt worden om er zeker van te zijn dat naar het juiste model en veld wordt verwezen.
Om de beschikbare velden te doorzoeken, typ je de front-end naam van het veld in het zoekvak. Dit geeft een resultaat van alle beschikbare velden voor het model (Toepassing op) waarvoor het sjabloon is gemaakt. Er kunnen meerdere niveaus zijn die geconfigureerd moeten worden.
Example
Het volgende is een voorbeeld van de variabelen die zijn ingesteld voor de bovenstaande plaatshouders in de betalingsontvangst waarnaar hierboven wordt verwezen:
Naam |
Voorbeeldwaarde |
Soort |
Veld |
|---|---|---|---|
lichaam - {{1}} |
Azuur interieur |
Veld van model |
|
lichaam - {{2}} |
INV/2022/00001 |
Veld van model |
|
lichaam - {{3}} |
Mijn bedrijf |
Veld van model |
|
lichaam - {{4}} |
€ |
Veld van model |
|
lichaam - {{5}} |
4000 |
Veld van model |
|
lichaam - {{6}} |
https://.. |
Portaal link |
Example
Als bijvoorbeeld in het Body tabblad het volgende wordt getypt, “Hallo {{1}},”, dan moet {{1}} worden ingesteld in het Variabelen tabblad. In dit specifieke geval moet het bericht de klant bij naam begroeten, dus moet {{1}} worden geconfigureerd om het {{1}} veld te vullen met de klant naam.
Waarschuwing
Het aanpassen van WhatsApp-sjablonen valt buiten het bereik van Odoo Support.
Goedkeuring meta-sjabloon¶
Na het bijwerken van de dynamische variabelen op de sjabloon, moet de sjabloon opnieuw ter goedkeuring worden voorgelegd aan Meta. Klik op Inzenden voor goedkeuring om het goedkeuringsproces te starten. Er wordt een e-mail gestuurd naar de beheerder van de Meta-account als de sjabloon is goedgekeurd.
Na de goedkeuring van Meta synchroniseer je de sjablonen opnieuw in de Odoo database. Zie deze documentatie: Sjablonen synchroniseren.
Tip
Als je de status wilt zien, ga je naar Meta’s dashboard voor WhatsApp-sjablonen door te navigeren naar https://business.facebook.com/wa/manage/home. Ga vervolgens naar :menuselectie:`Accounttools --> Berichtsjablonen`.
Sjablonen synchroniseren¶
Sjablonen moeten worden gesynchroniseerd met de Odoo-database zodra ze zijn goedgekeurd door het Meta-team. Om dit te doen, ga je eerst naar en selecteer je de configuratie die moet worden gesynchroniseerd. Klik onder het gedeelte op Synchroniseer sjablonen. Meta werkt de sjablonen bij die zijn goedgekeurd zodat ze kunnen worden gebruikt met verschillende apps in de database.
Een succesvolle melding in het groen verschijnt in de rechterbovenhoek met het aantal sjablonen dat is bijgewerkt.
Tip
Sjablonen kunnen ook afzonderlijk worden gesynchroniseerd vanuit de sjabloon zelf. Navigeer naar het dashboard en selecteer de sjabloon die je wilt synchroniseren. Klik vervolgens op de Synchroniseer sjabloon knop in het bovenste menu van het sjabloonformulier.
Sjablonen maken in Meta¶
Navigeer eerst naar Meta’s WhatsApp template dashboard en ga dan naar .
To create a WhatsApp template, click on the blue Create template button, and then select the Category. The options listed include: Marketing, Utility, and Authentication. In most instances the first two options are used, unless the user would like to send a password reset or something security related.
Voer de Naam van de sjabloon in en selecteer dan de Taal voor de sjabloon.
Notitie
Multiple languages can be selected by typing the language names and selecting the other languages as needed.
Nadat je de juiste selecties hebt gemaakt, klik je op Doorgaan in de rechterbovenhoek. De pagina wordt omgeleid naar de Sjabloon bewerken pagina. Hier worden de Header, Body, Footer en Buttons ingesteld. Rechts van de sjabloon staat een voorbeeld van hoe de sjabloon er in productie uit zal zien.
When all the necessary changes are made to the template, click on the Submit button in the upper-right corner. A confirmation window appears to confirm the language— click Confirm to approve and then another window appears stating that the template gets submitted to Meta for review and approval.
De Status van de sjabloon blijft in In beoordeling totdat Meta een beslissing heeft genomen. Zodra een e-mailbevestiging is ontvangen waarin de sjabloon wordt goedgekeurd, moeten de sjablonen worden gesynchroniseerd vanuit de Odoo database.
Zie ook
Ga voor meer informatie over het configureren van sjablonen op de Meta ontwikkelaarsconsole naar Meta’s WhatsApp sjabloondocumentatie.
Meldingen¶
Meldingen in WhatsApp worden op dezelfde manier afgehandeld als een berichtconversatie in Odoo. Er verschijnt een pop-upvenster met de ontvangen conversatie van de klant. Standaard worden meldingen ingesteld in de configuratie van het zakelijke WhatsApp-account in Odoo.
Notification settings can be adjusted by navigating to . From there, select the account and scroll down to the section where notifications are handled. Under the Notify users heading, type in the field which users should be notified for this particular WhatsApp channel.
Notitie
Once a conversation is initiated between a user and a customer, notifications to all the users specified in the WhatsApp business account configuration will not occur. Only notifications to the users in the conversation will occur. Should the user not respond within 15 days, the customer’s reply after the 15 days will populate once again to all the users specified in the WhatsApp configuration.
Gebruikers toevoegen aan chat¶
Gebruikers kunnen worden toegevoegd aan een WhatsApp-chat door het pop-upvenster WhatsApp uit te vouwen. WhatsApp-conversaties bevinden zich in de app Discussie. Klik op het 👤+ (gebruiker toevoegen) pictogram ernaast en er verschijnt een venster om gebruikers uit te nodigen voor het gesprek.
WhatsApp API FAQ¶
Verificatie¶
Vanaf 1 februari 2023, als de Meta app toegang tot machtigingen op geavanceerd niveau vereist, moet er mogelijk een volledige bedrijfsverificatie worden voltooid. Dit omvat het indienen van zakelijke kantoordocumenten bij Meta. Zie deze documentatie.
Sjabloon fouten¶
Het bewerken van sjablonen kan leiden tot tracebacks en fouten, tenzij het exacte proces hierboven wordt gevolgd, hier: (WhatsApp-sjablonen).
Dubbele validatiefout¶
Bij het synchroniseren van de sjablonen kan het voorkomen dat er meerdere sjablonen met dezelfde naam zijn in Meta’s business manager en in Odoo. Dit veroorzaakt een dubbele validatiefout. Om dit probleem op te lossen, hernoem je de dubbele sjabloonnaam in Odoo en synchroniseer je de sjablonen opnieuw door de stappen hier te volgen: Sjablonen synchroniseren.
Token fouten¶
Gebruikersfout¶
Als het tijdelijke token niet wordt vervangen door een permanent token, verschijnt er een gebruikersfout in Odoo bij het testen van de verbinding nadat het verzenden is mislukt. Om dit probleem op te lossen zie Permanente penning.
Gebruikersfout systeem 100¶
Als de systeemgebruiker een Werknemer is bij het instellen van het permanente token, dan wordt er een gebruikersfout 100 ingevuld.
Om deze fout te herstellen, maak je een Admin systeemgebruiker aan volgens het hier beschreven proces: Permanente penning.
