Before connecting your Livekit voice agent, ensure you have an active Livekit account and access to your API credentials. You will also need to create a Hamming voice test agent. For a detailed guide on creating scenarios and configuring your voice agent, refer to the Voice Agent Tutorial.

Important: Make sure your agent is able to respond to other rtc.ParticipantKind.PARTICIPANT_KIND_AGENT participants.

​
Before You Get Started

To set up and run a Livekit voice agent, you’ll need:

  • Your Livekit WebSocket URL
  • Your Livekit API Key and Secret

​
Step-by-Step Setup

1

Configure Livekit Credentials

Navigate to the Settings page in your Hamming dashboard and locate the Livekit Configuration tab. Enter your Livekit credentials:

  • WebSocket URL
  • API Key
  • API Secret

These credentials will be used to authenticate your Livekit integration.

2

Set Up Livekit Webhook

To enable call monitoring and scoring, you need to set up a webhook.

  1. Log in to your Livekit dashboard
  2. Navigate to Webhook settings
  3. Add a new webhook with the following URL: 
    https://app.hamming.ai/webhook/livekit
3

Start a Livekit Call

  1. Open the New Test Run dialog in your voice agent page
  2. Switch to the Livekit tab
  3. Your Livekit configuration will be pre-filled
  4. Click “Run Scenarios” to initiate a Livekit session

Your call will be automatically monitored and scored.

Github Actions TutorialVoice Agent Call Monitoring