Web in-app messaging

The web in-app channel lets you send messages that show up in your recipients' browsers. It shows up as a pop-up at the bottom right corner of the recipients’ screen.

Setup

• Install the Engage Javascript SDK. (If you haven’t, please read about the JS SDK before you continue). The web in-app messaging feature only works for a web client so you need to use the CDN version. Simply copy and paste the code just before the closing </body> tag of your web page.

!function(n){if(!window.Engage){window[n]=window[n]||{},window[n].queue=window[n].queue||[],window.Engage=window.Engage||{};for(var e=["init","identify","addAttribute","track"],i=0;i<e.length;i++)window.Engage[e[i]]=w(e[i]);var d=document.createElement("script");d.src="//d2969mkc0xw38n.cloudfront.net/next/engage.min.js",d.async=!0,document.head.appendChild(d)}function w(e){return function(){window[n].queue.push([e].concat([].slice.call(arguments)))}}}("engage");

• Next, initialize the SDK with your public API key. You can find your public API key in Settings → Account page of your dashboard.

Engage.init('api_key')

• To show the message to a specific user, you need to identify the user with the SDK.

Engage.identify({
 id: 'unique_user_id'
})

FAQ

How does this affect my pricing?

Each message you send to a unique customer contributes to your monthly active customers.

Can I use this on the free plan?

Absolutely. However, remember that the free plan is limited to only 1,000 active customers. Your in-app message will also have a "powered by Engage" footer.

When do customers get the message?

If the recipient is online, the message immediately pops up at the bottom right corner of the page. If they are not online, they see it when next they are online. By online, we mean when on any of your web pages with the Engage SDK integrated.

How do you determine delivered and opened?

We track "delivery" as when the message shows up on the recipients' browser. We track "opened" when the pop-up is closed.

Any plans to track clicks?

Not at the moment.

What happens if there are multiple messages sent before they come online?

They see the oldest message first. Once they close it (it’s marked as opened) and move to a different page (or refresh the page), they see the next. And so on.