Prerequisites
Before setting up the Endpoint, check whether these steps are done:Handover Configuration
To configure the Handover Settings of your Endpoint, follow these steps:- In the left-side menu of the Cognigy.AI interface, select Deploy > Endpoint.
- Click +New Endpoint.
- In the New Endpoint window, add an Endpoint name and select your AI Agent Flow that hands you over to a human agent.
- In the Endpoint type list, select the Webchat Endpoint.
- Enter a unique name and click Save.
- Go to Handover Settings.
- Select Cognigy Live Agent from the Handover Platform list.
- You can use the pre-configured Live Agent Account for a Handover, which is mapped to the Cognigy.AI organization.
- You can manually configure the Live Agent handover by deactivating the Handover to pre-configured Live Agent account using the toggle switch.
Handover to pre-configured Live Agent
If the toggle switch for 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. If you have on-premises installation, set the following environment variables in your Cognigy.AI installation:Handover to Manually Configured Live Agent
To configure your Live Agent manually, follow these steps:- Open the Endpoint Editor and deactivate in field Handover Settings the Handover to pre-configured Live Agent account option using the toggle switch.
- Enter the Base URL for the Live Agent instance. The Base URL is your Live Agent installation URL, extended by
plus /api/v1
. For example, in the Cognigy Trial environmenthttps://liveagent-trial.cognigy.ai/api/v1
is the Base URL wherehttps://liveagent-trial.cognigy.ai
is the Live Agent URL. - Enter the Account ID and the API Key. How to find the Account ID and the API Key, see sections below.
- Click Save to confirm your Live Agent settings.
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:- Open your Live Agent Account and go to Settings > Inboxes.
- In the Inboxes list, find the Inbox of your project, and click the Settings icon next to the Inbox.
- 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 URLhttps://liveagent-dev.cognigy.ai/app/accounts/2/settings/inboxes/32852
, the Account ID is 2.

Find API Keys
- 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.
- Find the Access Token section, showing your API Key.
- Copy the API Key and paste it into the API Key field of your Endpoint in Cognigy.AI.