Custom script integration

User.com plugins work by injecting a script to your website which enables communication between your site and our API. If you don’t want a plugin you can integrate User.com by yourself. To do so, insert the following code before the closing tag of your website:

Custom script integration

How to set it up?

User.com plugins work by injecting a script to your website which enables the communication between your site and our API. If you don’t want a plugin you can integrate User.com by yourself. To do so, insert the following code before the closing <body> tag of your website:
Simple widget integration
It’s a simple way to enable tracking and interacting with the User.com chat widget. Users’ page views will be recognized and send to the User.com with user-chatping/ request. All data is anonymous, cause within this request you don’t send any attributes. After this script is loaded, you’re able to use userengage namespace and UE methods.
<script data-cfasync="false" type="text/javascript">
  window.civchat = {
    apiKey: 'YOUR_API_KEY',
  };
</script>
<script data-cfasync="false" type="text/javascript" src="https://<your_app_subdomain>.user.com/widget.js">
</script>
Example of advanced usage
Within window.civchat object you can pass data to update your user attribute. Below, you can find an example of the prefilled values of these attributes. Remember, it’s static value just for example purposes. In a real-life scenario, you can use your GTM variables as a value of certain attributes or dynamically pass them with JavaScript.
<script data-cfasync="false" type="text/javascript">
  window.civchat = {
    apiKey: 'YOUR_API_KEY',
    name: "John Doe",
    user_id: "idfromyourdatabase",
    email: "myemail@example.org",
    gender: 2,
    status: 2,
    date_attr: "2017-07-25T14:14:08.612Z",   // Must be a valid ISO 8601 format
    phone_number: "+44754123434", // Must be a valid E.164 format
    score: 0,
    company: {
      name: "My Company",
      company_id: "idfromyourdatabase",
      revenue: "$239.9 billion"
    }
  };
</script>
<script data-cfasync="false" type="text/javascript" src="https://<your_app_subdomain>.user.com/widget.js"></script>

Learn more

Integration via script

How to integrate your data with the User.com database via simple script implementation within your web page source code

Learn more