## 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
- A LiveChat account with admin access
- Access to the [Text Developer Console](https://platform.text.com/console)


### Connect LiveChat

#### Step 1: Sign in to the Text developer console

Navigate to [platform.text.com/console](https://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](/assets/livechat-1.c8eb298f2f30f2b9aa4cc0520084493b082f4bb7e4a322d3da037e2d78f4786e.1ce25488.png)

#### 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](/assets/livechat-2.69bc32354b6b6db33f07d767a37f6dd16ce1e5c0dc488c1a93cd4a5b17ef4c3d.1ce25488.png)

#### 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](/assets/livechat-3.219f3c4463b06d1a08491c5b5a0f3c0f3540a3703aba473fabfc4e59fa31ba5b.1ce25488.png)

#### 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](/assets/livechat-4.76d77ff8517b114a8d0ad99a3992c2eb7a6767f37a7cf4c54f725e6dfec1981c.1ce25488.png)

#### 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](/assets/livechat-5.29bf1e1c3ce684953cf031dd26475e5db5203c276eabbc58464586223192f8f0.1ce25488.png)

#### 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](/assets/livechat-6.4ea3b310220e9c06ae1a92ccb744f12d4999cdb4663690f024a7a5f5e865a047.1ce25488.png)

#### 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](/assets/livechat-7.5e91665438e548c01b1ac01caa3afed32c5cd970063b1527d3eef37370c94a3f.1ce25488.png)

#### Step 8: Configure OAuth scopes

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

| Scope | Description |
|  --- | --- |
| `agents--my:ro` | Read my profile configuration |
| `agents--my:rw` | Update my profile configuration |
| `agents--all:rw` | Update any agents' profile configuration |
| `chats--my:ro` | Read my chats |
| `chats--my:rw` | Update my chats metadata |
| `chats--all:rw` | Update any chats metadata |
| `customers:ro` | Read customers |
| `customers:rw` | Add and update customers |
| `webhooks--my:rw` | Add 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](/assets/livechat-8.5bd18f84f8834e2170d91de5845e2a35865cff88cd117a339b4ad767f96fd71a.1ce25488.png)

### 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

- [LiveChat API documentation](https://developers.livechat.com/docs/messaging/)
- [Text OAuth 2.1 guide](https://platform.text.com/docs/authorization/)
- [Text Developer Console](https://platform.text.com/console)
- [How to get your Redirect URL](/agen-for-work/connectors/redirect-url)