Documentacion ChatDirect
Guia completa para comprender y aprovechar al maximo el chatbot IA y el mini-CRM integrado de ChatDirect.
Inicio rapido
Bienvenido a ChatDirect
ChatDirect es una plataforma de chatbot IA personalizado con mini-CRM integrado. El portal cliente es el centro de control del chatbot: configuracion del bot, gestion del CRM, seguimiento del pipeline de leads y consulta de conversaciones.
Lista de verificacion
- Identidad — Nombre del bot, avatar, mensaje de bienvenida
- Apariencia — Ajuste los colores para coincidir con la marca
- Prompt del sistema — Defina la personalidad, tono y limites del bot
- Base de conocimientos — Agregue FAQ, horarios, precios e informacion clave
- Respuestas rapidas — Cree 3-4 botones para guiar a los visitantes
- Pruebe — Use la vista previa en vivo para validar el comportamiento
- Instale el widget — Copie el codigo de integracion y peguelo en el sitio
- Active el CRM — Explore el dashboard CRM y configure los seguimientos
Configuracion del chatbot
Las 7 pestanas de configuracion
Toda la configuracion se organiza en 7 pestanas claras:
| Pestana | Parametros clave | Impacto |
|---|---|---|
| Identidad | Nombre del bot, mensaje de bienvenida, avatar, idioma, proveedor IA | Primera impresion del visitante |
| Apariencia | Colores (primario, secundario, burbuja, encabezado), tema | Coherencia con la marca |
| Horario | Modo (bot/hibrido/humano), horario de apertura, mensaje fuera de horario | Disponibilidad y experiencia del visitante |
| Conversaciones | Respuestas rapidas, formulario pre-chat, captura de leads, reservas | Engagement y conversion |
| IA | Prompt del sistema, base de conocimientos, plantillas por industria, test A/B | Calidad de las respuestas |
| Integraciones | Google Analytics, Slack, webhooks CRM (HubSpot/Pipedrive/Monday) | Automatizacion y seguimiento |
| RGPD | Consentimiento, politica de privacidad, eliminacion de datos | Cumplimiento legal |
Instalacion del widget
Opcion 1: Codigo HTML directo
Pegue el siguiente codigo justo antes de </body>:
Opcion 2: Google Tag Manager
- Abra Google Tag Manager y cree una nueva etiqueta
- Elija el tipo "HTML personalizado"
- Pegue el codigo JavaScript
- Configure el activador en "Todas las paginas"
- Publique los cambios
Opcion 3: Plugin WordPress
- Descargue el plugin ChatDirect
- Instalelo en WordPress → Plugins → Anadir nuevo
- Active y vaya a Ajustes → ChatDirect
- Ingrese el ID de cliente y guarde
Modos del chatbot
El modo determina como interactua el chatbot con los visitantes. Para mas detalles, consulte nuestro articulo sobre los 3 modos del live chat.
La IA responde automaticamente 24/7. Ideal para soporte basico.
Solo agentes humanos responden durante el horario de atencion.
La IA responde primero, con opcion de transferir a un humano.
| Escenario | Modo | Por que |
|---|---|---|
| E-commerce | Bot | Respuestas instantaneas sobre productos, precios, envio |
| Restaurante | Hibrido | Bot para menu y horarios, humano para reservas especiales |
| Clinica medica | Humano | Sensibilidad de datos, necesidad de juicio humano |
| SaaS | Bot | Soporte tecnico automatizado con escalacion |
Transferencia a agente humano
Los visitantes pueden solicitar hablar con un humano en cualquier momento. El sistema de transferencia y live chat permite una transicion fluida.
- El visitante hace clic en el boton de transferencia
- Aparece un mensaje de confirmacion
- El equipo recibe una notificacion (Slack, email, etc.)
- Un agente toma la conversacion
- El agente responde via live chat
- La conversacion se guarda en el historial
Conversaciones y engagement
El historial completo de todas las conversaciones se conserva. Cada intercambio se registra con mensajes, marcas de tiempo y evaluaciones de los visitantes.
Respuestas rapidas
| Industria | Sugerencias |
|---|---|
| Dentista | Agendar cita, Precios, Urgencia dental |
| Restaurante | Ver menu, Reservar mesa, Horario |
| Inmobiliaria | Propiedades disponibles, Evaluacion gratuita, Agendar cita |
| SaaS | Demo gratuita, Precios, Soporte tecnico |
Captura de leads
El chatbot captura automaticamente las coordenadas de los visitantes (nombre, email, telefono) a traves de un formulario integrado en la conversacion. Para profundizar, consulte nuestra guia sobre la generacion automatica de leads.
Smart Booking
El booking inteligente propone automaticamente un enlace de reserva (Calendly, Cal.com) cuando el visitante expresa intencion de agendar.
IA y Prompts
El prompt del sistema
El prompt del sistema define la personalidad, el tono y los conocimientos del chatbot. Es la instruccion principal que guia el comportamiento de la IA.
Estructura recomendada
- Rol — Definir quien es el bot
- Tono — Definir el estilo (profesional, amigable, formal)
- Conocimientos — Lo que el bot sabe (menu, precios, horarios)
- Limites — Lo que el bot NO debe hacer
- Objetivo — Lo que el bot debe lograr (capturar leads, responder FAQ)
Test A/B
El test A/B permite comparar dos variantes de prompt para determinar cual funciona mejor.
Agentes especializados
Los agentes permiten definir comportamientos diferentes segun la pagina visitada. Por ejemplo, un agente "Soporte" en /ayuda y un agente "Ventas" en /precios.
Plantillas por industria
Las plantillas preconfiguradas permiten comenzar rapidamente con una configuracion optimizada.
- Inmobiliaria — Propiedades, evaluaciones, citas
- Restaurante — Menu, reservas, horarios
- E-commerce — Productos, pedidos, devoluciones, envio
- B2B / Servicios — Cotizaciones, consultas, proceso de venta
- Dentista / Medico — Citas, servicios, urgencias
- SaaS — Funcionalidades, precios, demos, soporte tecnico
- Contador — Servicios fiscales, consultas
- Abogado — Areas de practica, consultas iniciales
Canales de comunicacion
Siempre activo. El chatbot en el sitio web.
Bidireccional. Los visitantes se comunican por texto.
Bidireccional. Conversaciones por correo electronico.
BYOK (Bring Your Own Key)
El modo BYOK permite usar su propia clave API para el proveedor IA de su eleccion. Las conversaciones se vuelven ilimitadas y los costos son facturados directamente por el proveedor. Consulte nuestra guia completa del BYOK para todos los detalles.
Proveedores soportados
| Proveedor | Modelos | Streaming |
|---|---|---|
| Anthropic | Haiku 4.5, Sonnet 4.6, Opus 4.6 | Si |
| OpenAI | GPT-4o Mini, GPT-4o, GPT-4 Turbo | No |
| Gemini 2.0 Flash, Gemini 1.5 Pro | No | |
| Mistral | Small, Medium, Large | No |
Costos estimados
| Proveedor | Modelo | Entrada (1M tokens) | Salida (1M tokens) | Ideal para |
|---|---|---|---|---|
| Anthropic | Haiku 4.5 | $1.00 USD | $5.00 USD | Chatbot general, mejor relacion calidad/precio |
| OpenAI | GPT-4o Mini | $0.15 USD | $0.60 USD | Alto volumen, costo minimo |
| Gemini 2.0 Flash | $0.10 USD | $0.40 USD | Costo muy bajo, rapidez | |
| Mistral | Small | $0.20 USD | $0.60 USD | Frances nativo, economico |
Sincronizacion automatica de conocimientos
La funcion auto-sync permite al chatbot recuperar automaticamente el contenido de paginas web especificas para enriquecer su base de conocimientos.
- Pagina de precios — El bot siempre conoce los precios actualizados
- FAQ — Sincronizacion con la pagina FAQ existente
- Blog — El bot puede referenciar los ultimos articulos
Dashboard CRM
El dashboard CRM muestra los indicadores clave: total de leads, tasa de conversion, tiempo promedio de conversion y puntuacion promedio. Conozca mas sobre las ventajas de un CRM integrado.
| Metrica | Descripcion | Objetivo |
|---|---|---|
| Total leads | Numero total de prospectos capturados | Crecimiento mensual |
| Tasa de conversion | Porcentaje de leads convertidos en clientes | > 15% |
| Tiempo promedio | Dias entre la captura y la conversion | < 7 dias |
| Puntuacion promedio | Nivel de engagement promedio (/15) | > 8 |
Pipeline kanban
El pipeline muestra los leads en 4 columnas segun su estado. Arrastre y suelte leads entre columnas para actualizar su estado.
| Columna | Descripcion | Accion recomendada |
|---|---|---|
| Nuevo | Lead recien capturado por el chatbot | Contactar en las proximas 24h |
| Contactado | Se ha establecido contacto | Dar seguimiento |
| Convertido | El prospecto se convirtio en cliente | Fidelizar |
| Perdido | El prospecto no convirtio | Analizar las razones |
Lead scoring dinamico (0-15 puntos)
Cada lead recibe una puntuacion calculada automaticamente segun su nivel de engagement. Se actualiza en tiempo real con cada interaccion.
| Factor | Puntos | Detalle |
|---|---|---|
| Campos completados | +1 a +4 | Nombre, email, telefono, empresa |
| Visitas de retorno | +1 a +3 | Numero de visitas al sitio |
| Paginas de alta intencion | +2 | Visita a /precios, /contacto, /demo |
| Duracion de conversacion | +1 a +2 | Numero de mensajes intercambiados |
| Intencion detectada | +3 | Intencion de compra, solicitud de cotizacion |
- 0-4: Lead frio — poco engagement
- 5-9: Lead tibio — interesado, dar seguimiento
- 10-15: Lead caliente — fuerte intencion, contactar de inmediato
Etiquetas personalizadas
Las etiquetas permiten categorizar los leads para un seguimiento mas efectivo.
- VIP — Cliente potencial de alto valor
- Urgente — Requiere respuesta inmediata
- Demo solicitada — Quiere ver el producto en accion
- Referido — Viene de una recomendacion
Recordatorios y tareas
Los recordatorios ayudan a no perder ningun seguimiento importante. Se pueden crear desde la ficha de un lead o desde el calendario.
Los recordatorios pendientes aparecen en el dashboard y en la barra lateral (badge rojo para los vencidos).
Seguimientos automaticos en 3 etapas
ChatDirect permite configurar hasta 3 etapas de seguimiento automatico por email. Cada etapa tiene un retraso, un asunto y una plantilla personalizable.
| Etapa | Retraso | Asunto |
|---|---|---|
| 1 | 1 hora | Gracias por su interes, {nom}! |
| 2 | 24 horas | Tiene alguna pregunta? |
| 3 | 72 horas | Ultima oportunidad: oferta especial |
Email desde el CRM
Desde la ficha de un lead, se puede enviar un email directamente. El formulario viene pre-llenado. El historial de emails se conserva en la linea de tiempo del lead.
- Formulario pre-llenado con datos del lead
- Historial de emails en la linea de tiempo
- Cambio automatico de estado a "Contactado"
- Soporte para proveedores de email API (SMTP2GO, SendGrid, Brevo, Mailgun, Amazon SES)
Deteccion y fusion de duplicados
El sistema detecta automaticamente duplicados por email o telefono. Al fusionar, se conserva la puntuacion mas alta y se combinan notas, etiquetas e historial de ambos registros.
Notificaciones en tiempo real
El sistema notifica sobre eventos importantes: nuevos leads, recordatorios vencidos, seguimientos enviados y cambios de estado.
- Campana CRM — Icono en la navegacion, polling cada 30 segundos
- Slack — Notificaciones en un canal Slack
- WhatsApp — Notificaciones WhatsApp Business
- Email — Email automatico para leads calientes
Registro de actividad
El registro muestra todos los eventos CRM en orden cronologico: capturas de leads, cambios de estado, emails enviados, notas agregadas, etiquetas modificadas, recordatorios y seguimientos.
Calendario mensual interactivo
El calendario ofrece una vista general de las actividades de seguimiento planificadas.
- Clic en una fecha — Agregar un nuevo recordatorio
- Clic en un recordatorio — Ver el lead asociado
- Colores — Azul = proximo, Rojo = vencido, Verde = completado
Informe CRM en PDF
Se puede generar un informe PDF de las estadisticas CRM con seleccion de fechas. Incluye indicadores clave, embudo de conversion, leads calientes y tendencias del periodo.
Google Analytics, Slack y Webhooks CRM
Google Analytics 4
| Evento | Activador |
|---|---|
chat_opened | Visitante abre el widget |
message_sent | Visitante envia un mensaje |
lead_captured | Datos de contacto capturados |
transfer_requested | Transferencia a humano solicitada |
Slack
Se envian notificaciones a Slack para cada nuevo lead, transferencia o alerta.
Webhooks CRM
- HubSpot — Integracion directa via API
- Pipedrive — Creacion automatica de deals
- Monday.com — Creacion de items en el tablero
- Webhook personalizado — POST JSON a cualquier URL
Estas integraciones son especialmente utiles para empresas B2B y SaaS y el comercio electronico. Descubra todas nuestras soluciones por sector.
Proveedores de email API
| Proveedor | Gratis | Notas |
|---|---|---|
| SMTP2GO | 1.000/mes | Recomendado para comenzar |
| SendGrid | 100/dia | Popular, buena entregabilidad |
| Brevo | 9.000/mes | Generoso en gratis |
| Mailgun | 100/dia | Muy confiable, API avanzada |
| Amazon SES | 3.000/mes * | * Si esta en AWS, el mas economico |
API publica REST
Una clave API publica permite acceder a los datos via API REST (plan Business o superior requerido).
| Endpoint | Metodo | Descripcion |
|---|---|---|
/api/v1/leads.php | GET | Lista de leads con filtros |
/api/v1/conversations.php | GET | Lista de conversaciones |
/api/v1/stats.php | GET | Estadisticas de uso |
Privacy by Design
ChatDirect integra la proteccion de la privacidad desde el diseno, siguiendo el enfoque Privacy by Design. Seis mecanismos garantizan un alto nivel de proteccion de datos de los visitantes.
| Medida | Detalle tecnico | Beneficio |
|---|---|---|
| Hash de IP | SHA-256 irreversible, ni el administrador puede recuperar la IP original | Anonimizacion completa |
| Retencion limitada | Purga automatica configurable (30 a 365 dias) | Ningun dato conservado indefinidamente |
| Cero cookies | Sin cookies, sin localStorage persistente, solo sessionStorage | No requiere banner de cookies |
| Sin seguimiento cross-session | Session ID unico por visita, sin fingerprinting | Imposible vincular visitas del mismo usuario |
| URL filtrada | Solo el path se transmite, los parametros query string se eliminan | Sin fuga de datos sensibles via URLs |
| GA4 condicional | Google Analytics se activa solo tras consentimiento explicito | Cumplimiento RGPD / Ley 25 |
Derecho de eliminacion
Los visitantes pueden solicitar la eliminacion de sus datos directamente desde el widget. Todos los datos asociados a su sesion se borran inmediatamente.
Cumplimiento RGPD y Ley 25
ChatDirect ofrece herramientas completas para el cumplimiento de proteccion de datos, aplicables al RGPD europeo y la Ley 25 de Quebec.
| Accion | Obligatorio |
|---|---|
| Activar consentimiento RGPD en el widget | Si (UE/QC) |
| Personalizar el texto de consentimiento | Si |
| Agregar enlace a politica de privacidad | Si |
| Requerir checkbox en formulario de leads | Recomendado |
| Condicionar Google Analytics al consentimiento | Si, si GA4 activo |
| Configurar duracion de retencion de datos | Recomendado |
Seguridad avanzada
| Funcionalidad | Descripcion |
|---|---|
| Alertas por palabras clave | Notificacion cuando un visitante menciona ciertos terminos |
| Control de acceso | Dominios autorizados, lista blanca/negra de IPs |
| Limite de tokens | Tope mensual de consumo de tokens IA |
| Export/Import configuracion | Exportar e importar configuracion completa en JSON |
| Test de webhooks | Verificar que los webhooks CRM funcionan correctamente |
Consumo y tokens
Un token equivale a aproximadamente 4 caracteres en ingles o 3 caracteres en frances.
| Valor | Equivalente | Caso de uso |
|---|---|---|
256 tokens | ~1-2 frases | Respuestas muy cortas |
500 tokens | ~1 parrafo | Respuestas estandar (recomendado) |
1024 tokens | ~2-3 parrafos | Respuestas detalladas |
2000 tokens | ~1 pagina | Respuestas tecnicas profundas |
Gestion de usuarios
El portal permite agregar colegas para que accedan con sus propias credenciales.
- Agregar usuario — Crear usuario y contrasena
- Cambiar contrasena — Cada usuario puede cambiar su contrasena
- Eliminar usuario — Revocar el acceso de un colega
Soporte y tickets
El sistema de tickets integrado permite comunicacion directa con el equipo de soporte ChatDirect.
- Cree un ticket con un asunto y prioridad (normal, alta, urgente)
- Describa claramente el problema
- Siga las respuestas y el estado del ticket (abierto, cerrado)
Planes y precios
| Plan | Precio | Conversaciones | Modelo IA |
|---|---|---|---|
| Descubrimiento | Gratis 14 dias | 250 mensajes | GPT-4o Mini |
| Starter | $39/mes | 1.000 conv | GPT-4o Mini |
| Pro | $69/mes | 1.000 conv (ilimitado con BYOK) | Claude Haiku 4.5 |
| Business | $149/mes | 2.500 conv (ilimitado con BYOK) | Claude Haiku 4.5 |
| Enterprise | $299/mes | 10.000 conv (ilimitado con BYOK) | Claude Haiku 4.5 |
Comparacion de funcionalidades
| Funcionalidad | Descubrimiento | Starter | Pro | Business | Enterprise |
|---|---|---|---|---|---|
| Widget chatbot | Si | Si | Si | Si | Si |
| Mini-CRM integrado | Si | Si | Si | Si | Si |
| Pipeline kanban | Si | Si | Si | Si | Si |
| Seguimientos automaticos | Si | Si | Si | Si | Si |
| Streaming (respuesta en vivo) | — | — | Si | Si | Si |
| BYOK (clave API personal) | — | — | Si | Si | Si |
| API publica REST | — | — | — | Si | Si |
| Canales SMS / Email | — | — | — | Si | Si |
| Webhooks CRM externos | — | — | — | Si | Si |
BYOK = Ilimitado
Con BYOK, las conversaciones son ilimitadas en todos los planes compatibles (Pro+). Los costos son facturados directamente por el proveedor IA. Costo estimado: ~$6 USD/mes para 1.000 conversaciones con Claude Haiku.