Qué cambió en Chatwoot Cloud en julio de 2026
En julio de 2026, el equipo de Chatwoot publicó una actualización de la política del plan Cloud gratuito. Según las publicaciones en el blog, las siguientes funciones se movieron detrás de un plan de pago:
- Acceso a la API REST: todas las rutas /api/v1/profile, /api/v1/accounts/{id}/conversations, contactos, etiquetas y todos los endpoints de gestión devuelven ahora HTTP 401 para las cuentas en el plan gratuito.
- Webhooks salientes: los eventos conversation_created, message_created, conversation_status_changed y otros ya no se envían a las URL configuradas.
- Integraciones con terceros: cualquier flujo de trabajo en n8n, Activepieces, Zapier o Make que dependa de un token de API de Chatwoot Cloud deja de funcionar sin aviso previo visible en el panel de control.
Qué está bloqueado en el plan gratuito de Chatwoot Cloud
- Llamadas a la API REST: todas las rutas
/api/v1/…devuelven HTTP 401 para tokens emitidos por una cuenta en el plan Free - Webhooks salientes: los eventos de conversación y mensaje ya no se envían a las URL configuradas
- Integraciones n8n: los nodos de Chatwoot y las llamadas HTTP directas a la API Cloud fallan silenciosamente o devuelven un error de autenticación
- Integraciones Activepieces: cualquier trigger o acción que consuma un token de API de Chatwoot Cloud está inoperativo
- Sincronización con CRM: los conectores que envían conversaciones de Chatwoot a un CRM a través de la API están cortados
- Informes automatizados: los scripts que agregan estadísticas de soporte a través de la API ya no pueden autenticarse
Plan Cloud gratuito vs self-hosted: tabla comparativa
Desplace la tabla
| Criterio | Cloud gratuito | Self-hosted |
|---|---|---|
| Acceso a la API REST | Bloqueado desde julio de 2026 | Completo, sin restricciones |
| Webhooks salientes | Desactivados | Configurables libremente |
| Número de agentes | Limitado (2 en el plan Free) | Ilimitado (según tus recursos) |
| Coste mensual | Gratuito pero sin API | Sólo el coste del VPS — sin coste de software adicional |
| Datos y privacidad | Datos alojados en Chatwoot Inc. | Datos bajo tu control, en tus servidores |
| Actualizaciones | Gestionadas por Chatwoot | Bajo tu responsabilidad (Docker pull) |
| Integraciones n8n / Activepieces | Imposibles en el plan gratuito | Funcionales desde el despliegue |
Exportar tus datos desde Chatwoot Cloud
Antes de cerrar tu cuenta Cloud, exporta todos los datos útiles. Chatwoot ofrece dos rutas de exportación desde el panel de control.
Procedimiento de exportación desde Chatwoot Cloud
Exportar contactos
En el panel de control de Chatwoot Cloud, ve a Contactos → icono de descarga (arriba a la derecha). Chatwoot genera un archivo CSV con el nombre, apellido, email, teléfono y etiquetas de cada contacto. Guarda este archivo — se usará para la importación en tu instancia self-hosted.
Exportar conversaciones a través de la API (si tu plan todavía lo permite)
Si todavía tienes acceso a la API o estás en un plan de pago en proceso de cancelación, exporta las conversaciones con:
curl -H "api_access_token: <YOUR_TOKEN>" \ "https://app.chatwoot.com/api/v1/accounts/<ACCOUNT_ID>/conversations" \ -o conversations-export.jsonReemplaza
<YOUR_TOKEN>y<ACCOUNT_ID>con tus valores. Repite con?page=2,?page=3… hasta obtener un array vacío.Descargar adjuntos
Los archivos adjuntos a las conversaciones se sirven desde el CDN de Chatwoot Cloud. Toma nota de las URL de la forma
https://app.chatwoot.com/rails/active_storage/…presentes en el JSON exportado. Un scriptwgetocurlpuede descargarlos en bloque si tu cuota de acceso todavía lo permite.Exportar perfiles de agentes
En Configuración → Agentes, anota las direcciones de email de cada agente. Las necesitarás para recrear las cuentas en tu instancia self-hosted. La exportación CSV está disponible desde la misma página.
Exportar bandejas de entrada y su configuración
En Configuración → Bandejas de entrada, documenta cada configuración: tipo de canal (email, widget web, WhatsApp Business, etc.), configuración SMTP, claves de API del canal. Estos datos no son exportables automáticamente — una captura de pantalla o copiar y pegar es suficiente.
Exportar etiquetas y respuestas predefinidas
En Configuración → Etiquetas y Respuestas predefinidas, exporta o copia las entradas. Las respuestas predefinidas no son exportables nativamente en CSV — cópialas manualmente o a través de la API si todavía tienes acceso:
GET /api/v1/accounts/<ID>/canned_responses.Archivar tu cuenta Cloud
Una vez recuperados los datos, puedes desactivar tu cuenta de Chatwoot Cloud desde Configuración de cuenta → Zona de peligro → Eliminar cuenta. Esta acción es irreversible.
Desplegar Chatwoot self-hosted en un VPS de ServOrbit
Chatwoot se despliega mediante Docker Compose. La objeción habitual — «el self-hosting es demasiado complejo de mantener» — está resuelta por el Marketplace de ServOrbit: la plantilla Chatwoot configura Docker, nginx y TLS en una sola operación. Conservas el acceso root y la API completa.
Despliegue desde el Marketplace de ServOrbit
Elegir el VPS adecuado
Chatwoot necesita al menos 2 vCPU y 4 GB de RAM para un uso cotidiano (pocos agentes, algunos centenares de conversaciones activas). Para un equipo de 10 agentes o más, prevé 4 vCPU / 8 GB. La base de datos PostgreSQL es el componente más intensivo en memoria.
En el área de cliente de ServOrbit, selecciona un VPS con estas características y elige Ubuntu 22.04 o Debian 12 como imagen base.
Activar la plantilla Chatwoot desde el Marketplace
En el área de cliente de ServOrbit, ve a Marketplace → Colaboración → Chatwoot (o usa el enlace directo a /marketplace/collaboration/chatwoot). Selecciona tu VPS de destino y lanza el despliegue. La plantilla instala Docker, Docker Compose, nginx y Certbot, y luego configura Chatwoot a través de
docker-compose.yml.Configurar las variables de entorno
Tras el despliegue, conéctate por SSH a tu VPS y edita el archivo
.envgenerado en/opt/chatwoot/:SECRET_KEY_BASE=<genera con openssl rand -hex 64> FRONTEND_URL=https://chat.yourdomain.com DEFAULT_LOCALE=es [email protected] SMTP_ADDRESS=<tu-smtp> SMTP_USERNAME=<login> SMTP_PASSWORD=<contraseña>Luego reinicia los contenedores:
docker compose down && docker compose up -d.Apuntar tu dominio y activar TLS
En Cloudflare (o tu gestor de DNS), añade un registro A para
chat.yourdomain.comapuntando a la IP de tu VPS. La plantilla de nginx incluye una configuración Certbot: ejecutacertbot --nginx -d chat.yourdomain.compara obtener y renovar automáticamente tu certificado Let's Encrypt.Crear la primera cuenta de administrador
Accede a
https://chat.yourdomain.comy sigue el asistente de configuración inicial. Crea tu cuenta de administrador y luego importa los agentes a través de Configuración → Agentes → Invitar agentes. Usa las direcciones de email exportadas en el paso anterior.Importar contactos
En Contactos → Importar, carga el archivo CSV exportado desde Chatwoot Cloud. Chatwoot reconoce las columnas
name,email,phone_numbereidentifier. Los duplicados se detectan durante la importación.
Restablecer una integración n8n o Activepieces
Una vez que tu instancia self-hosted esté operativa, los tokens de API están disponibles sin restricciones. Aquí te explicamos cómo reconfigurar un flujo de trabajo n8n que consulta Chatwoot.
Ejemplo — flujo de trabajo n8n con la API de Chatwoot self-hosted
Generar un token de API en tu instancia
En Chatwoot self-hosted, ve a Configuración del perfil → Acceso a la API. Copia el token generado. Este token no caduca y da acceso a todas las rutas REST de tu instancia.
Configurar las credenciales de Chatwoot en n8n
En n8n, añade credenciales de tipo Chatwoot API. Rellena:
- URL base:https://chat.yourdomain.com
- Token de acceso: el token copiado en el paso anteriorValida la conexión — n8n debería responder con HTTP 200 y el perfil de tu cuenta.
Reconfigurar los triggers webhook
En Chatwoot self-hosted, ve a Configuración → Integraciones → Webhooks y añade la URL del webhook de n8n (de la forma
https://n8n.yourdomain.com/webhook/<uuid>). Marca los eventos a escuchar:conversation_created,message_created,conversation_status_changed.Dispara una conversación de prueba y verifica en n8n que la ejecución se recibe correctamente.
Adaptar los flujos de trabajo de Activepieces
Activepieces dispone de un conector nativo de Chatwoot. En el panel de control de Activepieces, edita cada flujo que usaba Chatwoot Cloud y actualiza la conexión: reemplaza
app.chatwoot.comporchat.yourdomain.comy regenera las credenciales con el nuevo token. Los triggers de webhook siguen el mismo procedimiento que para n8n.
Monitorizar tu instancia tras la migración
Tras la migración, configura una sonda HTTP sencilla en tu instancia: Chatwoot expone un endpoint de salud en https://chat.yourdomain.com/auth/sign_in (se espera HTTP 200). Una herramienta como Uptime Kuma o Gatus, también desplegable desde el Marketplace de ServOrbit, puede monitorizar esta URL y alertarte en caso de interrupción.
Monitoriza también el espacio en disco: los adjuntos y los avatares se almacenan en docker volume chatwoot_storage. Para un equipo activo, planifica purgar o archivar regularmente las conversaciones antiguas.
Resolución de problemas — errores comunes tras la migración
Aquí están los cinco errores más frecuentes al migrar de Chatwoot Cloud a self-hosted, y cómo resolverlos.
Errores comunes y soluciones
- HTTP 401 en la API: el token se generó en la antigua instancia Cloud. Regenera un token desde Perfil → Acceso a la API en tu instancia self-hosted y actualiza todas tus credenciales de n8n / Activepieces.
- HTTP 422 Unprocessable Entity al crear una conversación: la bandeja de entrada de destino aún no existe en la instancia self-hosted. Recrea las bandejas de entrada en Configuración → Bandejas de entrada antes de importar conversaciones.
- Webhook no recibido: verifica que la URL del webhook de n8n o Activepieces sea alcanzable desde tu VPS (
curl -I <webhook-url>). Si tu n8n está detrás de un proxy inverso, asegúrate de que el puerto 443 esté abierto y que el certificado TLS sea válido. - Error SMTP al arrancar: si Chatwoot no puede enviar emails de confirmación, comprueba las variables
SMTP_ADDRESS,SMTP_PORT(587 para STARTTLS, 465 para SSL) ySMTP_AUTHENTICATIONen tu.env. Reinicia los contenedores tras cualquier modificación. - Interfaz en inglés a pesar de
DEFAULT_LOCALE=es: la variable de entorno se aplica a la configuración regional por defecto de las cuentas nuevas. Cada agente puede cambiar su propio idioma en Perfil → Idioma. Para forzar un idioma en todas las cuentas existentes, actualiza la columnalocaledirectamente en PostgreSQL condocker compose exec postgres psql -U chatwoot -c "UPDATE users SET locale='es';"— haz una copia de seguridad de la base de datos antes de cualquier modificación directa.
Recuperar el control de tu soporte al cliente
La eliminación de la API y los webhooks del plan gratuito de Chatwoot Cloud en julio de 2026 rompió docenas de integraciones con n8n, Activepieces y CRMs sin aviso visible en los paneles de control. El self-hosting no es una alternativa degradada: es la versión sin restricciones, con acceso root, API completa, webhooks libres y datos bajo tu control.
La objeción principal — el mantenimiento — está resuelta por la plantilla Chatwoot del Marketplace de ServOrbit: Docker, nginx y TLS se configuran en el despliegue. Las actualizaciones se reducen a un docker compose pull && docker compose up -d. En un VPS dimensionado a 2 vCPU / 4 GB, una instancia de Chatwoot self-hosted soporta varias decenas de agentes simultáneos con una latencia indistinguible de la Cloud.
Si tus integraciones de n8n o Activepieces llaman a la API de Chatwoot, la migración es la única vía sostenible: el plan Cloud gratuito no recuperará el acceso a la API en su forma actual.
