Máquina de Ventas IA
Escala sin equipo adicional
SmartyGroup · Ecosistema IA · Guía Paso a Paso

Ecosistema de IA
para Ventas con WhatsApp

Aprende a integrar Chatwoot, WhatsApp API y N8N para crear un sistema que atiende, califica y cierra clientes de forma automática — sin código, sin equipo adicional.

3-4h de implementación
3 partes
100% paso a paso
Parte 01 · Fundamentos

Cada lead atendido.
Cada venta cerrada. Automático.

⏱️ ~1.5 horas

El Problema que Resuelve

💡
Sin este ecosistema

Problema: Responder mensajes manualmente, perder leads, no escalar atención, respuestas lentas.
Costo: Contratar equipo, retrasos, clientes insatisfechos.

Con este ecosistema

Solución: Respuestas automáticas con IA, escalar sin equipo, disponibilidad 24/7, manejo de múltiples canales.
Beneficio: Más ventas, costos bajos, clientes felices.

Los 4 Componentes (y cómo hablan entre sí)

Componente Función ¿Por qué lo necesitas?
Chatwoot Centro de control de conversaciones Recibe mensajes de WhatsApp, Instagram, email, SMS en un solo lugar
WhatsApp API Conecta tu número de WhatsApp Business Automatización y webhooks (no es WhatsApp normal)
N8N Motor de automatización y orquestación Procesa mensajes, integra IA, ejecuta lógica de negocio
Meta Business Control de acceso y permisos Verifica WhatsApp, genera tokens, asigna permisos

Flujo: Cómo todo trabaja junto

1
Cliente envía mensaje por WhatsApp

"Hola, ¿cuánto cuesta tu servicio?"

2
Meta recibe y almacena el mensaje

A través de la WhatsApp API oficial de Meta

3
Chatwoot recibe el mensaje

Aparece en tu bandeja de entrada (Inbox)

4
Webhook enviado a N8N

N8N recibe el mensaje y comienza a procesar

5
N8N procesa con IA

Analiza intención, busca información, genera respuesta

6
Dos caminos posibles

A) Respuesta automática: Si IA puede resolver → envía respuesta
B) Escalado: Si es complejo → asigna a un agente

7
Conversación continúa

En Chatwoot (automática o con agente humano)

Requisitos Antes de Empezar

✅ Infraestructura Técnica
✅ Cuentas y Permisos de Meta

Instalar Chatwoot

Primer paso: configurar tu centro de control de conversaciones en la VPS.

Paso 1: Acceder a EasyPanel

🔑
Credenciales

Las recibiste por email cuando contrataste la VPS. URL típica: https://panel.tudominio.com:3000

  1. Abre tu panel de EasyPanel
  2. Ingresa con tu usuario y contraseña
  3. Verifica que estés en el servidor correcto

Paso 2: Crear Contenedor Docker de Chatwoot

1
En EasyPanel: Applications o Docker Services

Busca la sección de aplicaciones/servicios

2
Busca "Chatwoot"

En el marketplace de aplicaciones disponibles

3
Selecciona versión reciente

Versiones disponibles: https://hub.docker.com/r/chatwoot/chatwoot/tags

4
Configurar

• Dominio: chatwoot.tudominio.com
• SSL: Activar (HTTPS)
• Contraseña admin: Define una fuerte

5
Deploy

Espera 5-10 minutos a que se instale

Paso 3: Acceder y verificar

URL
https://chatwoot.tudominio.com
  1. Abre esa URL en tu navegador
  2. Ingresa con tu usuario admin (ese que creaste)
  3. Verifica que el dashboard esté visible
  4. ✓ Chatwoot está listo
⏱️
Tiempo estimado

20-25 minutos desde que presionas Deploy

Configurar Meta Business y WhatsApp

Crear la app en Meta y preparar WhatsApp para funcionar con Chatwoot.

Paso 1: Crear App en Meta

1
Accede a Meta Business Manager

https://business.facebook.com/

2
Mis Aplicaciones (esquina superior)

Busca el botón con ese nombre

3
Crear Aplicación

Click en "Crear aplicación"

4
Selecciona tipo

• Tipo: "Otros"
• Caso de uso: "Negocio"

5
Selecciona Portafolio Comercial

Elige tu portafolio de Meta Ads

Paso 2: Agregar WhatsApp a la App

  1. En tu app creada, busca el producto "WhatsApp"
  2. Click en "Configurar" o "Agregar producto"
  3. Selecciona tu número de WhatsApp Business
  4. Si no tienes número, crea uno aquí

Paso 3: Crear Política de Privacidad

⚠️
Requisito obligatorio

Meta requiere una política de privacidad accesible públicamente

Opción 1: Google Docs (rápido)

  1. Abre Google Docs
  2. Crea documento: "Política de Privacidad - [Tu empresa]"
  3. Contenido mínimo:
    • Qué datos recolectas
    • Cómo se usan
    • Cómo se almacenan
    • Derecho a eliminar datos
  4. Compartir → Cambiar a "Público"
  5. Copiar el link público

Paso 4: Marcar App como Desarrollo

  1. En tu app → Settings → Información general
  2. Modo de la aplicación: "Desarrollo"
  3. Pegá el link de la política de privacidad
  4. Guardar
ℹ️
Estado esperado

En Configuración → General: verás el estado de tu WhatsApp
Si dice "VERIFICADO": ✅ Listo para siguiente paso
Si dice "PENDIENTE": Forzamos verificación en próxima sección

Generar Credenciales y Tokens

Los datos que necesitamos para conectar Meta → Chatwoot → N8N.

📝
Abre un documento

Copia todos estos datos en un documento seguro. Los usarás en las próximas secciones.

Paso 1: Obtener ID de número de teléfono

1
Accede a Business Manager

https://business.facebook.com/

2
Ve a: Configuración → Números de teléfono WhatsApp

Busca esta opción en el menú lateral

3
Copia el ID de tu número

Formato: 123456789012345 (números largos)

Paso 2: Forzar verificación si está PENDIENTE

Si tu WhatsApp aún está en "PENDIENTE":

URL
https://developers.facebook.com/tools/explorer/
  1. Abre esa URL
  2. Selector de app: selecciona tu app
  3. Método: POST
  4. En "URL de solicitud", escribe: TU_ID_NUMERO/register
    (Reemplaza TU_ID_NUMERO con el que copiaste arriba)
  5. Agrégá estos parámetros:
    • messaging_product = whatsapp
    • pin = 654321
    • whatsapp_business_management = true
    • whatsapp_business_messaging = true
    • whatsapp_business_manage_events = true
  6. Click en "Enviar"
  7. Verifica que diga "success" en la respuesta

Paso 3: Crear usuario con permisos

1
En Business Manager → Usuarios del sistema

Menú lateral → Usuarios

2
Click en "Agregar"

Crear nuevo usuario

3
Completa datos

• Nombre: puedes poner "Bot Chatwoot"
• Email: un email que controles
• Rol: "Administrador"

4
Asignar activos

• Aplicaciones: Tu app WhatsApp
• Cuentas de WhatsApp: Tu número

Paso 4: Generar Token Permanente

Este es el token más importante — cuídalo.

  1. En tu app → Configuración → Tokens
  2. Click en "Generar token de acceso"
  3. Usuario: El que creaste en el Paso 3
  4. Vencimiento: "NEVER" (para que no expire)
  5. Permisos: Marca TODAS las opciones de WhatsApp:
    • whatsapp_business_management
    • whatsapp_business_messaging
    • whatsapp_business_manage_events
  6. Click en "Generar"
  7. CÓPIA ESTE TOKEN EN TU DOCUMENTO SEGURO

Paso 5: ID de Cuenta WhatsApp Business

  1. En Business Manager → Cuentas de WhatsApp Business
  2. Selecciona tu cuenta
  3. Cópia el ID (números largos)
  4. Guarda en tu documento
📋
Tu documento debe tener

✅ ID de número de teléfono
✅ Token permanente
✅ ID de cuenta WhatsApp Business

Integrar WhatsApp en Chatwoot

Conectar tus credenciales de Meta a Chatwoot para que reciba mensajes de WhatsApp.

Paso 1: Crear Inbox en Chatwoot

1
Abre Chatwoot

https://chatwoot.tudominio.com

2
Ve a: Settings → Inboxes

En el menú lateral izquierdo

3
Click en "Añadir Inbox"

Botón rojo "Add Inbox"

4
Selecciona el canal

• Opción: "WhatsApp"
• Tipo: "WhatsApp Cloud" (la API oficial)

Paso 2: Ingresar credenciales de Meta

Relleña estos campos con los datos que guardaste:

Campo en Chatwoot Qué copiar
Token de acceso El token permanente que generaste
ID de cuenta WhatsApp Business El ID que copiaste en Paso 5 de sección anterior

Paso 3: Verificar conexión

  1. Click en "Verificar y guardar"
  2. Espera 10-30 segundos
  3. Debería mostrar: "Conectado ✓" (en verde)
  4. Si hay error, verifica que copiaste los datos correctamente

Paso 4: Suscribirse a webhooks

Para que Chatwoot reciba mensajes en tiempo real:

  1. En el mismo Inbox de WhatsApp
  2. Busca sección "Webhooks" o "Subscriptions"
  3. Marca estas opciones:
    • ✅ messages (recibir mensajes)
    • ✅ flows (recibir eventos)
  4. Click en "Guardar"

Paso 5: Test

¡Momento de verdad!

  1. Abre WhatsApp en tu teléfono
  2. Busca tu número de WhatsApp Business
  3. Envía un mensaje: "Hola, ¿funciona?"
  4. Ve a Chatwoot → Inbox de WhatsApp
  5. ¿Aparece el mensaje? ✅ ¡Funcionó!
Checkpoint

Si los mensajes aparecen en Chatwoot, ya pasaste 50% del proceso. Ahora configuramos N8N para automatizar respuestas.

Parte 03 · Automatización con IA · ~1.5 horas

Conectar N8N
y Activar IA

Configurar webhooks, crear workflows de automatización, e integrar IA para procesar mensajes automáticamente.

⚙️ Automatización 🤖 IA 🕐 ~1.5 horas

El Flujo Completo

Cliente envía mensaje → Chatwoot recibe → Webhook a N8N → IA procesa → Respuesta automática o escalado

🔄
¿Por qué N8N?

N8N es el "director de orquesta". Recibe el mensaje, lo procesa con IA, decide si responder automático o escalar a un agente, y envía la respuesta. Todo esto sin código.

Paso 1: Acceder a N8N

N8N ya debería estar instalado en tu EasyPanel.

URL
https://n8n.tudominio.com
  1. Abre esa URL
  2. Login con tus credenciales
  3. Te debería mostrar la página de workflows

Paso 2: Crear primer Workflow

1
Click en "New"

Crear nuevo workflow

2
Click en "New Workflow"

Opción principal

3
Dale un nombre

Ejemplo: "Procesar Mensajes WhatsApp"

4
Click en "Create"

Se abre el editor visual

Paso 3: Agregar Trigger (Webhook)

El Trigger es el "inicio" — cuándo se ejecuta el workflow.

  1. En el editor, click en "Add Trigger"
  2. Busca: "Webhook"
  3. Selecciona: "Webhook"
  4. Configuración:
    • Method: POST
    • Path: Auto-generado (NO CAMBIES)
  5. Copia la URL completa que aparece (necesitarás en Chatwoot)

Paso 4: Guardar URL para después

Esta URL irá en la Consola de Super Admin de Chatwoot:

✦ Guarda esta URL

https://n8n.tudominio.com/webhook/uuid-del-webhook

Paso 5: Agregar nodo IF (Filtro)

Filtramos solo mensajes entrantes de clientes (no respuestas de bots).

  1. Click en "+" (agregar nodo)
  2. Busca: "IF"
  3. En la Condition, copia este código:
    javascript
    $json.body.event === 'message_created' &&
    $json.body.conversation.messages[0].sender_type === 'Contact' &&
    $json.body.message_type === 'incoming'

Paso 6: Agregar IA (OpenAI o alternativa)

Aquí es donde la IA genera respuestas.

Opción A: Si tienes API key de OpenAI

  1. Click en "+" → Busca "OpenAI" → Selecciona "Chat Model"
  2. Credenciales: Agrega tu API key de OpenAI
  3. Prompt:
    prompt
    Eres un agente de ventas profesional.
    Responde en 1-2 frases. Sé amable y útil.
    Mensaje del cliente: {{ $json.body.conversation.messages[0].content }}

Opción B: Respuesta manual (para testing)

  1. Click en "+" → Busca "Manual" → Selecciona "Function"
  2. En el código, escribe una respuesta simple

Paso 7: Enviar respuesta a Chatwoot

El último nodo — devuelve la respuesta a Chatwoot.

  1. Click en "+" → Busca "HTTP Request"
  2. Method: POST
  3. URL: https://chatwoot.tudominio.com/api/v1/...
    (Tu admin de Chatwoot te proporciona esta URL)
  4. Headers:
    • Authorization: Bearer [tu-token-chatwoot]
  5. Body: JSON con el mensaje y conversation_id

Paso 8: Testing

✅ Test Workflow
🚀
¡Lo lograste!

Si pasaste todos los tests, ya tienes un ecosistema de IA funcionando. Cliente envía mensaje → IA responde automáticamente. Próximos pasos: mejorar prompts, agregar lógica, escalar a producción.