LiveChat Destination

Destination Info
Connection Modes
Device-mode Cloud-mode
Web Web
Mobile Mobile
Server Server

Getting Started

When you enable LiveChat in the Segment web app, your changes appear in the Segment CDN in about 45 minutes, and then Analytics.js starts asynchronously loading LiveChat’s JavaScript onto your page. This means you should remove LiveChat’s snippet from your page.

  • LiveChat’s chat box will appear on your page and you can start chatting with visitors.

LiveChat is only supported on the client-side.


When you call identify on analytics.js, we take all the traits you provide and set them as custom variables using LiveChat’s set_custom_variables function. We use the userId you provide to identify as a custom variable called User ID.

Record Live Chat Events

With this destination, you can automatically record track events for live chat conversations. If you select this option, we’ll collect the following events:

  • Live Chat Conversation Started
  • Live Chat Conversation Ended
  • Live Chat Message
  • Live Chat Message Received

These events will then flow out to your other tools, so you can do things like analyze if users who chat spend more money over time.

To learn more about the live chat events you can capture with this destination, head on over to our Live Chat spec docs.

Turn on LiveChat


Segment lets you change these destination settings from the Segment app without having to touch any code.

Setting Description
Group string, defaults to 0 .

You can divide LiveChat agents into different groups such as “Billing” or “Support”
string. You can find your License key in your LiveChat Javascript snippet on the Settings > Installation page. Or, if you’re just signing up, it’s right in the setup guide!
Record live chat events. boolean, defaults to FALSE .

Automatically send Live Chat message events, conversation starts and ends to other tools you have enabled.

This page was last modified: 15 Jul 2022

Get started with Segment

Segment is the easiest way to integrate your websites & mobile apps data to over 300 analytics and growth tools.
Create free account