AI Sync

Working with AI Agents

Set Up the Lead Agent from Your AI Assistant

Connect Claude, ChatGPT or Grok, say "Set up my Lead Agent", and it interviews you, saves your rules, tests them, and only goes live after your yes.

Your AI assistant can set up and run the Lead Agent for you by chat. It uses the same settings as Settings → Lead Agent, and the same safety rules.

Step 1: Connect your assistant#

Follow Connect your AI assistant. It takes about 2 minutes. Sign in as the account owner or an admin: only they can change the Lead Agent.

Step 2: Start the setup interview#

Open a new chat and say:

Set up my Lead Agent.

Your assistant loads the built-in Lead Agent setup interview. It:

  1. Reads first. It checks what your account already has (voice agent, text agent, texting line, email domain, AI Memory, calling hours, pipelines and tags) and tells you what's ready and what isn't.
  2. Asks one question at a time: your business and goal, lead sources, don'ts and do's, leads who already got an offer, qualifying questions, calling hours, channels, limits, your hand-off person, scope, research, what "not interested" should do, field mapping, the off tag, and how the AI is paid for.
  3. Repeats back what each answer becomes, in one line.
  4. Checks your voice agent's prompt has {{call_reason}} and {{agent_rules}}, and shows you the change before adding them.
  5. Checks your text agent has a calendar and that you get a text on every booking.
  6. Reads the whole setup back and asks "Anything to change?" before saving.
  7. Tests it on fictional leads, then Watch, then adds your leads (dry run first), then reviews a day of decisions with you.
  8. Goes live only after you say yes to the exact live preview.

Your OpenRouter key never goes in the chat. If you choose your own key, add it in Settings → Lead Agent → AI billing in the web app. The assistant can only check whether a key is connected and working.

Want the exact words to type for each step? See Set it up from Claude.

There's also a built-in Lead Agent copy skill with writing rules for cash home buyers: short, human, one question per message, never claims to be human, no offer numbers, no promises.

Things to ask#

You want toAsk
See the setup"Show me my Lead Agent settings in plain words."
Change a rule"Add a don't: never mention we're investors."
See how it's doing"How is the Lead Agent doing today?"
Read its decisions"Show me the last 20 Lead Agent decisions and why."
Check one lead"What is the Lead Agent doing with Becky Smith?"
Pause one lead"Pause the Lead Agent for Becky, Luke is talking to her."
Read the morning report"Show me yesterday's Lead Agent report with suggestions."
Turn it off"Turn the Lead Agent off."

Previews first: what needs your yes#

Some actions start real outreach or spend money. For those, your assistant first shows you exactly what will happen and changes nothing. It only acts when you say yes.

Never let your assistant treat "sounds good" about something else as a yes to going live. A good assistant shows you the live preview word for word and asks you directly.

The Lead Agent tools#

ToolWhat it doesNeeds your yes
lead_agent_get_configReads the current settings and modeNo (read only)
lead_agent_update_configChanges settings. Never changes the mode.Yes for: any AI billing change, raising the daily AI limit, and on a live agent, any change to scope, account limit, per-lead limits, channels or hours. Other edits save at once.
lead_agent_set_modeSwitches Off, Watch or LiveYes for Watch (it uses billed AI) and Live. Off never needs it.
lead_agent_statusMode, whether it really sends, leads by status, sent today, bookings, contact rateNo (read only)
lead_agent_decisionsIts decisions, newest first, with reason, draft and next touchNo (read only)
lead_agent_contactEverything about one lead: status, next touch, historyNo (read only)
lead_agent_pause_contactPauses one leadNo
lead_agent_resume_contactResumes one paused or stopped leadYes. Leads who opted out, threatened legal action, said wrong number or not interested can never be resumed.
lead_agent_history_pullReads your GoHighLevel conversations and notes (365 days by default) so past STOPs and wrong numbers are stopped firstYes
lead_agent_seedAdds your existing in-scope leadsDry run: no. Yes to add them for real. Waits until the history pull is done.
lead_agent_simulateTests your settings on fictional leads; contacts nobodyYes for a real-AI run (it's billed). A plumbing check with no AI needs none.
lead_agent_simulation_resultReads a test's resultsNo (read only)
lead_agent_daily_reportThe daily learning report, with optional suggestionsNo (read only; suggestions use a little AI)
lead_agent_suggestionsLists the report's suggested changesNo (read only)
lead_agent_suggestion_previewShows a suggested voice-prompt change, before and afterNo (changes nothing)
lead_agent_suggestion_applyApplies a previewed prompt change (a revision is kept so it can be restored)Yes
lead_agent_suggestion_dismissMarks a suggestion as not wantedNo
lead_agent_copy_setupCopies this setup to another account you controlDry run: no. Yes to copy for real.
lead_agent_ai_key_statusWho pays for the AI and whether your own key works. Never shows the key.No (read only)

Your assistant also uses the normal tools for voice agents, text agents, AI Memory, email domain, pipelines, tags and workflows during setup. See What the MCP can do.

What the assistant can never change#

  • Opt-outs, Do Not Call and Do Not Disturb.
  • That a booked lead stops, and that a full opt-out stops every channel.
  • Calling hours wider than 8 AM to 9 PM in the lead's time (8 PM in Florida).

For agencies working inside a client#

When an agency acts inside a client account, these also need the agency's yes, because the client pays for the outreach or AI: Watch, Live, any AI billing change, a real-AI test, adding leads for real, a real copy, resuming a lead, and widening a live agent. A dry-run copy needs none. See Lead Agent for agencies.