> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cognigy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Set up a Cognigy.AI Endpoint for Handover

> Configure a Live Agent Endpoint for Live Agent in Cognigy.AI to hand over conversations from AI Agents to humans.

<Warning>
  Live Agent has been put in maintenance mode. The product will continue to be maintained in the foreseeable future. Users can continue to fully rely on Live Agent being available. In future releases, only security updates and bug fixes will be provided; no new features will be released.
</Warning>

When you create a new Agent in Cognigy.AI you are prompted to select an Endpoint. You can select, for example, **Cognigy Webchat** as a specific Endpoint to the Cognigy.AI platform.
For more information, see [Endpoints](https://docs.cognigy.com/ai/endpoints/overview/).

If you want to integrate a Handover process in your Flow, you need to configure your Endpoint for Handover.

## Prerequisites

Before setting up the Endpoint, check whether these steps are done:

* [Live Agent is set up for your Organization](/live-agent/getting-started/live-agent-setup/live-agent-setup-org)
* [The Inbox is created for your Live Agent account](/live-agent/getting-started/live-agent-setup/live-agent-setup-inbox)

## Handover Configuration

To configure the Handover Settings of your Endpoint, follow these steps:

1. In the left-side menu of the Cognigy.AI interface, select **Deploy > Handover Providers**.
2. Click **+ New Handover Provider** and select **Live Agent**.
3. Enter a unique name and click **Save**.

To configure your Live Agent handover, you have two options:

<AccordionGroup>
  <Accordion title="Handover to pre-configured Live Agent">
    If the **Handover to pre-configured Live Agent account** option is activated, conversations will be transferred to the Live Agent account mapped to the current Cognigy.AI organization.

    For on-premises installation, make sure the following environment variables are set in the [value.yaml](https://github.com/Cognigy/cognigy-ai-helm-chart/blob/main/values.yaml) configuration file.

    ```txt theme={null}
    FEATURE_USE_COGNIGY_LIVE_AGENT: true
    COGNIGY_LIVE_AGENT_API_BASE_URL_WITH_PROTOCOL: <https://sub-domain.domain.com>
    COGNIGY_LIVE_AGENT_PLATFORM_TOKEN: <app-platform-token>
    ```
  </Accordion>

  <Accordion title="Handover to manually configured Live Agent">
    To configure your Live Agent manually, follow these steps:

    1. In the handover provider settings, deactivate the **Handover to pre-configured Live Agent account** option.
    2. Enter the **Base URL** for the Live Agent instance. The Base URL is your Live Agent installation URL, extended by `/api/v1`. For example, in the Live Agent trial environment `https://liveagent-trial.cognigy.ai/api/v1` is the Base URL where `https://liveagent-trial.cognigy.ai` is the Live Agent URL.
    3. Enter the **Account ID** and the **API Key**. How to find the **Account ID** and the **API Key**, see sections below.
    4. Click **Save** to confirm your Live Agent settings.

    Your Live Agent has been configured.
  </Accordion>
</AccordionGroup>

## Find an Account ID

You can find the account ID in the Live Agent URL of your Live Agent **Inbox**.

To locate the ID, follow these steps:

1. Open your Live Agent account and go to **Settings > Inboxes**.
2. In the Inboxes list, find the Inbox of your project, and click the **Settings** icon next to the Inbox.
3. The Inbox settings will be displayed, and you will see the address line of your browser as follows: `https://liveagent-<your-environment>/app/accounts/<account-id>/settings/inboxes/<inbox-id>`. For example, in the URL `https://liveagent-dev.cognigy.ai/app/accounts/2/settings/inboxes/32852`, the account ID is 2.

<Frame>
  <img src="https://mintcdn.com/cognigy-15abf2ba/rezpWdJbiRsaPXbT/_assets/live-agent/getting-started/LA_Inbox_URL.png?fit=max&auto=format&n=rezpWdJbiRsaPXbT&q=85&s=e00e18a678952c1551fa7c68efca70c8" alt="Live Agent browser URL highlighting the account ID in the Inbox settings" style={{ width: 'auto' }} width="1139" height="808" data-path="_assets/live-agent/getting-started/LA_Inbox_URL.png" />
</Frame>

When you have found the account ID, you can enter it in the **Handover Settings** of your Endpoint in Cognigy.AI.

## Find API Keys

1. Click the **Profile Settings** icon of your account in the bottom-left corner of the Live Agent dashboard, then select **Profile Settings** in the selection menu.
2. Find the **Access Token** section, showing your API Key.
3. Copy the API Key and paste it into the **API Key** field in the **Live Agent Authentication** section of your handover provider settings in Cognigy.AI.

## What's Next?

When the Endpoint is configured, [set up your Flow for Handover to Live Agent](/live-agent/getting-started/live-agent-setup/live-agent-setup-handover-flow)