Skip to main content
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.
When you create a new agent in Cognigy, you’re prompted to select an endpoint. For example, you can select Cognigy Webchat as a specific endpoint to the Cognigy platform. For more information, see Endpoints. If you want to integrate a handover process in your flow, you need to configure a handover provider.

​
Prerequisites

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

​
Handover configuration

To configure the handover settings, follow these steps:
  1. In the navigation menu of your project, 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:
If the Handover to default Live Agent account option is activated, conversations will be transferred to the Live Agent account mapped to the current Cognigy organization.For on-premises installation, make sure the following environment variables are set in the value.yaml configuration file.
To configure your Live Agent manually, follow these steps:
  1. In the handover provider settings, deactivate the Handover to default 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. To find them, see the following sections.
  4. Click Save to confirm your Live Agent settings.
Your Live Agent has been configured.

​
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’ll 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.
Live Agent browser URL highlighting the account ID in the inbox settings
When you have found the account ID, you can enter it in the Account ID field of your handover provider settings in Cognigy.

​
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.

​
What’s next?

When the handover provider is configured, set up a Cognigy flow for handover
Last modified on November 11, 2026