Genesys
Overview
This guide explains how to integrate ElevenLabs conversational AI agents with Genesys Cloud using the Audio Connector integration. This integration enables seamless voice AI capabilities within your existing Genesys contact center infrastructure over websocket, without requiring SIP trunking.
How Genesys integration works
The Genesys integration uses a native WebSocket connection through the Audio Connector integration:
- WebSocket connection: Direct connection to ElevenLabs using the Audio Connector integration in Genesys Cloud
- Real-time audio: Bidirectional audio streaming between Genesys and ElevenLabs agents
- Flow integration: Seamless integration within your Genesys Architect flows using bot actions
- Dynamic variables: Support for passing context and data between Genesys and ElevenLabs
Requirements
Before setting up the Genesys integration, ensure you have:
- Genesys Cloud CX license with bot flow capabilities
- Administrator access to Genesys Cloud organization
- A configured ElevenLabs account and conversational AI agent
- ElevenLabs API key
Setting up the Audio Connector integration
Create Audio Connector integration
-
Click “Add Integration” and search for “Audio Connector”, and click “Install”
-
Select the Audio Connector integration type
-
Provide a descriptive name for your integration
Configure authentication
-
Navigate to the Configuration section of your Audio Connector integration
-
In Properties, in the Base Connection URI field, enter:
wss://api.elevenlabs.io/v1/convai/conversation/genesys
-
In Credentials, enter your ElevenLabs API key in the authentication configuration
-
Save the integration configuration
Configuring your Genesys flow
Create or edit a flow
Open an existing inbound, outbound, or in-queue call flow, or create a new one where you want to use the ElevenLabs agent.
Add bot action
-
In your flow, add a “Call Audio Connector” action from the Bot category
-
Select your Audio Connector integration from the integration dropdown
-
In the Connector ID field, specify your ElevenLabs agent ID
Agent configuration requirements
Your ElevenLabs conversational AI agent must be configured with specific audio settings for Genesys compatibility:
Audio format requirements
- TTS output format: Set to μ-law 8000 Hz in Agent Settings → Voice
- User input audio format: Set to μ-law 8000 Hz in Agent Settings → Advanced
Supported client events
The Genesys integration supports only the following client events:
- Audio events: For processing voice input from callers
- Interruption events: For handling caller interruptions during agent speech
Other client event types are not supported in the Genesys integration and will be silently ignored if configured.
Session variables
You can pass dynamic context from your Genesys flow to your ElevenLabs agent using input session variables:
Setting up session variables
- In Genesys flow: Define input session variables in your “Call Audio Connector” action
- In ElevenLabs agent: These variables are automatically available as dynamic variables
- Usage: Reference these variables in your agent’s conversation flow or system prompts
Learn more about dynamic variables.
Example usage
Genesys Flow input session variable: customer_name = “John Smith”
ElevenLabs agent prompt: Hi {{customer_name}}, how can I help you today?
Output session variables from ElevenLabs agents back to Genesys flows are coming soon. This feature will allow you to capture conversation outcomes and route calls accordingly.
Limitations and unsupported features
The following tools and features are not supported in the Genesys integration:
Unsupported tools
- Client tool: Not compatible with Genesys WebSocket integration
- Transfer to number: Use Genesys native transfer capabilities instead
Troubleshooting
WebSocket connection fails
Verify that your API key is correctly configured in the Audio Connector integration and the ElevenLabs agent ID is correctly configured in the Connector ID field in your Architect flow. If there are any dynamic variables defined on your agent, they must be passed in as input session variables.
Session variables not working
Verify that input session variables are properly defined in your Genesys flow’s “Call Audio Connector” action and that they’re referenced correctly in your ElevenLabs agent using the {{variable_name}} syntax.