In het kort: komt een e-mail uit Odoo niet aan, controleer dan eerst of Odoo een fout meldt. Stel daarna vast welke mailroute u gebruikt: de server van Odoo of een externe server. Op uw eigen domein moeten SPF, DKIM en DMARC kloppen, en het afzenderadres moet passen bij uw uitgaande mailserver. In dit artikel leest u in welke volgorde u dit controleert, voor Odoo 19.

Een klant zegt dat de factuur nooit is aangekomen. Odoo laat zien dat hij is verstuurd. Wie heeft gelijk? Dat kunnen ze allebei hebben, en daarom komt deze vraag zo vaak voor bij onze helpdesk. Een e-mail versturen en een e-mail bezorgen zijn twee verschillende dingen, en daartussen zitten meerdere partijen.
Dit artikel gaat over het vinden van de oorzaak. Wilt u dat antwoorden bij een team terechtkomen in plaats van bij één persoon, lees dan Centraal mailen vanuit Odoo.
Begin met wat u weet
De documentatie van Odoo zegt duidelijk dat Odoo geen volwaardige e-mailprovider is. Zodra een melding of transactionele e-mail met succes is verstuurd, wordt het e-mailobject verwijderd. De inhoud blijft staan in de chatter van het record. Een bericht in de chatter bewijst dus dat het is geschreven, niet dat het in een inbox is beland.
In de praktijk zijn er drie situaties:
- Odoo meldt een fout. U kunt de reden in Odoo lezen. Dit is het eenvoudigste geval.
- De e-mail wacht nog. Hij staat in de wachtrij en is nog niet vertrokken.
- Odoo meldt niets, maar de ontvanger heeft niets. De e-mail is mogelijk later geweigerd of gefilterd. Odoo kan niet altijd vaststellen waarom, omdat mailproviders hun eigen beleid hanteren.
Waar u kijkt in Odoo
- De rode envelop in de chatter. Dit pictogram betekent dat verzending voor minstens één ontvanger is mislukt. Klik erop voor de details. Waar beschikbaar toont See Error Details meer informatie.
- De e-mailwachtrij. Activeer de ontwikkelaarsmodus en ga naar Instellingen ‣ Technisch ‣ E-mail: E-mails (Settings ‣ Technical ‣ Email: Emails). Mislukte e-mails hebben de status Delivery Failed. Van hieruit kunt u een e-mail opnieuw proberen, direct versturen of annuleren.
- De logbestanden. Op Odoo.sh kunt u ook de logbestanden nakijken op verzendpogingen en herhaalde fouten.
Let op: verstuurde e-mails worden periodiek uit de wachtrij verwijderd door de geplande actie Auto-Vacuum. Een lege wachtrij zegt dus weinig over wat er vorige week is gebeurd.
Welke mailroute gebruikt u?
De juiste oplossing hangt af van de route die uw e-mail aflegt:
- De server van Odoo met een Odoo-subdomein. Standaard versturen Odoo Online en Odoo.sh vanaf een adres als notifications@uwdatabase.odoo.com. SPF, DKIM en DMARC zijn voor deze subdomeinen al ingesteld.
- De server van Odoo met uw eigen domein. U verstuurt vanaf uw eigen adres via Odoo. Dan moet u DNS-records toevoegen voor uw domein.
- Een externe mailserver. U verstuurt via uw eigen provider. De DNS-instructies van Odoo gelden dan niet: volg de instructies van die provider voor SPF, DKIM en DMARC.
SPF, DKIM en DMARC in gewone taal
Deze drie records vertellen ontvangende mailservers of uw e-mail echt is. U voegt ze toe bij uw DNS-provider, niet in Odoo. De voorbeelden hieronder gelden voor verzenden vanaf uw eigen domein via de server van Odoo.
SPF: wie mag versturen
SPF is een TXT-record met de servers die namens uw domein mogen versturen. De test loopt op het bounce-adres, dat afhangt van het veld Alias Domain in de algemene instellingen. Heeft u geen SPF-record, maak dan dit record aan: v=spf1 include:_spf.odoo.com ~all
Heeft u al een SPF-record, bijvoorbeeld voor uw kantoormail? Voeg daar dan include:_spf.odoo.com aan toe. Maak geen tweede record aan, want dat is een klassieke fout.
DKIM: een handtekening op het bericht
DKIM bewijst dat een bericht echt namens uw domein is verstuurd en onderweg niet is gewijzigd. Volgens Odoo is dit verplicht als u vanaf uw eigen domein via de server van Odoo verstuurt. Voeg een CNAME-record toe met de naam odoo._domainkey dat verwijst naar odoo._domainkey.odoo.com.
DMARC: wat er gebeurt als controles mislukken
DMARC verbindt SPF en DKIM en vertelt de ontvangende server wat er moet gebeuren met mail die niet door de controle komt. Het beleid p=none verzamelt alleen rapporten. De beleidsregels p=quarantine en p=reject grijpen wel in, dus stap daar pas op over als uw rapporten er schoon uitzien. Een startpunt is een TXT-record met de naam _dmarc en de waarde v=DMARC1; p=none; rua=mailto:postmaster@example.com, met uw eigen rapportadres.
Slagen voor DMARC garandeert geen bezorging, want spamfilters kijken naar meer dan deze records. Voor het bredere plaatje, inclusief DNSSEC en versleuteling, leest u Een score van 100% op internet.nl.
Het afzenderadres en de uitgaande mailserver
Veel problemen ontstaan doordat het afzenderadres niet bij de server past. Wilt u uw eigen server gebruiken, ga dan naar Instellingen, schakel in het onderdeel E-mails Use Custom Email Servers in en sla op. Open daarna Outgoing Email Servers, klik op Nieuw, vul de gegevens van uw provider in en klik op Test Connection. Een geslaagde test garandeert geen bezorging, want de provider kan aanvullende beperkingen opleggen.
Stel vervolgens het FROM-filter in volgens de instructies van uw provider. Odoo kiest een server in deze volgorde:
- Een server waarvan het FROM-filter overeenkomt met het volledige afzenderadres of domein.
- Anders de eerste server zonder FROM-filter, waarbij de afzender wordt vervangen door het notificatieadres.
- Anders de eerste server, ook met die vervanging.
Ziet een ontvanger dus ineens een notificatieadres als afzender, dan is het filter een waarschijnlijke oorzaak. Controleer nog drie dingen:
- Poort. Op Odoo Online en Odoo.sh is poort 25 geblokkeerd. Gebruik 465, 587 of 2525.
- Geverifieerde afzender. Providers accepteren soms alleen adressen die ze kennen. Een 550-fout die meldt dat het afzenderadres niet overeenkomt met een geverifieerde identiteit, betekent dat u het adres moet aanpassen of door uw provider moet laten goedkeuren.
- Het adres van de beheerder. Het standaard beheerdersaccount heeft een tijdelijk e-mailadres. Odoo raadt aan dit te vervangen om problemen met uitgaande e-mail te voorkomen.
Andere veelvoorkomende oorzaken
- De daglimiet. De documentatie noemt een standaardlimiet tussen 5 en 200 e-mails per dag, afhankelijk van uw abonnement, uw geïnstalleerde apps en of er een migratie loopt. Ook interne meldingen per e-mail tellen mee. Als collega's meldingen in Odoo ontvangen, vermindert u dit.
- Timing. De wachtrij wordt verwerkt door een geplande actie. Standaard draait die elke 60 minuten, dus een e-mail in de wachtrij is misschien gewoon nog niet vertrokken.
- Ongeldige adressen. Ruim adressen op die terugkomen. Odoo geeft aan dat verzenden naar ongeldige adressen of spam de reputatie van de verzendende server kan schaden.
- Eén klant of domein. Doet het probleem zich alleen bij één ontvanger voor, vraag dan of die zijn spamfilter wil controleren. Bij terugkerende problemen met één domein kunt u Odoo Support raadplegen.
Een test die u vandaag kunt doen
- Kies één e-mail die niet is aangekomen en zoek die op in de chatter.
- Controleer in de wachtrij de status en een eventuele foutmelding.
- Noteer welk afzenderadres is gebruikt en stel de mailroute vast.
- Controleer SPF en DKIM met een hulpmiddel als MXToolbox, dat ook in de documentatie van Odoo wordt genoemd.
- Stuur een testmail naar Mail-Tester om de volledige inrichting te controleren.
- Wijzig één ding tegelijk en test daarna opnieuw.
Wat dit voor u betekent
DNS-wijzigingen vallen buiten Odoo, dus zorg dat u weet wie uw domein beheert voordat u begint. Is dat een externe partij, stuur die dan de exacte records. Plan het werk ook op een rustig moment, en wijzig een bestaand SPF- of DMARC-record niet zonder te controleren welke andere diensten vanaf uw domein mailen. Uw kantoormail en marketingtools moeten blijven werken.
Veelgestelde vragen
Waar zie ik in Odoo welke e-mails zijn mislukt?
In de chatter ziet u een rood enveloppictogram bij een bericht dat voor minstens één ontvanger is mislukt. In de ontwikkelaarsmodus vindt u de wachtrij onder Instellingen, Technisch, E-mail: E-mails. Mislukte e-mails hebben daar de status Delivery Failed.
Moet ik SPF en DKIM instellen als ik mail via Odoo verstuur?
Op het standaard Odoo-subdomein is dat al geregeld. Verstuurt u vanaf uw eigen domein via de mailserver van Odoo, dan zijn SPF en DKIM nodig. Gebruikt u een externe mailserver, dan volgt u de instructies van die provider.
Is de e-mail aangekomen als er geen fout in Odoo staat?
Niet per se. Odoo kan niet altijd vaststellen waarom een bezorging mislukt, omdat mailproviders hun eigen beleid voor foutmeldingen hebben. Volgens de documentatie is een verkeerde SPF- of DKIM-instelling een van de meest voorkomende oorzaken van mislukkingen zonder foutmelding.
Tot slot
Betrouwbaar e-mailen begint bij weten welke route uw berichten nemen. Wilt u dat wij samen met u uw domeininstellingen en uitgaande mail controleren? Neem contact op met DAADit Group, Odoo Silver Partner in Eindhoven, of begin met de gratis Business Scan.