# 📥 Mesa de Ayuda Multicanal y Central de Mensajes (Chatwoot API & Intercom)

> **Resumen para No Técnicos**: Permite que tu empresa reciba en una sola pantalla compartida todos los mensajes que te envían tus clientes por WhatsApp, Instagram Direct, Facebook Messenger, correo electrónico y chat de tu página web, evitando que los mensajes queden sin responder en los teléfonos personales de tus empleados.

| Metadato | Detalle |
|---|---|
| **Tipo** | API REST Oficial de Mesa de Ayuda y Plataforma Omnicanal |
| **Área Empresarial** | 04. Servicio al Cliente, Soporte y PQRs |
| **Nivel de Dificultad** | 🟢 Fácil |
| **Modelo de Costo** | Chatwoot es 100% Gratuito y Open Source (Plan Cloud gratuito para hasta 2 agentes) |
| **Enlace Oficial** | [Chatwoot Developers](https://www.chatwoot.com/developers/api/) / [Intercom API](https://developers.intercom.com/) |

---

## 💡 ¿Para qué le sirve a tu empresa? (Valor Real)

En una pequeña empresa tradicional, el vendedor 1 atiende en su celular personal, el vendedor 2 en Instagram y la secretaria responde correos. Cuando un empleado falta al trabajo o renuncia, **se pierden los contactos y el historial de los clientes**.

Con **Chatwoot**:
- Todo el equipo trabaja en una sola bandeja de entrada unificada.
- Puedes asignar conversaciones a diferentes personas (*"Este mensaje es para Soporte"*, *"Este es para Facturación"*).
- La Inteligencia Artificial puede sugerir respuestas automáticas a los agentes humanos o atender como primer filtro antes de pasar la conversación.

---

## 🎁 ¿Qué valor aporta frente a soluciones tradicionales?

- **Cero Pérdida de Historial**: Ves todo lo que el cliente ha hablado con tu empresa en los últimos meses en cualquier canal.
- **Notas Internas Privadas**: Los miembros de tu equipo pueden dejar comentarios privados que solo ellos ven dentro del chat con el cliente (*"Cliente VIP, darle 10% de descuento en el flete"*).
- **Etiquetas y Clasificación**: Clasifica los chats por etiquetas como `#Reclamo`, `#VentaNueva`, `#Garantia`.

---

## 🔑 ¿Qué necesitas para activarlo?

1. Una cuenta en [Chatwoot.com](https://www.chatwoot.com) o instalado en tu propio servidor.
2. Tu clave de API de usuario (*User API Access Token*).
3. El ID de tu cuenta (*Account ID*).

---

## ⚙️ Configuración Paso a Paso

Variables de entorno para tu backend, automatización o servidor MCP:

```env
# Variables de entorno (.env)
CHATWOOT_BASE_URL=https://app.chatwoot.com
CHATWOOT_API_ACCESS_TOKEN=tu_token_de_acceso_chatwoot
CHATWOOT_ACCOUNT_ID=12345
```

---

## 🤖 Consultor Interactivo (Prompt Guiado para tu IA)

Copia y pega este prompt en tu chat con la IA:

```markdown
Actúa como mi Coordinador de Mesa de Ayuda y Atención al Cliente.
Vamos a revisar el estado de las conversaciones y tickets pendientes en Chatwoot.

Por favor, pregúntame:
1. ¿Qué deseas revisar hoy (mensajes sin asignar, reclamos de alta prioridad o resumen de satisfacción)?
2. ¿Deseas redactar una respuesta sugerida para una conversación específica?
3. ¿Quieres etiquetar automáticamente las conversaciones abiertas por tipo de solicitud?

Con tus instrucciones, consultaré la API de Chatwoot, clasificaré los mensajes y redactaré respuestas corteses y profesionales listas para que los asesores humanos las envíen.
```

---

## 🌎 Caso de Uso Real en América Latina

**Empresa**: "Mascotas & Cuidado San Martín" (Tienda de alimentos y accesorios veterinarios en Cali, Colombia).
- **Problema**: Recibían pedidos por Instagram, quejas por WhatsApp y dudas por la web; los clientes se quejaban de que nadie les respondía a tiempo.
- **Resultado con la API**: Centralizaron los 3 canales en Chatwoot. La IA responde las dudas de horarios y envíos de inmediato y canaliza los pedidos a los asesores de mostrador. El tiempo de respuesta promedio bajó de 45 minutos a 40 segundos.

---

## 🛡️ Consideraciones de Privacidad y Buenas Prácticas

- **Cierre Oportuno de Conversaciones**: Resuelve y cierra las conversaciones completadas para mantener la bandeja limpia.
- **Protección de Datos Personales**: No almacenes datos confidenciales de tarjetas o contraseñas en las notas internas.