Forja

https://forjabots.com/docs
Admin
Forja is an AI chatbot platform that allows businesses and agencies to deploy niche-specific...
Tokens:9,888
Snippets:111
Trust Score:3.1
Update:1 month ago
Show doc for...
Tokens:
Raw
### Install a bot by slug

Source: https://forjabots.com/docs/cli-ref

Downloads and initializes a specific bot template into a local directory using its slug and an optional license key.

```bash
$ npx forjabot install barberia --key HZN-7Q2K-9F3D-VX8M

  ◇ Forja  ·  bots de IA para tu negocio
  Bajando barberia… ✓ 84 KB · v1.0.0

  ✓ Bot instalado  →  ./barberia

  Lo que sigue (tu agente de Claude Code lo hace por ti):
    1.  cd barberia
    2.  pídele a tu agente:  "configura mi chatbot"  (skill /configurar-mi-chatbot)
    3.  conecta tu Cloudflare y tus canales — el agente te guía.
```

--------------------------------

### npx forjabot init

Source: https://forjabots.com/docs/cli-ref

Starts the interactive assistant to configure, download, and onboard a business bot.

```APIDOC
## npx forjabot init

### Description
Starts the interactive assistant to configure, download, and onboard a business bot. If run without arguments, it prompts for settings; otherwise, it can be run non-interactively using flags.

### Parameters
#### Flags
- **--key** (string) - Optional - License key (HZN-...)
- **--yes** (boolean) - Optional - Non-interactive mode, accepts defaults
- **--giro** (string) - Optional - Slug of the business type
- **--email** (string) - Optional - Email for free startup
- **--name** (string) - Optional - Name for free startup
- **--cerebro** (string) - Optional - AI model (claude|chatgpt|grok)
- **--tono** (string) - Optional - Tone (cercano|formal|divertido)
- **--lang** (string) - Optional - Language (es|en)
```

--------------------------------

### npx forjabot install <slug>

Source: https://forjabots.com/docs/cli-ref

Installs a specific bot directly without using the interactive assistant.

```APIDOC
## npx forjabot install <slug>

### Description
Installs a specific bot directly without using the interactive assistant.

### Parameters
#### Positional Arguments
- **slug** (string) - Required - The identifier of the bot/giro to install.

#### Flags
- **--key** (string) - Optional - License key
- **--yes** (boolean) - Optional - Non-interactive mode
```

--------------------------------

### npx forjabot install

Source: https://forjabots.com/docs/cli-ref

Installs a specific bot template into the local environment by its slug.

```APIDOC
## npx forjabot install <slug>

### Description
Downloads a bot template by its slug, creates a local directory, and configures the `wrangler.toml` file. This command skips the interactive onboarding process.

### Parameters
- **slug** (string) - Required - The unique identifier for the bot template to install.
- **--key** (string) - Optional - The license key (HZN-...) required for installation. If not provided, the CLI attempts to use a saved license.
```

--------------------------------

### Run Forjabot Health Check

Source: https://forjabots.com/docs/cli-ref

Performs a diagnostic check on the bot installation, verifying files, dependencies, configuration, and connectivity.

```bash
$ npx forjabot doctor

  ◇ Forja  ·  bots de IA para tu negocio
  ✓ Bot encontrado en ./barberia
  ✓ Instalado: barberia v1.1.0
  ✓ wrangler.toml presente
  ✓ package.json presente
  ✓ Dependencias instaladas
  ✓ Negocio configurado (member/config.local.ts)
  ✓ Nombre del negocio: Barbería El Filo
  ✓ Giro (nicho): barberia
  ✓ Estás en la última versión
  ✓ Licencia activa (pro)
  ✓ El bot responde en línea (https://mi-bot.workers.dev)

  Todo en orden. Tu bot está sano.
```

--------------------------------

### npx forjabot doctor

Source: https://forjabots.com/docs/cli-ref

Performs a diagnostic check on the installed bot.

```APIDOC
## npx forjabot doctor

### Description
Performs a diagnostic check on the installed bot, including files, configuration, version, license, and online status.

### Parameters
#### Positional Arguments
- **dir** (string) - Optional - The directory of the bot (autodetected if omitted).

#### Flags
- **--key** (string) - Optional - License key
```

--------------------------------

### Initialize a new bot project

Source: https://forjabots.com/docs/cli-ref

Run the interactive assistant to configure and download a new bot project.

```bash
# asistente — no requiere instalación global
$ npx forjabot init

  ◇ Forja
  Idioma / Language
   1. Español     2. English
  › 1

  ¿Ya tienes una licencia?
   1. Sí, pegar mi licencia
   2. No — empezar gratis (bot Starter)
  › 2

  Validando licencia… ✓  plan free

  Bots disponibles:
   1. Bot Starter · genérico
  Bajando Bot Starter… ✓ 84 KB · v1.0.0

  ✓ Config lista · tu bot ya sabe de tu negocio
  ✓ Bot instalado  →  ./starter
```

--------------------------------

### Instalar bot con clave de licencia

Source: https://forjabots.com/docs/licencia.html

Comando para instalar un bot específico pasando la clave de licencia directamente mediante la bandera --key.

```bash
$ npx forjabot install barberia --key HZN-XXXX-XXXX-XXXX
✓ licencia válida · descargando barbería…
✓ bot creado en ./barberia
```

--------------------------------

### Inicializar un bot con Forja

Source: https://forjabots.com/docs/index.html

Comando para iniciar el proceso de configuración de un nuevo bot, incluyendo la selección de idioma y giro de negocio.

```bash
# un comando para empezar — gratis
$ npx forjabot init
✓ idioma: español · licencia: gratis
✓ giro: Barbería · bot listo para desplegar
```

--------------------------------

### Reconectar cuenta de Cloudflare

Source: https://forjabots.com/docs/solucion-de-problemas.html

Ejecuta este comando para iniciar sesión en Cloudflare a través del navegador cuando ocurran errores de autenticación o caducidad de sesión durante el despliegue.

```bash
# reconecta tu cuenta de Cloudflare (abre el navegador)
$ pnpm wrangler login
✓ sesión iniciada correctamente
```

--------------------------------

### Ejemplo de interacción con el asistente init

Source: https://forjabots.com/docs/instalacion

Muestra el flujo de preguntas y respuestas durante la inicialización del bot.

```text
? Idioma / Language      Español
? Licencia               Empezar gratis (con tu correo)
✓ licencia activada · plan: gratis
? Elige tu plantilla     Barbería
✓ bot descargado en ./barberia
→ siguiente: cd barberia · pídele a tu agente «configura mi chatbot»
```

--------------------------------

### Verificar configuración de licencia

Source: https://forjabots.com/docs/licencia.html

Comando para visualizar el contenido del archivo de configuración local donde se almacena la licencia y preferencias.

```json
$ cat ~/.forja/config.json
{
  "lang": "es",
  "key":  "HZN-XXXX-XXXX-XXXX",
  "id":   "…"
}
```

--------------------------------

### Verificar configuración del bot

Source: https://forjabots.com/docs/conexiones/whatsapp.html

Ejecuta este comando en la terminal para diagnosticar problemas de configuración en tu proyecto.

```bash
npx forjabot doctor
```

--------------------------------

### Estructura del archivo de configuración local

Source: https://forjabots.com/docs/instalacion

Archivo generado automáticamente en el equipo del usuario para persistir la licencia y el idioma entre sesiones.

```json
# guarda tu licencia y tu idioma — no toques este archivo a mano
{
  "lang": "es",
  "key":  "HZN-XXXX-XXXX-XXXX"
}
```

--------------------------------

### Inicializar Forjabot

Source: https://forjabots.com/docs/licencia.html

Comando para iniciar la configuración inicial del asistente, donde se solicita el idioma y la clave de licencia.

```bash
# pega tu HZN-… cuando te la pida — o elige "empezar gratis"
$ npx forjabot init
✓ idioma: español
✓ licencia HZN-… válida · plan pro
✓ giro: Barbería · bot listo para desplegar
```

--------------------------------

### Localizar bots mediante comandos de CLI

Source: https://forjabots.com/docs/solucion-de-problemas.html

Muestra cómo ejecutar comandos de diagnóstico cuando el bot no es detectado automáticamente.

```bash
# opción A — entra a la carpeta del bot y corre el comando ahí
$ cd ~/mis-bots/barberia
$ npx forjabot doctor
# opción B — pásale la ruta directo
$ npx forjabot doctor ~/mis-bots/barberia
```

--------------------------------

### Actualizar y desplegar Forjabot

Source: https://forjabots.com/docs/solucion-de-problemas.html

Comandos para actualizar la versión del bot y aplicar los cambios en el entorno de producción. La configuración local se mantiene intacta durante este proceso.

```bash
$ npx forjabot update
↗ versión nueva: 1.2.0 → 1.4.0
✓ actualizado · tu configuración quedó intacta
# para publicar el cambio: reinstala e implementa
$ pnpm install && pnpm deploy
```

--------------------------------

### Ejecutar Forjabot con npx

Source: https://forjabots.com/docs/instalacion

Utiliza npx para ejecutar el instalador sin necesidad de una instalación global permanente.

```bash
# no requiere instalación global — npx lo corre y lo descarta
$ npx forjabot init
```

--------------------------------

### Revalidar licencia de Forjabot

Source: https://forjabots.com/docs/solucion-de-problemas.html

Utiliza este comando para verificar o actualizar la licencia pasando la clave directamente si el archivo de configuración local presenta problemas.

```bash
# revalida pasando tu licencia directamente
$ npx forjabot doctor --key HZN-XXXX-XXXX-XXXX
✓ licencia válida · plan pro
```

--------------------------------

### Actualización de precios con el comando /precios

Source: https://forjabots.com/docs/comandos

Demuestra cómo el bot procesa cambios de precios mediante texto, fotos o dictado, mostrando una comparativa antes/después.

```text
# por texto, por foto del menú, o dictado
tú › sube 10% los cortes  ·  [foto del menú]
agente › leo el catálogo → te muestro antes/después…
✓ 6 precios actualizados — reacomodo el buscador del bot
```

--------------------------------

### Desplegar el bot en Cloudflare

Source: https://forjabots.com/docs/inicio-rapido.html

Configura la llave de API como un secreto de entorno y realiza el despliegue del bot a la infraestructura de Cloudflare Workers.

```bash
# tu llave de IA entra como secreto, no como texto
$ wrangler secret put ANTHROPIC_API_KEY
✓ secreto guardado en tu Cloudflare
$ pnpm deploy
✓ subido a Cloudflare Workers
↗ panel en vivo → https://mi-bot.tu-sub.workers.dev/admin
```

--------------------------------

### List available bots

Source: https://forjabots.com/docs/cli-ref

Displays the catalog of available AI bots, including their name, slug, and availability status.

```bash
$ npx forjabot list

  ◇ Forja  ·  bots de IA para tu negocio · por Horizontes IA

  Restaurante        restaurante          disponible
  Toma pedidos y reservas por WhatsApp, 24/7.

  Inmobiliaria       inmobiliaria         disponible
  Califica compradores y agenda visitas.

  Hotelería          hoteleria            próximamente
  Reservas de hospedaje y cotización de eventos.
```

--------------------------------

### Link a deployed bot

Source: https://forjabots.com/docs/cli-ref

Registers a deployed bot to your account and automatically configures necessary secrets. This command is idempotent and should be run after deployment.

```bash
$ npx forjabot pair

  Verificando el bot… ✓
  Registrando en tu cuenta… ✓
  Configurando secrets… ✓

  ✓ bot conectado — míralo en https://app.forjabots.com/dashboard
```

--------------------------------

### Ejecutar diagnóstico del bot

Source: https://forjabots.com/docs/solucion-de-problemas.html

Comando para verificar el estado general del bot, incluyendo la detección de carpetas, archivos de configuración, licencias y versiones disponibles.

```bash
# diagnóstico general — no toca nada, solo revisa
$ npx forjabot doctor
✓ carpeta del bot detectada · giro: barbería
✓ wrangler.toml · package.json · node_modules
✓ member/config.local.ts
✓ licencia válida · plan pro
⚠ hay una versión nueva (1.2.0 → 1.4.0)
✓ el bot responde en línea
1 aviso · todo lo demás, en orden
```

--------------------------------

### Authenticate with Forjabots CLI

Source: https://forjabots.com/docs/cli-ref

Initiates the login process to connect your terminal to your Forjabots account. Credentials are stored locally in ~/.forja/credentials.json.

```bash
$ npx forjabot login

  Abre el navegador para entrar (Google o GitHub)…
  Si no se abre: https://app.forjabots.com/api/cli/auth?...

  ✓ conectado como tu@correo.com
  Siguiente: despliega tu bot y corre  forjabot pair
```

--------------------------------

### npx forjabot list

Source: https://forjabots.com/docs/cli-ref

Lists all available bot templates from the live catalog, including their name, slug, and availability status.

```APIDOC
## npx forjabot list

### Description
Queries the live catalog and displays a list of available bots, their business category (slug), and their current status (available or coming soon).

### Usage
`npx forjabot list`
```

--------------------------------

### npx forjabot list

Source: https://forjabots.com/docs/cli-ref

Displays the catalog of available bots.

```APIDOC
## npx forjabot list

### Description
Displays the catalog of available bots. This command does not require a license.
```

--------------------------------

### Exportar datos de leads y conversaciones

Source: https://forjabots.com/docs/comandos

Comando para volcar datos de leads o transcripciones a formatos compatibles con hojas de cálculo.

```text
# tus datos son tuyos — sin candado de nivel
tú › exporta mis leads a CSV
agente › leo la base (solo lectura) → escribo el archivo…
✓ leads-2026-07-15.csv listo para Excel / Google Sheets
```

--------------------------------

### Afinación del bot mediante el comando /afinar

Source: https://forjabots.com/docs/comandos

Muestra el flujo de interacción para identificar preguntas sin respuesta y aplicar mejoras al prompt del bot.

```text
# afinar barre muchos chats y te muestra antes/después
tú › el bot no supo contestar sobre estacionamiento
agente › encontré 7 preguntas sin respuesta que se repiten…
⚠ propongo 3 arreglos · ¿los aplico? (toma efecto al desplegar)
```

--------------------------------

### Generar informe mensual de rendimiento

Source: https://forjabots.com/docs/comandos

Comando para obtener un resumen ejecutivo del rendimiento del bot, incluyendo métricas de conversaciones y escalaciones.

```text
# le hablas normal — tu agente hace lo técnico
tú › hazme el reporte del mes
agente › leo la base en solo lectura…
✓ informe-julio-2026.pdf · 312 conversaciones · 94% sin humano
```

--------------------------------

### Verificar estado del bot con forjabot doctor

Source: https://forjabots.com/docs/inicio-rapido.html

Ejecuta este comando en la terminal para validar la configuración, la licencia y la conectividad del worker.

```bash
$ npx forjabot doctor
✓ carpeta del bot · mi-bot
✓ archivos clave · wrangler.toml · package.json · member/config.local.ts
✓ configuración · BOT_NAME · BOT_NICHE · DASHBOARD_BASE_URL
✓ versión al día · 1.2.0
✓ licencia válida · plan free
✓ worker en línea · /admin responde
✓ 0 problemas — tu bot está sano
```

--------------------------------

### Gestión de campañas con el comando /campaña

Source: https://forjabots.com/docs/comandos

Ejemplo de segmentación de contactos para reactivación, destacando que el envío final requiere acción manual del usuario.

```text
# el bot solo alcanza a quien YA le escribió
tú › reactiva a los que no compraron
agente › segmento: 48 contactos tibios en ventana de 24 h…
✓ copy listo — el botón de enviar lo aprietas tú en /admin/campanas
```

--------------------------------

### forjabot login

Source: https://forjabots.com/docs/cli-ref

Authenticates your terminal with your forjabots.com account.

```APIDOC
## forjabot login

### Description
Connects your terminal to your forjabots.com account. It opens a browser for authentication via Google or GitHub and stores credentials locally.

### Usage
`npx forjabot login [--no-browser] [--force]`

### Flags
- **--no-browser**: Prevents the CLI from automatically opening the browser; prints the authentication URL instead.
- **--force**: Forces a new login session even if one is already active.
```

--------------------------------

### Ejemplo de flujo de cobro

Source: https://forjabots.com/docs/comandos

Muestra la interacción con el agente para generar un link de pago a través de un proveedor externo.

```text
# Forja no procesa pagos — el dinero llega a TU cuenta
tú › cobra el setup a mi cliente
agente › método: Stripe → genero el link de pago…
✓ link listo + registro en member/agencia/cobros.md
```

--------------------------------

### Update Forjabot

Source: https://forjabots.com/docs/cli-ref

Updates the bot to the latest version while preserving local files like configurations and knowledge bases.

```bash
$ npx forjabot update

  ◇ Forja  ·  bots de IA para tu negocio
  Revalidando licencia… ✓
  Instalado: v1.0.0  ·  Última: v1.1.0
  Bajando v1.1.0… ✓ 86 KB

  ✓ Actualizado a v1.1.0  (tu config y tu KB se conservaron)
  Para publicar los cambios, pídele a tu agente:
    "reinstala dependencias y despliega mi bot"  (pnpm install && pnpm deploy)
```

--------------------------------

### forjabot pair

Source: https://forjabots.com/docs/cli-ref

Links a deployed bot to your Forjabots dashboard.

```APIDOC
## forjabot pair

### Description
Links an already deployed bot with your app.forjabots.com panel. It registers the bot under your account and automatically configures necessary Worker secrets.

### Usage
`npx forjabot pair [dir] [--url https://…] [--name "…"]`

### Parameters
- **dir** (string) - Optional - The directory of the bot project.

### Flags
- **--url**: Specifies the Worker URL if not present in wrangler.toml.
- **--name**: Sets a custom name for the bot in the dashboard.
```

--------------------------------

### npx forjabot update

Source: https://forjabots.com/docs/cli-ref

Updates the bot to the latest version while preserving configuration and knowledge base.

```APIDOC
## npx forjabot update

### Description
Updates the bot to the latest version while preserving configuration and knowledge base.

### Parameters
#### Positional Arguments
- **dir** (string) - Optional - The directory of the bot (autodetected if omitted).

#### Flags
- **--key** (string) - Optional - License key
```
Tokens:
Raw