Documentación

Instalación del widget

Una sola línea de código para integrar el chatbot en su sitio:

Agregue esta línea justo antes de </body>. El widget se carga automáticamente con la configuración de su bot (colores, idioma, horario, prompt).

Compatibilidad

• Todos los navegadores modernos (Chrome, Firefox, Safari, Edge)
• WordPress, Shopify, Wix, Squarespace, HTML estático
• Plugin WordPress dedicado disponible

Mostrar el widget en páginas específicas

Por defecto, el widget aparece en todas las páginas de su sitio. Puede limitarlo a ciertas páginas o excluirlo de páginas específicas.

Método 1: Vía Google Tag Manager (GTM)

Si usa GTM para integrar el widget:

1. Inicie sesión en tagmanager.google.com
2. Haga clic en su tag ChatDirect (el que contiene el script widget.js)
3. En la sección Activador, haga clic en el activador actual (ej: All Pages)
4. Elimine el activador “All Pages” y cree uno nuevo
5. Tipo: Vista de página → Algunas páginas
6. Para mostrar en ciertas páginas: URL de la página → contiene → /servicios (o la ruta deseada)
7. Para excluir ciertas páginas: URL de la página → no contiene → /admin
8. Guarde y publique el contenedor GTM

Método 2: Vía el plugin WordPress

Si usa el plugin WordPress ChatDirect, puede controlar la visualización por página:

1. En el editor de WordPress, abra la página donde no desea el widget
2. En los ajustes de la página, busque la opción ChatDirect o use un plugin de gestión de scripts
3. También puede agregar el shortcode [chatdirect] solo en las páginas deseadas en lugar de la activación global

Método 3: Código JavaScript condicional

Si integra el script directamente en su sitio, puede condicionar la visualización:

En este ejemplo, el widget no aparecerá en las páginas que contengan /admin, checkout o carrito en la URL.

Proveedores IA

ChatDirect soporta 4 proveedores de IA conversaciónal:

Prompt y base de conocimientos

El prompt del sistema define la personalidad y las instrucciones de su bot. La base de conocimientos contiene la información específica de su empresa (productos, precios, FAQ).

Buenas prácticas

• Defina un tono (formal, amigable, profesional)
• Liste sus productos/servicios con los precios
• Incluya los horarios de atención
• Agregue las preguntas frecuentes y sus respuestas
• Precise cuándo transferir a un humano

Tamaño máx: prompt 50 Ko, conocimientos 100 Ko.

Sugerencias IA dinámicas

El bot genera automáticamente 2-3 sugerencias clicables después de cada respuesta para guiar la conversación. Las sugerencias son contextuales y se adaptan al tema en curso.

Análisis automático de página

El chatbot analiza automáticamente el contenido de la página que su visitante está consultando para adaptar sus respuestas en tiempo real. No se necesita configuración manual por página.

Cómo funciona

Cuando un visitante abre el chatbot, el widget extrae automáticamente los elementos clave de la página actual:

• Título de la página — El título que aparece en la pestaña del navegador
• Meta descripción — El resumen SEO de la página
• Títulos H1 y H2 — La estructura del contenido
• Contenido principal — El texto del área principal (máx 500 caracteres)

En total, se envían un máximo de 800 caracteres a la IA, lo suficiente para entender el contexto sin sobrecargar el sistema.

Ejemplo concreto

Ventajas

• Respuestas contextuales — La IA sabe lo que el visitante está viendo y adapta su discurso
• Cero configuración — Funciona automáticamente en todas las páginas de su sitio
• Mejor tasa de conversión — Un chatbot relevante involucra más a los visitantes
• Seguro — El contenido se sanitiza para prevenir inyecciones de prompt

Privacidad

El contenido de la página se procesa en tiempo real y sigue las mismas reglas de privacidad que las conversaciónes. No se almacena por separado y solo se utiliza para contextualizar la respuesta de la IA durante la sesión.

Activación

Esta funcionalidad está activada por defecto. Para gestionarla: Configuración del bot → pestaña Conversaciones → «Personalización por página». Desmarque la casilla para desactivarla si es necesario.

Auto-sync de conocimientos

El auto-sync permite al chatbot actualizar automáticamente su base de conocimientos leyendo las páginas de su sitio web. No más actualizaciones manuales: sus precios, servicios y FAQ siempre estarán al día en el chatbot.

Cómo funciona

Un proceso automatizado (cron) visita las URLs que usted configuró según la frecuencia elegida. Extrae el contenido textual de cada página (eliminando scripts, navegación y estilos) y lo escribe directamente en la base de conocimientos (knowledge.txt) del chatbot.

• Extracción inteligente — Solo se conserva el contenido útil (texto, títulos, párrafos)
• Contenido permanente — La información sincronizada se escribe en la base de conocimientos y persiste entre conversaciónes
• Contenido manual preservado — Su contenido escrito manualmente nunca se sobrescribe; el contenido sincronizado se agrega en una sección separada

Configuración

1. Vaya a Configuración del bot → pestaña IA & Prompts
2. Active la sincronización automática
3. Agregue las URLs de sus páginas importantes (una por línea): servicios, precios, FAQ, etc.
4. Elija la frecuencia: diaria, semanal o mensual
5. Defina el límite de caracteres por URL (máx 5 000 por URL, 30 000 en total)

Casos de uso

• Página de precios — El bot siempre conoce sus precios actuales, incluso después de una actualización de su sitio
• FAQ — Sincronización automática con su página FAQ existente
• Blog — El bot puede referenciar sus últimos artículos publicados
• Páginas de servicios — Descripciones de servicios siempre actualizadas

Plan requerido

El auto-sync está disponible en los planes Business y Enterprise.

Auto-sync vs Análisis de página: ¿cuál es la diferencia?

ChatDirect ofrece dos funcionalidades complementarias para que su chatbot conozca su sitio web. Así se comparan:

Recomendación: ¡Active ambas! Auto-sync le da al chatbot un conocimiento profundo de su sitio, mientras que el Análisis de página le permite responder de forma contextual según la navegación del visitante.

Multi-agentes IA

La funcionalidad Multi-agentes IA permite que un solo chatbot tenga múltiples «personalidades» especializadas que toman automáticamente el control de la conversación según el tema.

Cómo funciona

1. El administrador configura agentes especializados (nombre, descripción, prompt dedicado) en el panel de administración.
2. Cuando un visitante hace una pregunta que corresponde a un agente, el sistema delega automáticamente la conversación a ese agente.
3. El agente especializado responde con su propia experiencia — la transición es invisible para el visitante.
4. Los mensajes siguientes continúan con el prompt especializado del agente activo.

Ejemplo de configuración

Ventajas

• Respuestas más precisas y especializadas por tema
• Cada agente tiene su propia personalidad y experiencia
• Delegación automática — ninguna intervención manual necesaria
• Experiencia transparente para el visitante (no ve el cambio)
• Número ilimitado de agentes configurables

Plan requerido: Business o Enterprise.

Multi-bots por cliente

La funcionalidad Multi-bots permite que una misma cuenta de cliente gestione múltiples chatbots independientes, cada uno con su propia identidad, colores, prompt y base de conocimientos. Ideal para empresas que necesitan bots distintos para diferentes departamentos o casos de uso.

Casos de uso

Configuración de cada bot

• Nombre e identidad — Cada bot tiene su propio nombre mostrado en el widget
• Colores — Paleta de colores independiente por bot
• Prompt del sistema — Personalidad e instrucciones dedicadas
• Base de conocimientos — Contenido específico al dominio del bot
• Respuestas rápidas — Sugerencias de respuestas rápidas personalizadas

Integración en su sitio

Cada bot se seleccióna mediante el parámetro ?bot=nombre en el widget:

Puede colocar un bot diferente en cada página o sección de su sitio.

Administración

La página bots.php en el panel de administración permite crear, modificar y eliminar bots. Cada bot es independiente y tiene sus propias estadísticas, conversaciónes y leads.

Funcionalidades IA avanzadas

Código QR dinámico

Genere un código QR personalizado que redirige a los visitantes hacia su chatbot. Ideal para tarjetas de presentación, escaparates, menús de restaurante o empaques de producto. Personalice el color y el tamaño, descargue en PNG o SVG y siga las estadísticas de escaneo en tiempo real.

Plan requerido

Disponible a partir del plan Pro (69$/mes).

Social proof en directo

Muestre el número de visitantes activos en el widget (ej.: «3 personas en línea»). Esta prueba social crea un sentido de urgencia y aumenta el engagement entre un 15 y un 20%. El contador se actualiza automáticamente cada 60 segúndos.

Plan requerido

Disponible a partir del plan Business (149$/mes).

Detección de oportunidades en tiempo real

La IA analiza cada conversación en tiempo real y detecta señales de compra fuertes: mención de presupuesto, urgencia e intención de compra. Cuando múltiples señales convergen, se envía una notificación inmediata por Slack, email o WhatsApp para que pueda intervenir en el momento justo.

Plan requerido

Disponible a partir del plan Business (149$/mes).

Auto-training IA

El chatbot aprende de las correcciones realizadas por los agentes humanos en el chat en vivo. Al escribir /correction seguido del texto correcto, el agente le enseña al bot la respuesta adecuada. El bot utiliza estas correcciones como contexto adicional en conversaciónes futuras, mejorando continuamente sin intervención técnica.

Plan requerido

Reservado al plan Enterprise (299$/mes).

Documentos IA (RAG)

Base de conocimientos vectorial

ChatDirect utiliza una base de datos Supabase (PostgreSQL) con la extensión pgvector para implementar RAG (Retrieval-Augmented Generation). En lugar de depender únicamente de un prompt de texto, el chatbot puede buscar semánticamente en sus documentos para encontrar los extractos más relevantes a cada pregunta del visitante.

Formatos soportados

Los clientes pueden subir documentos en los siguientes formatos para entrenar su chatbot:

• PDF — Manuales, catálogos, guías, políticas internas
• Word (.docx) — Documentos de procedimientos, FAQ internas, fichas de producto
• TXT — Archivos de texto plano, notas, bases de conocimiento existentes

Indexación de páginas web

También es posible indexar páginas web por URL para que el chatbot aprenda el contenido de su sitio. Basta con ingresar la dirección de las páginas que desea indexar y el sistema extraerá automáticamente el contenido relevante.

Cómo funciona

El sistema divide cada documento en secciones (chunks), genera embeddings vectoriales para cada sección y los almacena en la base de datos. Cuando un visitante hace una pregunta, se realiza una búsqueda semántica en tiempo real: la pregunta se compara con todos los documentos indexados para encontrar los extractos más relevantes, que son inyectados como contexto en la respuesta de la IA.

Beneficios

• Respuestas más precisas — Basadas en el contenido específico de su empresa, no en conocimientos generales de la IA
• Sin reescritura manual — No es necesario reescribir su base de conocimiento; simplemente suba sus documentos existentes
• Actualización fácil — Suba nuevas versiones de sus documentos o indexe nuevas páginas en cualquier momento
• Búsqueda inteligente — La búsqueda semántica comprende el sentido de la pregunta, no solo las palabras exactas

Plan requerido

Disponible a partir del plan Pro (69$/mes).

Límites por plan

Review Booster

Convierta conversaciones en reseñas de Google

El Review Booster utiliza su Perfil de empresa de Google (anteriormente Google My Business / GMB) para dirigir a los clientes satisfechos a su ficha de Google. Necesita un Perfil de empresa de Google activo para usar esta funcionalidad.

El Review Booster detecta automáticamente cuando un visitante está satisfecho y le pide calificar su experiencia de 1 a 5 estrellas, directamente en el widget de chat.

3 disparadores inteligentes

La solicitud de reseña se activa en tres situaciones: el visitante expresa satisfacción, la IA detecta un sentimiento positivo fuerte, o la conversación termina naturalmente en una nota positiva.

Filtro anti-mala-reseña

4-5 estrellas: el visitante es redirigido a su ficha de Google para dejar una reseña pública. 1-3 estrellas: el visitante completa un formulario privado. La IA genera una respuesta empática y usted recibe una notificación con el análisis IA de puntos de mejora.

A/B Testing integrado

Tres variantes del mensaje se prueban automáticamente. El dashboard Reviews muestra las tasas de conversión por variante para optimizar sus resultados.

Secuencia de seguimiento multicanal

Si el visitante no deja reseña inmediatamente: se envía un correo de recordatorio después del retraso configurado, y opciónalmente un SMS 24 horas después vía Twilio.

Widget de testimonios

Muestre sus reseñas positivas directamente en su sitio con el widget de testimonios. Integre mediante código HTML o el shortcode de WordPress [chatdirect-testimonials].

Configuración

Active el Review Booster en Configuración → pestaña IA. Ingrese su URL de Google Reviews desde su Perfil de empresa de Google (Google Maps → su ficha → Pedir reseñas → copiar enlace). Opciones disponibles: código promo incentivo, correo de seguimiento automático, informe mensual.

Plan requerido

Disponible a partir del plan Pro (69$/mes).

Modo oscuro del widget

El widget ChatDirect ofrece 5 temas visuales para adaptarse perfectamente a la apariencia de su sitio web.

Temas disponibles

Detección automática (Auto / System)

Los modos Auto y System utilizan la media query prefers-color-scheme del navegador para detectar la preferencia del usuario. En modo System, el widget reacciona en tiempo real: si el visitante cambia su OS del modo claro al modo oscuro, el widget se adapta instantáneamente sin recargar la página.

Colores adaptados

Cada tema ajusta automáticamente los colores de fondo, texto, burbujas de mensajes, barra de entrada y botones para garantizar un contraste óptimo y una legibilidad perfecta.

Configuración

El tema se configura en Configuración del bot → pestaña Apariencia → Tema del widget. El modo Auto es recomendado para la mayoría de los sitios.

Chat en vivo — 3 modos

Transferencia a un agente humano

En modo Híbrido o Humano, un botón de transferencia aparece en el widget. El visitante puede solicitar hablar con un humano en cualquier momento.

Un badge LIVE animado aparece en el widget cuando un agente está conectado y disponible. La disponibilidad se determina por el horario configurado. Límite: 20 transferencias por hora por dirección IP.

Interfaz del agente (admin y portal)

Los agentes gestionan las sesiones en vivo desde el panel de administración o el portal del cliente.

• Cola de espera — Badges visuales: «En espera» y «En curso»
• Toma de control (takeover) — El agente hace clic para tomar una sesión en espera
• Mensajes en tiempo real — Envío y recepción instantáneos
• Mensajes del sistema — «El agente X se ha unido a la conversación»
• Indicador «visto» — El agente ve cuando el visitante ha leído sus mensajes
• Enlace a la conversación — Acceso al historial completo de la conversación con el bot
• Cierre de sesión — El agente cierra la sesión cuando la conversación ha terminado

Respuestas guardadas

Acelere sus respuestas con plantillas pre-escritas.

• Plantillas organizadas por categoría (general, leads, soporte, ventas)
• Inserción en 1 clic en el campo de entrada
• Editable antes de enviar — personalice cada respuesta
• Gestión completa: crear, editar, eliminar desde la página de Respuestas guardadas

Resumen IA de la conversación

Un resumen automático de 3 líneas se genera para cada sesión:

• Necesidad — Lo que el visitante busca
• Respuesta — Lo que el bot respondió
• Acción recomendada — Siguiente paso sugerido

Generado por Claude Haiku, el resumen se almacena en caché y se puede regenerar bajo demanda.

Polling e indicador «visto»

Horario y comportamiento fuera de horario

Un horario unificado controla la disponibilidad del bot y de la transferencia humana.

Presets de horario: Lun-Vie 9am-5pm, Lun-Sáb 8am-8pm, 24/7. Más de 20 zonas horarias soportadas.

Notificaciónes

Cuando un visitante solicita una transferencia o envía un mensaje, su equipo es notificado por múltiples canales simultáneamente:

• Slack
• WhatsApp
• Messenger
• Email
• Webhooks personalizados
• Google Sheets

Cada notificación incluye un resumen del historial de la conversación.

Límites y rate limiting

Reservas inteligentes

El bot toma citas automáticamente a través de:

• Calendly — Integración directa con pre-llenado
• Google Calendar — Horarios disponibles en tiempo real
• Cal.com — Alternativa open-source

Pipeline kanban

Vista drag-and-drop con 4 columnas: Nuevo, Contactado, Convertido, Perdido. Cambie el estado con un clic o arrastrando y soltando.

Funcionalidades

• Etiquetas personalizadas (crear, aplicar, filtrar)
• Filtros avanzados (búsqueda, estado, puntuación, etiqueta, fechas)
• «Mis leads» — filtro por agente asignado
• Asignación a agentes

Lead scoring dinámico (0-15)

La puntuación se calcula automáticamente y se actualiza con cada interacción:

Score predictivo de conversión

Además del lead scoring clásico (0-15), ChatDirect calcula un score predictivo de conversión expresado en porcentaje (0-95%). Este score estima la probabilidad de que un lead se convierta en cliente, comparando su perfil con los leads ya convertidos.

Criterios de cálculo

Visualización

El score predictivo se muestra en la ficha detallada del lead como un indicador circular con colores:

• Verde (70-95%) — Alta probabilidad de conversión
• Naranja (40-69%) — Probabilidad moderada
• Rojo (0-39%) — Baja probabilidad

Scoring IA mejorado

El scoring IA detecta automáticamente señales en los mensajes del lead:

• Palabras clave de compra — «comprar», «pedir», «cotización», «presupuesto», «urgente»
• Palabras clave negativas — «cancelar», «muy caro», «no me interesa»
• Longitud de la conversación — Las conversaciónes más largas aumentan el score

Relanzamientos automáticos — 3 etapas

Configure hasta 3 etapas de relanzamiento por email (+ SMS Twilio opciónal). Cada etapa tiene un plazo, un asunto y una plantilla con variables:

Ejemplo de secuencia

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 línea de tiempo del lead.

• Formulario pre-llenado con datos del lead
• Historial de emails en la línea de tiempo
• Cambio automático de estado a "Contactado"
• Soporte para proveedores de email API (SMTP2GO, SendGrid, Brevo, Mailgun, Amazon SES)

Detección y fusión de duplicados

El sistema detecta automáticamente duplicados por email o teléfono. Al fusiónar, se conserva la puntuación más alta y se combinan notas, etiquetas e historial de ambos registros.

Notificaciónes en tiempo real

El sistema notifica sobre eventos importantes: nuevos leads, recordatorios vencidos, seguimientos enviados y cambios de estado.

• Campana CRM — Icono en la navegación, polling cada 30 segúndos
• Slack — Notificaciónes en un canal Slack
• WhatsApp — Notificaciónes WhatsApp Business
• Email — Email automático para leads calientes

Registro de actividad

El registro muestra todos los eventos CRM en orden cronológico: 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 = próximo, Rojo = vencido, Verde = completado

Informe CRM en PDF

Se puede generar un informe PDF de las estadísticas CRM con selección de fechas. Incluye indicadores clave, embudo de conversión, leads calientes y tendencias del periodo.

Campos personalizados

Defina campos personalizados para enriquecer las fichas de sus leads con información específica de su negocio. Los campos se configuran por cliente en la sección de administración.

Tipos de campos disponibles

Funcionalidades

• Visualización en la ficha — Los campos personalizados aparecen en la ficha detallada del lead
• Edición en línea — Modifique los valores directamente desde la ficha del lead
• Columnas en la lista — Los campos son visibles como columnas en la lista de leads
• Filtros avanzados — Filtre sus leads por cualquier campo personalizado

Formularios web integrables

Cree formularios HTML que se pueden integrar directamente en el sitio web de su cliente. Los envíos se convierten automáticamente en leads del CRM con notificaciónes.

Creación de formularios

• Campos estándar — Nombre, email, teléfono, mensaje
• Campos personalizados — Agregue sus propios campos definidos en la configuración
• Colores — Personalice los colores del formulario para coincidir con el sitio del cliente

Integración

Se genera automáticamente un código embed. Simplemente cópielo y péguelo en el HTML del sitio:

Seguridad

• Anti-spam honeypot — Campo oculto para bloquear robots
• Límite de envíos — Límite de envíos por IP para evitar abusos
• Notificaciónes — Alerta automática en cada nuevo envío

Vista de mapa de leads

Visualice sus leads en un mapa interactivo para comprender la distribución geográfica de sus prospectos. El mapa utiliza Leaflet.js y OpenStreetMap.

Funcionalidades

• Geolocalización por IP — Posición aproximada determinada vía ip-api.com con caché para rendimiento
• Marcadores por color — Color según el estado del lead (verde = convertido, azul = nuevo, naranja = contactado, rojo = perdido)
• Agrupación — Agrupamiento automático de marcadores cercanos para una vista legible
• Filtros — Filtre por estado, score, etiqueta o período
• Popups — Haga clic en un marcador para ver la información del lead (nombre, score, estado)

Analytics avanzado

El panel de Analytics ofrece una vista completa del rendimiento de su chatbot. Accesible desde el portal del cliente, reúne todas las métricas clave, gráficos de tendencia y herramientas de análisis necesarias para optimizar su chatbot y medir su impacto en su negocio.

Dashboard y métricas

El dashboard principal muestra de un vistazo los indicadores esenciales de su chatbot:

• Conversaciones totales — Número de conversaciónes en el período selecciónado
• Mensajes promedio por conversación — Indicador de la profundidad de los intercambios
• Tokens consumidos — Uso de tokens IA en el período
• Satisfacción — Proporción de pulgar arriba vs pulgar abajo
• Rendimiento — Tiempo de respuesta promedio, duración promedio, tasa de rebote, tasa de abandono y tasa de conversión a leads

Cuatro gráficos acompañan estas métricas:

• Conversaciones por día — Gráfico de barras mostrando el volumen diario
• Horas pico — Barras horizontales identificando los horarios más activos
• Tokens por día — Gráfico de línea del consumo diario
• Tendencia de satisfacción — Gráfico de línea de la evolución de satisfacción

Un selector de fechas permite elegir libremente el período a analizar. El dashboard se actualiza automáticamente cada 60 segúndos sin recargar la página.

Comparación de períodos y alertas

Active la casilla « Comparar » para mostrar un segúndo período de referencia. Las fechas de comparación son personalizables. Cada métrica muestra entonces un indicador delta con color:

• +12% en verde para mejoras
• -8% en rojo para retrocesos

El sistema también detecta anomalías automáticamente y muestra alertas en el dashboard:

• Caída de satisfacción superior al 20%
• Tasa de abandono superior al 50%
• Pico de tokens superior al 200% del promedio
• Cero conversaciónes durante 3 días consecutivos
• Tasa de rebote superior al 70%

Análisis detallado

Debajo del dashboard principal, secciones detalladas ofrecen un análisis a profundidad:

Engagement

• Visitantes únicos vs visitantes recurrentes
• Tasa de transferencia a humano
• Tasa de carga de archivos
• Desglose de evaluaciones positivas y negativas

Negocio

• Costo total, costo por conversación y costo por lead (visible solo en modo BYOK)
• Número de leads generados en el período
• Tokens totales consumidos

Páginas principales — Tabla de las páginas más visitadas por los visitantes antes de su interacción con el chatbot. Útil para comprender el recorrido del usuario.

Preguntas más frecuentes — Tabla que agrupa las primeras preguntas enviadas por los visitantes. Permite identificar temas recurrentes y ajustar la base de conocimiento.

Mensajes peor evaluados — Lista de respuestas del chatbot que recibieron pulgar abajo. Ideal para detectar puntos a mejorar en el prompt o la base de conocimiento.

Exportaciónes

Dos formatos de exportación están disponibles:

• Exportación PDF — Informe imprimible con métricas clave y gráficos. Ideal para compartir con el equipo o informes periódicos.
• Exportación CSV — Datos brutos exportables (conversaciónes, tokens, preguntas, o todo). Útil para análisis personalizado en una hoja de cálculo.

Widget integrable

Un mini-dashboard se puede integrar directamente en su sitio web mediante un iframe. Este widget muestra las métricas esenciales en tiempo real.

• Autenticación por clave API pública (api_public_key)
• Temas disponibles: claro (light) y oscuro (dark)
• Actualización automática cada 5 minutos

Automatizaciones

Informe semanal por email — Un resumen automático de las estadísticas de la semana se envía por correo electrónico cada semana. El cron se ejecuta automáticamente e incluye métricas clave, tendencias y alertas eventuales.

Webhooks de analytics — Envíe automáticamente sus estadísticas a una URL configurada, de forma diaria o semanal. Los datos se envían en formato JSON vía POST.

API analytics (v1)

El endpoint /api/v1/stats.php permite recuperar las estadísticas programáticamente. La autenticación se realiza mediante una clave API en el encabezado de la solicitud.

Google Analytics, Slack y Webhooks CRM

Google Analytics 4

Slack

Se envían notificaciónes a Slack para cada nuevo lead, transferencia o alerta.

Webhooks CRM

• HubSpot — Integración directa vía API
• Pipedrive — Creación automática de deals
• Monday.com — Creación de items en el tablero
• Webhook personalizado — POST JSON a cualquier URL

Estas integraciónes son especialmente útiles para empresas B2B y SaaS y el comercio electrónico. Descubra todas nuestras soluciones por sector.

Proveedores de email API

API pública REST

Una clave API pública permite acceder a los datos vía API REST (plan Business o superior requerido).

Logs de auditoría

El sistema de logs de auditoría rastrea automáticamente todas las acciones importantes realizadas por los administradores y los usuarios del portal. Cada modificación se registra con la identidad del actor, la marca de tiempo y los detalles del cambio.

Acciones rastreadas

Almacenamiento

• Por cliente — Archivo JSONL dedicado por cliente (tmp/audit/{clientId}.jsonl)
• Global — Archivo JSONL global que agrupa todas las acciones de todos los clientes
• Formato JSONL — Una entrada JSON por línea para facilitar el procesamiento y el análisis

Página de administración

La página Logs de auditoría en el panel de administración ofrece una vista completa de las acciones con herramientas de filtrado avanzadas:

• Filtro por cliente — Seleccione un cliente específico o muestre todos los clientes
• Filtro por actor — Identifique quién realizó la acción (admin, usuario portal)
• Filtro por acción — Busque un tipo de acción específico
• Filtro por fechas — Defina un período preciso
• Paginación — Navegación página por página para historiales voluminosos
• Exportar CSV — Descargue los logs filtrados en formato CSV para análisis externo

Integración calendario iCal

Exporte sus recordatorios CRM y relanzamientos a su aplicación de calendario preferida usando el formato iCal (.ics). Compatible con Google Calendar, Microsoft Outlook y Apple Calendar.

Cómo funciona

• Flujo iCal — Una URL única por cliente genera un flujo iCal en tiempo real
• Recordatorios incluidos — Todos los recordatorios CRM (tareas, seguimientos) aparecen como eventos
• Relanzamientos incluidos — Los relanzamientos programados también se sincronizan
• Token de autenticación — Cada cliente tiene un token único para asegurar el acceso al flujo

Configuración

Copie la URL del flujo iCal desde la configuración de su portal y agréguela en su aplicación de calendario:

Calendarios compatibles

Privacy by Design

ChatDirect integra la protección de la privacidad desde el diseño, siguiendo el enfoque Privacy by Design. Seis mecanismos garantizan un alto nivel de protección de datos de los visitantes.

Derecho de eliminación

Los visitantes pueden solicitar la eliminación de sus datos directamente desde el widget. Todos los datos asociados a su sesión se borran inmediatamente.

Cumplimiento RGPD y Ley 25

ChatDirect ofrece herramientas completas para el cumplimiento de protección de datos, aplicables al RGPD europeo y la Ley 25 de Quebec.

Seguridad avanzada

Aislamiento de datos (Privacy Wall)

Por defecto, el equipo de ChatDirect no tiene acceso a sus datos: conversaciones, leads, tickets, analytics. Sus datos están completamente aislados y son privados.

Acceso temporal al soporte

Si necesita ayuda y desea que nuestro equipo de soporte pueda consultar sus datos para asistirle, puede conceder un acceso temporal de 72 horas desde su Perfil → Acceso soporte.

Consumo y tokens

Un token equivale a aproximadamente 4 caracteres en inglés o 3 caracteres en francés.

Gestión de usuarios

El portal permite agregar colegas para que accedan con sus propias credenciales.

• Agregar usuario — Crear usuario y contraseña
• Cambiar contraseña — Cada usuario puede cambiar su contraseña
• Eliminar usuario — Revocar el acceso de un colega

Soporte y tickets

El sistema de tickets integrado permite comunicación directa con el equipo de soporte ChatDirect.

Soporte con asistente IA

Al crear un ticket, el asistente IA analiza tu pregunta y genera una respuesta instantánea para guiarte hacia la solución. La IA consulta toda la documentación para proporcionar una respuesta relevante. Puedes continuar la conversación con la IA hasta 4 intercambios. Si el problema está resuelto, haz clic en « Cerrar ticket ». Si no, un agente humano te responderá en un plazo de 24 horas hábiles.

Crear un ticket

1. Cree un ticket con un asunto y prioridad (normal, alta, urgente)
2. Describa claramente el problema
3. La IA responde inmediatamente con sugerencias y enlaces relevantes
4. Continúe el intercambio con la IA o cierre el ticket si está resuelto
5. Si es necesario, un agente humano toma el relevo en 24 horas hábiles

Instalar la aplicación móvil (PWA)

El portal ChatDirect se puede instalar como una aplicación en su teléfono o computadora. Funciona como una app nativa — pantalla completa, icono en la pantalla de inicio, notificaciones — sin pasar por la App Store o Google Play.

En iPhone / iPad (iOS)

1. Abra Safari (solo funciona con Safari en iOS)
2. Vaya a chatdirect.ca/portal/ e inicie sesión
3. Toque el botón Compartir (⬆️) en la parte inferior de la pantalla
4. Desplácese hacia abajo y toque « Agregar a la pantalla de inicio »
5. Escriba un nombre (ej: ChatDirect) y toque « Agregar »

En Android

1. Abra Chrome y vaya a chatdirect.ca/portal/
2. Un banner « Instalar ChatDirect » aparece automáticamente — toque « Instalar »
3. Si el banner no aparece: menú (⋮) → « Instalar aplicación »

En computadora (Chrome)

1. Abra Chrome y vaya a chatdirect.ca/portal/
2. Haga clic en el icono de instalación (⊕) en la barra de direcciones, o menú (⋮) → « Instalar ChatDirect »

Registro automático

El sistema de registro automático permite a los nuevos clientes crear su cuenta y comenzar a usar ChatDirect sin intervención humana. Todo el proceso está automatizado de principio a fin.

Proceso de registro

1. Formulario de registro — El visitante completa su nombre, correo electrónico y contraseña
2. Creación de cuenta — El sistema crea automáticamente la cuenta del cliente con el plan Descubrimiento
3. Aprovisionamiento — La configuración del bot se genera automáticamente (prompt por defecto, colores, idioma)
4. Acceso inmediato — El cliente recibe sus credenciales y accede al portal de inmediato

Prueba gratuita de 14 días

Cada nuevo registro recibe automáticamente una prueba gratuita de 14 días con el plan Descubrimiento, que incluye:

• 250 mensajes IA
• Widget chatbot completamente funcional
• Mini-CRM integrado
• Pipeline kanban
• Seguimientos automáticos

Seguridad

• Validación de email — Verificación del correo electrónico al registrarse
• Contraseña segura — Requisitos mínimos de complejidad
• Rate limiting — Protección contra registros masivos automatizados

Onboarding guiado

El asistente de onboarding guía a los nuevos clientes a través de la configuración inicial de su chatbot en 5 pasos simples. Se activa automáticamente la primera vez que un cliente accede a su portal.

Los 5 pasos del asistente

Características

• Activación automática — Se muestra automáticamente al primer inicio de sesión en el portal
• Botón saltar — Los usuarios experimentados pueden omitir el asistente en cualquier momento
• Progreso visual — Barra de progreso indicando el paso actual
• Vista previa en vivo — El widget se actualiza en tiempo real mientras configura

Subdominios wildcard

Los subdominios wildcard proporcionan a cada cliente una URL personalizada para su chatbot: client-id.chatdirect.ca. Esto simplifica la integración y ofrece una experiencia más profesional.

Funcionamiento

• URL personalizada — Cada cliente accede a su chatbot vía su-id.chatdirect.ca
• Configuración DNS — Un solo registro DNS wildcard (*.chatdirect.ca) redirige automáticamente todos los subdominios
• Detección automática — El sistema detecta el client-id a partir del subdominio y carga la configuración correspondiente
• SSL incluido — Certificado SSL wildcard para todos los subdominios

Configuración DNS

Ventajas

• Sin necesidad de crear un registro DNS por cliente
• URLs limpias y profesionales
• Aislamiento visual entre clientes
• Compatible con el widget estándar y el portal

Perfil y cambio de contraseña

Cada usuario del portal puede gestionar su propio perfil y modificar su contraseña de forma autónoma.

Funcionalidades del perfil

• Información personal — Nombre, correo electrónico de contacto
• Cambio de contraseña — Requiere la contraseña actual + nueva contraseña con confirmación
• Preferencia de idioma — Elegir el idioma de la interfaz (FR-CA, FR-FR, EN-US, ES-MX)
• Preferencia de tema — Elegir el tema visual del panel (claro, oscuro, etc.)

Seguridad

• La contraseña se almacena con hash bcrypt
• Se requiere la contraseña actual para cualquier cambio
• Sesión regenerada después de un cambio de contraseña
• El cambio se registra en los logs de auditoría

Planes y precios

Comparación de funcionalidades

BYOK = Ilimitado

Con BYOK, las conversaciónes 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 conversaciónes con Claude Haiku.

Expiración de prueba

Cuando la prueba gratuita de 14 días (plan Descubrimiento) expira, el sistema aplica automáticamente restricciones para proteger el servicio y motivar la conversión a un plan de pago.

Comportamiento después de la expiración

Alertas y notificaciónes

• 7 días antes — Banner de advertencia en el portal: «Su prueba expira en 7 días»
• 3 días antes — Notificación por email recordando la fecha de expiración
• Día de expiración — Email de confirmación con opciónes de actualización
• Después de la expiración — Banner permanente en el portal con enlace para actualizar el plan

Reactivación

Para reactivar el servicio, basta con suscribirse a un plan de pago (Starter, Pro, Business o Enterprise). El chatbot se reactiva inmediatamente con toda la configuración y los datos preservados.

Stripe Checkout y suscripciones

ChatDirect integra Stripe Checkout para gestionar las inscripciones de pago y las suscripciones recurrentes de forma totalmente automatizada.

Planes y precios

Flujo de inscripción

1. El cliente se inscribe con el plan Descubrimiento (gratis, 14 días)
2. Al expirar o por elección propia, accede a la página de suscripción
3. Redirección a Stripe Checkout para el pago seguro
4. Después del pago, el plan se activa automáticamente vía webhook
5. Página de éxito con la información de acceso al portal

Customer Portal de Stripe

Cada cliente puede gestionar su suscripción directamente desde el Customer Portal de Stripe:

• Modificar la tarjeta de crédito
• Cambiar de plan (upgrade/downgrade)
• Cancelar la suscripción
• Descargar las facturas

Webhooks automáticos

Los eventos de Stripe se procesan automáticamente:

• Pago exitoso — Plan activado, chatbot operativo inmediatamente
• Pago fallido — Notificación al cliente y al admin
• Cancelación — Desactivación del plan al final del período pagado

Programa de socios

El programa de socios de ChatDirect permite a revendedores, agencias y consultores referir clientes y recibir una comisión recurrente del 30 % por cada suscripción activa. Más información →

Portal de socios

Cada socio tiene un portal dedicado accesible en chatdirect.ca/partner/ con:

• Panel de control — Clientes activos, ingresos, comisión pendiente, gráfico 6 meses, previsión IA
• Pitch por email con IA — Generar correos de prospección personalizados (20 sectores, 12 argumentos)
• Seguimiento de clientes — Detalle de cada cliente referido (plan, estado, conversaciones, satisfacción)
• Registro de comisiones — Historial completo con pagos, ajustes y saldo acumulado (exportar CSV)
• Notificaciones automáticas — Correo en cada inscripción o cancelación de un cliente referido
• Seguridad — 2FA (aplicación o correo), contraseña segura, sesiones cifradas
• Guía de ayuda integrada — Documentación completa dentro del portal (FR/EN)

Enlace de referencia

Cada socio recibe un enlace único de referencia:

Cuando un cliente se inscribe a través de este enlace, queda automáticamente vinculado al socio. El socio recibe una notificación por correo y la comisión comienza a acumularse.

Comisión sobre el monto neto

La comisión se calcula sobre el monto neto después de deducir los cargos de procesamiento:

• Canadá — 2,9 % + 0,30 $ por transacción
• Internacional — 3,5 % + 0,30 $ por transacción

Ejemplo — Plan Pro a 69 $/mes (cliente canadiense):

• Cargos de procesamiento: 69 $ × 2,9 % + 0,30 $ = 2,30 $
• Monto neto: 69 $ − 2,30 $ = 66,70 $
• Comisión (30 %): 66,70 $ × 30 % = 20,01 $/mes

Pagos

Las comisiones se acumulan cada mes. Los pagos se realizan cuando el saldo alcanza el umbral mínimo de 100 $ CAD.