Building Your First Link Resolver

Monday, Nov 23rd, 2015

Mixmax is a communications platform that brings professional communication & email into the 21st century.

This post is part 3 in an engineering blog series about building on top of the Mixmax SDK. See part 1 and part 2.

If you’re ever on Giphy.com and find an awesome GIF to put it in your email, you have to download the image to your computer and then upload it in to your email. But not with Mixmax - we believe in bringing the web to your email authoring experience. So in Mixmax when you paste the Giphy URL such as http://giphy.com/gifs/excited-the-office-yes-t3Mzdx0SA3Eis into your email, it’ll be automatically replaced with the actual GIF. Magic.

At least that’s how it should work. We first need to build it using the Mixmax SDK Link Resolver framework. Fortunately we’ve written some open source code to get you started. Here are the steps:

  1. Ensure that you have git and node (>=0.12) installed on your system
  2. Check out the open source Giphy Mixmax command by running git clone https://github.com/mixmaxhq/giphy-example-link-resolver
  3. Inside the directory, run npm install and then npm start. You shouldn’t see any errors and it should say [nodemon] starting `node server.js`
  4. Restart Chrome in a special temporary mode so the self-signed HTTPS urls. See here.
  5. Verify it works by visiting https://localhost:9146/resolver?url=http%3A%2F%2Fgiphy.com%2Fgifs%2Fexcited-the-office-yes-t3Mzdx0SA3Eis in your browser. It should show JSON results.
  6. Go to Mixmax Integration Settings
  7. Click Add Link Resolver and enter the following values:
    Input NameValue
    DescriptionGiphy (giphy.com/gifs/*)
    Regular Expressiongiphy.com/gifs/[^\/]+-[^\/]+$
    Resolver URLhttps://localhost:9146/resolver

    Adding Giphy Link Resolver to the Mixmax Integrations page

Now refresh Gmail and you should be able to paste in the Giphy URL http://giphy.com/gifs/excited-the-office-yes-t3Mzdx0SA3Eis and have it be replaced with the real GIF. Explore the code and make changes, and build your own!

Use cases:

  • anyone at your company can paste a URL to an internal knowledgebase and a snippet from the article will be put in the email
  • any Mixmax user pasting a link to your company’s public product page will get a rich preview of the company offerings

Interested in working on an email platform of the future? Email us at careers@mixmax.com and follow us @Mixmax.