Skip to main content
Open an agent and click Settings in the sidebar. The page has eight tabs: General, Voice, Email, Helpdesk, Security, Custom domains, Webhooks, and Notifications.

General

The General tab has three cards: Agent details (Agent ID, Size, Name), Credits limit, and Danger zone (Delete all conversations, Delete agent).
Agent Details
In the Credits limit card, enable Set credits limit on agent to cap how many of the workspace’s credits this agent can consume.
Credits limit
DANGER ZONE The actions done in the section aren’t reversible. If you deleted the AI agent or the conversations, you can’t retrieve them moving forward.
DANGER ZONE

Voice

This section allows you to configure how your AI agent sounds and behaves during voice conversations.

Credit Usage

Voice sessions consume credits based on two components:
  • Agent voice: Every voice session consumes 6 message credits per minute. This is a per-minute cost regardless of the actual messages exchanged.
  • AI model: Each response from the AI agent during a voice session consumes message credits based on the model used, just like in text conversations. See the full list of models and their message credit costs.
The total credit cost of a voice session is the sum of both components.
Voice model settings
Suppose your voice agent uses GPT-5.1 (1 message credit per request).If a user has a 10-minute voice call with 15 AI requests:

Voice Model

Select the AI model used specifically for voice sessions. This model is separate from the one used for text-based conversations and only applies when users interact with your AI agent through voice. You can also adjust the Temperature to control how creative or reserved the AI agent’s responses are during voice conversations.
Voice model settings

Transcriber

Choose the model used to transcribe user speech during voice conversations.
Voice transcriber settings
  • Language: The language used to transcribe user speech. Select Multilingual (auto-detect) to let the transcriber detect the language automatically, or pick a specific language to improve accuracy.
  • Model: The speech-to-text model that converts user audio into text. Each model supports a different range of languages.
  • Silence Threshold: Seconds of silence before the AI agent considers the user has finished speaking. Lower values switch turns faster but may cut off pauses mid-thought.
  • Noise Sensitivity: Controls how loud audio must be to count as speech. Lower values pick up quieter speech but are more sensitive to background noise. Higher values filter out noise but may miss soft-spoken users.

Agent Voice

Choose a voice for your AI agent and fine-tune how it sounds during voice conversations.
Voice agent voice settings
Click on the voice selector to open the voice picker, then fine-tune how the selected voice sounds. The available controls depend on the voice you picked, some voices expose sliders such as speed, stability, and similarity, while others let you describe the desired delivery. A few examples:
  • Speed: Controls how fast or slow the AI agent speaks. Adjust the slider between slower and faster to match your preferred pace.
  • Stability: Determines how stable the voice is. Lower values introduce a broader emotional range, while higher values produce a more consistent, monotone delivery with limited emotion.
  • Similarity: Determines how closely the AI adheres to the original voice when replicating it. Higher values result in a closer match to the selected voice.
  • Voice instructions: For voices that support it, enter a short prompt describing the tone, style, or dialect you want the AI agent to use when speaking.
Make sure to click Save on the voice card to apply your changes.

Selecting a voice

The voice picker has two tabs: All voices for browsing pre-recorded voices, and Custom voice for bringing a custom voice from a supported provider.
Voice selection modal
Under All voices, you can search by name and filter voices by language, accent, age, and gender. Each row shows the voice’s supported languages and a Preview language dropdown, pick a language and click the play button to hear a sample of the voice speaking it. Select a voice and click Confirm voice to apply it to your agent.
Custom voice selection modal
Under Custom voice, you can add a custom public voice that isn’t in the pre-recorded list by referencing it directly from your provider:
  • Provider: The voice provider that hosts the custom voice (for example, ElevenLabs).
  • Voice ID: The identifier of the voice in the provider’s account. Paste it in and click Add voice to make it available for selection, then click Confirm voice to apply it to your agent.
Custom voices only work with publicly available shared voices from your provider. Private voices in your provider account are not supported.

Using Dialects and Regional Accents

Some voices support custom dialects and accents through Voice Instructions. Look for voices marked with the ✨ sparkle icon. These voices can adapt their accent, dialect, pacing, and speaking style based on the instructions you provide.
Voices Sparkle
After selecting the desired voice, in the Instructions field, describe how you want the voice to sound. Recommended Settings
  • Transcriber: Soniox
  • Voice LLM: GPT-5.4 Mini or Gemini 3.5 Flash

Messages

Configure the initial greeting and error messages for your voice agent.
Voice messages settings
  • Initial message: The first message the AI agent speaks when a voice session begins. If left empty, the voice agent will wait for the user to speak first.
  • Error message: The message played if the voice session encounters an error. If left empty, the default error message “The voice session encountered an error. Please try again.” will be used.

Session Configurations

Control how the AI agent handles interruptions, silence, and text input during active voice calls.
Voice session configurations settings
  • Allow interruptions: When enabled, users can speak over the AI agent to interject mid-response. Disable this if you’d prefer the agent to always finish speaking before listening for the user’s next turn. Defaults to enabled.
  • End conversation after silence: The number of seconds of inactivity after which the call is automatically ended. Useful for closing out abandoned sessions and avoiding unnecessary credit usage. Defaults to 300 seconds.
  • Allow text input during voice calls: When enabled, users can type messages mid-call alongside speaking. Helpful for entering details that are easier to type than to say, such as names, emails, or URLs. Defaults to disabled.

Recordings

Enable recording of voice sessions for quality review and training purposes. You can also toggle Retain voice recordings forever to keep recordings indefinitely, or set a custom retention period.
Voice recordings settings

Limits

Control session volume and duration to manage costs and performance.
Voice limits settings
  • Max no. of concurrent voice sessions: The maximum number of voice sessions that can run at the same time. If left empty, your plan’s default limit will apply.
  • Max call duration: The maximum length of a single voice call in minutes. The default is 15 minutes.
  • Allowed no. of daily calls: The total number of voice calls allowed each day. If left empty, your plan’s default limit will apply.
Your subscription plan enforces account-level limits for daily sessions and concurrent sessions across all your AI agents. You can set agent-specific limits here to further restrict usage for individual agents.

Email

The Email tab holds your agent’s dedicated Agent email address and the Email configuration card, where you add and verify the addresses used to send and receive mail. See Email settings.

Helpdesk

The Helpdesk tab has its own sub-navigation: Email, Members, Teams, Scheduling, Team routing, Ticket statuses, Translation, and AI draft replies. See Helpdesk.

Security

The Security tab holds a single Rate limit card. Use it to cap how many messages one device can send to your agent through the chat bubble and iframe over a chosen time period, which helps prevent abuse. Set Limit to N messages every N seconds, and write the Message to show when limit is hit.
Rate limiting
The rate limit applies to your agent on your own site, not to you when testing from chatbase.co. To restrict which domains your agent can load on, see Allowed Domains under Channels.

Custom domains

White label the embed script so it loads from a domain you own instead of a Chatbase URL. See Custom domains.

Webhooks

The Webhooks tab has three cards: Configure (click + Create webhook), Events (tick the events to listen for), and Endpoints (the URL that receives them). Existing endpoints are listed below with the events each one subscribes to.
Webhooks configuration
The webhook sends a POST request to your chosen endpoint, which you can use to automate workflows with third-party tools.
Lead submission webhooks are configured on the action itself, not here. Open your Collect Leads action and use its Webhooks tab. See Collect Leads.

Notifications

From this page, you can configure the notifications you get from the agent. You can either opt for getting one email per day that contains all the leads submitted for that day. You can also opt for another email that sends you a daily email with the conversations done on that day.  You can add multiple email addresses to receive these emails if needed.
Notifications - Receive emails with your daily leads and conversations

Webhooks 

On this page, you can configure webhooks that are triggered when a Custom Form is submitted. When a user completes and submits a Custom Form in your agent, Chatbase automatically sends a POST request to your configured webhook endpoint containing the submitted form data. You can use this webhook to integrate with third-party services, automate workflows, store submissions in your own systems, or trigger custom business logic whenever a form is submitted.