{"id":14923,"date":"2014-07-24T19:29:09","date_gmt":"2014-07-24T13:59:09","guid":{"rendered":"http:\/\/www.tothenew.com\/blog\/?p=14923"},"modified":"2024-01-02T17:50:04","modified_gmt":"2024-01-02T12:20:04","slug":"email-tracking-using-mailgun-with-grails-application","status":"publish","type":"post","link":"https:\/\/www.tothenew.com\/blog\/email-tracking-using-mailgun-with-grails-application\/","title":{"rendered":"Email Tracking using MailGun with Grails application"},"content":{"rendered":"

Many times we need to track whether the email is open\/deliver\/read by users, sent from our application. After analyzing, I concluded that MailGun provides email tracking services that i used with my grails application and thought it worth sharing.<\/p>\n

There are two ways to send messages using MailGun:<\/p>\n

#1. HTTP API
\n#2. SMTP<\/p>\n

I have used HTTP API and MailGun uses Jersey Request Builder.So, add following dependency:<\/p>\n

[java]
\ncompile ":jersey-request-builder:1.2.1"
\n[\/java]<\/p>\n

The steps involved in using MailGun by Rackspace in our grails application are as:-<\/p>\n

#1.SignUp With MailGun:<\/p>\n

SignUp with Mailgun HERE<\/a> and you will get the following code.<\/p>\n

[java]
\npublic static ClientResponse SendSimpleMessage() {
\n Client client = Client.create();
\n client.addFilter(new HTTPBasicAuthFilter("api",
\n "${YOUR_API_KEY}"));
\n WebResource webResource =
\n client.resource("https:\/\/api.mailgun.net\/v2\/${YOUR_MAILGUN_SUB_DOMAIN}\/messages");
\n MultivaluedMapImpl formData = new MultivaluedMapImpl();
\n formData.add("from", "Mailgun Sandbox <postmaster@${YOUR_MAILGUN_SUB_DOMAIN}>");
\n formData.add("to", "${EMAIL_ID_YOU_WANT_TO_SEND_TO}");
\n formData.add("subject", "Hello ${ACCOUNT_NAME_YOU_REGISTERED_WITH}");
\n formData.add("text", "Congratulations ${ACCOUNT_NAME_YOU_REGISTERED_WITH}, you just sent an email with Mailgun! You are truly awesome! You can see a record of this email in your logs: https:\/\/mailgun.com\/cp\/log . You can send up to 300 emails\/day from this sandbox server. Next, you should add your own domain so you can send 10,000 emails\/month for free.");
\n return webResource.type(MediaType.APPLICATION_FORM_URLENCODED).
\n post(ClientResponse.class, formData);
\n}
\n[\/java]<\/p>\n

#2.Log In to MailGun here<\/a> and go to Logs section.And enter a call back url on which mailgun let’s you know about Delivery of messages and also you can a enter a call back for failed messages, as can be seen in following image:<\/p>\n

\"ForMailGunDelivery<\/p>\n

#3.Similary go to Tracking section.And enter a call back url on which mailgun let’s you know about Opens event of messages and also you can a enter a call back for Clicks event messages, as can be seen in following image:<\/p>\n

\"ForMailGunOpenedCallBack\"<\/p>\n

#4.Add following actions to send mails through MailGun and to handle callBacks provided to MailGun.<\/p>\n

a) action to send mail-<\/p>\n

[java]
\n def sendSimpleMessage() {
\n log.debug "::::Exceuting mail::::"
\n Client client = Client.create();
\n client.addFilter(new HTTPBasicAuthFilter("api",
\n "${grailsApplication.config.mailGun.api}"));
\n WebResource webResource =
\n client.resource("${grailsApplication.config.mailGun.webResource}");
\n MultivaluedMapImpl formData = new MultivaluedMapImpl();
\n formData.add("from", "${grailsApplication.config.mailGun.mail.from}");
\n formData.add("to", "${EMAIL_ID_YOU_WANT_TO_SEND_TO}");
\n formData.add("subject", "Hello MediaIQ");
\n formData.add("text", "Congratulations, you just sent an email with Mailgun!");
\n \/\/use html instead text for sending html content
\n formData.add("o:tracking", true);
\n \/\/Set this to true to track opens event
\n webResource.type(MediaType.APPLICATION_FORM_URLENCODED).
\n post(ClientResponse.class, formData);
\n render "success"
\n }
\n[\/java]<\/p>\n

b) action to handle delivery call back-<\/p>\n

[java]
\n def mailDeliveryCallBack() {
\n boolean isMailSent = false
\n List headerData = (JSON.parse(params.get("message-headers").toString())) as List
\n headerData.each { List header ->
\n if (header[0] == "Received") {
\n isMailSent = true
\n } else if (header[0] == "To") {
\n User user = User.findByEmail(header[1].toString())
\n user.isMailSent = true
\n user.save()
\n }
\n }
\n }
\n[\/java]<\/p>\n

b) action to handle opens call back-<\/p>\n

[java]
\n def mailOpenedCallBack() {
\n boolean isMailOpened = false
\n isMailOpened = params.get("event").toString().equals("opened")
\n User user = User.findByEmail(params.get("recipient").toString())
\n user.isMailOpened = isMailOpened
\n user.save()
\n }
\n}
\n[\/java]<\/p>\n

This worked for me.
\nHope it helps.<\/p>\n

Useful Links:<\/p>\n

http:\/\/documentation.mailgun.com\/user_manual.html<\/a><\/p>\n

Cheers!!!
\nVivek Garg
\nvivek.garg@intelligrape.com
\nwww.intelligrape.com<\/a>
\nMy LinkedIn
\nMORE BLOGS BY ME<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"

Many times we need to track whether the email is open\/deliver\/read by users, sent from our application. After analyzing, I concluded that MailGun provides email tracking services that i used with my grails application and thought it worth sharing. There are two ways to send messages using MailGun: #1. HTTP API #2. SMTP I have […]<\/p>\n","protected":false},"author":69,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"iawp_total_views":9,"footnotes":""},"categories":[7],"tags":[4840,1486,1487],"class_list":["post-14923","post","type-post","status-publish","format-standard","hentry","category-grails","tag-grails","tag-mailgun","tag-mailgun-api"],"aioseo_notices":[],"aioseo_head":"\n\t\t\n\t\n\t\n\t\n\t\n\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t