Chatwoot - Plataforma de Soporte al Cliente

Chatwoot es una plataforma open source de engagement con clientes. Centraliza todos tus canales de comunicacion (chat web, WhatsApp, email, redes sociales) en un solo inbox.

Para que sirve?

• Chat en vivo - Widget de chat para tu sitio web
• Inbox unificado - Todos los mensajes de todos los canales en un solo lugar
• Multicanal - WhatsApp, Facebook, Instagram, Twitter, Email, Telegram
• Equipo de soporte - Asigna conversaciones a agentes, usa respuestas predefinidas

Alternativa Open Source a

• Intercom
• Zendesk Chat
• Freshdesk
• Crisp
• Drift
• LiveChat
• Tidio

¿Por qué elegir Chatwoot sobre alternativas SaaS?

Característica	Chatwoot	Alternativas SaaS
Costo	Precio fijo mensual	Por usuario/uso
Datos	En tu servidor	En servidores externos
Límites	Sin límites	Límites por plan
Personalización	100% personalizable	Limitada
Código	Open source	Propietario

Ejemplos de uso

• E-commerce - Atencion al cliente en tiempo real
• SaaS - Soporte tecnico por chat
• Agencias - Gestionar clientes de multiples empresas
• Servicios - Responder consultas de clientes potenciales
• Soporte IT - Tickets y seguimiento de problemas

Requisitos minimos

Recurso	Minimo	Recomendado
CPU	2 vCPU	4 vCPU
RAM	2 GB	4 GB
Almacenamiento	25 GB	50 GB

Configuracion inicial

Al desplegar Chatwoot, configuras:

• Email admin - Tu email para la cuenta de administrador
• Password - Contrasena de acceso

Primeros pasos

1. Accede a Chatwoot

Despues del deployment, haz clic en "Abrir App" e inicia sesion con tus credenciales.

2. Configura tu primer inbox

Un inbox es un canal de comunicacion. Para el widget de chat web:

1. Ve a Settings > Inboxes
2. Click Add Inbox
3. Selecciona Website
4. Configura el nombre y color del widget
5. Copia el codigo JavaScript que te da

3. Instala el widget en tu sitio

Pega el codigo antes de </body> en tu sitio:

<script>
  (function(d,t) {
    var BASE_URL="https://tuapp.deployalo.com";
    var g=d.createElement(t),s=d.getElementsByTagName(t)[0];
    g.src=BASE_URL+"/packs/js/sdk.js";
    g.defer = true;
    g.async = true;
    s.parentNode.insertBefore(g,s);
    g.onload=function(){
      window.chatwootSDK.run({
        websiteToken: 'TU_TOKEN_AQUI',
        baseUrl: BASE_URL
      })
    }
  })(document,"script");
</script>

4. Prueba el chat

1. Visita tu sitio web
2. Veras el boton de chat en la esquina
3. Envia un mensaje de prueba
4. El mensaje aparecera en tu inbox de Chatwoot

Canales disponibles

Website (Chat Widget)

El widget de chat que aparece en tu sitio.

Email

Conecta cuentas de email para recibir y responder desde Chatwoot:

1. Ve a Settings > Inboxes > Add Inbox > Email
2. Configura IMAP y SMTP

WhatsApp

Conecta WhatsApp Business API:

1. Ve a Settings > Inboxes > Add Inbox > WhatsApp
2. Configura tu numero de WhatsApp Business
3. Requiere cuenta de Meta Business

Facebook & Instagram

Conecta tus paginas de Facebook e Instagram:

1. Ve a Settings > Inboxes > Add Inbox > Facebook
2. Conecta con tu cuenta de Facebook
3. Selecciona las paginas a conectar

Telegram

Conecta un bot de Telegram:

1. Crea un bot con @BotFather en Telegram
2. Ve a Settings > Inboxes > Add Inbox > Telegram
3. Ingresa el token de tu bot

Funciones clave

Respuestas predefinidas (Canned Responses)

Crea respuestas guardadas para preguntas frecuentes:

1. Ve a Settings > Canned Responses
2. Click Add Canned Response
3. Define un shortcode (ej: /saludo)
4. En el chat, escribe el shortcode para insertar la respuesta

Etiquetas (Labels)

Organiza conversaciones con etiquetas:

1. Ve a Settings > Labels
2. Crea etiquetas como "Urgente", "Venta", "Soporte"
3. Aplica etiquetas a conversaciones desde el inbox

Equipos

Organiza agentes en equipos:

1. Ve a Settings > Teams
2. Crea equipos (ej: "Ventas", "Soporte Tecnico")
3. Asigna agentes a cada equipo
4. Las conversaciones pueden asignarse a equipos

Automatizaciones

Crea reglas automaticas:

1. Ve a Settings > Automations
2. Crea reglas como "Si mensaje contiene 'precio', asignar etiqueta 'Venta'"

Agentes y permisos

Agregar agentes

1. Ve a Settings > Agents
2. Click Add Agent
3. Ingresa email y nombre
4. El agente recibira invitacion por email

Roles

• Administrator - Control total
• Agent - Puede responder conversaciones asignadas

Recursos adicionales

• Documentacion oficial de Chatwoot
• Guias de integracion
• API de Chatwoot

Solucion de problemas

El widget no aparece

1. Verifica que el codigo JavaScript este bien instalado
2. Revisa la consola del navegador por errores
3. Asegurate de que websiteToken sea correcto

No recibo notificaciones

1. Ve a Settings > Account Settings > Notifications
2. Activa notificaciones por email o push

Mensajes no se envian

Revisa los logs de Chatwoot:

docker logs chatwoot_app --tail=50