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
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.
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:
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.
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.
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 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.
paginaKlik 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.
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.
Klik op de Edit, waar zowel de Callback URL als de Webhook Verify Token waarden uit Odoo worden toegevoegd.
pagina opNotitie
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:
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 . 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 .
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 Nieuw. Voer op het formulier een Naam in voor de sjabloon en selecteer een Taal.
en klik je opBelangrijk
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.
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.
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 Synchroniseer sjablonen. Meta werkt de sjablonen bij die zijn goedgekeurd zodat ze kunnen worden gebruikt met verschillende apps in de database.
en selecteer je de configuratie die moet worden gesynchroniseerd. Klik onder het gedeelte opEen 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 Synchroniseer sjabloon knop in het bovenste menu van het sjabloonformulier.
dashboard en selecteer de sjabloon die je wilt synchroniseren. Klik vervolgens op deSjablonen maken in Meta¶
Navigeer eerst naar Meta’s WhatsApp template dashboard en ga dan naar .
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.
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.
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 -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.
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.