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:

    • Offertes uit de Verkoop-app

    • Ontvangsten en facturen van de Point of Sale app

    • Tickets van de Evenementen app

Zie ook

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.

De WhatsApp-connector ondersteunt twee stromen: op initiatief van het bedrijf en op initiatief van de klant. Een bedrijf kan een discussie starten door een sjabloon naar een of meer personen te sturen. Zodra de sjabloon is verzonden, kan de ontvanger antwoorden om een discussie op gang te brengen tussen de verzender en de ontvanger (er verschijnt een Discussie chatvenster als de klant binnen 15 dagen antwoordt).

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:

  1. Maak een Meta-bedrijfsaccount

  2. Maak een Meta-ontwikkelaarsaccount

  3. Stel een app en WhatsApp product in op Meta’s ontwikkelaarsconsole

  4. 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.

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.

Om naar het zakelijke account te gaan, ga je naar de Facebook Developer Console en klik je op de accountnaam in de rechterbovenhoek. Klik onder de kop Business Accounts op het gewenste bedrijf waar de WhatsApp-configuratie moet plaatsvinden. Dit is het account waarvoor Odoo WhatsApp-berichten verzendt en ontvangt.

Schakel tussen Meta persoonlijke en zakelijke accounts.

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>`_.

Klik op Mijn Apps in de rechterbovenhoek nadat je je met succes hebt aangemeld bij het Meta-ontwikkelaarsaccount. Dit leidt de beheerder door naar alle apps die de ontwikkelaar heeft geconfigureerd in dit specifieke ontwikkelaarsaccount. Klik op App aanmaken om te beginnen met het configureren van een nieuwe Meta-toepassing.

Type app

Selecteer op de Een app maken 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

Als het Meta-bedrijfsaccount niet mag adverteren, is het claimen van een app niet toegestaan. Om dit probleem op te lossen ga naar https://business.facebook.com/business voor hulp.

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.

Op de volgende pagina: aangezien WhatsApp wordt gebruikt, klik je op Instellen naast het vak met WhatsApp, dat zich onderaan de pagina bevindt.

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.

Navigeren naar de WhatsApp snelstartwizard in het dashboard van Meta voor ontwikkelaars.

Notitie

Als de browser zich niet op de Quickstart-pagina voor WhatsApp bevindt, navigeer je naar https://developers.facebook.com/apps en klik je op de app die wordt geconfigureerd (de naam van de app is Odoo als de bovenstaande instructies zijn gevolgd).

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.

Handmatig navigeren naar de Whatsapp webhooks configuratie.

Klik op de Webhook configuration pagina op Edit, waar zowel de Callback URL als de Webhook Verify Token waarden uit Odoo worden toegevoegd.

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

Voer nu individuele webhook-velden in de ontwikkelaarsconsole van Meta in, onder de Webhook-velden sectie. Klik op Beheer en wanneer het pop-up venster verschijnt, vink dan de vakjes in de Aanmelden kolom aan voor de volgende veldnamen:

  • account_update

  • bericht_template_kwaliteit_bijwerken

  • bericht_template_status_bijwerken

  • berichten

  • sjabloon_categorie_bijwerken

Klik na het maken van de selecties op Done.

De voltooide Webhooks configuratie ziet er als volgt uit in de Meta ontwikkelaarsconsole:

WhatsApp webhooks instellen 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

Als er nog geen betaalmethode is toegevoegd, is dit nodig om verder te gaan. bezoek Meta’s documentatie over het toevoegen van een betaalmethode in Meta’s Business Manager <https://www.facebook.com/business/help/915454841921082?id=180505742745347>`_. Dit is onderdeel van Meta’s fraudedetectiesysteem, om er zeker van te zijn dat de account/het bedrijf echt een betaalmethode is, is dit nodig om verder te kunnen gaan.

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 Business settings ‣ User ‣ System Users. 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.

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.

Vervolgens wordt het permanente token gegenereerd. Klik op Generate new token en er verschijnt een pop-upvenster met de vraag voor welke app dit token moet worden gegenereerd. Selecteer de App waar dit token voor is. Bepaal vervolgens de vervaldatum van 60 dagen of Nooit.

Tenslotte, wanneer Meta vraagt welke permissies de systeemgebruiker moet toestaan, voeg dan alle volgende permissies toe:

  • WhatsApp_zakelijk_berichten

  • WhatsApp_zakelijk_beheer

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 WhatsApp-app ‣ Configuratie ‣ WhatsApp Zakelijke accounts.

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 App Settings ‣ Basic. 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 WhatsApp app ‣ Sjablonen 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

Deze modellen zijn ook toegankelijk in ontwikkelaarsmodus. Navigeer op een contactformulier (of een vergelijkbaar formulier in Odoo) naar het model waarnaar verwezen wordt en ga met de muis over een veldnaam. Er verschijnt een kader met backend informatie met de specifieke Odoo Model naam in de backend. Zoek (met behulp van de naam van het front-end) naar dit model in het vervolgkeuzemenu Toepassing op in het WhatsApp-sjabloon.

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.

Om beschikbare velden te zoeken, typ je de naam van de front-end in het Zoek… vak. Dit zal een resultaat vinden van alle beschikbare velden voor het model (Toepassing op) waarvoor de sjabloon is gemaakt.

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.

Zoeken naar het telefoonveld in de zoekbalk.

Verander de Categorie in een Marketing, Gebruiksfuncties of Authenticatie categorie. In de meeste gevallen zullen de eerste twee opties worden gebruikt, tenzij de gebruiker een wachtwoord reset wil sturen of iets dat met beveiliging te maken heeft. Stel in op Marketing als er iets promotioneels wordt verzonden en stel in op Utility als er algemene transactieberichten worden verzonden (bijv. verkooporder, evenementticket, enz.).

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

Er zijn vooraf geconfigureerde demo-gegevenssjablonen beschikbaar in Odoo om te gebruiken of aan te passen. Deze sjablonen kunnen worden gebruikt zoals ze zijn of worden aangepast aan een specifieke bedrijfsbehoefte.

Om deze sjablonen te gebruiken, navigeer je naar :menuselectie:`WhatsApp-app --> Sjablonen` en selecteer je een vooraf geconfigureerd sjabloon. Klik op Voor goedkeuring indienen om het goedkeuringsproces te starten. Er wordt een e-mail verzonden naar de beheerder van het Meta-account wanneer de sjabloon is goedgekeurd.

Knoppen

Knoppen kunnen aan het bericht worden toegevoegd via het tabblad Knoppen. Voer het Type in (ofwel Website bezoeken, Bellen, of Snel antwoord) en geef vervolgens de Knop tekst, Bellen of Website URL (inclusief Url Type) op, afhankelijk van het Type van de knop.

Notitie

Knoppen kunnen ook worden toegevoegd op de Meta business console. Bekijk het dashboard voor WhatsApp-sjablonen van Meta door te navigeren naar https://business.facebook.com/wa/manage/home. Ga vervolgens naar :menuselectie:`Accounttools --> Berichtsjablonen`.

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.

WhatsApp-bericht met dynamische variabelen gemarkeerd.

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}},

Hier is je factuur {{2}} van {{3}} voor een totaal van {{4}}{{5}}.
Om je factuur te bekijken of online te betalen: {{6}}

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

Partner

lichaam - {{2}}

INV/2022/00001

Veld van model

Aantal

lichaam - {{3}}

Mijn bedrijf

Veld van model

Company

lichaam - {{4}}

Veld van model

Valuta > Symbool

lichaam - {{5}}

4000

Veld van model

Amount

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 WhatsApp app ‣ Configuration ‣ WhatsApp Business Accounts en selecteer je de configuratie die moet worden gesynchroniseerd. Klik onder het gedeelte Berichten verzenden op Synchroniseer sjablonen. Meta werkt de sjablonen bij die zijn goedgekeurd zodat ze kunnen worden gebruikt met verschillende apps in de database.

Meta WhatsApp-sjablonen synchroniseren met de Odoo-database, met de optie 'Sjablonen synchroniseren' gemarkeerd.

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 WhatsApp app ‣ Sjablonen 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 Account tools ‣ Berichtsjablonen.

Account tools gemarkeerd in business manager met de link sjablonen beheren gemarkeerd.

Als je een WhatsApp-sjabloon wilt maken, klik je op de blauwe knop Sjabloon maken en selecteer je vervolgens de Categorie. De vermelde opties zijn onder andere: Marketing, Middelen en Authenticatie. In de meeste gevallen zullen de eerste twee opties worden gebruikt, tenzij de gebruiker een wachtwoord reset wil sturen of iets dat met beveiliging te maken heeft.

Voer de Naam van de sjabloon in en selecteer dan de Taal voor de sjabloon.

Notitie

Je kunt meerdere talen selecteren door de naam van de taal of talen in te voeren en de andere talen te selecteren als dat nodig is.

De sjabloonconfiguratieopties worden opgesomd, met Marketing, Utility, Naam en Taal gemarkeerd.

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.

Bewerk de sjabloon met een koptekst, body, voettekst en knoppen.

Wanneer alle noodzakelijke wijzigingen in de sjabloon zijn aangebracht, klik je op de Zend in knop in de rechterbovenhoek. Er verschijnt een bevestigingsvenster om de taal te bevestigen- klik op Bevestigen om goed te keuren en er verschijnt nog een venster waarin staat dat de sjabloon ter controle en goedkeuring naar Meta wordt gestuurd.

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.

Instellingen voor meldingen kunnen worden aangepast door te navigeren naar :menuselectie:`WhatsApp-app --> Configuratie --> WhatsApp Zakelijke accounts`. Selecteer daar het account en scroll naar beneden naar de Control-sectie waar meldingen worden afgehandeld. Typ onder de kop Gebruikers waarschuwen in het veld welke gebruiker(s) moet(en) worden geïnformeerd voor dit specifieke WhatsApp-kanaal.

Notitie

Zodra een gesprek wordt gestart tussen een gebruiker en een klant, worden geen meldingen gedaan aan alle gebruikers die zijn opgegeven in de configuratie van het zakelijke WhatsApp-account. Alleen de gebruiker(s) in het gesprek krijgen meldingen. Als de gebruiker niet binnen 15 dagen reageert, wordt het antwoord van de klant na de 15 dagen opnieuw ingevuld voor alle gebruikers die zijn opgegeven in de configuratie van WhatsApp.

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.

Gebruikers toevoegen aan een WhatsApp-gesprek, met het pictogram Gebruiker toevoegen gemarkeerd.

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.

Gebruikersfout in Odoo wanneer er een dubbele sjabloon bestaat.

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 in Odoo wanneer token verloopt.

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.

Gebruikersfout in Odoo wanneer een werknemerstoken wordt gegenereerd in plaats van een Admin-gebruiker.