Mailjet API¶

Odoo är kompatibelt med Mailjets API för massutskick. Sätt upp en dedikerad massutskicksserver via Mailjet genom att konfigurera inställningar i Mailjet-kontot och Odoo-databasen. Under vissa omständigheter måste inställningar konfigureras på den anpassade domänens DNS inställningar också.

Uppsättning i Mailjet¶

Skapa autentiseringsuppgifter för API¶

För att komma igång loggar du in på sidan Mailjet Kontoinformation. Gå sedan till avsnittet Sändare & Domäner och klicka på SMTP och SEND API-inställningar.

Kopiera sedan SMTP-konfigurationsinställningarna till ett anteckningsblock. De finns under avsnittet Konfiguration (endast SMTP). Konfigurationsinställningarna för SMTP inkluderar serveradressen, det säkerhetsalternativ som behövs (Använd SSL/TLS) och portnumret. Inställningarna behövs för att konfigurera Mailjet i Odoo, vilket beskrivs i :ref:` sista avsnittet <maintain/mailjet-api/odoo-setup>`.

Klicka sedan på knappen Retrieve your API credentials för att hämta Mailjets API-referenser.

Klicka sedan på ögonikonen för att visa API-nyckeln. Kopiera denna nyckel till ett anteckningsblock, eftersom den fungerar som Username i Odoo-konfigurationen. Klicka sedan på knappen Generate Secret Key för att generera Secret Key. Kopiera den här nyckeln till ett anteckningsblock, eftersom den fungerar som Password i Odoo-konfigurationen.

Lägg till verifierad avsändaradress¶

Nästa steg är att lägga till en avsändaradress eller en domän i Mailjets kontoinställningar så att e-postadressen eller domänen godkänns för att skicka e-post med hjälp av Mailjets servrar. Navigera först till sidan Mailjet-kontoinformation. Klicka sedan på länken Lägg till en avsändardomän eller adress under avsnittet Avsändare och domäner.

Avgör om en avsändares e-postadress eller hela domänen behöver läggas till i Mailjet-inställningarna. Det kan vara enklare att konfigurera domänen som helhet om DNS-åtkomst finns tillgänglig. Gå till avsnittet Lägg till en domän för steg om hur du lägger till domänen.

Som standard läggs den e-postadress som ursprungligen konfigurerades i Mailjet-kontot till som betrodd avsändare. Om du vill lägga till en annan e-postadress klickar du på knappen Lägg till en avsändaradress. Lägg sedan till den e-postadress som är konfigurerad att skicka från den anpassade domänen.

Minst följande e-postadresser ska vara konfigurerade hos leverantören och verifierade i Mailjet:

• meddelanden@yourdomain.com

• bounce@yourdomain.com

• catchall@yourdomain.com

Därefter fyller du i formuläret E-postinformation och ser till att välja lämplig e-posttyp: transaktionsmejl eller massmejl. När du har fyllt i formuläret skickas ett aktiveringsmeddelande till e-postadressen och den betrodda avsändaren kan aktiveras.

Det rekommenderas att SPF/DKIM/DMARC ställs in på avsändarens domän.

Lägg till en domän¶

Genom att lägga till en hel domän till Mailjet-kontot valideras alla avsändaradresser som är relaterade till den domänen automatiskt för att skicka e-post med Mailjet-servrar. Navigera först till sidan Information om Mailjet-kontot. Klicka sedan på länken Lägg till en avsändardomän eller adress under avsnittet Avsändare och domäner. Klicka sedan på Lägg till domän för att lägga till den anpassade domänen.

Därefter fyller du i Add a new Domain på Mailjet och klickar på Continue.

När du har lagt till domänen visas en valideringssida. Om inte Odoo-databasen är lokal (i så fall väljer du Alternativ 1), väljer du Alternativ 2: Skapa en DNS-post. Kopiera TXT-postinformationen till ett anteckningsblock och navigera sedan till domänens DNS-leverantör för att slutföra valideringen.

Inställning i domänens DNS¶

När du har fått TXT-postinformationen från Mailjet-kontot lägger du till en TXT-post i domänens DNS. Denna process varierar beroende på DNS-leverantören. Kontakta leverantören för specifika konfigurationsprocesser. TXT-postinformationen består av Host och Value. Klistra in dessa i motsvarande fält i TXT-posten.

Gå tillbaka till Mailjets kontoinformation¶

När du har lagt till TXT-posten i domänens DNS, navigerar du tillbaka till Mailjet-kontot. Gå sedan till Kontoinformation ‣ Lägg till en avsändardomän eller adress, klicka på kugghjulsikonen bredvid Domän och välj Validera.

Denna åtgärd kan också göras genom att gå till sidan Sender domains & addresses på Mailjet-kontoinformationen och klicka på Manage.

Klicka sedan på Check Now för att validera den TXT-post som lades till på domänen. En framgångsskärm visas om domänen är korrekt konfigurerad.

När du har konfigurerat domänen finns det ett alternativ Autentisera denna domän (SPF/DKIM). Den här knappen fyller i SPF & DKIM leverantören.

Installera i Odoo¶

För att slutföra installationen, navigera till Odoo-databasen och gå till Settings. Med Developer mode (debug mode) aktiverat, gå till Technical Menu ‣ Email ‣ Outgoing Mail Servers. Skapa sedan en ny utgående serverkonfiguration genom att klicka på knappen Create.

Ange sedan SMTP-server (in-v3.mailjet.com), portnummer (587 eller 465), och Säkerhet (SSL/TLS) som kopierades tidigare från Mailjet-kontot. De kan också hittas här. Det rekommenderas att använda SSL/TLS även om Mailjet kanske inte kräver det.

För Username, ange API KEY. För Password, ange SECRET KEY som kopierades från Mailjet-kontot till anteckningsblocket tidigare. Dessa inställningar hittar du på Mailjet ‣ Account Settings ‣ SMTP and SEND API Settings.

Om Mailjet-servern används för massutskick av e-post ska du ställa in värdet Priority högre än för alla transaktionella e-postservrar. Slutligen sparar du inställningarna och Test the Connection.

När installationen är klar är Odoo-databasen redo att använda Mailjet e-postserver för massutskick eller transaktionsmeddelanden!