Skip to content

Visitor Identification

Benefits

  • Confirms the visitor's identity, making it more difficult for unauthorized users to impersonate legitimate ones.

  • Provides an additional measure to counteract malicious activities.

  • Allows conversation history to be consistent and accessible across multiple devices.

How it works

You can send us data about your users, and we'll use it to link Kipps visitors to your users. Once a visitor is identified, you will be able to access their chat history in Kipps Dashboard.

Upgrading Anonymous Visitors to Known Users

Once a visitor is identified, they will only be able to access their conversations after logging in. This is to prevent unauthorized users from accessing conversations of other users, simply by knowing their ID.

To set up Visitor Authentication, you need to:

Set visitor data to the Kipps Script Tag

On client side, include the visitor data in each page you want to use the widget with visitor identification.

<script>   
    window.kippsUserIdentification = {
        authToken: {
            "id": "<USER_ID>",
            "name": "<USER_NAME>",
            "email": "<USER_EMAIL>",
        },
    }; 
</script>

You can place the snippet anywhere in your HTML page, but make sure it happens before the widget is initialised.

Supported fields

We support the following user fields:

  • id

  • name

  • email

ID field is required. It is used to link the visitor to your user. Different ID means a different user.

All fields must be strings. If you need to pass a number, convert it to a string first.

Example user data

{
  "id": "1",
  "name": "John Doe",
  "email": "john@example.com",
}