Documentación de Trement IA

Primeros pasos

Para comenzar a usar Trement IA necesitas completar tres pasos fundamentales. Una vez configurados, tu asistente comenzará a responder automáticamente.

1. Inicia sesión Ingresa a app.airtestndt.com con las credenciales que recibiste. Si es tu primer acceso, verás un tour guiado que te mostrará las funciones principales.
2. Conecta WhatsApp Ve al panel de conexión de WhatsApp y escanea el código QR con tu teléfono. También puedes usar el método de código de vinculación si lo prefieres.
3. Configura tu Prompt Define las instrucciones de tu asistente IA. Escribe cómo quieres que responda, qué información debe dar, horarios, precios — todo lo que necesite para atender a tus clientes.

Arquitectura

Trement IA es una plataforma multi-tenant donde cada organización opera de forma completamente aislada. Tus datos, conversaciones, configuraciones y contactos son privados y no se comparten con otras organizaciones.

Dashboard

El dashboard es la vista principal de Trement. Funciona como una interfaz de chat donde puedes ver y gestionar todas las conversaciones de tus canales conectados.

Panel de contactos

En el lateral izquierdo verás la lista de todos tus contactos con conversaciones activas. Puedes buscar por nombre o número, y filtrar los chats silenciados.

• Búsqueda: Filtra contactos en tiempo real por nombre, número o contenido
• Indicador de no leídos: Muestra cuántos mensajes sin leer tiene cada contacto
• Último mensaje: Vista previa del último mensaje de cada conversación
• Foto de perfil: Se obtiene automáticamente de WhatsApp cuando está disponible

Vista de conversación

Al seleccionar un contacto, verás el historial completo de mensajes. Los mensajes entrantes se muestran a la izquierda y las respuestas (automáticas o manuales) a la derecha.

Silenciar chats

Puedes silenciar un contacto para que el asistente IA no responda automáticamente sus mensajes. Esto es útil cuando quieres tomar el control manual de una conversación. Para silenciar, usa el botón de silenciar en la cabecera del chat.

Enviar archivos

Desde la caja de mensajes puedes enviar imágenes, videos, audios, documentos PDF y otros archivos. El asistente también puede recibir y transcribir notas de voz automáticamente.

Indicadores de estado

En la parte superior del dashboard verás indicadores de conexión de cada canal:

• Verde: Canal conectado y funcionando
• Rojo: Canal desconectado
• Naranja: Conectando o reconectando

Ventas

El módulo de ventas convierte tus conversaciones en oportunidades de negocio. La IA analiza cada conversación y genera perfiles de leads con puntuación, etapa del embudo y recomendaciones estratégicas.

Lead Scoring

Cada contacto recibe una puntuación de 0 a 100 calculada por IA basándose en múltiples factores:

Listas dinámicas

Los leads se organizan automáticamente en listas inteligentes que se actualizan en tiempo real:

• Listos para cerrar: Leads con score alto y señales de decisión
• Alta prioridad: Contactos con urgencia elevada
• Pidieron precio: Quienes preguntaron por costos
• Calientes hoy: Leads activos en las últimas 24h
• Con objeciones: Contactos que expresaron dudas
• Nuevos 24h: Contactos nuevos del día
• Seguimiento: Leads que necesitan follow-up

Timeline visual

La línea de tiempo muestra la actividad de leads de la semana con puntos de color que representan la clasificación del lead: rojo para calientes, naranja para tibios, azul para fríos y verde para nuevos.

Detalle del lead

Al hacer clic en un lead puedes ver su perfil completo generado por IA:

• Resumen ejecutivo de la conversación
• Productos o servicios de interés
• Datos estratégicos: presupuesto estimado, timeline, tamaño de empresa
• Puntos de dolor y objeciones detectadas
• Recomendaciones de acción generadas por IA
• Acciones rápidas: abrir chat o tomar control de la conversación

Exportar

Puedes exportar toda la tabla de leads a formato CSV para trabajar con los datos en Excel u otras herramientas.

Contactos

El módulo de contactos te da una vista completa de todas las personas que han interactuado con tu organización. A diferencia del dashboard (que muestra chats activos), aquí ves toda tu base de contactos con herramientas de filtrado avanzado.

Filtros disponibles

• Rango de fechas: Filtra por fecha de primer o último contacto
• Clasificación: Caliente, tibio, frío o nuevo
• Búsqueda: Por nombre, teléfono, email o empresa
• Etiquetas: Filtra por tags asignados

Información de cada contacto

Multimedia

El módulo de multimedia te permite configurar respuestas automáticas con archivos cuando se detectan palabras clave en los mensajes de tus contactos. Funciona como un sistema de reglas: defines las palabras clave y el archivo que se envía.

Cómo funciona

1. Crea una nueva regla
2. Define las palabras clave que activarán la regla (separadas por coma)
3. Pega el enlace al archivo (Google Drive, Dropbox, YouTube, etc.)
4. Opcionalmente agrega un mensaje de texto que acompañe al archivo
5. Define la prioridad (alta, media, baja)

Tipos de archivo soportados

Ejemplo

Prompt IA

El prompt es el corazón de tu asistente. Es un conjunto de instrucciones que le indican a la IA cómo comportarse, qué información dar y cómo interactuar con tus clientes. Un buen prompt marca la diferencia entre un asistente genérico y uno que realmente represente tu negocio.

Modo manual

Escribe libremente las instrucciones para tu asistente. Puedes incluir:

• Nombre y personalidad del asistente
• Información de tu empresa (servicios, precios, ubicación)
• Horarios de atención
• Respuestas a preguntas frecuentes
• Instrucciones sobre qué hacer cuando no sepa algo
• Tono de comunicación (formal, casual, técnico)
• Reglas de cierre de conversación

Plantillas por industria

Si no sabes por dónde empezar, Trement ofrece plantillas pre-configuradas para distintas industrias. Selecciona la más cercana a tu negocio y personalízala.

Contexto personalizado

Además del prompt, puedes agregar contexto adicional. Esto es información complementaria que la IA puede consultar — como un catálogo de productos, políticas internas o datos técnicos.

Ejemplo de prompt

Etiquetas

Las etiquetas te permiten categorizar y organizar tus contactos. Puedes crear etiquetas personalizadas con colores y asignarlas manual o automáticamente.

Crear etiquetas

Cada etiqueta tiene:

• Nombre: El texto visible (ej: "VIP", "Requiere seguimiento")
• Color: Para identificarla visualmente
• Categoría: Estado, prioridad, fuente, industria o personalizada
• Descripción: Nota interna sobre cuándo usar esta etiqueta

Asignar etiquetas

Puedes asignar etiquetas desde la cabecera del chat en el dashboard, o desde el módulo de contactos. La IA también puede sugerir y asignar etiquetas automáticamente basándose en el contenido de las conversaciones.

Filtrar por etiquetas

Tanto en el módulo de contactos como en ventas, puedes filtrar la vista por etiquetas para enfocarte en segmentos específicos de tu base de clientes.

Estadísticas

El panel de estadísticas te muestra métricas clave sobre el rendimiento de tu asistente y la actividad de tus conversaciones.

Métricas principales

Gráficos

• Actividad por día: Gráfico de barras con mensajes diarios de la semana
• IA vs Manual: Distribución de respuestas automáticas vs intervención humana
• Contactos más activos: Lista de los contactos con mayor interacción

Catálogo de productos

Gestiona un catálogo de productos o servicios directamente dentro de Trement. Los productos se sincronizan automáticamente con tu catálogo de WhatsApp Business si lo tienes, o puedes crearlos manualmente.

Funcionalidades

• Sincronización WhatsApp: Importa automáticamente los productos de tu catálogo de WhatsApp Business
• CRUD manual: Crea, edita y elimina productos directamente
• Envío por chat: Envía productos a contactos con imagen y descripción como fallback de texto
• Campos: Nombre, descripción, precio, moneda, imagen, URL, disponibilidad

Endpoints

WhatsApp

La conexión de WhatsApp es el canal principal de Trement. Se conecta directamente a tu número de WhatsApp existente (personal o Business) mediante escaneo de código QR.

Conectar

1. Abre el panel de conexión Haz clic en el botón de WhatsApp en la barra superior del dashboard.
2. Escanea el código QR Abre WhatsApp en tu teléfono → Dispositivos vinculados → Vincular dispositivo → Escanea el código.
3. Espera la sincronización Una vez escaneado, el sistema sincronizará tus contactos y conversaciones. Esto puede tomar unos segundos.

Método alternativo: Código de vinculación

Si prefieres no escanear QR, puedes usar un código numérico. Ingresa tu número de teléfono y recibirás un código que debes introducir en WhatsApp.

Reconexión automática

Si la conexión se pierde temporalmente (por reinicio del servidor, problemas de red, etc.), el sistema se reconecta automáticamente sin necesidad de volver a escanear el QR.

Catálogo

Si usas WhatsApp Business con catálogo de productos, Trement sincroniza automáticamente tu catálogo y puede mostrarlo a los clientes cuando lo soliciten.

Telegram

Trement se conecta a Telegram como cliente de usuario (no como bot), lo que permite acceder a todas tus conversaciones personales y de grupo.

Conectar

1. Abre el panel de conexión de Telegram
2. Ingresa tu número de teléfono con código de país
3. Recibirás un código de verificación en Telegram
4. Si tienes verificación en dos pasos, ingresa tu contraseña

Chat Web

El Chat Web es un widget embebible que puedes agregar a cualquier sitio web. Los visitantes pueden chatear directamente con tu asistente IA sin necesidad de WhatsApp ni Telegram.

Configuración

• Color primario: El color principal del widget para que coincida con tu marca
• Posición: Esquina izquierda o derecha de la pantalla
• Logo: URL de tu logo para mostrar en el widget
• Mensaje de bienvenida: Lo primero que ve el visitante al abrir el chat
• Horario: Mensaje cuando escriben fuera de horario

Instalación

Copia el código de instalación y pégalo antes del cierre </body> de tu sitio web:

Canales complementarios

Dentro de la configuración del widget puedes agregar enlaces a tus otros canales (WhatsApp, Telegram, Facebook, Instagram) para que los visitantes elijan cómo contactarte.

Configuración del modelo IA

Ajusta los parámetros del modelo de inteligencia artificial que genera las respuestas de tu asistente.

Protección Anti-Ban

WhatsApp puede restringir cuentas que envían mensajes de forma automatizada sin comportamiento humano. Trement incluye un sistema de protección que simula patrones de uso natural.

Control de números

Define qué números pueden o no recibir respuestas automáticas de tu asistente.

Lista blanca (permitidos)

Si agregas números a la lista blanca, el asistente SOLO responderá a esos números. Útil para pruebas o para limitar el servicio a clientes específicos.

Lista negra (bloqueados)

Los números en la lista negra nunca recibirán respuestas automáticas. Útil para bloquear spam o números que prefieres atender manualmente.

Horario de atención

Configura los días y horas en que tu asistente debe responder. Fuera de este horario, puedes definir un mensaje automático personalizado (por ejemplo: "Nuestro horario de atención es de Lunes a Viernes de 8am a 6pm").

• Días laborales: Selecciona qué días de la semana está activo
• Hora inicio / fin: Rango horario de operación
• Mensaje fuera de horario: Texto que se envía cuando escriben fuera del horario configurado

Comportamiento del sistema

Controles avanzados sobre cómo el sistema gestiona las conversaciones internamente.

Conector Universal de API

Conecta cualquier sistema externo que tenga API (CRMs, ERPs, e-commerce, bases de datos) para que tu asistente IA consulte y envíe datos en tiempo real durante las conversaciones.

¿Cómo funciona?

1. Crea una integración — Define URL del API, método HTTP, autenticación y las palabras clave que activarán la consulta.
2. Configura parámetros — Define qué datos necesita la API. Pueden ser auto-extraídos del mensaje o recolectados conversacionalmente.
3. El usuario escribe por WhatsApp — Cuando un contacto envía un mensaje con las keywords, el sistema intercepta y consulta la API automáticamente.
4. La IA responde con datos reales — Los datos se inyectan como contexto en GPT. Las imágenes se envían como mensajes nativos de WhatsApp.

Tipos de autenticación

Auto-extracción de parámetros

Cuando un parámetro tiene extractFromMessage activado, se extrae automáticamente del mensaje del usuario sin preguntar.

Stem matching inteligente

Keywords de 5+ caracteres generan un "stem" (raíz) para detectar conjugaciones en español:

• "tienen" → stem "tien" → detecta: tienes, tiene, tienen, tenemos
• "disponible" → stem "disponibl" → detecta: disponibles, disponible
• "catálogo" → stem "catálo" → detecta: catálogo, catálogos

Envío de imágenes nativas

Si la API devuelve campos de imagen (image, foto, thumbnail, picture), se detectan automáticamente y se envían como mensajes nativos de WhatsApp — no como links de texto.

Response mapping

Para APIs con datos anidados (ej: data.results.items), configura un response mapping que indica dónde está el array de resultados.

Endpoints

Plantillas de conectores

Trement incluye 14 plantillas preconfiguradas para los sistemas más populares. Selecciona, completa credenciales y listo.

Google Meet

Crea enlaces de videollamada directamente desde las conversaciones. La IA genera un link de Meet automáticamente cuando un cliente quiere agendar una reunión.

Configuración

1. Conecta tu cuenta de Google — Configuración → Google Meet → Conectar (OAuth2).
2. Configura preferencias — Duración por defecto y zona horaria.
3. Usa en conversaciones — La IA detecta solicitudes de agenda y genera el link.

Endpoints

Webhooks

Notifica a sistemas externos cuando ocurren eventos en Trement. Cada webhook envía un HTTP POST firmado con HMAC SHA-256. Reintentos automáticos (3 intentos). Estadísticas de entrega.

Eventos disponibles

Endpoints

Memoria conversacional

Historial completo de cada conversación en PostgreSQL. La IA usa este historial para respuestas contextuales — recuerda lo que el contacto dijo, sus preferencias y el hilo de la conversación.

• Almacenamiento: Cada mensaje con timestamp y metadata
• Contexto GPT: Últimos N mensajes como contexto (configurable)
• Limpieza automática: Conversaciones inactivas se limpian periódicamente
• Sincronización: Persistencia en disco como backup

Endpoints

Mensajes interactivos

Botones y listas interactivas nativos de WhatsApp para guiar a tus contactos con mejor tasa de respuesta.

Acciones disponibles

Si el dispositivo no soporta interactivos, se convierten a texto numerado con detección de respuesta numérica.

Audio de bienvenida

Genera un audio personalizado para contactos nuevos usando GPT-4 (texto) + OpenAI TTS (voz). Se envía como nota de voz nativa de WhatsApp.

• Se activa en el segundo mensaje del contacto
• Solo si el mensaje no es un saludo genérico
• Se cachea por organización (~$0.01 por audio)
• Configurable a nivel de organización

Transcripción de audio

Las notas de voz se transcriben automáticamente con OpenAI Whisper. La IA responde al contenido transcrito como texto.

• Máximo: 25 MB por audio
• Formatos: OGG, MP3, WAV, M4A
• Idiomas: Detección automática
• Stats: Estadísticas de transcripciones por organización

Caché GPT

Dos niveles de caché para reducir costos y acelerar respuestas:

Suscripciones y planes

Trement opera con un modelo de suscripción por organización. Cada plan define los límites de uso del servicio.

Planes disponibles

Ciclo de vida

• Trial: 48 horas de acceso completo. Se puede extender desde el panel admin.
• Facturación: Mensual o anual (descuento en anual).
• Expiración: El sistema trackea fechas de vencimiento y notifica al usuario.
• Upgrade: Cambio de plan en cualquier momento con pago proporcional.

Pagos con Bold

Integración con Bold como pasarela de pagos para compra de planes. El flujo es completamente seguro con verificación de integridad SHA-256.

Flujo de pago

1. El usuario selecciona un plan — Elige plan y periodo (mensual/anual).
2. Se genera el hash de integridad — El servidor genera un HMAC SHA-256 para Bold.
3. Checkout en Bold — El usuario completa el pago en la pasarela segura de Bold.
4. Registro automático — Después del pago exitoso, se crea la organización con el plan seleccionado y fecha de expiración.

Fijar chats

Fija conversaciones importantes para que siempre aparezcan en la parte superior de tu lista de chats. Los chats fijados se persisten en base de datos y se mantienen entre sesiones.

• Toggle desde la cabecera del chat
• Persiste en DB (campo pinned)
• Los chats fijados se ordenan por encima de los demás

Renombrar contactos

Asigna nombres personalizados a tus contactos. Cuando renombras manualmente, el sistema marca el nombre con nameSource='manual' para que la detección automática nunca lo sobrescriba.

• Actualiza el nombre en chats y leads simultáneamente
• Persiste entre reinicios del servidor
• Se mantiene aunque el contacto cambie su nombre de WhatsApp

Notificaciones

Sistema de notificaciones push desde la administración a los usuarios. Las notificaciones llegan en tiempo real vía WebSocket y se muestran en la campana del dashboard.

Características

• Segmentación: Enviar a todos, por plan o a una organización específica
• Tiempo real: Entrega inmediata vía WebSocket
• Tracking: Control de lectura por usuario
• Expiración: Notificaciones con fecha de vencimiento opcional

Tour guiado

Los usuarios nuevos reciben un tour interactivo (powered by Shepherd.js) que los guía por las funciones principales del dashboard en su primer inicio de sesión. El tour destaca: conexión de WhatsApp, chat, ventas, configuración y personalización del prompt.

Referidos

Sistema de referidos que genera códigos de descuento del 15% para nuevos usuarios. Cuando recomiendas Trement, el referido obtiene un descuento y tu referencia queda registrada con nombre, teléfono y email.

API REST

Trement expone una API REST completa. Todas las rutas requieren autenticación JWT excepto los endpoints públicos del widget.

Autenticación

Todos los endpoints

WebSocket

Las actualizaciones del dashboard se entregan en tiempo real mediante WebSocket. La conexión se autentica con JWT y opera con aislamiento multi-tenant.

Características

• Autenticación: JWT token en handshake
• Heartbeat: Ping cada 30 segundos para mantener conexión
• Multi-tenant: Cada organización recibe solo sus eventos
• Eventos: Nuevos mensajes, cambios de estado, notificaciones, actualizaciones de chats
• Throttling: Emisiones agrupadas para evitar sobrecarga del cliente

Modelos de datos

Referencia de las entidades principales de la plataforma y sus relaciones.

Roles y permisos

Sistema de roles con permisos granulares para controlar acceso dentro de la organización.

Roles

Permisos granulares

• viewDashboard — Ver dashboard y chats
• manageLeads — Módulo de ventas y leads
• manageMultimedia — Reglas multimedia
• managePrompts — Prompt y contexto IA
• manageUsers — Gestión de usuarios
• manageSettings — Configuración del sistema
• manageWhatsApp — Conexión de WhatsApp
• manageIntegrations — Webhooks e integraciones dinámicas

Monitor del sistema

Panel de monitoreo en tiempo real del estado del servidor y sus servicios.

Métricas disponibles

Endpoints

Soporte

Chat de soporte técnico integrado en la plataforma, powered by GPT-4o-mini con conocimiento de todas las funciones de Trement.

¿Qué puede resolver?

• Problemas de conexión de WhatsApp y Telegram
• Configuración del prompt e integraciones
• Dudas sobre ventas, leads y estadísticas
• Configuración del Chat Web y widget
• Problemas con multimedia y catálogo
• Configuración de Google Meet y webhooks

Contacto directo