Bill Nothing by Accident With a Grok Bot Template for Lead Finder Runs

The scary part of pointing an agent at a Grok bot template for lead finder work is billing. An agent that can add tracked keywords looks like an agent that can add cost. RedReplier's API is built so it cannot: no call charges you or changes the plan, and knowing where that line sits is the difference between a useful agent and one you have to supervise constantly.

The short version: keywords added through the API go ACTIVE at once if they fit your plan, and the rest wait as PENDING. GET /keywords/billing-preview prices a bigger plan without changing it, and POST /keywords/activate-pending only fills free slots. An upgrade happens in the RedReplier app, after you say yes.

What is a Grok bot template for lead finder work?

A Grok bot template for lead finder work is a share link that copies a configured Grok Bot into your own Grok Bot app. The copy includes a skill documenting the RedReplier REST API. SpaceXAI shipped template sharing on 28 August 2026. Your token and your tracked keywords stay yours; only the instructions travel.

It is the lead-generation companion to the Grok bot template for social listening guide.

When does a keyword stay PENDING?

RedReplier's KeywordStatus enum is PENDING, ACTIVE, DISABLED and SUSPENDED. A keyword added through the API goes ACTIVE at once when it fits the plan allowance, and only the ones beyond it wait at PENDING. A pending keyword is recorded but monitors nothing and bills nothing. The API cannot upgrade the plan, which is what makes an agent safe to hand keyword suggestions to.

So a session looks like this. The bot proposes twenty keywords, prices them, and adds only what you approve:

You:  Suggest keywords for a project management tool aimed at agencies,
      then price them.
 
Bot:  POST /websites/analyze-description   -> reads the site, drafts a profile
      GET  /keywords/billing-preview       -> "20 keywords: bigger plan, $X/mo"
      "Twenty candidates. Your plan has room for twelve. Add which?"
 
You:  Add the twelve about agency workflows only.
 
Bot:  POST /websites/{id}/keywords         -> those twelve go ACTIVE at once

Nothing in that session bills. The last line changes what you track, which is why it only runs because you said so.

How does the bot find actual buying signals?

The bot filters mentions to the sources and relevance buckets where people ask for recommendations, then explains why each one scored. Reddit comments carry most of the recommendation traffic, so a lead run usually starts there and widens.

You:  Today's lead candidates: Reddit comments and Hacker News, HIGH and above,
      sorted by relevance. Explain the top five.
 
Bot:  GET  /mentions?sources=REDDIT_COMMENT,HACKERNEWS
           &scoreBuckets=HIGH,VERY_HIGH&statuses=NEW&sort=RELEVANCE
      POST /mentions/{id}/explain    (x5)

POST /mentions/{id}/explain is what turns a score into something you can act on. It returns the reasoning behind the number, so a borderline thread gets judged on its content rather than on a bucket label.

How do I install and test it?

Installing the RedReplier Grok bot template takes four steps. Open the share link in Grok Bot, create a redreplier_ API token, paste it into the credential field, and ask for a keyword billing preview as a read-only test.

Can the bot manage keywords over time?

Yes, and the read-only half is where it earns its keep. GET /mentions/count filtered by keywords shows which keywords stopped producing mentions, so the bot can flag them and propose disabling them. GET /keywords/change-usage reports the edit allowance, which is unlimited on every plan, and an edit keeps the keyword's paid slot.

Turning one off is POST /keywords/{id}/disable, and re-enabling is POST /keywords/{id}/enable. Both are reversible, unlike deletion, which is why the skill prefers them.

Should the bot run lead finding on a schedule?

Run it on a schedule for reading, never for adding keywords. A daily lead digest is useful; a routine that adds keywords on its own fills your plan's slots with its own guesses, because every keyword that fits goes live at once.

Name:      Daily lead candidates
Schedule:  every weekday 08:30
What:      GET /mentions for new REDDIT_COMMENT and HACKERNEWS mentions since
           the last run, HIGH and VERY_HIGH only, sorted by relevance.
           Summarise the top five with a one-line reason and a direct link.
Approval:  never add or activate keywords and never change a mention status.
If empty:  do nothing, send no notification.

What breaks in the first week?

The most common one looks like a broken integration and is not: a keyword was added past the plan allowance, so it sits in PENDING and monitors nothing. Ask the bot for GET /websites and you will see it sitting in pending until a slot frees up or the plan is upgraded in the RedReplier app.

After that, a 403 permission_denied on the first call means a Viewer token, because every call, reads included, needs redreplier.write, so create an Editor or Admin token instead. And a lead run filtered to REDDIT_POST alone will miss the comment threads where recommendations actually happen. The Reddit monitoring guide covers that split in detail.

Frequently asked questions

Can the Grok bot spend money without asking me?

No. No RedReplier API call charges you or changes the plan. Keywords that fit the plan go ACTIVE at once and the rest wait as PENDING, POST /keywords/activate-pending only fills free slots, and an upgrade happens in the RedReplier app, where you see the price before you confirm.

What does the bot use to suggest keywords in the first place?

POST /websites/analyze-description reads a URL and drafts a description of what the site sells, which the bot then turns into keyword candidates. You can also just tell it what you sell and skip that call.

Can it find leads on Hacker News as well as Reddit?

Yes. HACKERNEWS is one of the six sources, alongside REDDIT_POST, REDDIT_COMMENT, TWITTER, BLUESKY and FACEBOOK. For B2B and developer tools, Hacker News plus Reddit comments is usually the highest-signal pair.

Does disabling a keyword delete its history?

No. POST /keywords/{id}/disable stops future monitoring and leaves existing mentions in place, which is why it is the reversible option the template prefers over deletion.

Where do I find other Grok bot templates?

groktemplates.dev indexes Grok bot templates by use case. On this blog, the Reddit monitoring and X social listening guides cover the other two jobs this template does.

Install the RedReplier Grok bot template and run a billing preview before anything goes live, or read the API docs first.

Sources: the RedReplier OpenAPI spec, x.ai/bot, and @bot on X (28 August 2026). Checked 30 August 2026.

Meta's agent takes a different route into the same API: the Meta Muse connector guide.