Gmail verbinden met Odoo met Google OAuth

Odoo is compatibel met Google’s OAuth voor Gmail. Om beveiligde e-mails te versturen vanaf een eigen domein, hoef je alleen maar een paar instellingen te configureren op het Workspace platform van Google en op de back-end van de Odoo database. Deze configuratie werkt door gebruik te maken van een persoonlijk e-mailadres of een adres dat is aangemaakt door een aangepast domein.

Tip

Ga voor meer informatie naar Google’s documentatie over het instellen van OAuth.

Zie ook

• /applicaties/algemeen/gebruikers/google

• Google Calendar synchronization

Opzet in Google

Maak een nieuw project aan

Om te beginnen ga je naar de Google API Console. Log in met je Google Workspace account als je die hebt, anders log je in met je persoonlijke Gmail account (dit moet overeenkomen met het e-mailadres dat je in Odoo wilt configureren).

Klik daarna op Project maken, helemaal rechts van het Overeenkomst toestemmingsscherm. Als er al een project is aangemaakt in dit account, dan staat de optie Nieuw project rechtsboven onder het keuzemenu Selecteer een project.

In het New Project scherm hernoem je de Projectnaam naar Odoo en blader je naar de Location. Stel het Location in als de Google Workspace organisatie. Als je een persoonlijk Gmail-account gebruikt, laat de Location dan staan op No Organization.

Klik op Create om deze stap te voltooien.

OAuth-toestemmingsscherm

Als de pagina niet doorverwijst naar de User Type opties, klik dan op OAuth consent screen in het linkermenu.

Selecteer onder User Type opties het juiste User Type en klik dan nogmaals op Create, waardoor je uiteindelijk op de Edit app registration pagina terecht komt.

Waarschuwing

Persoonlijke Gmail accounts mogen alleen een Externe gebruikerstype zijn, wat betekent dat Google mogelijk een goedkeuring nodig heeft of dat Scopes moeten worden toegevoegd. Als je echter een Google WorkSpace account gebruikt, kan je een Interne gebruikerstype gebruiken.

Merk ook op dat wanneer de API verbinding in de Externe testmodus staat, er geen goedkeuring nodig is van Google. De gebruikerslimiet in testmodus is ingesteld op 100 gebruikers.

App-registratie bewerken

Vervolgens gaan we de app-registratie van het project configureren.

Voer in de OAuthenticatie scherm stap, onder de App informatie sectie, Odoo in het App naam veld in. Selecteer het e-mailadres van de organisatie in het User support e-mailveld.

Klik vervolgens onder App Domain ‣ Authorized domains op Add Domain en voer odoo.com in.

Voer daarna onder het Contactinformatie ontwikkelaar het e-mailadres van de organisatie in. Google gebruikt dit e-mailadres om de organisatie op de hoogte te stellen van wijzigingen in je project.

Klik vervolgens op de knop Opslaan en doorgaan. Sla vervolgens de Scopes pagina over door naar beneden te scrollen en op Save and Continue te klikken.

Als je doorgaat in de testmodus (Extern), voeg dan de e-mailadressen toe die zijn geconfigureerd onder de Testgebruikers stap, door te klikken op Voeg gebruikers toe en vervolgens op de Opslaan en doorgaan knop. Er verschijnt een samenvatting van de app-registratie.

Scroll tenslotte naar beneden en klik op Terug naar Dashboard om het instellen van het project te voltooien.

Credentials aanmaken

Nu het project is ingesteld, moeten er referenties worden aangemaakt, waaronder de Client ID en Client Secret. Klik eerst op Credentials in het linker zijbalkmenu.

Klik dan op Create Credentials in het bovenste menu en selecteer OAuth client ID uit het dropdown menu.

• Selecteer onder Applicatietype Webtoepassing uit het vervolgkeuzemenu.

• Voer in het veld Naam Odoo in.

• Klik onder het Authorized redirect URIs label op de knop ADD URI en voer vervolgens https://yourdbname.odoo.com/google_gmail/confirm in het URIs 1 veld in. Zorg ervoor dat je het gedeelte yourdbname van de URL vervangt door de echte Odoo databasenaam.

• Klik vervolgens op Create om een OAuth Client ID en Client Secret te genereren. Kopieer tot slot elke gegenereerde waarde voor later gebruik bij het configureren in Odoo en navigeer vervolgens naar de Odoo database.

Opzetten in Odoo

Google-inloggegevens invoeren

Open eerst Odoo en navigeer naar de module Apps. Verwijder vervolgens het Apps filter uit de zoekbalk en typ Google in. Installeer de module Google Gmail.

Navigeer vervolgens naar Instellingen ‣ Algemene instellingen en controleer onder het Discussie gedeelte of het selectievakje voor Aangepaste e-mailservers of Externe e-mailservers is aangevinkt. Hierdoor verschijnt een nieuwe optie voor Gmail Credentials of Use a Gmail Sever. Kopieer en plak vervolgens de respectievelijke waarden in de velden Client ID en Client Secret en Save de instellingen.

Uitgaande e-mailserver configureren

Om het externe Gmail-account te configureren, ga je terug naar het begin van de Custom Email Servers instelling en klik je op de Outgoing Email Servers link.

Klik vervolgens op New of Create om een nieuwe e-mailserver aan te maken en vul de Name, Description en de e-mail Username (indien nodig) in.

Klik vervolgens op Gmail OAuth Authentication of Gmail (onder het Authenticate with of Connection gedeelte). Klik ten slotte op Connect your Gmail Account.

Een nieuw venster met de naam Google wordt geopend om het autorisatieproces te voltooien. Selecteer het juiste e-mailadres dat in Odoo is geconfigureerd.

Als het e-mailadres een persoonlijk account is, dan verschijnt er een extra stap, dus klik op Doorgaan om de verificatie toe te staan en het Gmail-account te verbinden met Odoo.

Vervolgens geef je Odoo toegang tot het Google account door te klikken op Doorgaan of Toelaten. Daarna navigeert de pagina terug naar de nieuw geconfigureerde uitgaande e-mailserver in Odoo. De configuratie laadt automatisch het token in Odoo en een tag met de tekst Gmail Token Valid verschijnt in het groen.

Tot slot Test de verbinding. Er zou een bevestigingsbericht moeten verschijnen. De Odoo database kan nu veilige, beveiligde e-mails versturen via Google met behulp van OAuth authenticatie.

Google OAuth FAQ

Productie VS Testen Publicatiestatus

Door Productie te kiezen als Publicatiestatus (in plaats van Testen) wordt de volgende waarschuwing weergegeven:

Om deze waarschuwing te corrigeren, navigeer je naar het Google API Platform. Als de Publicatiestatus In productie is, klik dan op Terug naar testen om het probleem op te lossen.

Geen testgebruikers toegevoegd

Als er geen testgebruikers worden toegevoegd aan het OAuth toestemmingsscherm, dan verschijnt er een 403 toegang geweigerd foutmelding.

Om deze fout te herstellen, ga je terug naar het OAuth toestemmingsscherm onder APIs & Services en voeg je testgebruiker(s) toe aan de app. Voeg het e-mailadres toe dat je in Odoo configureert.

Gmail-module niet bijgewerkt

Als de Google Gmail module in Odoo niet is bijgewerkt naar de nieuwste versie, dan verschijnt er een Verboden foutmelding.

Om deze fout te herstellen, ga je naar de Apps module en wis je de zoektermen. Zoek vervolgens naar Gmail of Google en upgrade de Google Gmail module. Klik ten slotte op de drie puntjes rechtsboven de module en selecteer Upgrade.

Type toepassing

Bij het aanmaken van de referenties (OAuth Client ID en Client Secret), als Desktop App is geselecteerd voor het Application Type, verschijnt er een Authorization Error.

Om deze fout te herstellen, verwijder je de reeds aangemaakte referenties en maak je nieuwe aan, waarbij je Web Application selecteert voor de Application Type. Klik vervolgens onder Authorized redirect URIs op ADD URI en typ: https://yourdbname.odoo.com/google_gmail/confirm in het veld en zorg ervoor dat je yourdbname in de URL vervangt door de Odoo databasenaam.