Skip to content
Last updated

LiveChat integration

LiveChat is a customer service platform that helps teams manage real-time chat support, agents, and customer interactions. Integrating LiveChat with Frontegg allows your application to access chat data — including conversations, agents, and customers — on behalf of your users through OAuth 2.1 authentication.


Prerequisites

Connect LiveChat

Step 1: Sign in to the Text developer console

Navigate to platform.text.com/console and sign in with your LiveChat account. You can use Google, Microsoft, Apple, or email and password authentication.

Text developer console sign-in page

Step 2: Open the developer console

After signing in, you land on the Text Platform homepage. Under Develop your own solution, click Build an app to open the developer console.

Text Platform homepage with Build an app button highlighted

Step 3: Create a new app

In the developer console, click Create new app. On the Create a new app form, fill in the following:

  • App Name — Enter a name for your application, for example Frontegg Integration.
  • Product — Select LiveChat.

Click Create app to continue.

Create a new app form with Frontegg Integration name entered

Step 4: Open the App Authorization block

After the app is created, you land on the app overview page showing the App creation process steps. Click Configure Authorization or select App Authorization in the left sidebar under Blocks.

LiveChat app overview page with Configure Authorization step

Step 5: Select the client type

On the App Authorization page, set the Client type to Server-side app (backend, eg. Node, PHP). This is required for server-side OAuth flows used by the Frontegg integration.

App Authorization page with Server-side app selected as client type

Step 6: Copy your credentials

On the same page, locate the following credentials:

  • Client Id — Your app's unique identifier used to initiate OAuth flows.
  • Client Secret — Used to exchange authorization codes for access tokens. Copy and save this value now — it will not be shown again after you leave this page.

Keep your credentials secure

Never share or commit your Client Secret to version control.

App Authorization page showing Client Id and Client Secret fields

Step 7: Configure redirect URIs

Under Redirect URI whitelist, add the Frontegg callback URL by entering each one in the input field and clicking Add:

  • https://YOUR_MCP_GATEWAY_URL/integration-callback

App Authorization page with the redirect URI configured

Step 8: Configure OAuth scopes

Under App scopes and API access, use the Select scopes dropdown to add the scopes your integration requires:

ScopeDescription
agents--my:roRead my profile configuration
agents--my:rwUpdate my profile configuration
agents--all:rwUpdate any agents' profile configuration
chats--my:roRead my chats
chats--my:rwUpdate my chats metadata
chats--all:rwUpdate any chats metadata
customers:roRead customers
customers:rwAdd and update customers
webhooks--my:rwAdd and delete my webhooks configuration

Minimum required scopes

For basic chat functionality, you need: agents--my:ro, chats--my:ro, customers:ro.

Click Save changes to apply.

App Authorization scopes configuration with all scopes selected

Configure the Frontegg portal

Once you have obtained your Client Id and Client Secret from the steps above, enter them in the integration configuration page of the Frontegg portal:

  1. Open the Frontegg portal and navigate to [ENVIRONMENT] → Integrations → LiveChat.
  2. Enter the Client Id and Client Secret in the corresponding fields.
  3. Select the required scopes.
  4. Click Save.

Additional resources