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.

Zie ook

Mailjet: Hoe kan ik mijn SMTP parameters configureren?

Belangrijk

Odoo blokkeert poort 25 op Odoo Online en Odoo.sh databases.

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:

• meldingen@uwdomein.nl

• stuiteren@uwdomein.nl

• catchall@uwdomein.nl

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.

Zie ook

Mailjets SPF/DKIM/DMARC documentatie

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 Account Information ‣ Add a Sender Domain or Address, 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.

Zie ook

Mailjets SPF/DKIM/DMARC documentatie

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 Technical Menu ‣ Email ‣ Outgoing Mail Servers. 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 Mailjet ‣ Accountinstellingen ‣ SMTP en SEND API Instellingen.

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

Om de notificatie functie te laten werken met Mailjet, zijn er drie instellingen die moeten worden ingesteld in Odoo.

1. Het Van Filter moet worden ingesteld in de serverconfiguratie. Het wordt aanbevolen om het in te stellen als een domein en niet als een volledig e-mailadres. Het moet overeenkomen met het domein in de twee volgende stappen. Bekijk voor meer informatie de FROM filtering documentatie.

2. De mail.default.from systeemparameter moet de waarde notifications@yourdomain.com hebben.

3. De mail.default.from_filter systeemparameter moet de waarde uwdomein.com hebben. Vervang yourdomain door het aangepaste domein voor de Odoo database. Als dat er niet is, gebruik dan de mail.catchall.domain systeemparameter.

Bekijk voor meer informatie de “Een uniek e-mailadres gebruiken” documentatie.

De Systeemparameters is toegankelijk door de ontwikkelmodus te activeren.

Zodra de installatie is voltooid, is de Odoo database klaar om de Mailjet e-mailserver te gebruiken voor massamailings of transactiemails.