Intercom

Learn how to setup Intercom in Noloco

To use an Intercom chat widget to chat with your customers, and correctly pass the customer information to Intercom you can follow these steps:

Setup

Find your workspace Id (or App id) by following these instructions:

https://www.intercom.com/help/en/articles/3539-where-can-i-find-my-workspace-id-app-id

Next, go to the "Custom Code" section of your portal settings and enter the following code in the Header Code section, replacing <YOUR_APP_ID> with the value you found in the first step

<script type="text/javascript">
  // These two blocks prevent the Noloco intercom widget from loading
  window.loadIntercom = () => null;
  window.intercomLoaded = true;
  
  // You can put any custom settings in here
  // but you need this to override the Noloco Settings
  window.intercomSettings = {};   

  var APP_ID = '<YOUR_APP_ID>';

  (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(w.attachEvent){w.attachEvent('onload',l);}else{w.addEventListener('load',l,false);}}})();

  window.Intercom('boot', {
     app_id: APP_ID,
  });

  function setIntercomSettings(user) {
    window.Intercom('update', {
     app_id: APP_ID,
      id: user.id,
      name: user.firstName + " " + user.lastName, 
      email: user.email, 
      company: user.company.companyName, 
      // Add other values here
    });
  }

  window._NolocoOnLoadUser = setIntercomSettings;
</script>

Finally, publish your project so that this is picked up when your users load your app.

If there are other details you need to send to Intercom be sure to request them in the app, and then just update the window.Intercom('update', ....) function call with whatever values you need.

More information

For more information on integrating Intercom you can read their help article:

https://www.intercom.com/help/en/articles/170-integrate-intercom-in-a-single-page-app