> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# LiveChat Connector

## Intro

Live Chat is a customer service chat and ticketing platform. To learn more about the LiveChat API, visit their page ([https://developers.livechatinc.com/](https://developers.livechatinc.com/ "https://developers.livechatinc.com/") ).

You connect to your LiveChat account in the Data Center. This topic discusses the fields and menus that are specific to the LiveChat connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in [Adding a DataSet Using a Data Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Data Connector").

## Prerequisites

To connect to your LiveChat account and create a DataSet, you must have the following:

* The username for your LiveChat account.
* A LiveChat API key. For information about finding your API key, visit [https://docs.livechatinc.com/rest-ap...asic-api-usage](https://docs.livechatinc.com/rest-api/#basic-api-usage "https://docs.livechatinc.com/rest-api/#basic-api-usage").

## Connecting to Your LiveChat Account

This section enumerates the options in the **Credentials** and **Details** panes in the LiveChat Connector page. The components of the other panes in this page, **Scheduling** and **Name & Describe Your DataSet**, are universal across most connector types and are discussed in greater length in [Adding a DataSet Using a Data Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Data Connector").

## Credentials Pane

This pane contains fields for entering credentials to connect to your LiveChat account. The following table describes what is needed for each field:

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p><span class="s1"> Field </span></p></th><th colspan="1" rowspan="1"><p><span class="s1"> Description </span></p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"> Username </td><td colspan="1" rowspan="1"> Enter the username for your LiveChat account. </td></tr><tr><td colspan="1" rowspan="1"> API Key </td><td colspan="1" rowspan="1"> Enter your LiveChat API key. For information about finding your API key, visit <a href="https://docs.livechatinc.com/rest-api/#basic-api-usage" target="_blank" title="https://docs.livechatinc.com/rest-api/#basic-api-usage"> [https://docs.livechatinc.com/rest-ap...asic-api-usage](https://docs.livechatinc.com/rest-ap...asic-api-usage) </a>. </td></tr></tbody></table>

Once you have entered valid LiveChat credentials, you can use the same account any time you go to create a new LiveChat DataSet. You can manage connector accounts in the **Accounts** tab in the Data Center. For more information about this tab, see [Managing User Accounts for Connectors](https://domo-support.domo.com/s/article/360042926054?language=en_US "Managing User Accounts for Connectors").

## Details Pane

This pane contains a primary **Reports** menu, along with various other menus which may or may not appear depending on the report type you select.

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p> Menu </p></th><th colspan="1" rowspan="1"><p> Description </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Report </p></td><td colspan="1" rowspan="1"><p> Select the LiveChat report you want to run. The following reports are available: </p><table border="1" cellpadding="1" cellspacing="1"><tbody><tr><td colspan="1" rowspan="1"><p> Agents </p></td><td colspan="1" rowspan="1"><p> Returns a list of all LiveChat agents. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Agent Dashboard Report </p></td><td colspan="1" rowspan="1"><p> Returns a statistics overview from the last 7 days for the specified agent. Shows his ratings, number of chats, and number of reached goals. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Availability Report </p></td><td colspan="1" rowspan="1"><p> Shows how much the agent (or group or whole account) was available for chatting during specified period. When querying for one day, results are shown in minutes per every hour, otherwise in hours for each day. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Canned Responses </p></td><td colspan="1" rowspan="1"><p> Returns a full list of your currently set canned responses. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Chat </p></td><td colspan="1" rowspan="1"><p> Returns a list of all ended chats. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Chat Agents </p></td><td colspan="1" rowspan="1"><p> Returns a list of chat agents. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Chat Custom Variables </p></td><td colspan="1" rowspan="1"><p> Returns a list of chat custom variables. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Chat Events </p></td><td colspan="1" rowspan="1"><p> Returns a list of chat events. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Chat Goals </p></td><td colspan="1" rowspan="1"><p> Returns a list of chat goals. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Chat Messages </p></td><td colspan="1" rowspan="1"><p> Returns a list of chat messages. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Chat Postchat Survey </p></td><td colspan="1" rowspan="1"><p> Returns chat postchat survey data. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Chat Prechat Survey </p></td><td colspan="1" rowspan="1"><p> Returns a list of all prechat survey. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Chat Report </p></td><td colspan="1" rowspan="1"><p> Shows how many chats occurred during the specified period. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Chat Supervisors </p></td><td colspan="1" rowspan="1"><p> Returns a list of supervisors. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Chat Tags </p></td><td colspan="1" rowspan="1"><p> Returns a list of chat tags. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Chat Tickets </p></td><td colspan="1" rowspan="1"><p> Returns a list of chat tickets. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Chatting Time Report </p></td><td colspan="1" rowspan="1"><p> Shows how much time the agent (or group) spent on chatting during specified period. <br /> When querying for one day results are shown in minutes per every hour, otherwise in hours for each day. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Dashboard Report </p></td><td colspan="1" rowspan="1"><p> Returns a statistics overview from last 7 days for the whole license. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Goals </p></td><td colspan="1" rowspan="1"><p> Returns a list of currently set goals. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Goals Report </p></td><td colspan="1" rowspan="1"><p> Shows the number of reached goals. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Greeting </p></td><td colspan="1" rowspan="1"><p> Returns a list of greetings. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Greetings Report </p></td><td colspan="1" rowspan="1"><p> Returns the "greetings to chat to goals" conversion rates report. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Group </p></td><td colspan="1" rowspan="1"><p> Returns a list of all created groups. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Group Dashboard Report </p></td><td colspan="1" rowspan="1"><p> Returns statistics overview from last 7 days for the specified group. Shows ratings, number of chats and reached goals. </p></td></tr><tr><td colspan="1" rowspan="1"><p> New Ticket Report </p></td><td colspan="1" rowspan="1"><p> Shows the number of the tickets created during the specified period. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Queue Waiting Time Report </p></td><td colspan="1" rowspan="1"><p> Shows Minimum, Average and Maximum waiting times for a given time period. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Queued Visitor Report </p></td><td colspan="1" rowspan="1"><p> Shows how many visitors were waiting in the queue, how many abandoned the queue, or proceeded to chats. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Ranking Report </p></td><td colspan="1" rowspan="1"><p> Shows the ratio of good to bad ratings for each operator. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Ratings Report </p></td><td colspan="1" rowspan="1"><p> Shows how many chats were rated and how they have been rated during the specified period. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Solved Ticket Report </p></td><td colspan="1" rowspan="1"><p> Shows the number of the tickets solved during the specified period. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Status </p></td><td colspan="1" rowspan="1"><p> Returns the current status of your live chat instance. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Tickets First Response Report </p></td><td colspan="1" rowspan="1"><p> Shows the time of the first response to tickets that were responded to for the first time during the specified period. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Ticket Resolution Time Report </p></td><td colspan="1" rowspan="1"><p> Shows the resolution time of the tickets that were solved during the specified period. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Tickets </p></td><td colspan="1" rowspan="1"><p> Returns a list of all tickets. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Tickets Sources Report </p></td><td colspan="1" rowspan="1"><p> Shows the distribution of tickets between various channels. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Visitors </p></td><td colspan="1" rowspan="1"><p> Returns a list of visitors on the page with the tracking code installed. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Visitors Operators </p></td><td colspan="1" rowspan="1"><p> Returns a list of visitors operators. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Visitors Prechat Survey </p></td><td colspan="1" rowspan="1"><p> Returns prechat survey data. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Visitors Visit Path </p></td><td colspan="1" rowspan="1"><p> Returns visitors visit path data. </p></td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"><p> Start Days </p></td><td colspan="1" rowspan="1"><p> Enter the number of days back for which you want to start pulling report data. Pair with <b> End Days </b> to create a range of days. For example, if you entered <span class="mt-font-courier-new"> 14 </span> for <b> Start Days </b> and <span class="mt-font-courier-new"> 7 </span> for <b> End Days </b>, each time your report ran it would pull data from 14 days ago up until 7 days ago. </p></td></tr><tr><td colspan="1" rowspan="1"><p> End Days </p></td><td colspan="1" rowspan="1"><p> Enter the number of days back for which you want to stop pulling report data. Pair with <b> Start Days </b> to create a range of days. For example, if you entered <span class="mt-font-courier-new"> 14 </span> for <b> Start Days </b> and <span class="mt-font-courier-new"> 7 </span> for <b> End Days </b>, each time your report ran it would pull data from 14 days ago up until 7 days ago. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Group </p></td><td colspan="1" rowspan="1"><p> Select the group you want to retrieve data for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Login </p></td><td colspan="1" rowspan="1"><p> Select the login name you want to retrieve data for. </p></td></tr></tbody></table>

## Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see [Adding a DataSet Using a Data Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Data Connector").