> ## Documentation Index
> Fetch the complete documentation index at: https://chatbase.co/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Settings

Open an AI agent and click **Settings** in the sidebar. The page has seven tabs: **General**, **Email**, **Helpdesk**, **Custom fields**, **Custom domains**, **Webhooks**, and **Notifications**. Voice has its own page under **Build**. See [Voice](https://chatbase.co/docs/user-guides/chatbot/voice.md).

## General

The **General** tab has three cards: **Agent details** (Agent ID, Size, Name), **Credits limit**, and **Danger zone** (Delete all conversations, Delete AI agent).

![Agent Details](https://mintcdn.com/chatbase/P4P4lN52AUAJVwNj/user-guides/chatbot/images/settings/agent-details.png?fit=max\&auto=format\&n=P4P4lN52AUAJVwNj\&q=85\&s=0ea8178fa2db3d3f1fbfc765bf9a6ca3)

In the **Credits limit** card, enable **Set credits limit on AI agent** to cap how many of the workspace’s credits this AI agent can consume.

![Credits limit](https://mintcdn.com/chatbase/P4P4lN52AUAJVwNj/user-guides/chatbot/images/settings/credits-limit.png?fit=max\&auto=format\&n=P4P4lN52AUAJVwNj\&q=85\&s=e77eacd12e8ce51e7039d5d59b1bc828)

***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](https://mintcdn.com/chatbase/P4P4lN52AUAJVwNj/user-guides/chatbot/images/settings/danger-zone.png?fit=max\&auto=format\&n=P4P4lN52AUAJVwNj\&q=85\&s=d728d708e44a678d30beb4b129ce3b22)

## Email

The **Email** tab has two cards:

* **Agent email address** - your AI agent's dedicated `agent@….chatbase-mail.com` address for receiving and replying to customer emails, with a copy button next to it.
* **Email configuration** - the addresses on your own domains that send and receive email. Click **New email address** to add one. Existing addresses are listed under their domain, with the domain's authentication status, each address's **Automatic forwarding** status, and edit and delete icons per row.

See [Email settings](https://chatbase.co/docs/user-guides/chatbot/email-settings.md) for the full setup walkthrough.

## Helpdesk

The **Helpdesk** tab has its own sub-navigation. Each entry opens the settings for one part of your Helpdesk:

* **Email** - the address that receives tickets and sends replies, and who is alerted about delivery failures. See [Email sub-tab](#email-sub-tab) below.
* **Members** - every AI agent with their teams and availability status. See [Assignment algorithm](https://chatbase.co/docs/user-guides/chatbot/help-desk/assignment-algorithm.md#agent-availability).
* **Teams & assignment** - create teams and set each team's auto-assignment rules. See [Teams](https://chatbase.co/docs/user-guides/chatbot/help-desk/teams.md).
* **Scheduling** - shifts, AI agent schedules, and time off. See [Scheduling](https://chatbase.co/docs/user-guides/chatbot/help-desk/scheduling.md).
* **Triggers** - automation rules that run when tickets are created or updated. See [Triggers](https://chatbase.co/docs/user-guides/chatbot/help-desk/triggers.md).
* **Ticket statuses** - add your own statuses alongside the built-in ones. See [Helpdesk overview](https://chatbase.co/docs/user-guides/chatbot/help-desk/help-desk-overview.md).
* **Tags** - define the labels your team applies to tickets. See [Tags](https://chatbase.co/docs/user-guides/chatbot/help-desk/tags.md).
* **Translation** - detect and translate customer messages automatically. See [Translation](https://chatbase.co/docs/user-guides/chatbot/help-desk/translation.md).
* **AI draft replies** - generate suggested responses that AI agents review before sending. See [AI draft replies](https://chatbase.co/docs/user-guides/chatbot/help-desk/ai-draft-replies.md).

### Email sub-tab

The **Email** sub-tab opens on the **Configuration** card, which controls which addresses receive and create support tickets:

* **Helpdesk email address** - the address tickets arrive at and replies are sent from. Until you add your own domain, this is the auto-generated Chatbase address (`agent@….chatbase-mail.com`), shown with a copy button next to it. Click **Configure email settings** to add and verify your own domain so replies come from your email instead. Once you have verified addresses, this card lets you pick one or more of them as Helpdesk inboxes. See [Email settings](https://chatbase.co/docs/user-guides/chatbot/help-desk/email-settings.md).
* **Deliverability alert contact** - the team member who is notified when outgoing Helpdesk emails bounce or fail to deliver. Defaults to **None**, in which case nobody is alerted.

Click **Save** to apply your changes. Below the Configuration card are three more cards, each with its own **Save** button:

* **Display name** - the name recipients see in the "From" field: the responding support associate's name, or a custom name. See [Display name](https://chatbase.co/docs/user-guides/chatbot/help-desk/email-settings.md#display-name).
* **Signature** - a rich-text signature appended to every email your Helpdesk sends. See [Email signature](https://chatbase.co/docs/user-guides/chatbot/help-desk/email-settings.md#email-signature).
* **Preview** - a sample email showing how the sender name, address, and footer will look to recipients. See [Preview](https://chatbase.co/docs/user-guides/chatbot/help-desk/email-settings.md#preview).

## Custom fields

The **Custom fields** tab lists the details your AI agent collects from customers, such as an order number or a company size. Define a field once, then add it to the actions that should ask for it.

* **Built-in fields**: **Subject** and **Description** are always available and can't be edited or archived.
* **Your fields**: Click **New field** to add one. Each row shows the field's name, description, and type, with edit and archive icons.
* **Archived**: Archived fields are kept for history, and data already collected stays intact.

See [Custom fields](https://chatbase.co/docs/user-guides/chatbot/help-desk/custom-fields.md) for field types, collecting fields on tickets, and archiving.

## Custom domains

White label the embed script so it loads from a domain you own instead of a Chatbase URL. See [Custom domains](https://chatbase.co/docs/developer-guides/custom-domains.md).

## Webhooks

The **Webhooks** tab POSTs AI agent events and Helpdesk trigger notifications to your own endpoints. It has two cards:

### Event webhooks

Fires a POST when a subscribed event occurs. Today the available events are [custom form](https://chatbase.co/docs/developer-guides/website-integration/client-side-custom-forms.md) submissions, so the **Events** list is empty until you create and enable at least one custom form Action.

1. Under **Events**, tick the form submissions you want to listen for.
2. Enter the URL that receives them in **Endpoint**.
3. Click **Create webhook**.

Each webhook you create is listed below the form with its endpoint and subscribed events. Use the **⋯** menu on a row to edit or delete it.

When a user submits a subscribed form, Chatbase sends a POST request containing the form data to your endpoint. Use it to integrate with third-party services, store submissions in your own systems, or trigger custom business logic. See [Webhooks integration](https://chatbase.co/docs/developer-guides/website-integration/client-side-custom-forms.md#webhooks-integration) for the payload.

> [!NOTE]
>
> Webhooks for collected leads and collected data are not configured here. Open the Action itself and use its **Destinations** section. See [Collect Leads](https://chatbase.co/docs/user-guides/chatbot/actions/collect-leads.md#webhooks).

### Helpdesk webhooks

Reusable connections that Helpdesk [Triggers](https://chatbase.co/docs/user-guides/chatbot/help-desk/triggers.md#send-webhook) POST to when their conditions match. Click **Create webhook** on the card and set the endpoint URL, optional custom headers, and a request body template (insert ticket fields with `{{ticket.*}}` placeholders). When you create one, Chatbase shows a signing **secret** once - every delivery carries an `X-Chatbase-Signature` header your endpoint can verify with it.

Existing connections are listed on the card, where you can edit or delete them. To actually send a webhook, pick the connection in a trigger's **Send webhook** action.

![Webhooks configuration](https://mintcdn.com/chatbase/ySX-DcFanyEg0V4A/user-guides/chatbot/images/settings/webhooks-configure.png?fit=max\&auto=format\&n=ySX-DcFanyEg0V4A\&q=85\&s=27f84541890be70f647f331662e01b8c)

## Notifications

From this page, you can configure the notifications you get from the AI 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](https://mintcdn.com/chatbase/P4P4lN52AUAJVwNj/user-guides/chatbot/images/settings/notifications-preferences.png?fit=max\&auto=format\&n=P4P4lN52AUAJVwNj\&q=85\&s=51ac706410d7c8ed66b2155955cc65fb)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.