Instala Chatwoot

Chatwoot es una plataforma de atención al cliente de código abierto que te permite recibir y responder mensajes de tus clientes desde diferentes canales (como WhatsApp, Instagram, correo electrónico, tu sitio web, etc.) en un solo lugar.

En pocas palabras:

Chatwoot es como una central de mensajes donde puedes hablar con tus clientes sin importar desde dónde te escriban.

¿Para qué sirve?

• Atender a tus clientes más rápido.
• Ver todos los mensajes en un solo panel.
• Trabajar en equipo (varios agentes pueden responder).
• Automatizar respuestas con bots o integraciones.

Instalar Chatwoot

Una vez que hemos instalado Portainer y Traefik (que vienen en un solo combo) en la anterior lección, procederemos a instalar nuestra segunda aplicación: Chatwoot.

Paso 1: Seleccionar la aplicación

1. Regresa al setup de Orion Design en tu terminal
2. Ingresa la letra Y y presiona Enter cuando te pregunte si deseas instalar otra aplicación
3. Selecciona la opción 02 que corresponde a Chatwoot

Paso 2: Configurar el registro DNS

Antes de continuar con la instalación, necesitamos configurar el DNS:

Agregar registro CNAME

1. Ve a tu proveedor de hosting/DNS
2. Crea un registro de tipo CNAME con:
   • Nombre: Tu prefijo + el nombre de la aplicación (ejemplo: devchatwoot)
   • Objetivo: El mismo registro tipo A que creaste anteriormente (ejemplo: workstation.tudominio.com)

Ejemplo práctico:

1. Registro CNAME: devchatwoot
2. Apunta a: workstation.jerocuevas.com
3. Guarda el registro DNS
4. Vuelve a la terminal e ingresa tu dominio completo (ejemplo: devchatwoot.jerocuevas.com)

Paso 3: Configurar SMTP con Gmail

Chatwoot necesita configuración SMTP para enviar correos. Usaremos Gmail para esto:

Datos requeridos:

• Correo electrónico SMTP: Recomiendo usar tu mail de gmail
• Usuario SMTP: Tu correo de Gmail
• Contraseña SMTP: Una contraseña de aplicación (NO tu contraseña normal)
• Host SMTP: smtp.gmail.com
• Puerto: 465

Generar contraseña de aplicación en Gmail:

1. Activar verificación en dos pasos (obligatorio):
   • Ve a tu cuenta de Google → Administrar cuenta → Seguridad
   • Busca «Verificación en dos pasos» y actívala si no la tienes
   • Sigue las instrucciones (necesitarás tu número de teléfono)
2. Crear contraseña de aplicación:
   • En el apartado de Seguridad, busca «contraseñas»
   • Selecciona «Contraseñas de aplicaciones»
   • Inicia sesión si te lo pide
   • Crea una nueva contraseña con un nombre identificativo (ejemplo: «jerocuevas» o nombre de tu cliente)
   • ¡IMPORTANTE! Copia la contraseña generada inmediatamente (no podrás verla después)
   • Guárdala en un lugar seguro

Configurar en la terminal:

1. Usuario SMTP: Ingresa tu correo de Gmail
2. Confirmar correo: Ingresa nuevamente tu correo de Gmail
3. Contraseña SMTP: Pega la contraseña de aplicación que generaste (tal como está, con espacios)
4. Host SMTP: smtp.gmail.com
5. Puerto: 465

Paso 4: Confirmar e instalar

1. Revisa que todos los datos sean correctos
2. Si hay algún error, presiona N y vuelve a ingresar los datos
3. Si todo está correcto, presiona Y para iniciar la instalación

Paso 5: Proceso de instalación automática

Chatwoot requiere aplicaciones adicionales para funcionar:

• pgvector: Base de datos vectorial
• Redis: Sistema de caché

Estas aplicaciones se instalarán automáticamente durante el proceso. Solo debes esperar a que termine la instalación completa.

Paso 6: Configuración inicial de Chatwoot

Acceder a la aplicación:

1. Copia la URL que aparece al finalizar la instalación
2. Recomendación: Guarda esta URL y credenciales en un documento para futuras referencias
3. Abre la URL en tu navegador

Crear tu primera cuenta:

1. Completa el formulario de registro con tus datos
2. Consejo: Usa la misma contraseña para todas las aplicaciones de tu infraestructura para evitar confusiones
3. Presiona «Finish» para completar el registro
4. Inicia sesión con tus credenciales

Configurar idioma:

1. Ve a Configuraciones
2. En la primera pantalla, selecciona Español (o tu idioma preferido)
3. Presiona Actualizar configuraciones

Verificación en Portainer

Para confirmar que todo se instaló correctamente:

1. Ve a Portainer
2. Presiona Refresh en la sección de Stacks
3. Deberías ver los nuevos stacks instalados:
   • redis
   • pgvector
   • chatwoot

Esto confirma que Setup Orion se conectó automáticamente a Portainer y desplegó correctamente todas las aplicaciones necesarias.

Puntos importantes a recordar

• Guarda todas las URLs y credenciales en un documento seguro
• Usa la misma contraseña para todas las aplicaciones de tu infraestructura
• Las dependencias se instalan automáticamente – no necesitas hacer nada adicional
• Cada aplicación aparecerá como stacks separados en Portainer

¡Chatwoot está ahora completamente instalado y listo para usar! En las próximas lecciones aprenderemos cómo sacar el máximo provecho de esta plataforma y cómo administrar correctamente nuestras aplicaciones.