> ## 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.

# AI agent settings: general, email, Helpdesk, domains, and webhooks

> Configure your AI agent's general details, credit limit, email, Helpdesk, custom fields, custom domains, webhooks, and notifications.

AI agent settings are the per-agent options in Chatbase for an AI agent's name and credit cap, its email addresses, Helpdesk configuration, custom fields, custom domains, webhooks, and daily email notifications. This is also where you delete all conversations or delete the AI agent itself. Workspace-wide settings, such as members and billing, live in your workspace settings instead.

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)

### Credits limit

The **Credits limit** card sets the "Maximum credits to be used by this agent from the credits available on the workspace." Turn on **Set credits limit on agent** and enter the cap. Use it to stop one AI agent from using up the credits your other AI agents need.

When the AI agent reaches its limit, it stops replying, and visitors see: "This chatbot is currently unavailable. If you are the owner please check your account". Raise or remove the limit to bring it back.

Workspaces billed per conversation don't see this card.

![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 in this section aren't reversible. Once you delete the AI agent or its conversations, you can't retrieve them.

![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)

#### Delete all conversations

**Delete all conversations** removes every conversation from the AI agent's **Activity > Conversations** page. Deleted conversations are permanently erased once they're 30 days old, counted from when each conversation started. Your role needs permission to delete conversations.

| Kept | Deleted |
| - | - |
| Helpdesk tickets | Conversations and their messages |
| Leads and collected data | Topic assignments |
| Knowledge gaps | WhatsApp, Messenger, and Instagram thread records |
| Procedure runs | |

Kept items are no longer linked to the deleted conversation.

#### Delete AI agent

**Delete AI agent** permanently deletes the AI agent. To confirm, type "I understand" in the dialog. There's no recovery window.

Deleting an AI agent also deletes:

* Conversations, [contacts](https://chatbase.co/docs/user-guides/chatbot/contacts/contacts-overview.md), and contact custom attributes
* Helpdesk tickets and their messages
* [Tests](https://chatbase.co/docs/user-guides/chatbot/tests.md) and test runs
* Sources, Actions, Procedures, and webhooks
* [Backstage](https://chatbase.co/docs/user-guides/chatbot/backstage.md) sessions and scheduled audits
* WhatsApp connection records. Phone numbers connected to the AI agent are disconnected.

The AI agent's past credit use still appears in [Usage](https://chatbase.co/docs/user-guides/workspace/usage.md) under **Deleted agents**. Its slot is freed right away, so you can create a new AI agent immediately.

If your role doesn't allow deleting agents, the button shows "You do not have permission to delete agents".

## 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).
* **Ticket reuse** - add a customer's new emails and chats to the ticket they already have open. See [Ticket reuse](https://chatbase.co/docs/user-guides/chatbot/help-desk/ticket-reuse.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 added to the replies your teammates send by email. Trigger emails don't include it. 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

The **Notifications** tab has a **Preferences** card to "Customize how and when you receive notifications about new leads and conversations from your agent." It has two toggles:

* **Receive email with daily leads**: one email a day with the leads submitted the previous day, attached as a CSV file.
* **Receive email with daily conversations**: one email a day with the previous day's conversations, attached as a PDF.

You can add multiple email addresses to receive each email.

![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)

> [!NOTE]
>
> Daily conversations and leads emails are not available for HIPAA accounts.

## Frequently asked questions

> [accordion] Can a deleted AI agent be restored?
>
> No. Deleting an AI agent is permanent, and there's no recovery window. Its conversations, contacts, Helpdesk tickets, Tests, sources, and Actions are deleted with it.

> [accordion] Does deleting an AI agent free up a slot on my plan?
>
> Yes, right away. Your AI agent count only includes agents that exist now.

> [accordion] Does Delete all conversations also delete Helpdesk tickets and leads?
>
> No. Tickets, leads, collected data, and knowledge gaps are kept, but they're no longer linked to the deleted conversations.

> [accordion] What do visitors see when the AI agent hits its credits limit?
>
> The chat stops with "This chatbot is currently unavailable. If you are the owner please check your account". Raise or turn off the limit in **Settings > General** to restore it.

> [accordion] Why don't I get the daily conversations email?
>
> Check that **Receive email with daily conversations** is on and your address is listed. HIPAA accounts don't receive daily conversations or leads emails.


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