Manual de Usuario

Bienvenida a Venbot

Tu plataforma de e-commerce automatizado con IA

Venbot es una plataforma multi-tenant que automatiza la venta de productos en LATAM combinando IA generativa, anuncios pagados y un bot de WhatsApp. Tú subes la foto de un producto y Venbot:

  • Genera el copy de venta, SEO y guion de video con IA
  • Crea imágenes publicitarias en distintos estilos
  • Lanza campañas en Meta Ads segmentadas por edad y género
  • Atiende a los clientes en WhatsApp 24/7 y cierra ventas
  • Notifica al cliente en cada paso del envío

Tus primeros 5 minutos

  1. Configura tu API key de Gemini (gratis) o Claude/OpenAI
  2. Crea tu primer producto con foto y descripción
  3. Espera 1-3 minutos a que la IA genere todo el contenido
  4. Lanza tu primera campaña (opcional, requiere Meta Ads configurado)

⚙️ Configuración inicial

Lo que tienes que poner antes de usar la app.

🧠 Proveedor de IA

Venbot funciona con tres proveedores. Elige uno según tu presupuesto:

✨ Gemini

Gratis hasta cierto uso. Recomendado para empezar.

Key en aistudio.google.com

🔮 Claude

Mejor calidad de texto. Pago por uso.

Key en console.anthropic.com

🤖 ChatGPT

Soporta DALL-E para imágenes pagas.

Key en platform.openai.com

Pasos: Sidebar → Configuración → sección Inteligencia Artificial → escoge proveedor → pega tu key → escoge modelo del dropdown → Guardar.

🎬 Generación de video (opcional)

Si quieres que cada producto tenga un video promocional automático:

  • Kling AI — recomendado, video cinemático con tu producto. klingai.com
  • Higgsfield — movimiento de cámara más artístico. higgsfield.ai
  • HeyGen — videos con avatar humano hablando. heygen.com

Si no configuras ninguno, los productos se generan sin video (solo texto + imágenes).

🛍️ Shopify (opcional)

Si tienes una tienda Shopify, Venbot publicará automáticamente cada producto generado.

  1. Ve a tu admin Shopify → AppsDevelop apps
  2. Crea una app personalizada con scopes: write_products, write_inventory
  3. Copia el Access Token y la URL de tu tienda (sin https://)
  4. Pégalo en Configuración → sección Shopify

📱 WhatsApp Business (opcional, para el bot)

Sin esto, el bot no recibe ni responde mensajes.

  1. Ve a developers.facebook.com → tu app → WhatsApp
  2. Pega tu Phone Number ID y Access Token en Configuración
  3. En la sección URLs de Webhooks, copia la URL de WhatsApp
  4. Pégala en Meta Developers → Configuration → Callback URL
  5. Define un Verify Token en ambos lados (Meta y Venbot — debe ser el mismo)
  6. Suscríbete al evento messages

📧 Email SMTP (opcional)

Necesario solo si quieres enviar correos automáticos a los clientes (confirmación de pedido, estado de envío). Funciona con Gmail (con app password), SendGrid, Resend, Mailgun, etc.

📦 Gestionar productos

Cómo crear y administrar tus productos.

Crear un producto

  1. Sidebar → Productos → botón + Nuevo producto
  2. Paso 1 (Datos): Nombre, descripción para la IA, precio, inventario. La descripción es importante: dile a la IA qué tiene de especial el producto, a quién va dirigido, qué problema resuelve.
  3. Paso 2 (Fotos): Arrastra hasta 10 fotos del producto real. La IA las analiza para generar contenido más preciso. Sin fotos también funciona, pero el resultado es más genérico.
  4. Click en "Crear con mis fotos". El producto aparece en la lista con la barra de progreso de IA.

¿Qué muestra cada estado?

5%En cola — esperando worker
25%Generando copy de venta y guion
50%Generando imágenes publicitarias
75%Procesando video (si tienes Kling/Higgsfield)
90%Publicando en Shopify (si está configurado)
✓ CompletoListo para lanzar campaña

Ver el detalle del producto

Click en "Ver detalle" en la fila del producto. Verás:

  • Título SEO optimizado para Google
  • Descripción persuasiva (150-200 palabras)
  • 5 bullet points de beneficios
  • 21 variantes de copy (4 grupos de edad × M/F/todos) listas para anuncios
  • Imágenes generadas (galería)
  • Video promocional (si aplica)
  • Guion de video

Si algo quedó mal, puedes regenerar todo el contenido con un click.

🤖 Pipeline de IA — qué genera y cuánto cuesta

El flujo completo cuando creas un producto.

Paso Proveedor (gratis) Proveedor (pago) Tiempo
Texto (copy + SEO + guion) Gemini 2.5 Flash Claude / GPT-4o ~30s
Imágenes (3 estilos) Pollinations Flux Imagen 3 / DALL-E 3 ~60s
Video (5-10 seg) — (omitido) Kling / Higgsfield / HeyGen 2-5 min
Publicación Shopify N/A Shopify API ~5s

💡 Estrategia recomendada para empezar

Usa solo Gemini + Pollinations en tus primeros productos. Es 100% gratis. Cuando valides que un producto vende, mejora ese específico subiendo a Imagen 3 para imágenes más realistas y agregando Kling para video.

📣 Campañas Meta Ads

Cómo lanzar y administrar anuncios en Facebook e Instagram.

Crear una campaña

  1. Sidebar → Campañas+ Nueva campaña
  2. Nombre descriptivo (ej. "Licuadora — Verano 2026")
  3. Selecciona el producto a promocionar (debe tener contenido IA generado)
  4. Presupuesto diario en USD (mínimo $5 recomendado para Meta)
  5. ROAS mínimo: si la campaña baja de este múltiplo, se auto-pausa cada 30 min
  6. Fechas de inicio/fin (opcional)

Estados

Borrador — creada pero no enviada a Meta. Editable libre.
Activa — corriendo en Meta. Los cambios se sincronizan al guardar.
Pausada — pausada en Meta. Reactívala cuando quieras.
Error — Meta rechazó algo. Revisa los logs del worker.

Segmentación automática

Venbot crea 7 conjuntos de anuncios automáticamente, cada uno con su propio copy:

18-24 M
18-24 F
25-34 M
25-34 F
35-44 M
35-44 F
45+

Cada uno recibe 1/7 del presupuesto. Países por defecto: CO, MX, PE, EC.

Auto-pausa por bajo ROAS

Cada 30 minutos, Venbot revisa todas las campañas activas. Si el ROAS de la campaña cae bajo el mínimo que definiste, los AdSets que más están perdiendo se pausan automáticamente. Esto protege tu presupuesto sin que tengas que estar pendiente.

💬 Bot de ventas

Cómo funciona y cómo intervenir cuando hace falta.

Flujo automático

  1. Cliente ve un anuncio Meta y escribe a tu WhatsApp
  2. Venbot procesa el mensaje con la IA (Claude/Gemini) usando el contexto del producto
  3. Genera respuesta en español natural y la envía
  4. Si la confianza es alta (>50%), sigue conversando solo
  5. Si baja (objeciones complejas, queja, devolución), transfiere a humano y aparece un aviso amarillo en la conversación
  6. Cuando el cliente confirma compra, el bot pide datos de envío y crea el pedido

Responder manualmente

Sidebar → Bot de Ventas → click en una conversación → escribe en el campo de abajo → Enter para enviar (Shift+Enter para nueva línea).

Apenas envías un mensaje, la conversación pasa a estado transferida — el bot no intervendrá más hasta que cierres la conversación o vuelvas a marcarla como activa.

Estados de conversación

ActivaEl bot responde automáticamente
TransferidaEsperando respuesta humana, el bot ya no responde
CerradaConversación archivada

🛒 Pedidos

Gestionar el ciclo de vida de cada venta.

Estados

⏳ Pendiente — recién creado por el bot
✓ Confirmado — pago verificado, listo para envío
📦 Enviado — entregado a transportadora
🚚 En camino — rastreo activo
🎉 Entregado — cliente lo recibió
❌ Fallido / Cancelado — algo salió mal

Cambiar estado y notificar

  1. Sidebar → Pedidos
  2. Click en "Cambiar estado"
  3. Escoge nuevo estado, número de seguimiento y transportadora si aplica
  4. Marca "Notificar al cliente" (default: sí)
  5. Guardar — el cliente recibe automáticamente WhatsApp + email

Rastreo automático con Dropi

Si tienes Dropi configurado, cada 2 horas Venbot consulta el estado de los envíos activos y notifica al cliente automáticamente sin que tengas que tocar nada.

👥 Clientes

Tu CRM básico integrado.

Los clientes se crean automáticamente cuando:

  • Alguien escribe a tu WhatsApp por primera vez
  • Cierras una venta por el bot
  • Los agregas manualmente desde la vista de Clientes

De cada cliente ves: total de pedidos y total gastado. Útil para identificar tus mejores clientes y enfocarte en retenerlos.

Buscador en tiempo real por nombre, email, teléfono o WhatsApp.

💳 Mi plan y límites

Cuánto consumes y cómo cambiar de plan.

Lo que mide tu plan

  • Productos creados — cuántos productos activos puedes tener
  • Campañas activas — cuántas campañas puedes tener corriendo a la vez
  • Mensajes bot/mes — cuántos mensajes responde el bot al mes

Ver tu uso en tiempo real

Sidebar → Mi Plan → barras de progreso por cada métrica. Verde si vas bien, amarillo cerca del límite, rojo si lo excediste.

Cuando excedes un límite: el endpoint correspondiente devuelve 402 Payment Required con un mensaje claro pidiéndote subir de plan. Tus datos siguen seguros, solo no puedes crear nuevos hasta liberar espacio o actualizar.

❓ Preguntas frecuentes

Probablemente el worker Celery no está procesando tareas. Causas comunes: (1) tu API key de IA es inválida o expiró, (2) excedió rate limit del proveedor (Gemini free tiene límite por minuto), (3) falló la conexión a Redis. Revisa los logs del contenedor o reinstala tu API key.
El paso 1 (texto) se completó pero el paso 2 (imágenes) falló. Si usas Pollinations gratis, a veces el servicio se cae unos minutos. Espera 5 min e intenta regenerar el contenido desde el detalle del producto.
Verifica que (1) tu key de Kling sea válida, (2) tu producto tenga al menos una foto subida — Kling necesita una imagen de referencia, (3) el guion del video no esté vacío. Los videos tardan 2-5 min, paciencia.
Click en la campaña, revisa el detalle. Causas típicas: (1) tu Ad Account no tiene método de pago activo, (2) Meta rechazó las imágenes por políticas, (3) el píxel no está configurado. Meta es estricto con primer lanzamiento — usa anuncios genéricos al inicio.
Probablemente el modelo IA no tiene suficiente contexto del producto. Asegúrate de que el producto tenga descripción detallada (no solo el nombre) y que el contenido IA esté generado. El bot usa el guion del video como contexto principal.
Tu cuenta queda en estado "suspendida" — no puedes crear cosas nuevas pero los datos siguen ahí. Después de 90 días sin actividad se eliminan permanentemente. Backup de tus pedidos es tu responsabilidad (export desde la lista de pedidos).
Por ahora hay que hacerlo una a una. En próximas versiones agregaremos templates de respuesta rápida y autoasignación a agentes.
Sí. En el panel admin → tu app → Domains. Agrega tu dominio (ej. tienda.midominio.com) y apunta el DNS A al IP del servidor. Coolify emite el cert SSL automático.

¿No encontraste lo que buscabas?

El manual técnico está en github.com/Juliandrp/venbot/docs