Mailjet API¶
Odoo is compatibel met Mailjets API voor massamailings. Zet een speciale massamailingserver op via Mailjet door instellingen te configureren in de Mailjet account en de Odoo database. In sommige gevallen moeten de instellingen ook worden geconfigureerd op de DNS instellingen van het aangepaste domein.
Instellen in Mailjet¶
API-referenties aanmaken¶
Om te beginnen log je in op de Mailjet Account Informatie pagina. Navigeer vervolgens naar de Senders & Domeinen sectie en klik op SMTP en SEND API Instellingen.
Kopieer vervolgens de SMTP configuratie-instellingen naar een kladblok. Deze kun je vinden onder de Configuratie (alleen SMTP) sectie. De SMTP configuratie-instellingen bevatten het serveradres, de benodigde beveiligingsoptie (Gebruik SSL/TLS) en het poortnummer. De instellingen zijn nodig om Mailjet in Odoo te configureren, wat wordt behandeld in de laatste sectie.
Belangrijk
Odoo blocks port 25 on Odoo Online and Odoo.sh databases. See reference here.
Klik vervolgens op de knop Retrieve your API credentials om de Mailjet API credentials op te halen.
Klik vervolgens op het oogpictogram om de API key te onthullen. Kopieer deze sleutel naar een kladblok, want deze dient als de Gebruikersnaam in de Odoo-configuratie. Klik vervolgens op de knop Generate Secret Key om de Secret Key te genereren. Kopieer deze sleutel naar een kladblok, want deze dient als Password in de Odoo-configuratie.
Geverifieerd(e) afzenderadres(sen) toevoegen¶
De volgende stap is het toevoegen van een afzenderadres of domein aan de Mailjet account instellingen zodat het e-mailadres of domein wordt goedgekeurd om e-mails te versturen via de servers van Mailjet. Navigeer eerst naar de Mailjet Account Informatie pagina. Klik vervolgens op de Een afzenderdomein of -adres toevoegen link onder de Afzenders & Domeinen sectie.
Bepaal of het e-mailadres van een afzender of het hele domein moet worden toegevoegd aan de Mailjet instellingen. Het kan eenvoudiger zijn om het domein als geheel te configureren als DNS toegang beschikbaar is. Ga naar de Een domein toevoegen sectie voor stappen om het domein toe te voegen.
Notitie
Ofwel alle e-mailadressen van de Odoo database gebruikers die e-mails versturen via de Mailjet servers moeten worden geconfigureerd of de domein(en) van de e-mailadressen van de gebruikers kunnen worden geconfigureerd.
Standaard wordt het e-mailadres dat oorspronkelijk is ingesteld in de Mailjet account toegevoegd als vertrouwde afzender. Om een ander e-mailadres toe te voegen, klik je op de knop met het label Een afzenderadres toevoegen. Voeg vervolgens het e-mailadres toe dat is ingesteld om te verzenden vanaf het aangepaste domein.
Minimaal moeten de volgende e-mailadressen zijn ingesteld bij de provider en geverifieerd in Mailjet:
Notitie
Vervang je domein door het aangepaste domein voor de Odoo database. Als dat er niet is, gebruik dan de mail.catchall.domain systeemparameter.
Vul daarna het Email Informatie formulier in en zorg ervoor dat je het juiste e-mailtype selecteert: transactie e-mails of massa e-mails. Na het invullen van het formulier wordt er een activeringsmail naar het e-mailadres gestuurd en kan de vertrouwde afzender worden geactiveerd.
Het wordt aanbevolen om de SPF/DKIM/DMARC instellingen in te stellen op het domein van de verzender.
Belangrijk
Als de database geen aangepast domein gebruikt, dan moet om het adres van de afzender te verifiëren een tijdelijke alias (van de drie hierboven genoemde e-mailadressen) worden ingesteld in Odoo CRM om een lead aan te maken. Dan kan de database de verificatiemail ontvangen en de accounts verifiëren.
Een domein toevoegen¶
Door een heel domein aan het Mailjet account toe te voegen, worden alle afzenderadressen die aan dat domein gerelateerd zijn automatisch gevalideerd voor het verzenden van e-mails via Mailjet servers. Navigeer eerst naar de Mailjet Account Informatie pagina. Klik vervolgens op Een afzenderdomein of -adres toevoegen onder de Afzenders en domeinen sectie. Klik vervolgens op Domein toevoegen om het aangepaste domein toe te voegen.
Notitie
Het domein moet worden toegevoegd aan het Mailjet account en vervolgens worden gevalideerd via het DNS.
Vul daarna de Een nieuw domein toevoegen pagina op Mailjet in en klik op Doorgaan.
Nadat je het domein hebt toegevoegd, verschijnt er een validatiepagina. Tenzij de Odoo-database zich op locatie bevindt (kies in dat geval Optie 1), kies dan Optie 2: Maak een DNS-record aan. Kopieer de TXT record informatie naar een kladblok en navigeer dan naar de DNS provider van het domein om de validatie te voltooien.
Instellen in de DNS van het domein¶
Nadat je de TXT record informatie van het Mailjet account hebt gekregen, voeg je een TXT record toe aan het DNS domein. Dit proces verschilt per DNS provider. Raadpleeg de provider voor specifieke configuratieprocessen. De TXT record informatie bestaat uit de Host en Value. Plak deze in de corresponderende velden in het TXT-record.
Terug naar Mailjet account informatie¶
Nadat je het TXT-record hebt toegevoegd aan het DNS domein, navigeer je terug naar de Mailjet account. Navigeer vervolgens naar , klik op het tandwielpictogram naast Domain en selecteer Validate.
Deze actie kan ook gedaan worden door naar de Verzender domeinen & adressen pagina te gaan op de Mailjet account informatie en te klikken op Beheer.
Klik vervolgens op Check Now om het TXT-record dat is toegevoegd aan het domein te valideren. Er verschijnt een successcherm als het domein correct is geconfigureerd.
Nadat het domein met succes is ingesteld, is er een optie om Dit domein te authenticeren (SPF/DKIM). Deze knop vult SPF & DKIM provider.
Instellen in Odoo¶
Om de installatie te voltooien, navigeer je naar de Odoo database en ga je naar het Instellingen. Met Ontwikkelaarsmodus (debugmodus) ingeschakeld, ga je naar het . Maak vervolgens een nieuwe uitgaande serverconfiguratie aan door op de Create knop te klikken.
Voer vervolgens de SMTP server (in-v3.mailjet.com), poortnummer (587 of 465) en beveiliging (SSL/TLS) in die eerder zijn gekopieerd van het Mailjet account. Ze kunnen ook worden gevonden hier. Het wordt aanbevolen om SSL/TLS te gebruiken, ook al vereist Mailjet dit niet.
Voer voor de Gebruikersnaam de API KEY in. Voor de Password voer je de SECRET KEY in die eerder van de Mailjet account naar het kladblok is gekopieerd. Deze instellingen kun je vinden op .
Als de Mailjet server wordt gebruikt voor massamailing, stel dan de Priority waarde hoger in dan die van de transactionele e-mailserver(s). Sla tenslotte de instellingen op en Test de verbinding.
Belangrijk
For the notifications feature to work using Mailjet, with a custom domain, the following settings need to be configured:
The From Filter needs to be set on the server configuration. It is recommended to set it as a domain and not a full email address. It should match the domain in the two proceeding steps. More information can be referenced here.
De mail.default.from systeemparameter moet de waarde
notifications@yourdomain.comhebben.The mail.default.from_filter system parameter must have the value
yourdomain.com. Replaceyourdomainwith the custom domain.
If utilizing a database domain, and not a custom domain, the following settings need to be configured:
The From Filter needs to be set on the server configuration. It should match the domain in the two proceeding steps.
The mail.default.from system parameter must have the value
notifications.The mail.default.from_filter system parameter must have the value
yourdomain.odoo.com.
For more information see Using a default email address.
The System Parameters can be accessed by activating the developer mode.
Once the setup is complete, the Odoo database is ready to use the Mailjet email server for mass mailing or transactional emails!