Chatwoot en una tarde: descarga, instala y conecta WhatsApp, Instagram, Messenger y tu web

Chatwoot es una bandeja de entrada donde llegan todos los mensajes de tu negocio: WhatsApp, Instagram, Messenger y el chat de tu web. Tú o tu equipo contestan desde un solo lugar. Es software de código abierto (gratis) y se instala en un servidor tuyo. Aquí está la descarga lista. Más abajo, lo que casi nadie explica: cómo conectar WhatsApp por la API oficial de Meta, con tu número, sin que te lo cierren.

1. Qué necesitas antes de empezar

• Un servidor (VPS) con Ubuntu 22.04 o más nuevo, 2 vCPU y 4 GB de RAM. Cuesta entre US$ 12 y 24 al mes en cualquier proveedor (Hetzner, DigitalOcean, Vultr, Contabo).
• Un subdominio apuntando a la IP del servidor, por ejemplo chat.tunegocio.cl. Se configura en el panel donde compraste el dominio (registro A).
• Un correo con SMTP (el de tu dominio, Google Workspace, Brevo…) para que Chatwoot pueda invitar agentes y recuperar contraseñas.
• Para WhatsApp: un Business Manager de Meta con la verificación de negocio aprobada (se pide en business.facebook.com con documentos de la empresa; tarda de 1 a 5 días), un número de teléfono que controles, y un medio de pago cargado en ese Business Manager.
• Para Instagram y Messenger: la Página de Facebook y la cuenta profesional de Instagram conectadas a ese mismo Business Manager.

Si te falta la verificación de negocio, pídela hoy. Es lo único de esta lista que no depende de ti ni de tu técnico.

2. Descarga

3. Instalar en 7 pasos

Todo se hace por terminal en el servidor. Si nunca lo hiciste, tu técnico lo termina en una tarde.

1. Instala Docker (una sola línea, en Ubuntu):

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

2. Copia la carpeta descomprimida al servidor (por scp o pegando los archivos) y entra en ella.
3. Crea tu .env a partir del ejemplo y edita tres cosas: el dominio, las tres claves y el correo SMTP.

   cp .env.example .env
   openssl rand -hex 32   # repítelo 3 veces: SECRET_KEY_BASE, POSTGRES_PASSWORD, REDIS_PASSWORD
   nano .env

4. Pon tu subdominio en el Caddyfile. El DNS tiene que apuntar al servidor antes de levantar: Caddy pide el certificado HTTPS solo en ese momento.
5. Prepara la base de datos (una vez):

   docker compose run --rm rails bundle exec rails db:chatwoot_prepare

6. Levanta todo:

   docker compose up -d

7. Crea tu usuario en https://chat.tunegocio.cl/app/auth/signup. Después, en el .env, cambia ENABLE_ACCOUNT_SIGNUP=false y vuelve a correr docker compose up -d: así nadie más puede crearse cuentas en tu Chatwoot.

Ya tienes tu bandeja. Ahora, los canales.

4. Conectar WhatsApp por la API oficial (sin riesgo de ban)

Hay dos formas de «enganchar» WhatsApp a un sistema. La no oficial simula un celular que lee tu WhatsApp: es rápida de montar y es la que Meta detecta y cierra. La oficial (WhatsApp Cloud API) vive dentro de tu Business Manager, con tu verificación y tu número: Meta la aprueba, y lo único que puede cerrarte es hacer spam. Chatwoot usa la oficial. Estos son los pasos, en orden:

1. En developers.facebook.com → Mis apps → Crear app → tipo Empresa. Asóciala a tu Business Manager. Agrega el producto WhatsApp.
2. Agrega tu número en WhatsApp Manager (te llega un código por SMS o llamada). Si el número ya está en la app WhatsApp Business del celular, tienes que sacarlo de la app primero: los chats antiguos no se migran. Muchos negocios prefieren un número nuevo y avisar a los clientes.
3. Crea un token permanente: en el Business Manager → Usuarios del sistema → nuevo usuario de sistema (rol administrador) → Generar token con los permisos whatsapp_business_messaging y whatsapp_business_management. Guárdalo: es la llave.
4. En Chatwoot → Configuración → Bandejas de entrada → Agregar → WhatsApp → proveedor WhatsApp Cloud. Pega el número, el Phone number ID, el Business Account ID (los dos salen en la pestaña WhatsApp de tu app) y el token.
5. Webhook: Chatwoot te muestra una URL de callback y un token de verificación. Pégalos en tu app de Meta → WhatsApp → Configuración → Webhooks, y suscribe el campo messages. Desde ese momento, cada mensaje entra en Chatwoot.
6. Plantillas: para escribirle tú primero a un cliente (más de 24 horas después de su último mensaje) necesitas plantillas aprobadas por Meta. Se crean en WhatsApp Manager y Chatwoot las lista solas.

Lo que cuesta: Chatwoot, nada. Contestar dentro de las 24 horas siguientes a un mensaje del cliente no tiene costo de Meta. Escribirle tú primero (con plantilla) se cobra por mensaje, según el país y el tipo de plantilla; el cargo llega al medio de pago de tu Business Manager.

5. Instagram y Messenger

Los dos entran por la misma app de Meta que creaste arriba. Agrega el producto Messenger y, dentro, la configuración de Instagram. En el .env completa FB_APP_ID, FB_APP_SECRET y los dos tokens de verificación, y reinicia (docker compose up -d).

• Messenger: en Chatwoot → Bandejas → Agregar → Messenger: inicia sesión con Facebook y elige la Página.
• Instagram: mismo camino → Instagram. Requiere cuenta profesional conectada a la Página.
• La revisión de Meta: para que la app reciba mensajes de cualquier persona (no solo de los administradores) Meta revisa los permisos pages_messaging e instagram_manage_messages. Se pide desde la app, con un video corto mostrando el uso, y tarda algunos días. Hasta entonces funciona en modo desarrollo con tu propia cuenta.

6. El chat de tu web

En Chatwoot → Bandejas → Agregar → Sitio web: nombre, dominio, color. Te entrega un fragmento de código; pégalo antes de </body> en tu sitio (o en Google Tag Manager). Las conversaciones del sitio llegan a la misma bandeja que WhatsApp.

7. Lo que sigue: el agente que contesta solo

Con los canales en Chatwoot, el siguiente paso es que un agente conteste de noche, cotice y agende — y te pase la conversación cuando haga falta. Se monta con n8n y Claude sobre esta misma instalación. La descarga y la guía están en n8n.cl/descarga.