WhatsApp¶
WhatsApp is een instant messaging- en voice-over-IP-app waarmee gebruikers berichten kunnen verzenden, oproepen kunnen maken en content kunnen delen. Bedrijven kunnen WhatsApp Business gebruiken om met hun klanten te communiceren via tekst, documenten te verzenden en ondersteuning te bieden. Deze documentatie behandelt de integratie van een WhatsApp Business Account (WABA) met Odoo met behulp van de WhatsApp Business API.
Notitie
WhatsApp is een Odoo Enterprise-only applicatie die niet werkt in Odoo Community editie. Om de Odoo WhatsApp app te gebruiken, schakel over van Community naar Enterprise.
Een WhatsApp Business Account verbinden met een Odoo database maakt het volgende mogelijk in Odoo’s WhatsApp app:
Verstuur en ontvang WhatsApp-berichten rechtstreeks vanuit een Odoo-database.
Maak en verstuur vooraf goedgekeurde sjablonen met dynamische placeholders/variabelen, zoals:
Offertes uit de Verkoop-app.
Bonnetjes en verkoopfacturen uit de Kassa-app.
Tickets uit de Evenementen-app.
Belangrijk
De WhatsApp-integratie is alleen compatibel met WhatsApp Business Platform rekeningen. Persoonlijke WhatsApp-rekeningen en WhatsApp Business App rekeningen zijn niet compatibel met de Odoo WhatsApp-integratie. Zie Meta’s documentatie voor meer informatie:
De WhatsApp-integratie ondersteunt twee stromen: door het bedrijf geïnitieerd en door de klant geïnitieerd. Een bedrijf kan een discussie starten door een sjabloon naar een of meer klanten te versturen. Als de klant binnen 15 dagen antwoordt, verschijnt er een Chat-venster om het gesprek te beginnen.
Als een klant het initiatief neemt door een bericht naar het openbare WhatsApp-nummer van het bedrijf te sturen, opent Odoo een groepschat met alle operators die verantwoordelijk zijn voor het WhatsApp-kanaal.
Tip
Overweeg om aparte WhatsApp-rekeningen in te stellen voor elke afdeling om de communicatie beter te beheren.
WhatsApp-configuratie in Meta¶
WhatsApp wordt beheerd door Meta, het moederbedrijf van Facebook. Odoo’s WhatsApp-integratie maakt gebruik van een standaard :abbr:`API (Application Programming Interface)`verbinding die is geconfigureerd in Meta:
Maak een Meta-zakelijk account aan.
Maak een Meta-ontwikkelaarsaccount aan.
Stel een app en WhatsApp-product in in de ontwikkelaarsconsole van Meta.
Test de API-verbinding.
Zodra de WhatsApp-API is verbonden, kunnen Odoo-gebruikers berichten verzenden en ontvangen via de Chat-applicatie van Odoo.
Maak een Meta-bedrijfsaccount¶
Belangrijk
Om een Meta-bedrijfsrekening aan te maken, moet de gebruiker een persoonlijke Facebook-rekening hebben die minimaal een uur voor het instellen van de Facebook-bedrijfsrekening heeft bestaan. Als je de bedrijfsrekening eerder probeert aan te maken, resulteert dit in een fout.
Om een bedrijfsrekening bij Meta aan te maken, ga je naar Meta Business Suite. Klik op Rekening aanmaken en voer vervolgens de bedrijfsnaam, de naam van de beheerder en een zakelijk e-mailadres in. Klik op Volgende en bevestig het e-mailadres in het pop-upvenster dat verschijnt. Klik na het bevestigen op Voltooid 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 de bedrijfsrekening gekoppeld is aan een persoonlijke Facebook-rekening, moet de beheerder schakelen tussen zijn persoonlijke rekening en de bedrijfsrekening voor de rest van de configuratie.
Om over te schakelen naar de bedrijfsrekening, ga je naar het Meta Developer Dashboard en klik je op de rekeningnaam in de rechterbovenhoek. Selecteer onder Bedrijfsrekeningen het bedrijf dat moet worden geconfigureerd.
Meta-ontwikkelaarsapp voor Odoo aanmaken¶
Meld je aan met de Meta-ontwikkelaarsrekening op het Meta Developer Dashboard-dashboard. Als er nog geen rekening is geconfigureerd, koppel je een Facebook-rekening om een Meta-ontwikkelaarsrekening aan te maken.
Notitie
Een Facebook-ontwikkelaars*rekening is anders dan een Facebook-*bedrijfs*rekening. Hoewel ontwikkelaarsrekeningen gekoppeld zijn aan persoonlijke Facebook-rekeningen, zijn bedrijfsrekeningen dat **niet*, omdat ze een bedrijf vertegenwoordigen en alle bedrijfsmiddelen in Meta beheren, zoals apps.
Klik na het aanmelden bij de Meta-ontwikkelaarsrekening op Mijn apps in de rechterbovenhoek. Dit leidt de beheerder om naar alle apps die de ontwikkelaar heeft geconfigureerd in de specifieke ontwikkelaarsrekening. Klik op App aanmaken om een nieuwe Meta-applicatie te configureren.
App-gegevens toevoegen¶
De eerste stap van het proces Een app aanmaken is het invullen van de sectie App-gegevens. Voer Odoo in het veld App-naam in.
Notitie
De app-naam kan achteraf in de instellingen worden gewijzigd.
Waarschuwing
Handelsmerken en merkgebonden elementen mogen niet in deze tekstsectie worden gebruikt. Dit omvat de Meta-groep van bedrijven. Voeg het woord WhatsApp niet toe, anders markeert het systeem dit als een fout.
Voer vervolgens het e-mailadres van de ontwikkelaar in het veld E-mailadres app-contactpersoon in en klik op Volgende.
App-type selecteren¶
De volgende stap bij het aanmaken van een app is de sectie :Gebruikssituaties. Selecteer onder de optie Overige, selecteer Overige en klik vervolgens op Volgende. De pagina leidt om naar Selecteer een app-type.
Selecteer Bedrijf. Met deze selectie kunnen de WhatsApp-API worden aangemaakt en beheerd. Klik op Volgende om de app naar wens te configureren.
Bedrijfsportfolio selecteren¶
De laatste stap van het app-aanmaakproces is het verbinden van een bedrijfsportfolio.
Klik onder Business portfolio - Optional op het vervolgkeuzemenu en selecteer het Meta-bedrijfsrekening-profiel. Bekijk de overeenkomsten Meta Platform Terms en Developer Policies en klik vervolgens op Create app om te accepteren en de app aan te maken.
Voer het Facebook-rekeningwachtwoord in en klik op Submit om de overeenkomsten te accepteren en de app aan te maken. De browser leidt vervolgens door naar het Meta for Developers-dashboard.
Waarschuwing
Als het Meta-bedrijfsaccount verboden is om te adverteren, kan de app niet worden geclaimd. Om dit probleem op te lossen, ga je naar Meta Business Suite 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 aangemaakt, moet er een product aan de app worden toegevoegd. Ga naar het Meta Developer Dashboard en klik op de app die wordt geconfigureerd. De pagina leidt door naar het dashboard van de app.
Ga onder Add products to your app naar WhatsApp onderaan de pagina en klik op Set up.
De browser leidt vervolgens door naar de configuratiepagina voor de WhatsApp Business Platform API.
Selecteer onder de optie Select a Meta Business Account het Meta-bedrijf dat moet worden geconfigureerd en klik vervolgens op Continue om de selectie te bevestigen en akkoord te gaan met de algemene voorwaarden van Meta zoals vermeld op het Meta App Dashboard.
Zodra het WhatsApp-product aan de app is toegevoegd, verstrekt Meta een WhatsApp-testtelefoonnummer. Dit testtelefoonnummer kan onbeperkt berichten verzenden naar maximaal vijf ontvangers.
Selecteer onder Send and receive messages het veld To en kies Manage phone number list. Voeg maximaal vijf geldige WhatsApp-nummers toe als ontvangers en voer vervolgens de bevestigingscodes die naar die telefoonnummers in WhatsApp zijn verzonden in om te verifiëren.
Zie ook
WhatsApp API snelstartgids¶
Zodra de Meta-rekeningen en app zijn geconfigureerd, klik je op Continue om door te gaan naar de WhatsApp Quickstart-pagina. Deze pagina biedt een startpunt voor het configureren van de WhatsApp API door een telefoonnummer toe te voegen en een eerste testbericht te verzenden.
Notitie
Als de browser niet automatisch doorverwijst naar de WhatsApp Quickstart-pagina, ga je naar het Meta Developer Dashboard en selecteer je de Odoo-app.
Klik in het menu aan de linkerkant van de pagina op het (down chevron)-icoon naast de sectiekop WhatsApp. Er opent zich een klein menu met de volgende opties:
Snelstart
API-instelling
Configuratie
Klik op de optie Snelstart en klik vervolgens op Start met de API.
API-instelling¶
Nadat je op Start using the API hebt geklikt, gaat de pagina naar de API-instelling. Nu het testnummer is aangemaakt, kan er een testbericht worden verzonden om te bevestigen dat WhatsApp goed werkt. Ga naar het gedeelte Send and receive messages. Onder Step 1 Select phone numbers klik je op het vervolgkeuzemenu naast To.
Selecteer vervolgens de enige beschikbare optie: Manage phone number list. Volg de stappen en voeg maximaal vijf telefoonnummers toe om de gratis testberichten naar te verzenden. Voer de juiste landcode en het telefoonnummer in en klik vervolgens op Next.
Belangrijk
Het toevoegen van een telefoonnummer om naar te verzenden in deze stap zorgt ervoor dat er een geslaagde test via de terminal kan worden verzonden. Dit is essentieel om te zorgen dat de WhatsApp API werkt.
Voer op de volgende pagina de verificatiecode in die naar de telefoonnummers is verzonden en klik op Next om de nummers te verifiëren.
Stuur een testbericht via terminal¶
Zodra het telefoonnummer is geverifieerd, verstuur je een testbericht via de terminal. Klik onder Step 2 Send messages with the API op Send Message. Dit zou een testbericht moeten verzenden naar de telefoonnummers die zijn toegevoegd.
Na het succesvol ontvangen van het bericht op de nummers, ga je verder naar het volgende gedeelte om produce and configure webhooks.
WhatsApp-configuratie in Odoo¶
Om een Callback URL en Webhook Verify Token aan te maken, moeten het telefoonnummer, token, app-ID en rekening-ID in Odoo worden geconfigureerd; deze waarden worden gebruikt om webhooks in te stellen, waardoor het mogelijk wordt om berichten in de database te ontvangen. De configuratiestappen in dit gedeelte worden allemaal in de Odoo-database uitgevoerd.
Navigeer in Odoo naar en klik op Nieuw om het WhatsApp-bedrijfsaccount te configureren in Odoo.
Navigeer in een ander browsertabblad naar Meta Developer Dashboard. Selecteer en kopieer de volgende waarden uit de Meta-ontwikkelaarsconsole 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-geheim op te halen, ga je naar het Meta Developer Dashboard en selecteer je de Odoo-app. Selecteer in het menu aan de linkerkant onder App-instellingen de optie Basis.
Klik vervolgens op Tonen naast App-geheim en voer het accountwachtwoord in. Kopieer het App-geheim en plak het in het veld App-geheim op het Odoo-configuratiedashboard voor WhatsApp-bedrijfsaccount.
Klik op Verbinding testen om de installatie van het WhatsApp-bedrijfsaccount in Odoo te voltooien. Als de configuratie correct is ingesteld, verschijnt er een succesbericht in groen in de rechterbovenhoek van het dashboard.
Webhooks configureren¶
Om de webhooks voor de Odoo WhatsApp-app te configureren, ga je naar het Meta Developer Dashboard en selecteer je de Odoo-app. In het menu aan de linkerkant klik je op . Ga naar Step 3: Configure webhooks to receive messages en klik op Configure webhooks.
Tip
Webhookconfiguratie-instellingen zijn ook toegankelijk door naar het Meta Developer Dashboard te gaan, de Odoo-app te selecteren en vervolgens Webhooks te selecteren in het linkermenu.
Klik op de pagina op Bewerken. Hier worden de waarden Callback-URL en Webhook-verificatietoken uit Odoo toegevoegd.
Notitie
De waarden Callback-URL en Webhook-verificatietoken worden beide automatisch ingevuld nadat je in de vorige stap op Verbinding testen hebt geklikt.
Haal in een apart browservenster de benodigde waarden op in Odoo door naar te gaan en vervolgens het account te selecteren dat wordt geconfigureerd. De waarden bevinden zich onder Berichten ontvangen.
Kopieer en plak de Callback-URL uit Odoo in het veld Callback-URL in Meta en kopieer en plak vervolgens het Webhook-verificatietoken in het veld Verificatietoken op de Meta-ontwikkelaarsconsole. Klik op Verifiëren en opslaan.
Webhookvelden toevoegen¶
Nu de Odoo-database en WhatsApp zijn geconfigureerd om met elkaar te communiceren, is de volgende stap het toevoegen van webhookvelden om de informatie te specificeren die tussen beide moet worden verzonden. Om individuele webhookvelden toe te voegen in de ontwikkelaarsconsole van Meta, ga je naar de sectie Webhookvelden en klik je op Beheren. Vink in het pop-upvenster dat wordt geladen de vakjes aan in de kolom Abonneren voor de volgende veldnamen:
account_update
message_template_quality_update
message_template_status_update
messages
template_category_update
Klik na het maken van de selecties op Done.
Als de configuratie van Webhooks succesvol is, veranderen de knoppen in de kolom Abonneren van Abonneren naar Afmelden:
Belangrijk
Webhookvelden verschijnen pas wanneer het abonnement is bevestigd met de Callback-URL en het Webhook-verificatietoken.
Voeg een telefoonnummer toe¶
Om het zakelijke telefoonnummer te configureren dat voor WhatsApp in Odoo wordt gebruikt, ga je terug naar het Meta Developer Dashboard en selecteer je de Odoo-app. Onder WhatsApp in het menu aan de linkerkant klik je op API setup. Ga naar Step 5: Add a phone number en klik op Add phone number.
Voer een Bedrijfsnaam en Bedrijfswebsite of profielpagina in.
Tip
Het veld Bedrijfswebsite of profielpagina kan een link naar een social media-pagina zijn.
Selecteer het land waarin het bedrijf actief is in het vervolgkeuzemenu Land; een bedrijfsadres is optioneel. Klik na het toevoegen van de bedrijfslocatie op Volgende.
Vul op de volgende pagina de volgende :guilabel:`WhatsApp Business-profiel`gegevens in:
WhatsApp bedrijfsprofiel weergavenaam
Tijdzone
categorie
Bedrijfsomschrijving (optioneel)
Zodra deze secties compleet zijn, klik je op Volgende. De pagina wordt ververst en vraagt de beheerder vervolgens om Een telefoonnummer voor WhatsApp toe te voegen in het betreffende veld. Voer het zakelijke telefoonnummer in dat met WhatsApp gebruikt wordt.
Selecteer Sms-bericht of Oproep als verificatiemethode voor het telefoonnummer en klik vervolgens op Volgende om door te gaan.
Het zakelijke telefoonnummer ontvangt een WhatsApp-code via de gekozen verificatiemethode. Voer de verificatiecode in het veld Verificatiecode in en klik op Volgende om het zakelijke telefoonnummer te verifiëren.
Waarschuwing
Een betaalmethode moet worden toegevoegd om door te gaan. Dit maakt deel uit van Meta’s fraudedetectiesysteem. Om ervoor te zorgen dat de rekening/het bedrijf echt is, is een betaalmethode vereist om door te gaan. Zie Meta’s documentatie over hoe je een betaalmethode toevoegt in Meta Business Suite.
Maak een permanente token aan¶
Na voltooiing van de configuratie en het testen, maak je een permanente token aan om de Tijdelijke token te vervangen.
Ga naar Meta Business Suite en ga vervolgens naar . Selecteer een bestaande systeemgebruiker of maak een nieuwe systeemgebruiker aan door op Toevoegen te klikken.
Om een permanente token te genereren, moeten activa aan de systeemgebruiker worden toegevoegd. Klik op Activa toevoegen, en er verschijnt een pop-upvenster. Selecteer Apps onder Selecteer activatype, selecteer vervolgens de Odoo-app en zet de machtigingen op Aan onder de optie Volledige controle, en klik vervolgens op Wijzigingen opslaan. Klik op Voltooid in het bevestigingsvenster dat verschijnt.
Klik op Nieuwe token genereren, en er verschijnt een pop-upvenster met de vraag voor welke app deze token moet worden gegenereerd. Selecteer de Odoo-app en stel vervolgens de vervaldatum in op 60 dagen of Nooit.
Meta vraagt welke rechten de systeemgebruiker toestaat. Voeg beide volgende rechten toe:
business_managementwhatsapp_business_messagingwhatsapp_business_managementwhatsapp_business_manage_events
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¶
Ten slotte moet de Meta-app om de app te lanceren op Live worden gezet in het Meta Developer Dashboard. Klik op de app die wordt geconfigureerd en zet vervolgens het veld App-modus om van Ontwikkeling naar Live.
Belangrijk
Als de app-status niet op live is ingesteld, kan de database alleen contact opnemen met de testnummers die in de ontwikkelaarsconsole zijn opgegeven.
Waarschuwing
Er moet een privacy policy-URL worden ingesteld om de app op live te kunnen zetten. Ga naar het Meta Developer Dashboard en selecteer de Odoo-app. Ga vervolgens in het menu aan de linkerkant naar . Voer het hyperlinkadres van het privacybeleid in onder het veld Privacy Policy-URL van het formulier. Klik op Wijzigingen opslaan om het privacybeleid op de app toe te passen.
Zodra de app live is gegaan in de Meta ontwikkelaarsconsole, wordt er een bevestigingsmail naar de beheerder gestuurd.
WhatsApp-sjablonen¶
WhatsApp-sjablonen stellen gebruikers in staat om berichten op te slaan die vaak worden verzonden. Door sjablonen te maken die zijn afgestemd op specifieke situaties, kunnen gebruikers vooraf goedgekeurde berichten verzenden zonder in te leveren op kwaliteit of steeds dezelfde tekst te hoeven opstellen. Dit zorgt voor een snelle afhandeling en consistente klantenserviceberichten, en verhoogt het totale betrokkenheidspercentage bij de klant.
WhatsApp-sjablonen kunnen worden aangemaakt op zowel de Odoo- als Meta-consoles.
Belangrijk
WhatsApp heeft een goedkeuringsproces dat verplicht vooraf moet worden voltooid voordat het sjabloon kan worden gebruikt. Zie Goedkeuring meta-sjabloon.
Om WhatsApp-sjablonen te openen, ga naar het dashboard .
Elk sjabloon heeft drie tabbladen:
Hoofdtekst: bevat de berichttekst. De berichttekst kan plaatshouders bevatten voor dynamische inhoud die wordt ingevuld wanneer het bericht wordt verzonden.
Knoppen: voegt aanklikbare knoppen/hyperlinks toe onderaan het WhatsApp-sjabloon. Momenteel zijn er drie knoptypes: Snel antwoord, Website bezoeken en Nummer bellen. Website bezoeken ondersteunt statische, dynamische en getraceerde URL’s.
Variabelen: toont alle plaatshouders in het sjabloon, evenals de variabelen die moeten worden ingevuld. Berichten kunnen bijvoorbeeld plaatshouders bevatten voor de naam van een ontvanger, gekochte producten of een verkoopordernummer.
Maak WhatsApp-sjablonen in Odoo¶
Om een WhatsApp-sjabloon te maken, ga naar het dashboard en klik op Nieuw. Voer een Naam in voor het sjabloon en selecteer een Taal.
Belangrijk
Om deze volgende taak te voltooien, zijn beheerderstoegangsrechten nodig om het veld Geldt voor te bewerken.
Selecteer in het vervolgkeuzemenu Rekening de WhatsApp-zakelijke rekening in Odoo waarmee dit sjabloon gekoppeld moet worden. Selecteer vervolgens onder het veld Toepassen op het model waarop de serveractie dit sjabloon moet toepassen.
Tip
Deze modellen zijn ook toegankelijk in ontwikkelaarsmodus. In een contactformulier (of vergelijkbaar relevant formulier in Odoo) ga je naar het model waarnaar moet worden verwezen en beweeg je de muis over een veldnaam. Dit toont backend-informatie, inclusief de specifieke Odoo Model-naam in de backend. Zoek naar de frontend-naam van het model in het WhatsApp-sjabloon, onder het vervolgkeuzemenu Applies to.
Waarschuwing
Het Telefoonveld kan een fout genereren bij het wijzigen van het model of het veld Toepassen op. Het Telefoonveld moet altijd worden ingesteld op het model Telefoon of Mobiel.
Om beschikbare velden te doorzoeken, typ je de frontend-naam in het vak Search…. Dit toont resultaten van alle beschikbare velden voor het model (Applies to) waarvoor het sjabloon is gemaakt.
Notitie
Om specifieke velden te vinden, moet je mogelijk door meerdere niveaus navigeren in het zoekresultatenvenster. Gebruik de (rechter pijltje) en (linker pijl)-iconen om tussen de menuniveaus te navigeren.
Wijzig de Categorie in een van de volgende:
Marketing: Promoties of informatie over het bedrijf, producten of diensten. Of elk bericht dat niet voor nut of authenticatie is.
Nuttig: Berichten over een specifieke transactie, rekening, order of klantverzoek.
Authenticatie: Eenmalige wachtwoorden die klanten gebruiken om een transactie te authenticeren of in te loggen.
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.
Wanneer alle benodigde wijzigingen aan het sjabloon zijn aangebracht, klik op de knop Ter goedkeuring indienen in de linkerbovenhoek en de status van het sjabloon wijzigt naar In afwachting.
De status blijft In afwachting totdat Meta een beslissing heeft genomen, waarna een bevestigingsmail wordt verzonden die aangeeft dat het sjabloon is goedgekeurd of afgewezen. Synchroniseer vervolgens de sjablonen vanuit de Odoo-database.
Zie ook
Tip
Vooraf geconfigureerde demodata-sjablonen zijn beschikbaar in Odoo om te gebruiken of te wijzigen. Deze sjablonen kunnen worden gebruikt zoals ze zijn of worden aangepast aan een specifieke zakelijke behoefte.
Om deze sjablonen te gebruiken, ga je naar en selecteer je een vooraf geconfigureerd sjabloon. Klik op Submit for Approval om het goedkeuringsproces te starten. Er wordt een e-mail verzonden naar de beheerder van het Meta-account wanneer het sjabloon is goedgekeurd.
Plaatshouders en variabelen¶
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
Deze plaatshouders moeten worden geconfigureerd op het tabblad Variabelen van het sjabloon voordat je het ter goedkeuring aan Meta indient. Om de dynamische variabelen op een sjabloon te bewerken, wijzig je eerst het Type naar Veld van model. Hierdoor kan Odoo een veld binnen een model raadplegen om unieke gegevens te genereren in het te verzenden bericht.
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 frontendnaam van het veld in het zoekvak. Dit vindt een resultaat uit alle beschikbare velden voor het model (Toepassen op) waarvoor het sjabloon is gemaakt. Er kunnen meerdere niveaus zijn die moeten worden geconfigureerd.
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¶
Nadat je de dynamische variabelen op het sjabloon hebt bijgewerkt, moet het sjabloon opnieuw worden ingediend bij Meta voor goedkeuring. Klik op Ter goedkeuring indienen om het goedkeuringsproces te starten. Er wordt een e-mail verzonden naar de beheerder van de Meta-rekening wanneer het sjabloon is goedgekeurd.
Na de goedkeuring van Meta synchroniseer je de sjablonen opnieuw in de Odoo-database. Zie deze documentatie: Sjablonen synchroniseren.
Tip
Om de status te zien, ga naar Meta Business Suite en selecteer .
Sjablonen synchroniseren¶
Sjablonen moeten worden gesynchroniseerd met de Odoo-database zodra ze zijn goedgekeurd door het Meta-team. Navigeer hiervoor naar en selecteer de configuratie die moet worden gesynchroniseerd. Klik onder de sectie , onderaan, op Sjablonen synchroniseren. Meta werkt de goedgekeurde sjablonen bij 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 het sjabloon zelf. Navigeer naar het -dashboard en selecteer het te synchroniseren sjabloon. Klik vervolgens op de knop Sjabloon synchroniseren in het bovenste menu van het sjabloonformulier.
Maak WhatsApp-sjablonen aan in Meta¶
Navigeer eerst naar Meta Business Suite en ga vervolgens naar .
Klik op de blauwe knop Sjabloon maken om een WhatsApp-sjabloon te maken en selecteer vervolgens de Categorie uit een van de volgende opties:
Marketing: Promoties of informatie over het bedrijf, producten of diensten. Of elk bericht dat niet voor nut of authenticatie is.
Nuttig: Berichten over een specifieke transactie, rekening, order of klantverzoek.
Authenticatie: Eenmalige wachtwoorden die klanten gebruiken om een transactie te authenticeren of in te loggen.
Voer de Naam van de sjabloon in en selecteer dan de Taal voor de sjabloon.
Notitie
Meerdere talen kunnen worden geselecteerd door de taalnamen te typen en vervolgens de andere talen te selecteren indien nodig.
Klik na het maken van de juiste selecties op Doorgaan in de rechterbovenhoek. De browser leidt door naar de pagina Sjabloon bewerken, waar de Header, Hoofdtekst, Voettekst en Knoppen worden geconfigureerd. Rechts van het sjabloon staat een voorbeeld van hoe het sjabloon eruitziet in productie.
Klik op de knop Verzenden in de rechterbovenhoek wanneer alle benodigde wijzigingen aan het sjabloon zijn aangebracht. Er verschijnt een venster om de taal te bevestigen. Klik op Bevestigen om goed te keuren. Vervolgens verschijnt een ander venster met de melding dat het sjabloon is ingediend bij Meta voor beoordeling en goedkeuring.
De Status van het sjabloon blijft Wordt beoordeeld totdat Meta een beslissing heeft genomen. Zodra een e-mailbevestiging is ontvangen waarin het sjabloon wordt goedgekeurd, moeten de sjablonen worden gesynchroniseerd vanuit de Odoo-database.
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.
Meldingsinstellingen kun je aanpassen door te navigeren naar . Selecteer daar de rekening en scroll naar beneden naar de sectie waar meldingen worden afgehandeld. Typ onder de kop Gebruikers op de hoogte stellen in het veld welke gebruikers op de hoogte moeten worden gesteld voor dit specifieke WhatsApp-kanaal.
Notitie
Nadat een gesprek tussen een gebruiker en een klant is gestart, worden meldingen aan alle gebruikers die zijn opgegeven in de WhatsApp-zakelijke rekeningconfiguratie niet meer verstuurd. Alleen meldingen aan de gebruikers in het gesprek worden verstuurd. Als de gebruiker niet binnen 15 dagen reageert, wordt het antwoord van de klant na de 15 dagen opnieuw aan alle gebruikers in de WhatsApp-configuratie getoond.
Voeg gebruikers toe aan een chat¶
Gebruikers kunnen worden toegevoegd aan een WhatsApp-chat door het WhatsApp-pop-upvenster uit te vouwen. WhatsApp-gesprekken bevinden zich in de Chat-app. Selecteer een gesprek en klik op het icoon (Gebruiker toevoegen) rechtsboven. Er verschijnt een venster om gebruikers uit te nodigen voor het gesprek.
WhatsApp API FAQ¶
Verificatie¶
Vanaf 1 februari 2023 moet mogelijk een volledige bedrijfsverificatie worden voltooid als de Meta-app geavanceerde toegang tot machtigingen vereist. Dit omvat het indienen van zakelijke documenten bij Meta. Zie deze documentatie.
Kan geen berichten ontvangen¶
Als de zakelijke rekening geen berichten kan ontvangen, controleer dan alle webhookconfiguraties. Navigeer naar , of klik hier. Log indien nodig in op de zakelijke rekening. Klik onder de sectie Request Syntax op Try it en vul de volgende velden in:
autorisatie: voer het permanente toegangstoken in.
WABA-ID: voer het WhatsApp Business Account ID (WABA ID) in.
override_callback_uri: voer de callback-URL in.
verify_token: voer de verificatiecode in.
Om het WABA ID op te halen, navigeer je naar in het linkermenu van het Meta Developer Dashboard. Het WABA ID staat in de sectie Send and receive messages, onder Step 1: Select phone numbers. Zodra alle velden zijn ingevuld, klik je op Send request.
Sjabloon fouten¶
Het bewerken van sjablonen kan tracebacks en fouten veroorzaken, tenzij het exacte proces wordt gevolgd.
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. Odoo toont Validation Error: The operation cannot be completed: Duplicate template is not allowed for one Meta account. Om dit probleem op te lossen, hernoem je de dubbele sjabloonnaam in Odoo en synchroniseer je de sjablonen opnieuw.
Token fouten¶
Gebruikersfout 190¶
Als het tijdelijke token niet wordt vervangen door een permanent token, toont Odoo Gebruikersfout 190: Fout bij valideren van toegangstoken: Sessie is verlopen. Om dit probleem op te lossen, voeg je een permanent token toe.
Gebruikersfout 100¶
Als een Werknemer probeert het permanente token in te stellen, toont Odoo User Error 100: Unsupported get request.
Om deze fout te corrigeren, maak je een beheerdersysteemgebruiker aan.
Overige¶
Sjabloon kan niet naar meerdere contacten worden verzonden¶
Zorg ervoor dat de functie Multi-Sjabloon is ingeschakeld op het sjabloon.
Bericht kon niet worden verzonden¶
Schakel de kolommen Faaltype en Faalreden in onder WhatsApp —> Berichten.
Andere foutcodes¶
Voor andere fouten, zie Meta’s Developer Suite voor WhatsApp Error Codes.