Docs / Reference · Commands

Reference

Agent Commands

These are not forjabot subcommands. They're skills you ask your agent for —in plain language or with /name— to run your already-installed bot: pull reports, fine-tune it, send campaigns, and if you resell, quote and invoice. You ask; your agent executes and you approve.

The difference from the CLI, in one sentence

forjabot is a program that installs and updates the bot (init · list · install · update · doctor — see CLI · forjabot). The agent commands are instructions your agent follows on the bot that's already running. There's nothing to memorize: you talk to it normally and it picks the right skill.

How These Commands Work

Each command on this page is a skill: a script of steps your agent reads and runs for you. You describe what you want (or type /name) and the agent pulls the data, drafts it, and asks for your confirmation before changing anything. Three rules apply to all of them:

👤 You don't code — the agent runs the commands 🔒 Whatever reads data is read-only; it never deletes or changes anything on its own 🚀 Nothing takes effect until you deploy, and you're the one who triggers the deploy

Most of these commands are Forja +. Two are free because they're about your data: reporte and exportar. Here's the full map:

Command	Tier	What For
/reporte	Free	Monthly value report for your client
/exportar	Free	Download your leads and conversations to CSV/JSON
/mantenimiento	Forja +	Monthly tune-up: health + cleanup + gaps
/afinar	Forja +	Make the bot smarter from real chats
/campaña	Forja +	Win back clients and send follow-ups
/clonar	Forja +	Build the knowledge base from the website
/precios	Forja +	Update the menu / price list on the fly
/cliente-nuevo	Forja +	Agency Mode · set up a client's bot
/cotizar	Forja +	Agency Mode · put together a quote for a prospect
/propuesta	Forja +	Agency Mode · document to close the sale
/cobrar	Forja +	Agency Mode · generate the invoice and payment link

Day-to-Day Operation

Your bot's day to day: checking how it's doing, pulling your data, keeping it healthy, and tuning it. The first two are free; the rest unlock with Forja +.

View and Pull Your Data

/reporte Free

The monthly value report you hand to your client: how many conversations the bot handled, how many it escalated to a human, how many leads it captured (if Pro), and the approximate cost for the month — all in business-owner language.

How to trigger it: "give me this month's report" · "monthly report" · "how did the bot do" · "report for the client" · /reporte
Output: A .md (and PDF if possible) in member/reportes/, plus the summary in the chat. Read-only.

Chat with your agent

# you talk to it normally — your agent does the technical work
you › give me this month's report
agent › reading the database, read-only…
✓ report-july-2026.pdf · 312 conversations · 94% without a human

/exportar Free

Take your data with you. Dumps your leads and/or your conversations and transcripts to CSV (and optional JSON), ready to open in Excel or Google Sheets or keep as a backup.

How to trigger it: "export my leads" · "download the conversations" · "get my data out" · "backup my leads" · /exportar
Tier: No lock — your data is yours. Works the same on Free and on Forja +. Read-only.

Chat with your agent

# your data is yours — no tier lock
you › export my leads to CSV
agent › reading the database (read-only) → writing the file…
✓ leads-2026-07-15.csv ready for Excel / Google Sheets

Want a narrated report instead of the raw dump?

If what you want is "how did the bot do" told for your client, that's /reporte. /exportar is the raw backup in CSV/JSON.

Care For and Grow the Bot

/mantenimiento Forja +

The bot's monthly tune-up, like a car's service check: a health traffic light (conversations, escalations, cost, channels), knowledge-base cleanup (duplicates, blanks, outdated info), and gap detection (what people ask that it can't resolve), with a short list of prioritized improvements.

How to trigger it: "give the bot maintenance" · "tune up the bot" · "clean up the knowledge base" · "monthly bot review" · /mantenimiento
Touches the bot?: Read-only except what you confirm — it never deletes or changes anything on its own.

/afinar Forja +

Makes the bot smarter by learning from its real conversations. It sweeps chats, escalations, and the Improvements queue to find the questions it couldn't answer (or answered poorly) and proposes concrete fixes to its info and its instructions, with a before/after for each change.

How to trigger it: "tune the prompt" · "the bot couldn't answer X" · "improve the bot's answers" · "make the bot smarter" · /afinar
How it's applied: Only with your "yes." It reminds you to deploy for it to take effect — nothing is live until then.

Chat with your agent

# afinar sweeps many chats and shows you before/after
you › the bot couldn't answer about parking
agent › found 7 recurring unanswered questions…
⚠ proposing 3 fixes · apply them? (takes effect on deploy)

Which one do I use?

For the bot's tone/voice → /voz-de-marca. For the forensics on a single chat that went wrong → /autopsia. To test it with scenarios → /cliente-misterioso. /afinar sweeps many conversations to close the gaps that keep repeating.

/campaña Forja +

Wins back clients and sends follow-ups to people who already messaged the bot. It segments your prospects and clients, drafts the message per group (short, with value, and an opt-out), and guides the actual send over WhatsApp from the panel — with total honesty about WhatsApp's rules.

How to trigger it: "send a campaign" · "win back my leads" · "follow up with the ones who didn't buy" · "reminder for my prospects" · /campaña
Who sends it: You're the one who presses the send button, in /admin/campanas. The agent never fires a campaign on its own. It doesn't upload lists of new numbers.

Chat with your agent

# the bot only reaches people who ALREADY messaged it
you › win back the ones who didn't buy
agent › segment: 48 warm contacts in the 24h window…
✓ copy ready — you press the send button in /admin/campanas

/clonar Forja +

Builds the bot's knowledge base from the business's website. You give it the URL, the agent reads the page (services, prices, contact, FAQs), pulls the real info, and uses it to write the documents the bot will use to answer — without making anything up.

How to trigger it: "clone my website" · "build the knowledge base from my site" · "import the info from my website" · "set up the bot from my site" · /clonar
Golden rule: It only writes what actually exists on the site. Whatever it can't find gets flagged [COMPLETE HERE] for you to fill in.

Don't confuse it

/clonar fills in what the bot knows (the facts). For how it sounds → /voz-de-marca. To change its business type → /re-nichar. To install it from scratch → /configurar-mi-chatbot.

/precios Forja +

Updates in seconds the price list / menu the assistant uses when someone asks "how much does it cost?" It takes the changes as text, a photo of the menu, or dictation, locates where the prices live (the catalog or the knowledge base), changes them with your confirmation, and reindexes the bot's search, with a before/after.

How to trigger it: "update my prices" · "change the menu" · "I raised the prices" · "new price list" · "change how much X costs" · /precios
How it's applied: It writes only with your confirmation and shows you a clean before/after before touching anything.

Chat with your agent

# as text, a photo of the menu, or dictation
you › raise haircuts by 10%  ·  [photo of the menu]
agent › reading the catalog → here's the before/after…
✓ 6 prices updated — reindexing the bot's search

Agency Mode · Sell and Get Paid

If you resell bots, these four commands are your sales workshop: set up a client's bot, price it, close the sale, and invoice it. All of them are Forja +. Except for /cliente-nuevo (which installs a separate instance), none of them touch your bot: they just produce documents in member/agencia/.

/cliente-nuevo Forja +

Sets up a resale client's bot end to end in its OWN instance —its own panel, its own database, and its own deployment, with no mixing of data with other clients. It orchestrates the full onboarding (business type, create, configure, client's branding, publish with your "ok," and connect a test channel) and wraps up with a delivery checklist and the next step to get paid.

How to trigger it: "new client" · "set up a bot for a client" · "client onboarding" · "resale client" · /cliente-nuevo
How it works: It's an orchestrator: it chains /configurar-mi-chatbot and /voz-de-marca. Golden rule: one client = one bot = one panel.

/cotizar Forja +

Puts together the price to sell a bot to a business. It takes the business type, channels, whether it wants scheduling/integrations, and its market, and proposes a sound structure —one-time setup + monthly fee + extras— that never undercuts the community's resale floor, in a clean quote ready to send.

How to trigger it: "quote a bot" · "how much do I charge" · "price for a client" · "help me set a price" · /cotizar
Output: Quote in markdown (and PDF if possible) in member/agencia/. Doesn't touch the bot or run numbers for you without showing them.

/propuesta Forja +

The complete sales document to close the deal: the business's problem, the solution (your bot on their channel), what's included, the expected results in honest language (no made-up numbers), the price (pulled from your quote if one exists), timelines, and the next step.

How to trigger it: "make me a proposal" · "sales proposal" · "put together the proposal for [client]" · "I want to close this prospect" · /propuesta
Output: Proposal ready as PDF in member/agencia/. 100% honest: it never makes up numbers, testimonials, or guarantees.

/cobrar Forja +

Generates the invoice and payment link for your client. It detects your payment method (Stripe, Mercado Pago, or bank transfer), puts together the payment link or a receipt with YOUR details, and keeps track of what you're owed in member/agencia/cobros.md.

How to trigger it: "how do I invoice this" · "generate a payment link" · "make the invoice for the client" · "charge for the setup" · "charge the monthly fee" · /cobrar
Honesty: Forja doesn't process payments: the money goes to YOUR provider, not to Forja. This skill only puts together and organizes the invoice. It doesn't touch the bot.

Chat with your agent

# Forja doesn't process payments — the money goes to YOUR account
you › charge my client for the setup
agent › method: Stripe → generating the payment link…
✓ link ready + logged in member/agencia/cobros.md

Almost all of this lives in Forja +

With the free plan you use /reporte and /exportar. Forja + unlocks the recurring ones (/mantenimiento, /afinar, /campaña, /clonar, /precios) and the full Agency Mode for reselling. A single $2,000–3,000 client pays for your whole year. See plans and unlock →