Configuración de Chatwoot
Chatwoot es la columna vertebral de mensajería de PropPilot. Es lo que da soporte a todas las conversaciones de clientes en WhatsApp, Telegram y el widget web.
¿Qué es Chatwoot?
Chatwoot es una plataforma de atención al cliente open source que PropPilot utiliza para:
- Enrutar mensajes desde múltiples canales
- Almacenar el historial de conversaciones
- Habilitar mensajería en tiempo real
- Conectar agentes de IA con los clientes
PropPilot aprovisiona Chatwoot automáticamente para tu organización. No necesitas una cuenta de Chatwoot aparte.
Acceder a la configuración de Chatwoot
- Ve a Integrations en la barra lateral
- Selecciona la pestaña Chatwoot
- Verás el estado de la conexión y los canales disponibles
Estado de la conexión
La tarjeta de Chatwoot muestra:
| Estado | Significado |
|---|---|
| Connected | Chatwoot está configurado y operativo |
| Provisioning | Configuración inicial en curso |
| Error | Problema de conexión: requiere acción |
| Not Connected | Necesita configuración inicial |
Configuración inicial
Si Chatwoot muestra "Not Connected":
- Haz clic en Connect Chatwoot o Provision
- Espera al aprovisionamiento automático (1-2 minutos)
- El estado cambia a Connected cuando esté listo
El sistema automáticamente:
- Crea tu cuenta de Chatwoot
- Configura los webhooks
- Configura la integración por API
- Prepara la infraestructura de canales
Canales disponibles
Tras conectarte, puedes configurar estos canales:
| Canal | Estado | Acción |
|---|---|---|
| Web Widget | Configurar | Guía de configuración |
| Configurar | Guía de configuración | |
| Telegram | Configurar | Guía de configuración |
| API | Disponible | Ver Canal API |
Registrar tu bot
Para habilitar agentes de IA en los canales, registra tu bot:
Paso 1: Ve a la sección Bot
- En la pestaña Chatwoot, busca la sección Bot
- Haz clic en Register Bot o Configure
Paso 2: Introduce los datos del bot
| Campo | Descripción |
|---|---|
| Bot Name | Nombre visible de tu asistente de IA |
| Description | Descripción breve de lo que hace el bot |
Paso 3: Guardar
Haz clic en Save para registrarlo. El bot ya está listo para habilitarse en los canales.
La URL del webhook se configura automáticamente. No necesitas establecerla manualmente.
Gestionar canales
Ver el estado de un canal
Cada tarjeta de canal muestra:
- Estado de conexión (Connected, Error, Not Configured)
- Estado del bot (Enabled, Disabled)
- Marca temporal de la última actividad
- Acciones rápidas
Acciones de canal
| Acción | Descripción |
|---|---|
| Configure | Configurar un nuevo canal |
| Test | Verificar la conectividad del canal |
| Refresh | Actualizar el estado |
| View Logs | Ver actividad reciente |
Canal API
Usa el canal API cuando quieras que un sistema personalizado (tu propia web, una app móvil o cualquier servicio externo) envíe contactos, conversaciones y mensajes a PropPilot.
Crear un inbox de API
- En la pestaña Chatwoot, haz clic en Add Inbox y elige API
- Dale un nombre (por ejemplo, "Custom app")
- Guarda; el inbox aparecerá en la lista como Connected
Obtener tus credenciales
Una vez creado el inbox, abre el menú de acciones de su fila y elige API Credentials. Verás:
| Campo | Qué es |
|---|---|
| Inbox Identifier | Token público que identifica este inbox en las llamadas a la API |
| Base URL | La dirección a la que tu sistema debe llamar |
| HMAC Token | Secreto opcional para firmar identificadores de contactos |
Copia cada valor con el botón de copiar y pégalo en la configuración de tu sistema. Estos valores permiten que tu sistema se autentique contra este inbox concreto: mantén privado el token HMAC.
Tus desarrolladores usarán Inbox Identifier y Base URL para llamar a la API pública de cliente de Chatwoot. El token HMAC solo es necesario si activan identificadores de contactos firmados.
Aprovisionar miembros del equipo
Cuando invitas a miembros del equipo, pueden aprovisionarse en Chatwoot:
- Ve a Members en la barra lateral
- Encuentra al miembro que quieres aprovisionar
- Haz clic en Provision to Chatwoot
- El miembro ya puede acceder a las conversaciones
Consulta Gestión del equipo para más detalles.
Resolución de problemas
Falla la conexión
Si Chatwoot no se conecta:
- Comprueba tu conexión a internet
- Haz clic en Retry en el mensaje de error
- Espera unos minutos e inténtalo de nuevo
- Contacta con soporte si el problema persiste
Errores de canal
Si un canal específico muestra errores:
- Revisa el mensaje de error en Recent Activity
- Comprueba que las credenciales son correctas
- Usa la acción Test para diagnosticar
- Reconfigura el canal si es necesario
Los mensajes no se entregan
Si los mensajes no llegan a los clientes:
- Verifica que el canal esté en estado Connected
- Comprueba que el bot esté Enabled en el canal
- Revisa la configuración del webhook
- Comprueba que no se hayan superado los rate limits
Seguridad
PropPilot se toma la seguridad en serio:
- Todas las credenciales se cifran antes de almacenarse
- Las API keys usan cifrado AES
- Los webhooks usan verificación por secreto
- El acceso es por rol
Nunca compartas tus credenciales de Chatwoot. PropPilot las almacena de forma segura y no necesitas introducirlas en ningún otro sitio.
¿Qué sigue?
Configura tus canales de mensajería:
- Web Widget - Añade chat a tu sitio web
- WhatsApp - Conecta WhatsApp Business
- Telegram - Configura el bot de Telegram