Intercom IO

Integrate with Intercom IO

Integrate your Intercom.io live chat with Ruler Analytics, so you can track and attribute your new intercom leads in the Ruler dashboard.

First step you will need to add the Ruler Visitor ID to your Intercom, The Visitor ID holds all the attribution information we have on a visitor about their source and journey on your website, and will allow you to attribute the new lead within Ruler Analytics.

Please see a guide from Intercom about how to add custom user attributes to your live chat here

The below snippet of script will needadding into your current Intercom Live Chat Script that is on your website.

window.intercomSettings = {
    RulerId : RulerAnalyticsVisitorId
}

The final script should look something like below - Please ensure you populate your APP ID, under ‘Your App ID’

<script type="text/javascript">
 function liveChatRefresh() {
   try {
     if (RulerAnalyticsVisitorId) {
       var APP_ID = "YOUR APP ID"
       window.intercomSettings = {
         app_id: APP_ID,
         "RulerId" : RulerAnalyticsVisitorId
       };
       (function(){var w=window;var ic=w.Intercom;if(typeof ic==="function"){ic('reattach_activator');ic('update',w.intercomSettings);}else{var d=document;var i=function(){i.c(arguments);};i.q=[];i.c=function(args){i.q.push(args);};w.Intercom=i;var l=function(){var s=d.createElement('script');s.type='text/javascript';s.async=true;s.src='https://widget.intercom.io/widget/' + APP_ID;var x=d.getElementsByTagName('script')[0];x.parentNode.insertBefore(s, x);};if(document.readyState==='complete'){l();}else if(w.attachEvent){w.attachEvent('onload',l);}else{w.addEventListener('load',l,false);}}})();
     }
   } catch (error) {
     setTimeout(() => {
       liveChatRefresh();
     }, 500);
   }
 }
 liveChatRefresh();
</script>

Once the script has been updated and published on your website, you should then be able to see the custom variable within your new chats within Intercom.

Once you have successfully passed the RAID into your Intercom chats, you will need to post the new chats back to Ruler Analytics using Webhooks within Intercoms Developer hub.

Please see Intercoms guide on utilising their Webhooks here.

When setting up your Webhooks, paste in your endpoint URL provided by Ruler, and select "contacts_added_email" as the topic.

Your Ruler Analytics account manager will provide you with your unique end point URL to post your new chats too.

Any questions, please contact [email protected]