Home›AI Receptionist & Lead Capture›How to Create a Voice AI Agent in GoHighLevel
AI Receptionist & Lead Capture

How to Create a Voice AI Agent in GoHighLevel

By William Welch ·October 20, 2026 ·11 min read

Follow along — get 30 days free →

In This Guide
  1. What a Voice AI agent does
  2. Before you begin
  3. Choose a creation method
  4. Step-by-step: create a custom Voice AI agent
  5. Launch checklist
  6. FAQ
  7. Related guides

This tutorial also has a podcast episode

Listen on Spotify — "Go High Level" podcast

To create a Voice AI agent in GoHighLevel, go to AI Agents → Voice AI → Agent List, click + Create Agent, choose Browse Marketplace, Create Custom Agent, or Flow Builder, and click Continue. For the Create Custom Agent path, set the agent's name, voice, model, language, prompt, and welcome message, then click Save.

TL;DR
  • Create: AI Agents → Voice AI → Agent List → + Create Agent → pick a method → Continue.
  • Configure (Create Custom Agent): name, voice, model, language, prompt, welcome message → Save.
  • Add a Knowledge Base and only the Actions the agent needs.
  • Test in the Test Audio panel with a Web Call (no phone number needed). Call Transfer does not run during Web Call testing; use a Phone Call test or call the deployed number to validate a transfer.
  • Go live on the Deploy tab: assign a phone number or Number Pool, then set Call Routing and Working Hours. Assigning a number alone does not guarantee the agent answers every call.

What a Voice AI agent does

A Voice AI agent is an automated voice assistant that talks to callers using the instructions, business information, and actions you configure. It can answer questions, collect information, update contact records, book appointments, trigger automations, and route callers when a person is needed.

Before you begin

Have these ready
  • Access to the correct sub-account and the View & Manage Voice AI Agents permission. If Voice AI is missing, ask a sub-account admin to review your permissions. Agent management, goal configuration, and dashboard access may be controlled separately.
  • One defined use case, such as lead qualification, customer support, appointment booking, or call routing.
  • Approved business information for the prompt or Knowledge Base.
  • Any calendar, workflow, transfer number, or integration your actions need.
  • An eligible LC Phone number, Twilio number, or Number Pool if the agent will take live calls.
  • Outbound calling needs the applicable approval and compliance setup first. The Outbound test option may stay unavailable until that is done.

Choose a creation method

AI Agents→ Voice AI→ Agent List→ + Create Agent→ Select a creation method→ Continue
Create Custom Agent

Standard call handling

A full-screen builder with a prompt, Knowledge Base, actions, and call settings. HighLevel's FAQ recommends it for standard call-handling use cases.

Browse Marketplace

Prebuilt agent

Install a prebuilt agent for a specific use case when a suitable one exists. Review its prompts, actions, workflows, calendars, fields, and Knowledge Base, and replace any business-specific information before you deploy.

Flow Builder

Structured, multi-path calls

A visual, node-based flow (the help article calls it Flow Based Builder). A new blank flow starts with a Start Call node connected to an AI Agent node. The starter flow is not kept until you save the agent.

This is built into GoHighLevel. Try it free for 30 days →

Step-by-step: create a custom Voice AI agent

The help article's steps follow the Create Custom Agent path. Create a separate agent for each main call-handling use case.

1
You

Open Voice AI

  1. Log in to the right sub-account.
  2. Go to AI Agents → Voice AI.
  3. The page opens on Dashboard & Logs. Click the Agent List tab.
AI Agents, Voice AI page on the Agent List tab with the Create Agent button
Voice AI: Agent List with + Create Agent. 1AI Agents (left menu) · 2Voice AI · 3Agent List tab · 4+ Create Agent.
2
You

Start a new agent

  1. Click + Create Agent.
  2. In the Create Voice AI Agent window, select Create Custom Agent (or Browse Marketplace / Flow Builder).
  3. Click Continue. HighLevel creates the agent right away under an automatic name (ours was "My Agent 664") and opens the builder.
Create Voice AI Agent window with Browse Marketplace, Create Custom Agent selected, Flow Builder, and Continue
Create Voice AI Agent: choose a method. 1Browse Marketplace · 2Create Custom Agent (selected) · 3Flow Builder · 4Continue.
3
You

Configure the core agent

The full-screen builder keeps the prompt, settings, and test console on one page.

  1. Click the pencil next to the agent name at the top and enter a clear name (the help article calls this the Agent Name).
  2. Select the Voice.
  3. Select the Model and Language.
  4. Click the clock icon in the toolbar to set the Timezone.
  5. Write or review the prompt. A new custom agent opens with a prefilled template prompt, so read it and replace anything that does not fit your business.
  6. Set the Welcome Message for inbound and outbound calls.
  7. Choose whether the agent or the caller speaks first, when that option is available (the dropdown under Welcome Message shows AI speaks first here).
  8. Set the pause before the agent starts speaking (Pause Before Speaking).
  9. Click Save (top right).
Voice AI builder for Sandbox Front Desk Agent with Voice, Model, Language, Timezone clock, prompt editor, Welcome Message, and Test Audio panel
Full-screen builder: core settings. 1agent name (pencil to rename) · 2Voice (Jessica here) · 3Model and Language (GPT 4.1, English here) · 4clock icon (Timezone) · 5prompt editor with Custom Value and Prompt Optimizer · 6Welcome Message with AI speaks first and Pause Before Speaking · 7Test Audio panel. One line of the prefilled template prompt is blurred.
What the prompt should cover
  • The agent's role and main objective
  • What information to collect
  • Which topics it may answer, and which claims or topics to avoid
  • When each action should run
  • When to transfer or escalate the caller
  • How the call should end

Prompt Optimizer can help improve a first draft, but review and test the final instructions. Tell the agent not to guess when it lacks required information.

Outbound (S2S agents)

For an S2S agent that will place outbound calls: set the outbound welcome message, open Outbound Settings, configure the AI Disclosure, review Verbal Opt-out, then save. The same S2S agent can handle inbound and outbound calls.

4
You

Connect a Knowledge Base

  1. Open Knowledge Base in the configuration panel.
  2. Select the Knowledge Base the agent should use.
  3. Add or update the relevant sources, such as business hours, services, pricing, policies, locations, and FAQs.
  4. Describe when the agent should search the Knowledge Base.
  5. Test common questions and edge cases.
5
You

Add actions

A new agent already has an End call action under During the call. After the call starts empty.

  1. Open Actions in the configuration panel and click + New Action.
  2. Select the action type and give it a clear name.
  3. Define the condition that triggers it.
  4. Fill in the required destination, workflow, field, calendar, or integration settings.
  5. Save the action. Add only the actions the agent's objective needs.
Voice AI Actions section with New Action, a default End call action during the call, and no after-call actions
Actions before you add one. 1Actions · 2+ New Action · 3During the call (default End call action) · 4After the call (empty).
New Action menu with Search and nine Voice AI action types
+ New Action: action types. 1Search · 2action types: Call transfer, Trigger a workflow, Send SMS, Update contact field, Appointment Booking, Send WhatsApp message, Custom Action 2.0, Agent Transfer, Add MCP.
Common action types
  • Call transfer: send the caller to a human phone number.
  • Agent Transfer: hand the call to another Voice AI agent, when available.
  • Trigger a workflow: start a selected HighLevel workflow.
  • Send SMS: send a message during the call.
  • Update contact field: save what the caller tells the agent.
  • Appointment Booking: offer availability and book an appointment.
  • Custom Action 2.0 (the help article calls it Custom Action): send a real-time webhook request to an external system.

The live menu also lists Send WhatsApp message and Add MCP. The help article does not describe them yet.

After-call actions can apply updates or start follow-up after the call without interrupting the caller.

6
You

Review call and post-call settings

Advanced settings are hidden by default. At the bottom of the configuration panel, turn on Show advanced settings to reach Call Settings, Agent Behavior, Transcription & Speech, Voice Settings, and System Prompts. The browser remembers your choice.

  • Call Settings: call duration, idle reminders, silence handling.
  • Agent Behavior: response speed, interruption sensitivity, response style.
  • Transcription & Speech: speech recognition, pronunciation, keywords.
  • Voice Settings: voice speed, volume, supported audio options.
  • Post-Call: notifications, workflows, summaries, follow-up, and whether the AI call summary is saved to the contact's notes. Turning that off only keeps it out of notes; the summary stays in the Voice AI call logs.

Keep defaults that already fit. Change one setting at a time and retest.

7
You

Test the agent

  1. Save the agent.
  2. Use the Test Audio panel on the right of the builder.
  3. Under Choose Call Type, pick Web Call (in your browser, no phone number needed) or Phone Call (the full phone experience).
  4. Select the available inbound or outbound scenario, start the call (Start Web Call for a web call), and talk to the agent like a real caller.
  5. Adjust the prompt, Knowledge Base, actions, or settings, and repeat until behavior is consistent.
  6. Review the call history (Call History), transcript, recording, summary, and action results.

Test a common request, a Knowledge Base question, a question it should not answer, an unclear request, each action, a transfer request, silence, an interruption, and the closing.

Web Call limit

Call Transfer does not run during a Web Call test. Use a Phone Call test or call the deployed number to check transfers.

8
You

Deploy to a phone number

  1. Switch from Build to the Deploy tab at the top of the builder.
  2. In the Phone card, open Numbers & number pool and select an eligible phone number or Number Pool. Buy new number lets you buy one without leaving the Deploy screen, then choose whether to assign it.
  3. Under Call Routing, pick Answer calls directly or Use as backup (the screen describes it as "AI agent answers when no one picks up").
  4. Under Working hours, select All hours - 24×7 for unrestricted availability or Custom schedule to choose active days and time ranges. Custom schedules can extend through midnight.
  5. Optional: in the Widgets card, under Chat widgets, connect an existing chat widget or click Create new widget (the help article calls this the Chat section).
  6. Review the number's inbound call flow, forwarding, timeout, voicemail, and fallback, then click Save.
Voice AI Deploy tab with Numbers and number pool, Call Routing, Working hours, and Chat widgets
Deploy tab: Phone, Call Routing, Working hours, Widgets. 1Deploy tab · 2Numbers & number pool, Buy new number, Manage numbers · 3Call Routing · 4Working hours · 5Chat widgets. Our sandbox agent has no number assigned.
Routing matters

Assigning a number does not guarantee the agent answers every call. Working Hours, the Call Routing mode, forwarding, timeout, voicemail, and the number's call-flow configuration can affect routing.

Launch checklist

FAQ

Why can't I see Voice AI under AI Agents?

Your role may not include View & Manage Voice AI Agents. Ask a sub-account administrator to review your permissions.

Can I test without a phone number?

Yes. A Web Call in the Test Audio panel tests prompts, Knowledge Base answers, and most actions in your browser.

Why doesn't the agent answer the assigned number?

Confirm the number or Number Pool is assigned to the right agent, then check Working Hours, Call Routing, inbound routing, forwarding, timeout, voicemail, and the number's call flow.

Can one agent answer several numbers?

Yes. Assign a configured Number Pool.

Can Voice AI book appointments during a call?

Yes. Add the Appointment Booking action, connect a HighLevel calendar, and test availability and booking confirmation before you deploy.

Source: HighLevel Support, How to Create Voice AI Agents (article 155000004107; modified Thu, 1 Oct, 2026 at 8:30 AM; fetched 2026-10-16).

Screenshots: our HighLevel Cloud Sandbox (English UI, captured 2026-10-16). Where the live screen uses a different label from the help article, this guide uses the live label.

Ready to try this?

$0 for 30 days — just a ~$1 card-verification hold (no subscription charge). Set up everything in this guide inside your trial.

Start Free 30-Day Trial
Cancel anytime — $0 for the first 30 days
Share
William Welch
GoHighLevel Consultant & Agency Automation Specialist
I help agencies replace 5-10 disconnected tools with one platform. I've built and managed GoHighLevel automations across CRM, email, SMS, WhatsApp, and AI — and I publish everything I learn here. More about me →