AI Sync

Lead Agent

Lead Agent Troubleshooting and FAQ

Why the Lead Agent is paused, why it skipped a lead, and how to get it going again.

The whole agent is paused#

A yellow banner on Settings → Lead Agent says why. While paused, the agent makes no AI requests and contacts nobody.

What the banner saysWhyHow to fix
The balance is empty (no_balance)Metered billing, and the balance is $0. For an agency client, the agency balance can also cause this.Top up. It starts again on its own within a minute.
Today's AI limit is reached (daily_ai_cap)The day's AI spend hit your limit ($25 by default).Wait until midnight UTC, or raise Most AI spend per day on Settings → Lead Agent → AI billing and click Save.
AI usage could not be recorded (billing_failed)A charge didn't save on the account. To be safe, the agent stops.Contact RizzDial support. This one never lifts by itself; support fixes the billing and restarts it.
Metered AI needs a billing plan from your agency (no_billing_plan)You're an agency client with no plan assigned.Ask your agency to assign a plan, or switch to your own OpenRouter key.
No key is connected (own_key_missing)Billing is set to your own AI key (OpenRouter, Google Gemini or Anthropic), but there's no key for that provider.Add the key on Settings → Lead Agent → AI billing, or switch to Platform AI.
Your provider refused the key (own_key_refused)The key is wrong, expired, or that provider account is out of credit.Fix it with your provider, then Save and test or Test the key again. Or switch to Platform AI. It never falls back to our key.
Stopped for everyone by the platformRizzDial's emergency stop is on.Nothing to do on your side. Support will tell you when it's lifted.

You get one alert when the agent pauses (in the app, and in Slack if you set a hand-off Slack channel).

One lead was skipped or paused#

Ask your assistant "What is the Lead Agent doing with Becky?" or read the lead's timeline under Changes. The reason is in plain words.

ReasonWhat it meansCan it be resumed?
Opted outThey said STOP or "remove me"Never
Legal threatThey threatened legal actionNever
Wrong numberThey said it's the wrong personNever
Not interestedThey said no to the text agentNever by the agent. Your team can still reach out by hand (unless you chose Do Not Disturb).
Old "not interested"The history check found a past plain noComes back on its own after 180 days, or resume it now
EscalatedIt was handed to your teamYes, once your team is done
A person is talkingSomeone on your team contacted themResumes on its own after 48 hours
Text agent is talkingYour AI text agent has a conversation goingResumes on its own 48 hours after the text agent's last message
Off tagThe contact has ai-offRemove the tag
BookedThey have an appointmentStays stopped. If they write again, your rep gets it.
Duplicate contactAnother record of the same person is already being workedThat other record is worked instead
Out of scopeThe lead no longer matches your scopeChange the scope or the lead

Why a send was blocked or skipped#

A decision with the outcome blocked means a hard rule stopped it right before it went out. Common reasons:

  • outside calling hours or business hours (it plans the next allowed time);
  • a limit was reached (per lead, or the account's daily limit);
  • Do Not Disturb on that channel, in RizzDial or GoHighLevel;
  • GoHighLevel couldn't be read for that lead, so nothing goes out until it can;
  • an earlier send on that channel never reported back (it waits up to 24 hours);
  • the lead was on a live call.

How to resume a lead#

  • Off tag: remove ai-off from the contact.
  • Anything else: on Settings → Lead Agent → Activity → One lead, enter the contact id, click Look up, then Resume this lead. Or ask your assistant "Resume the Lead Agent for Becky." It shows what will happen and resumes after your yes. The agent looks at the lead again within a minute.

Only the account owner or an admin can resume. Pausing is open to anyone on the team.

Common questions#

Mode says Live but nothing is being sent

If sending isn't switched on for your account yet, the page says Live is saved but sending is off for this account: ask support. and decisions read Watch only (not sent). Contact support. If there are no decisions at all, see the next question.

There are no decisions at all

Check three things: the mode isn't Off; you chose a scope in Who it follows up (with no scope, the page says No leads are in scope yet, so the agent works on nobody.); and you've added your existing leads (new leads join on their own, old ones need adding once).

It never calls anyone

Calls need a voice agent in Agents and hand-off → Voice agent for calls (not None (no calls)), and Calls ticked in Channels and hours → Channels it may use. Ask your assistant "Is my Lead Agent's voice agent set?"

Calls ignore my don'ts

Your voice agent's prompt needs the line Rules for this call: {{agent_rules}}. See Step 3. Rules over 500 characters are cut, so put the most important first.

It doesn't book by text

Your text agent needs a calendar: set the AI agent whose calendar to use. See Step 5. It books only when the lead picks one of the two times it offered.

It doesn't send email

Email needs a verified sending domain and a From address on it. See Email.

A lead got a text after they said STOP somewhere else

The agent reads STOP on every channel and Do Not Disturb in GoHighLevel right before every send. If you see this, send us the contact so we can check the exact record.

Does Watch mode cost money?

Yes. Watch mode makes the same AI requests as Live, so it's billed the same way and counts toward your daily AI limit.

How do I stop everything right now?

Settings → Lead Agent, mode menu → Off → Save mode. Every send checks the mode again right before it goes out.