LivePerson Functions is a Function as a Service (FaaS) platform which enables brands to develop custom behaviors within LivePerson’s conversational platform to better tailor the system to their specific needs. Get started with a hosted function in less than 60 seconds. Check out the Functions documentation to get acquainted with this powerful new feature.

The LiveEngage platform offers a messaging solution that you can harness and enhance by integrating LiveEngage with your native app, customizing LiveEngage reports or creating new reports, and building or integrating workspace widgets. This can be achieved using our various APIs and SDKs.

Our APIs configure and manipulate LiveEngage features and capabilities. To use these APIs, you must make sure to configure your LiveEngage account to access these features. For example, if you want to use the Agent Messaging SDK to connect a bot, then your account must support bot users. Therefore, before working with any of the below documentation, it's best to contact your account team or LivePerson Support to check that the prerequisite features are enabled for your account.

Most user actions within LiveEngage can be performed programmatically using the REST API. Some of the key categories are:

  • Domain API for returning the base domain for your LivePerson account, which is used in conjunction with the other APIs outlined in the documentation.

  • Login Service API for logging into LiveEngage as a user with credentials or as an application with an API key. After logging in, you receive a session token (Bearer) to use for other related API calls.

  • Engagement attributes for collecting specific information about the visitor such as product viewed, purchase information, errors the visitor encountered, and search results. LiveEngage provides out-of-the-box information for the visitor’s geolocation, the amount of time spent on a page, and the pages they viewed, among other parameters.

  • Data APIs for retrieving your contact center’s information such as types of conversations, load, and messaging transcripts.

  • Bot connectors for integrating third-party messaging platforms and LiveEngage. Bot connectors send/receive text messages, send structured content, transfer the conversation to other skills, change Time To Response, and close a conversation.

Common use cases

To better understand our documentation, APIs, and the LiveEngage platform, we’ve listed our common use cases as entry points into the documentation to help you start building an API client. If, however, you can’t find the project you had in mind, reach out to LivePerson Support for guidance.

Integrate LiveEngage with your native app

You can integrate your native iOS or Android app with LiveEnage using the Mobile Messaging SDK. When you implement this SDK and its APIs, brands can create and manage digital engagements that start in your native app. This allows customers to communicate with the brand's agents through their channel of choice. For more information, refer to the Mobile Messaging SDK for Android or iOS.

Customize LiveEngage reports or create new ones

Working with historical data APIs, brands can address specific goals and KPIs by accessing their entire raw data. Brands can use this data in data warehouse systems as well as create customized reports.

Some of the key use cases are:

  • Retrieve up to 13 months of historical conversations, both metadata and content for a specific consumer using the Consumer Messaging History API. This API is based on the REST architecture and supports the HTTPS GET protocol. All retrieved data is returned in JSON format. This API supports CORS which enables cross-domain data transfers.

  • Retrieve agent activity data per region and review agent utilization using the Data Access API. The brand can integrate the data with specific regional information from their workforce management system. This API is based on the REST architecture style and supports the HTTPS GET protocol (data retrieval), all retrieved data is returned in JSON format.

  • Search, filter and keep copies of chat transcripts and related data, for example surveys, using the Engagement History API. You can integrate and further analyze this data with third-party tools like DWH and CRM systems. This API is based on the REST architecture style.

  • Retrieve the most up-to-date information available about contact center messaging interactions using the Messaging Interactions API. This API makes it possible to search, filter and analyze data and transcripts of open and closed conversations. This API supports the HTTP POST functionality (data retrieval), and all data is returned in JSON format.

  • Comply with the GDPR and permanently delete any personal data that the consumer requests to be deleted using the Personal Data Deletion API. Once the data has been deleted there is no way to restore it. This API is not meant for massive deletion of data, there is an internal mechanism which will protect the system from such misuse of the API.

Build or integrate workspace widgets

You can integrate your application with the LiveEngage Agent Workspace using the Agent Workspace Widget SDK, which is a lightweight, client-side communication package. The Agent Workspace Widget connects with visitors and handles multiple concurrent connections from one central console, by opening applications directly within the Agent Workspace.

When you implement this SDK, and its APIs, you can achieve two-way communication between LiveEngage and external applications. This allow you to receive more in-depth information about your visitors, so you can assist them more effectively and efficiently. Brands can also send conversation lines directly from the application, and develop the ability to transfer the conversation transcript automatically to the external application.

You can also use the Engagement Window Widget SDK with the Agent Workspace Widget SDK. This allows sharing of rich media between the customer and the agent. An external platform facilitates a direct connection between the two SDKs using unique session IDs, providing a seamless widget integration framework.

Major Flows

These "flows" demonstrate how specific APIs work with and inform other APIs. The three APIs listed below are essential for working with our platform. For example, if you're looking to use the Messaging Window API to rebuild our engagement window, you could also employ the Monitoring API listed below to track visitors, pass information about them to the agent and update their information depending on the conversation's result. Similarly, if you're looking to build custom applications, you'll need to authenticate them using our Authentication methods.

These are just some of the uses for these APIs. Since they provide entry points into our platform or the ability to more closely track and maintain visitor information, they have numerous use cases when used in conjunction with our other APIs.

Accessing LivePerson APIs

Some of our APIs require authorization before you can use them. This is done via either of the following methods: 1) common oAuth2.0 scenarios for web server applications. 2) server to server authrization via either a) API Key which uses the OAuth 1.0 methodology or b) oAuth2.0 for server to server interations. Every API uses either of the two methods (or both), as listed in its overview


The Monitoring API enables consumer monitoring and engagement flows. When you combine monitoring capabilities with our Campaigns feature, you display tailored engagements to the right consumer at the right time. If you're looking to build your own customized mobile experience in conjunction with our other APIs, you can enrich those APIs with monitoring. If you're already using other LivePerson APIs to build custom solutions, you'd need to work with this API directly to enable communication with those custom solutions.