How can I set up the Internal FAQ Assistant in HubSpot?

To set up the Internal FAQ Assistant in HubSpot, add it from your Breeze assistants list or the HubSpot AI/assistants area and select the Internal FAQ template. In the studio, give it a clear name and description, define which topics and teams it supports, and specify what it should not answer.

Then create Knowledge Vaults as its source of truth, upload your cleaned SOPs, PDFs, and internal documentation into themed vaults (for example, naming standards, lifecycle stages, deal processes), and connect them to the assistant.

Finally, test it from the HubSpot sidebar with real questions from your teams, refine the instructions if needed, and only then roll it out with a short internal announcement and a few example prompts.

Before your team can benefit from an internal FAQ assistant, you need a clear plan: what it should answer, which documents it can use, and how you will keep it accurate. This guide walks through the setup in HubSpot with Breeze and then shows concrete, low‑friction use cases your colleagues will adopt.

Table of contents:

• What is the Internal FAQ Assistant (and why use it)?
• Step-by-step setup of your Internal FAQ Assistant in HubSpot
• What's the Internal Assistant source of truth?
• What can I use the Internal FAQ Assistant for?

What is the Internal FAQ Assistant (and why use it)?

An internal FAQ assistant is an AI helper that answers employees’ questions based on approved internal documentation. It lives inside your CRM sidebar, uses curated knowledge (not the public web), and is controlled by admins, so answers stay accurate, consistent, and safe for everyday use across teams.

What it is

• A Breeze agent designed to answer internal questions for your team (not customers).
• When you add the assistant to your portal, it runs in the HubSpot sidebar (Breeze Assistant) and can also be used in other internal contexts, depending on how Breeze evolves.
• It uses knowledge vaults (curated collections of content) to answer questions reliably using your own documentation, rather than guessing.

Why use it

• Reduce repetitive “How do I…?” questions across sales, marketing, CS, and ops.
• Give new hires and non‑admins a safe way to learn internal processes.
• Keep answers aligned with your official documentation (KB, Notion/Confluence exports, PDFs, internal SOPs, etc.).
• Let admins control exactly which content is considered the source of truth.
  
  

Step-by-step setup of your Internal FAQ Assistant in HubSpot

Set up the Assistant by following these steps:

1. Install/open the Internal FAQ Assistant from the Breeze Marketplace listing.

1. On the main menu, go to Breeze Studio → Add an assistant
   
   
2. Choose Internal FAQ Assistant and on the next page, click Add.

Now you have already added the assistant to your Breeze Assistants.

2. Configure the agent in Breeze Studio:

Go to your Breeze Studio-> Assistants -> Configure. You can configure the assistant’s name and description (optional tweaks).

Behavior/instructions: give instructions to the agent on how it should answer and what topics it will cover.

1. • HubSpot Knowledge Vaults are specialized containers within the Breeze AI that store proprietary data, documents, and content, acting as a "source of truth" to provide AI agents with context-aware, accurate information. They enable Breeze to generate tailored insights, enhance automation accuracy, and leverage company-specific knowledge, like competitor data, product details, naming conventions or case studies, directly in CRM workflows.
     
     
   • Go to Breeze → Knowledge Vaults
     
     
     
      

1. • Click Create Knowledge Vault to pick and organize the internal content that can be used. You can add files, HubSpot content, and segments. Read more here.
     
     
     
      

      
2. Connect the vault(s) to the Internal FAQ Assistant.
   1. Once you create a Knowledge Vault, add it as the source of truth for your Internal FAQ Assistant. Go back to Breeze Studio-> Assistants -> Configure. Scroll to the last section, “Set the information this assistant can access”.
       
      On “What this assistant knows,” click Add knowledge. A slide-in window will appear where you can select available information from your portal and the “custom” knowledge vault you created.
      
      
      
      
   2. Click Add to set the vault you created as a source for the assistant. 
      
       

       

       

What's the Internal Assistant source of truth?

A powerful assistant starts with structured internal knowledge, not with clever prompts. Before setup, decide which documents are the “source of truth” for each topic and clean them up so the AI can read them clearly and consistently.

Start by listing your high‑friction questions: “How do I name workflows?”, “Which lifecycle stage should I use?”, “Where do I store webinar assets?” Then, locate the existing answers across your knowledge base, PDFs, slide decks, and internal wikis. Combine or update them into a small number of concise, clearly formatted documents.

Next, group those documents into themes that match real workflows: naming and folder structure, deal stages, data standards, and request processes. In HubSpot, you will later turn each theme into a Knowledge Vault or a collection inside a vault so you can connect the right content to the right assistant behavior.

Research on AI knowledge systems shows that adoption rises sharply when employees can trust that answers come from a maintained, transparent repository rather than from guesswork (AI-Powered Knowledge Vault Guide). That means assigning an owner to each document set and agreeing on a simple update cadence.

Finally, remove drafts and outdated files from the folders you plan to sync. If the assistant can read it, your team can see it in answers—so keep that input clean. 

What can I use the Internal FAQ Assistant for?

Well‑designed internal FAQ use cases make the assistant feel practical on day one. Instead of saying “Ask it anything,” give each team a short menu of examples that match their daily tasks and tools inside HubSpot - "ready prompts".

For marketing:

Start with naming conventions and campaign structure. A marketer might ask: “How should I name a Q4 webinar campaign for new leads in North America?” and the assistant replies with the correct pattern and folder path, turning a static naming PDF into a live helper. This mirrors real implementations where teams store naming standards in a vault and let the assistant translate them into concrete names.

For sales:

Define use cases around deal stages, playbooks, and qualification rules. A rep can ask, “When should I move a deal to Proposal Sent?” or “What’s the process if a prospect requests a discount?” The assistant responds with the official stage criteria or links to the discount policy document so frontline decisions match your playbooks.

For customer success and operations:

Focus on renewals, escalations, and internal request flows. Example prompts include, “How do I log a renewal forecast?” or “Which form do I use to request a new integration?” Every answer should map back to an SOP stored in your vaults, so process drift is reduced.

When the Internal FAQ Assistant is built on clear sources of truth and defined use cases, it stops being a standalone AI feature and becomes part of how your teams work in HubSpot.

Instead of searching through documentation or asking colleagues, teams can query the agent and receive consistent, process-aligned answers. This reduces friction, accelerates onboarding, and limits process drift.

Begin with a few critical workflows, monitor where the assistant removes repetitive questions, then extend its scope. Used this way, the Internal FAQ Assistant continually standardizes and optimizes daily execution in HubSpot.