Custom Script Integration

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.

Copied to clipboard!

<script data-cfasync="false" type="text/javascript">
  window.civchat = {
    apiKey: 'YOUR_API_KEY',
  };
</script>
<script data-cfasync="false" type="text/javascript" src="https://.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.

Copied to clipboard!

<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://.user.com/widget.js"></script>

Custom Script Integration

Simple widget integration

Example of advanced usage

Integration via script

Grow your business automatically