El agente que contesta: n8n + Claude sobre tu Chatwoot, listo para descargar

Ya tienes los canales en una bandeja (Chatwoot). Ahora falta que alguien conteste cuando no hay nadie: de noche, el fin de semana, mientras atiendes a otro. Este agente lee cada mensaje que llega a Chatwoot, contesta con lo que tú le enseñaste en diez preguntas, cotiza, agenda, y cuando el cliente pide una persona se calla y te avisa. Corre en n8n (gratis, en tu servidor) con Claude como cerebro.

1. Qué necesitas

• Chatwoot instalado y con al menos un canal conectado (WhatsApp por la API oficial, Instagram, Messenger o el chat de la web). Si no lo tienes: chatwoot.cl/descarga.
• Un servidor: puede ser el mismo de Chatwoot si tiene 4 GB de RAM; si no, otro VPS de 2 GB.
• Una llave de Claude o de Gemini: Claude se crea en platform.anthropic.com con una tarjeta (centavos por conversación); Gemini en aistudio.google.com y tiene capa gratis. Los workflows aceptan cualquiera de las dos: eliges en un campo.
• Un subdominio para n8n, por ejemplo n8n.tunegocio.cl, apuntando al servidor.
• Diez respuestas sobre tu negocio. Están en el archivo agente.md de la descarga. Es lo único que el técnico no puede hacer por ti.

2. Descarga

3. Instalar n8n en 5 pasos

1. Docker, si el servidor no lo tiene:

   curl -fsSL https://get.docker.com | sh

2. Copia la carpeta al servidor y entra en ella.
3. Tu .env: el subdominio y dos claves.

   cp .env.example .env
   openssl rand -hex 32   # dos veces: POSTGRES_PASSWORD y N8N_ENCRYPTION_KEY
   nano .env

4. El Caddyfile con el mismo subdominio; el DNS tiene que apuntar al servidor antes de levantar.
5. Levanta y crea tu usuario:

   docker compose up -d

   Abre https://n8n.tunegocio.cl: la primera vez te pide nombre, correo y contraseña.

4. Conectar Chatwoot con n8n

Son dos credenciales, un bot y un clic por bandeja. Lo probamos en nuestra instalación antes de escribirlo:

1. Un agente «Asistente» en Chatwoot (Configuración → Agentes → Agregar): es la identidad con la que el agente lee y contesta. Entra con ese usuario, abre Perfil → Token de acceso y cópialo. El token de un bot no sirve: Chatwoot no le deja leer la conversación.
2. En n8n → Credenciales: «Chatwoot (token de acceso)» (tipo Header Auth, nombre api_access_token, valor = ese token) y la del modelo: «Anthropic» (Header Auth, nombre x-api-key) o «Gemini» (Header Auth, nombre x-goog-api-key). En el workflow 2, el campo proveedor dice cuál usas.
3. Un bot en Chatwoot (Configuración → Integraciones → Bots → Agregar): en URL saliente pega la URL del webhook del workflow 1 · input (n8n la muestra al abrir el primer nodo). Desde ese momento, cada mensaje nuevo en las bandejas donde el bot esté asignado llega a n8n, mientras la conversación siga pendiente.
4. Asigna el bot a cada bandeja donde quieras que conteste (Bandejas → la bandeja → Bots). Donde no lo asignes, no contesta: así partes con un canal y sumas los otros después. Cuando el agente deriva, pasa la conversación a abierta y una persona la toma.
5. Activa los workflows 2 y 3 antes que el 1: n8n no deja encender un workflow que llama a otro apagado.

5. Las diez preguntas (el prompt)

El archivo agente.md es el «manual del empleado» del agente. Tiene diez secciones con llaves como {{QUE_VENDES}}; las rellenas con tus palabras y lo pegas en el nodo Agente de n8n. Las diez:

1. Qué vendes y a quién (y a qué zona llegas).
2. Precios y horarios que sí puede decir.
3. Cómo hablamos: tú o usted, corto, con o sin humor.
4. Lo que no promete nunca: descuentos, plazos, garantías.
5. Cuándo le pasa la conversación a una persona, y a quién.
6. Cómo se agenda.
7. Dirección, teléfono, correo, web.
8. Preguntas frecuentes con la respuesta exacta.
9. Qué hace con notas de voz, fotos y documentos.
10. Memoria: no pregunta lo que el cliente ya dijo.

Regla que evita el 90 % de los problemas: si no está en el archivo, el agente no lo dice. Pregunta o deriva.

6. Los tres workflows: input · agente · router

No es un solo workflow gigante; son tres pequeños, y por eso se entienden y se arreglan:

• input: recibe el webhook de Chatwoot, ignora lo que no es un mensaje de cliente, junta los mensajes seguidos (la gente escribe en tres líneas), transcribe la nota de voz si la hay y arma el contexto: los últimos mensajes de esa conversación.
• agente: le da a Claude el prompt de las diez preguntas más el contexto y recibe una respuesta con una decisión: contestar, agendar o pasar a una persona. Antes de salir revisa la respuesta: sin precios que no estén en el archivo, sin links de terceros, sin promesas.
• router: publica la respuesta en la conversación de Chatwoot (y Chatwoot la manda por el canal que sea: WhatsApp, Instagram, Messenger o la web), o marca la conversación como pendiente de humano y te avisa.

7. Probar antes de soltarlo

Cinco mensajes desde tu propio celular, antes de asignar el bot a la bandeja de verdad: (1) una pregunta que está en el archivo, (2) una que no está, (3) «quiero hablar con una persona», (4) una nota de voz, (5) un mensaje en tres partes seguidas. Si contesta bien las cinco, y en la (2) pregunta en vez de inventar, lo sueltas. Si no, ajustas el archivo, no el código.

8. Qué cuesta

• n8n: gratis en tu servidor (licencia de uso sostenible: puedes usarlo para tu negocio sin pagar).
• El modelo: Gemini tiene capa gratis (suficiente para una pyme que parte). Claude se paga por uso: una conversación normal usa unos pocos miles de tokens; con Claude Haiku son centavos de dólar por conversación.
• Servidor: el mismo de Chatwoot, o US$ 6–12 al mes aparte.