MailJet
You can send email notifications through MailJet transactional email API.
Unique Identifier
Each provider is identified by a unique identifier. Unique identifier of MailJet provider is mailjet_email
Enabling MailJet
To enable MailJet provider, login to your Engagespot dashboard, goto Channels -> Email and enable MailJet.
MailJet provider uses email
attribute in your user's profile as the primary address to deliver the notifications. So make sure your user's profile has the email
attribute set.
MailJet Configurations.
MailJet requires the following configurations.
Configuration | Description | Required | Example |
---|---|---|---|
API_KEY | API KEY from your MailJet dashboard | Yes | |
API_SECRET | SECRET KEY from your MailJet dashboard | Yes | |
FROM_EMAIL | Sender signature created in your MailJet dashboard | Yes | |
FROM_NAME | Sender signature created in your MailJet dashboard | Yes |
Overriding Configurations
MailJet provider allows you to override all the above configurations (and you can specify several more options) while sending a notification through Engagespot API, using the https://api.engagespot.co/v3/notifications
endpoint.
To override the configurations, you must supply them via override
-> mailjet_email
parameter of the above API.
Configurations override values should be passed via _config
object, and you can directly supply any additional parameters that will be passed to MailJet API.
For example,
{
"notification": {
"title": "Anand commented on your photo",
"message": "Hey Steve, you're looking cool 😎. Who took this photo?",
"url": "https://your-app.com/photos/17293739",
"category": "comment"
},
"recipients": ["steve@example.com"],
"override": {
"mailjet_email": {
"_config": {
"API_KEY": "ANNHYAAJMLCPWRWGCNBSKHFY",
"API_SECRET": "ANNHYAAJMLCPWRWGCNBSKHFY",
},
"From": {
"Email": "pilot@mailjet.com",
"Name": "Your Mailjet Pilot"
},
"Sender": {
"Email": "copilot@mailjet.com",
"Name": "Your Mailjet Co-pilot"
},
"To": [
{
"Email": "passenger@mailjet.com",
"Name": "Passenger 1"
}
],
"Cc": [
{
"Email": "passenger2@mailjet.com",
"Name": "Passenger 2"
}
],
"Bcc": [
{
"Email": "passenger3@mailjet.com",
"Name": "Passenger 3"
}
],
"ReplyTo": {
"Email": "copilot@mailjet.com",
"Name": "Your Mailjet Co-pilot"
},
"Subject": "Your email flight plan!",
"TextPart": "Dear passenger, welcome to Mailjet! May the delivery force be with you!",
"HTMLPart": "<h3>Dear passenger 1, welcome to <a href=\"https://www.mailjet.com/\">Mailjet!</a></h3><br />May the delivery force be with you!",
"TemplateID": "12345",
"TemplateLanguage": false,
"TemplateErrorReporting": {
"Email": "errors@mailjet.com",
"Name": "Error Email"
},
"TemplateErrorDeliver": true,
"Attachments": [
{
"Filename": "test.txt",
"ContentType": "text/plain",
"Base64Content": "VGhpcyBpcyB5b3VyIGF0dGFjaGVkIGZpbGUhISEK"
}
],
"InlinedAttachments": [
{
"Filename": "logo.gif",
"ContentType": "image/gif",
"Base64Content": "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",
"ContentID": "logo"
}
],
"Priority": 2,
"CustomCampaign": "SendAPI_campaign",
"DeduplicateCampaign": true,
"TrackOpens": "account_default",
"TrackClicks": "account_default",
"CustomID": "CustomValue",
"EventPayload": "Eticket,1234,row,15,seat,B",
"MonitoringCategory": "Category1",
"URLTags": "utm_source=newsletter&utm_medium=email&utm_campaign=sale1",
"Headers": "object",
"Variables": "object"
}
},
}