Intro
LiveChat is an online customer service software with online chat, help desk software, and web analytics capabilities. Use Domo’s LiveChat connector to delight your customers and fuel your sales. To learn more about the LiveChat V3 API, visit https://developers.livechat.com/updates/release-stable-livechat-api-v3-2. 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.Prerequisites
To connect to your LiveChat account and create a DataSet, you must have the following:- Your LiveChat Account ID
- Your LiveChat Personal Access Token
Connecting to Your LiveChat Account
This section enumerates the options in the Credentials and Details panes on the LiveChat Connector page. The components of the other panes on 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.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:Field | Description |
|---|---|
| Account ID | Enter your LiveChat account ID. |
| Personal Access Token | Enter your LiveChat personal access token. |
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.Menu | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Report | Select the LiveChat report you want to run. The following reports are available:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Date Selection | Select the date format for your data. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Single Date | Select whether the report data is for a specific date or a relative number of days back from today. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Single Date - Specific | Select the specific date using the date selector. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Single Date - Relative | Enter the number of days back that you would like to get data for in the Days Back field. Specify either today or 0, yesterday or 1, or today or 7 to get data for 7 days into the past. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Date Range | Select the specific or relative date range. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Start Date - Specific | Select the first date in your date range using the date selector. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| End Date - Specific | Select the last date in your date range using the date selector. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Start Date - Relative | Enter the number of days back that you would like to get data from (start day). Combine with End Date to create a range of represented days. For example, if you entered 10 for Start Date and 5 for End Date , the report would contain data from 10 days ago up until 5 days ago. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| End Date - Relative | Enter the number of days back that you would like to get data to (end day). Combine with Start Date to create a range of represented days. For example, if you entered 10 for Start Date and 5 for End Date , the report would contain data from 10 days ago up until 5 days ago. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Time Period | Specify the time period that you would like to receive data for. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Starting Day of the Week | Select the day you would like your week to start with. |
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.FAQs
What endpoint is the base URL for this connector?
What endpoint is the base URL for this connector?
The base URL for LiveChat is https://api.livechatinc.com.
Which endpoint does each report call in this connector?
Which endpoint does each report call in this connector?
| Report Type | Report Name | Endpoint URL |
| Reports API | ||
| Availability | /reports/availability | |
| Chats - Chatting Time | /reports/chats/chatting_time | |
| Chats - Engagement | /reports/chats/engagement | |
| Chats - First Response Time | /reports/chats/first_response_time | |
| Chats - Goals | /reports/chats/goals | |
| Chats - Greetings | /reports/chats/greetings | |
| Chats - Not Replied Chats | /reports/chats/not_replied_chats | |
| Chats - Queued Visitors | /reports/chats/queued_visitors | |
| Chats - Queued Visitors Waiting Times | /reports/chats/queued_visitors/waiting_times | |
| Chats - Rankings | /reports/chats/ratings/ranking | |
| Chats - Ratings | /reports/chats/ratings | |
| Chats - Response Time | /reports/chats/response_time | |
| Chats - Total Chats | /reports/chats/total_chats | |
| Tickets - First Response Time | /reports/tickets/first_response_time | |
| Tickets - New Tickets | /reports/tickets/new_tickets | |
| Tickets - Rankings | /reports/tickets/ratings/ranking | |
| Tickets - Ratings | /reports/tickets/ratings | |
| Tickets - Resolution Time | /reports/tickets/resolution_time | |
| Tickets - Solved Tickets | /reports/tickets/solved_tickets | |
| Tickets - Ticket Sources | /reports/tickets/ticket_sources | |
| Management API | ||
| Agents | /v3.2/configuration/action/list_agents | |
| Bot Agents | /v3.2/configuration/action/list_bots | |
| Groups | /v3.2/configuration/action/list_groups | |
| License Properties | /v3.2/configuration/action/list_license_properties | |
| Registered Properties | /v3.2/configuration/action/list_registered_properties |
What kind of credentials do I need to power up this connector?
What kind of credentials do I need to power up this connector?
You need the account id and personal access token associated with your LiveChat account.
How often can the data be updated?
How often can the data be updated?
As often as needed.
Are there any API limits that I need to be aware of?
Are there any API limits that I need to be aware of?
No.
What's the difference between the LiveChat and LiveChat API V3 connectors?
What's the difference between the LiveChat and LiveChat API V3 connectors?
The LiveChat API V3 connector uses the API version 3.2 for the Management API reports.