Skip to content

Understand the customer agent

Last updated: March 31, 2026

Available with any of the following subscriptions, except where noted:

Set up a customer agent powered by Breeze, HubSpot's AI, to automatically respond to customer questions using your existing content. This lets the rest of your support team focus on more complex cases.

Once assigned to your support channels, the customer agent will respond to customer questions with contextual knowledge and a conversational tone. For example, customers can ask the agent about product offerings or get help resetting their password.

Please note: you can manage AI feature access in your AI settings and configure what data is shared. Review HubSpot's AI Trust FAQs and AI Model Cards for detailed information on AI security controls, data use, and compliance.

Use cases

Generate reply recommendations

Please note: you do not need to deploy the customer agent to channels to use reply recommendations. Reply recommendations do not consume HubSpot credits.


Use the customer agent to generate AI-powered reply recommendations in help desk without deploying it to live channels.

The agent analyzes the conversation context, references your synced content, and generates suggested responses directly in the thread. Support reps can send the response as-is, edit it, or dismiss it. This is useful if your team handles a high volume of repetitive tickets, to improve response speed and consistency across answers, and if you prefer a set-up where human reps remain responsible for all customer communication.

For example, if your team frequently responds to refund-related inquiries, syncing your refund policy allows the agent to generate accurate, source-backed recommendations for reps to review before sending.

Handle customer queries

Deploy the customer agent to live channels, such as chat or email, to respond directly to customer inquiries. You can control which conversations the agent handles by assigning it to specific channels or using workflows to filter by criteria such as customer tier or issue type.

When deployed, the customer agent answers questions using synced content, performs configured actions (such as resetting a password or booking a meeting), and transfers conversations to a human agent when its confidence is low or escalation rules are met.

This setup is useful if your team wants the agent to handle common or repeatable inquiries while automatically routing more complex or sensitive cases to support reps.

Before you get started

Before you begin working with this feature, review the following requirements, limitations and considerations.

Please note: each HubSpot account supports only one customer agent. This agent can be assigned across multiple channels.

Permissions required Customer agent editor permissions are required to create, edit, and manage the customer agent.

Seats required An assigned seat is required to create, edit, and manage the customer agent.

Requirements

Before you can create and publish a customer agent, you must have:

Opt in to 28 days of free access

If you're setting up the customer agent for the first time, you can opt in to 28 days of free access. During the free access period, the customer agent does not use HubSpot Credits. Learn more about opting into 28 days of free access to the customer agent.

HubSpot credits

Understand credit limits

Deploying the customer agent to channels requires HubSpot Credits.

  • The agent consumes credits for each separate conversation.

  • Reopening a closed conversation does not consume additional credits.

  • Conversations automatically close after a period of inactivity:

    • Live chat, WhatsApp, Facebook Messenger, and Calling (BETA) conversations close after 24 hours of inactivity.
    • Email conversations close after 72 hours of inactivity.

Learn more about how customer agent uses HubSpot Credits.

Managing credit limits

If your credits run out, the agent will temporarily stop being assigned to new conversations across all connected channels until your next reset date or until you purchase more credits. New conversations are routed to a user or team based on your configured handoff process.

If you've purchased additional credit capacity packs, your credits may be automatically upgraded if your usage exceeds your current allotment. Learn more about automatic upgrades.

Manually pause the agent

You can manually pause the customer agent assignment by turning it off. Credits are not consumed while the agent is turned off. This can be useful when updating or reviewing content sources or making changes to the agent's configuration. Learn more about pausing the customer agent.

Understand customer agent behavior in chat

When the customer agent is assigned to a chat channel on your website, visitors can start a conversation with it. When the customer agent responds, they will see Powered by AI within the header of the chat widget.

Visitors can quickly engage by clicking on a prompt suggestion. Breeze will automatically detect the page a visitor is on and suggests three relevant questions based on synced content. If no page-specific content has been synced, it will instead display general prompts.

If the customer agent knows the answer, it will respond to the visitor and provide relevant sources. If the agent doesn’t know the answer, it'll ask the visitor to rephrase the question or transfer the conversation to a human agent. If the visitor doesn't reply within 24 hours, the chat will automatically close.

Learn more about setting up the customer agent.

Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.