Docs / Inicio rápido

De cero a bot en vivo

Cinco pasos, unos 20 minutos. Al final tienes un chatbot atendiendo un canal real, con su panel de administración, corriendo en tu nube y con tu llave de IA. Tu agente hace lo técnico; tú eliges el negocio y apruebas.

Lo que necesitas

Antes de empezar, ten a la mano tres cosas. Nada de esto cuesta para arrancar:

La llave de IA no se teclea nunca en el chat: se guarda como secreto de Cloudflare al momento de desplegar (paso 2). Si te falta algo, tu agente te guía a conseguirlo en la masterclass o siguiendo la skill configurar-mi-chatbot.

Los 5 pasos

1. 1 · Crea tu bot con forjabot init

   El asistente te pregunta el idioma, valida tu licencia (o te crea una gratis al vuelo), y te deja elegir tu bot. El Chatbot Starter es gratis; los 14 giros —barbería, restaurante, inmobiliaria…— se desbloquean con Forja +. Para el Starter, corre un onboarding de ~6 preguntas de tu negocio (nombre, qué haces, tu oferta, horario, ubicación y a qué correo te avisa) y eliges el cerebro de IA. Al terminar, tu bot ya sabe a qué te dedicas.

   TerminalCopiar

   # de cero: un solo comando, gratis
   $ npx forjabot init
   ? Idioma            ›  Español
   ? Licencia          ›  Empezar gratis
   ✓ licencia creada · plan free
   ? Elige tu bot      ›  Chatbot Starter   (los 14 giros → Forja +)
   ✓ plantilla lista → ./mi-bot
   ? Cerebro de IA     ›  Claude · OpenAI · Grok
   # ~6 preguntas de tu negocio: nombre, qué haces, oferta, horario, ubicación…
   ✓ tu bot ya sabe a qué te dedicas
   → cd mi-bot · dile a tu agente: "configura mi chatbot"

2. 2 · Despliégalo a Cloudflare

   Ahora tu agente lo pone en línea. Guarda tu llave de IA como secreto (nunca queda escrita en el código ni en el chat) y publica el bot con pnpm deploy. En segundos tienes una URL propia de Cloudflare — y ahí mismo vive tu panel en /admin, protegido con contraseña. Ábrelo: es tu centro de mando.

   Terminal · lo corre tu agenteCopiar

   # 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

   Entra al panel con el usuario admin y la contraseña que definiste. Verás el Resumen con todo en cero — normal, tu bot todavía no habla con nadie. Eso cambia en el paso siguiente.

3. 3 · Conecta un canal

   Aquí tu bot deja de estar solo. Le conectas un canal para que reciba mensajes: Telegram Gratis es el más rápido para probar; WhatsApp por Twilio Forja + es el que usan la mayoría de negocios. No es un comando mágico: tu agente sigue la skill configurar-mi-chatbot paso a paso — consigue el token del canal, lo guarda como secreto y apunta el webhook a tu worker. Tú solo le das el token cuando te lo pida.

   Los canales los conecta tu agente, siguiendo una skill

   No existe un forjabot conectar. Conectar WhatsApp, Instagram, Messenger o Telegram es un procedimiento guiado que ejecuta tu agente. Dile "conéctame WhatsApp" y él hace el resto. La receta completa de cada canal está en Conexiones.

4. 4 · Haz la primera prueba

   Desde tu teléfono, mándale un mensaje real al canal que conectaste — un "hola, ¿a qué hora abren?" basta. El bot debería contestar solo, con lo que aprendió de tus ~6 respuestas. Vuelve al panel y refresca el Resumen: verás la conversación, el conteo de mensajes de las últimas 24 h y tu primer cliente único. Si algo salió raro, la sección Solución de problemas tiene los tropiezos comunes.

5. 5 · Opéralo con tu agente

   Con el bot vivo, el día a día es hablarle a tu agente. Pídele el /reporte del mes (conversaciones, escalaciones, leads), afínalo con /mantenimiento, revive clientes con /campaña. Son skills, no comandos del CLI: le hablas normal y él sabe cuál correr. El catálogo completo está en Comandos del agente.

Verifica que quedó bien

Si algo no responde o quieres una revisión rápida, corre forjabot doctor. Chequea que la carpeta y los archivos clave estén, que tu licencia siga válida, que la versión esté al día y —lo importante— que tu worker esté en línea respondiendo en /admin. Te lo dice con ✓ / ⚠ / ✗ y cuenta cuántos problemas encontró.

$ 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

Qué sigue