How to Install and Configure

How to Install the Mailjet Extension

1. Go to the Mailjet’s Magento Extension GitHub repository.

2. Click on the mailjet-2.x.x.tgz file name.

   

3. Use the ‘Download’ button to download the file.

   

4. Log into your Magento Admin page and go to ‘System’ → ‘Magento Connect’ → ‘Magento Connect Manager’.

   

5. Under ‘Direct package file upload’ click on ‘Choose File’ and select the downloaded Mailjet extension file.

   

6. Click on the ‘Upload’ button to start the installation.

   

7. You will now see a console screen in the web page, which will show you the installation process. Once it is done, you can click on ‘Refresh’ to confirm that Mailjet has been added to your ‘Extising Extensions’.

   

   

The Mailjet extension has now been successfully installed! You can go back to your Magento Admin page.

Mailjet Settings

1. Now you need to configure your Mailjet account in Magento. In the Magento Admin, go to ‘System’ → ‘Configuration’.

   

   Important

   Since Magento is a multi-store service, you are able to administer several stores from your Magento admin page. Whenever you configure your Mailjet settings, if you have selected ‘Default Config’ from the ‘Current Configuration Scope’ menu, the settings you choose will be saved as default ones. However, if you choose a certain store instead, they will only be valid for the store you have selected at the time.

   

2. In the left-side menu under ‘Mailjet’ click on ‘Settings’.

   

3. You will see the Mailjet extension configuration page. We will now describe the options available for you here.

   

   • Enabled - should be set to ‘Yes’. By enabling this checkbox, you are allowing Mailjet to send all of the emails emanating from your Magento environment (transactional emails and marketing campaigns). With Mailjet’s SMTP relay, you will have access to real-time statistics, triggered marketing events, order statuses, ROI on campaigns, optimized email deliverability and much more.

   • Send test mail now - you can use this option to test your Mailjet configuration. Simply select ‘Yes’, and once you save your new settings, an automatic email will be sent to the email address you have specified. The sender address for the test email will be the one you have selected for sending automatic emails from Magento - the “General Contact” email. For more information see the Store Email Addresses section of the guide.

   • Recipient of test mail - this is the email address where you will receive your test email.

   • API Settings - You will need to enter your Mailjet API Key and Secret Key here to link your Mailjet account to Magento. You can find the API Key and Secret Key information in your Mailjet API Key Management page.

   Note

   If you do not have a Mailjet account, please create one now by clicking on ‘Create your Mailjet account’ button on the API Settings section, or go directly to the Mailjet Signup page.

   Once you have entered all the information you need, click on the ‘Save Config’ button to submit the changes. If you have opted to receive a test email, it will be sent as soon as you click on ‘Save Config’.

   

Configure Sender Address for Automatic Emails

To select the Sender address for your automatic Magento emails, from the Configuration section go to ‘Store Email Addresses’.

You will see the different options for sender email addresses, where you can select the email and the Sender Name.

The ‘General Contact’ email will be the one used by Magento to send automatic emails. In order to successfully use it, you need to have the ‘General Contact’ email verified in Mailjet. To do that, please visit the Sender domains & addresses section of your Mailjet account.

Event Tracking

Event Callback (or Tracking) simply means whenever there is an event, an event is dispatched to the provided Endpoint URL, containing meaningful context about the event (like the recipient email, timestamp, etc). From here, the customer can script actions to be done following it.

Note

Mailjet allows you to track each event from one URL at a time, so it will not be possible to track a Click event simultaneously from Magento and a custom URL, for example.

In case you want to track certain events in Magento automatically, you can use the Endpoint URL displayed at the top of the Mailjet ‘Settings’ section.

To track the events you want you need to first copy the displayed link, then go to the ‘Event Tracking’ section of your Mailjet account.

Let’s look at the ‘Unsub’ event. In this case, when a recipient unsubscribes from your newsletter (the event), that information is pushed to Magento and that recipient’s profile is automatically updated (the action). The steps you need to follow are:

1. Tick the checkbox next to the ‘Unsub’ event.
2. Paste the URL you copied earlier in the ‘Endpoint URL’ box.
3. Click on ‘Send’ to test the URL. If the test is successful, you will see a ‘OK, Code 200’ response.
4. Click on ‘Save’ to submit the changes.

Congratulations - you have successfully configured your Mailjet Extension!

Note

Once your configuration is saved, your Mailjet account will be linked to Magento. Your Magento customer contacts will be automatically transferred to a new Mailjet Contact List, along with the contact properties configured there.