> ## Documentation Index
> Fetch the complete documentation index at: https://revolai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Conceptos Fundamentales
> Conceptos clave y terminologia en Revol
## Empresas
Una **Empresa** es la entidad central en Revol. Todo — productos, archivos, agentes, integraciones y analiticas — pertenece a una empresa.
Cada empresa tiene:
* **Productos y Servicios** — catalogo estructurado con descripciones, precios, fotos y parametros
* **Gestor de Archivos** — documentos, enlaces, texto, video y fotos para bases de conocimiento
* **Agentes de IA** — uno o mas asistentes inteligentes entrenados con datos de la empresa
* **Integraciones** — canales conectados (widget, VoIP, mensajeros, publicidad, CRM)
* **Analiticas** — seguimiento de visitantes, datos de sesiones e historial de conversaciones
Una unica cuenta de Revol puede gestionar multiples empresas con datos completamente aislados — ideal para agencias o negocios multimarca.
***
## Productos y Servicios
Los **Productos** son modelos de datos estructurados que describen lo que su negocio ofrece. A diferencia de los documentos de texto sin formato, los productos proporcionan a los agentes de IA informacion precisa y consultable.
Cada producto incluye:
| Campo | Proposito |
| ------------------ | -------------------------------------------------------------- |
| **Nombre** | Titulo del producto o servicio |
| **Descripcion** | Texto detallado que el agente utiliza para las respuestas |
| **Precio** | Informacion de precios |
| **URL** | Enlace a la pagina del producto en su sitio web |
| **Disponibilidad** | Si el producto esta actualmente disponible |
| **Fotos** | Imagenes del producto que el agente puede compartir |
| **Parametros** | Pares estructurados clave-valor (talla, color, duracion, etc.) |
Los **Parametros** son la parte mas potente — caracteristicas estructuradas que permiten a los agentes dar respuestas exactas en lugar de interpretar texto no estructurado. Consulte [Inicio Rapido -> Parametros de Producto](/quickstart#product-parameters) para ver ejemplos.
***
## Base de Conocimientos
La **Base de Conocimientos** es el contenido del que aprenden sus agentes de IA. Utiliza **RAG (Retrieval-Augmented Generation)** — los documentos se dividen en fragmentos, se convierten en embeddings vectoriales y se buscan semanticamente durante las conversaciones.
### Tipos de Contenido
| Tipo | Formatos | Como funciona |
| -------------- | -------------- | ----------------------------------------------------- |
| **Documentos** | PDF, DOCX, TXT | Texto extraido y fragmentado |
| **Enlaces** | Cualquier URL | Contenido de la pagina web obtenido e indexado |
| **Texto** | Texto libre | Agregado directamente como fragmentos de conocimiento |
| **Video** | MP4, WebM, MOV | Audio transcrito a texto via STT |
| **Fotos** | JPG, PNG | Texto extraido via OCR |
### Dos Niveles de Conocimiento
* **Archivos a nivel de empresa** — disponibles para todos los agentes de la empresa
* **Archivos a nivel de producto** — adjuntos a un producto especifico, utilizados cuando el agente habla sobre ese producto
***
## Agentes de IA
Un **Agente de IA** es un asistente inteligente configurado de forma independiente con su propia personalidad, conocimiento y comportamiento. Los agentes pueden operar en tres modos:
| Modo | Descripcion |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Activo** | La IA gestiona completamente la comunicacion con el cliente — responde mensajes, realiza llamadas a herramientas, sigue el flujo de trabajo |
| **Pasivo** | Su equipo gestiona toda la comunicacion. El agente funciona en segundo plano — supervisando conversaciones, auditando el cumplimiento de los estandares de comunicacion y proporcionando analisis |
| **Hibrido** | Una combinacion: la IA maneja las interacciones rutinarias automaticamente, mientras su equipo se encarga de los casos complejos. El agente analiza continuamente todas las conversaciones independientemente de quien responda |
El modo pasivo es ideal para equipos que desean control de calidad impulsado por IA sin reemplazar a los operadores humanos. El agente supervisa cada conversacion, verifica el cumplimiento de guiones y estandares, y genera informacion util — sin responder directamente a los clientes.
### Componentes del Agente
El conjunto de instrucciones principal — define el rol del agente, el tono, el idioma y los limites. Cuanto mas especifico sea su prompt, mejor funcionara el agente.
Seleccione que productos y archivos debe aprender el agente. Despues de la seleccion, haga clic en **Entrenar** para generar embeddings vectoriales para la busqueda semantica.
Editor visual basado en nodos para la logica de conversacion. Cada agente obtiene un [flujo de trabajo predeterminado](/quickstart#default-workflow) que maneja la mayoria de los casos de uso de forma inmediata.
Funciones que el agente puede ejecutar durante las conversaciones — buscar productos, verificar disponibilidad, obtener fotos, recuperar documentos, consultar informacion de la empresa.
Personalice la apariencia del widget de chat — colores, etiquetas, ubicacion, mensajes de bienvenida, terminos y condiciones.
Conecte el agente a canales de comunicacion — widget del sitio web, Telegram, WhatsApp, Instagram, Facebook Messenger, VoIP.
### Proveedores LLM
Cada agente (o nodo individual del flujo de trabajo) puede utilizar un modelo de IA diferente:
| Proveedor | Modelos Estandar | Modelos Premium |
| ------------- | ---------------- | ----------------- |
| **OpenAI** | GPT-4o-mini | GPT-4o |
| **Anthropic** | Claude 3.5 Haiku | Claude 3.5 Sonnet |
| **Google** | Gemini 2.0 Flash | Gemini 2.5 Pro |
| **Groq** | Llama 3.1 8B | Llama 3.3 70B |
Los modelos estandar son mas rapidos y consumen tokens estandar. Los modelos premium ofrecen mayor calidad y consumen tokens premium.
***
## Flujos de Trabajo
Un **Flujo de Trabajo** es un editor visual basado en nodos para definir como su agente procesa las conversaciones. Los nodos se conectan con aristas que definen el flujo de datos.
### Tipos de Nodos
| Nodo | Descripcion |
| ---------------------- | ------------------------------------------------------------------------ |
| **Start** | Punto de entrada — recibe el mensaje del usuario |
| **LLM** | Envia el contexto a un modelo de IA y obtiene una respuesta |
| **Condition** | Ramifica el flujo segun reglas (palabras clave, intencion, variables) |
| **Tool Call** | Ejecuta una funcion externa (buscar productos, verificar disponibilidad) |
| **Voice Input (STT)** | Convierte voz a texto para interacciones de voz |
| **Voice Output (TTS)** | Convierte la respuesta de texto a voz |
| **Response Formatter** | Combina las salidas de multiples nodos en una unica respuesta |
### Flujo de Trabajo Predeterminado
Cada nuevo agente viene con un flujo de trabajo preconstruido:
```
Start → Product Agent ─┐
├→ Media Agent ─┤→ Response Formatter
└→ Company Agent ─┘
```
Tres agentes especializados trabajan **en paralelo** — cada uno maneja su dominio (productos, multimedia, informacion de la empresa), y el Formatter fusiona sus salidas. Esto cubre la mayoria de los casos de uso sin ninguna configuracion.
Para escenarios complejos — ramificacion condicional, llamadas a herramientas personalizadas, flujos de multiples pasos — utilice el [Editor de Flujos de Trabajo](/agents/workflow).
***
## Conversaciones
Una **Conversacion** es una sesion de chat entre un visitante y un agente de IA. Todas las conversaciones se almacenan y son accesibles desde la pagina de **Conversaciones**.
### Canales
Las conversaciones pueden ocurrir a traves de:
* **Widget del sitio web** — chat integrado en su sitio
* **VoIP** — llamadas telefonicas via Twilio, Ringostat o Binotel
* **Mensajeros** — Telegram, WhatsApp Business, Instagram DM, Facebook Messenger
* **API** — acceso programatico
### Caracteristicas
* **Bandeja de entrada unificada** — todas las conversaciones de todos los agentes y canales en un solo lugar
* **Filtros** — por agente, estado, fecha, canal
* **Transcripciones** — historial completo de mensajes con marcas de tiempo
* **Reproduccion de audio** — escuche grabaciones de llamadas de voz
* **Calificaciones** — puntuaciones de satisfaccion del cliente por conversacion
***
## Seguimiento
El **Tracker** esta integrado en el mismo script del widget y supervisa automaticamente la actividad de los visitantes en su sitio web.
### Que se Rastrea
| Datos | Descripcion |
| -------------------- | ------------------------------------------------------------------------------------------------------ |
| **Sesiones** | Sesiones de navegacion de visitantes — dispositivo, navegador, sistema operativo, ubicacion, referente |
| **Vistas de Pagina** | Visitas individuales a paginas dentro de una sesion |
| **Eventos** | Eventos personalizados — clics, envios de formularios, llamadas telefonicas |
| **Campanas** | Agrupacion basada en UTM (fuente, medio, campana, termino, contenido) |
### Automatizacion
* **Disparadores** — acciones automatizadas basadas en el comportamiento del visitante (tiempo en la pagina, profundidad de desplazamiento, coincidencia UTM, tipo de dispositivo). Pueden mostrar superposiciones de chat o mensajes personalizados.
* **Intercambio de Telefono** — reemplazo dinamico de numeros telefonicos para seguimiento y atribucion de llamadas.
***
## Integraciones
Las **Integraciones** conectan sus agentes de IA con servicios externos y canales de comunicacion.
| Categoria | Proveedores | Que hace |
| -------------------- | ------------------------------------------------- | ---------------------------------------------------------------------- |
| **VoIP** | Twilio, Ringostat, Binotel | Llamadas telefonicas — el agente atiende llamadas entrantes |
| **Mensajeros** | Telegram, WhatsApp, Instagram, Facebook Messenger | Chat a traves de aplicaciones de mensajeria |
| **Google Workspace** | Gmail, Docs, Sheets, Drive, Calendar, Meet | Leer e interactuar con servicios de Google |
| **Publicidad** | Google Ads, Facebook Ads | Ver rendimiento de campanas y gestionar anuncios |
| **Webhook** | Cualquier endpoint HTTP | Enviar datos de leads, eventos o notificaciones a CRM u otros sistemas |
Cada integracion se configura por empresa y puede conectarse a uno o mas agentes.
***
## Facturacion y Planes
Revol utiliza un modelo de **facturacion basado en tokens**. Cada interaccion con IA consume tokens — tokens de entrada (su mensaje + contexto) y tokens de salida (respuesta del agente).
### Planes
**\$0/mes** — pruebe Revol con limites basicos
| Recurso | Limite |
| -------------------------- | ----------- |
| Empresas | 1 |
| Agentes de IA | 1 |
| Tokens Estandar | 20K / dia |
| Tokens Premium | — |
| Voz | — |
| Almacenamiento | 100 MB |
| Documentos de Conocimiento | 10 |
| Conversaciones | 100 |
| Retencion de Seguimiento | 30 dias |
| Integraciones | — |
| Marca del Widget | Marca Revol |
**\$29/mes** — para negocios en crecimiento
| Recurso | Limite |
| -------------------------- | ------------------- |
| Empresas | 3 |
| Agentes de IA | 5 |
| Tokens Estandar | 5M / mes |
| Tokens Premium | 1M / mes |
| Voz (STT) | 60 min |
| Voz (TTS) | 200K caracteres |
| Almacenamiento | 5 GB |
| Documentos de Conocimiento | 100 |
| Conversaciones | 5,000 |
| Retencion de Seguimiento | 180 dias |
| Integraciones | VoIP, Mensajeros |
| Marca del Widget | Marca personalizada |
**\$79/mes** — para agencias y empresas grandes
| Recurso | Limite |
| -------------------------- | ----------------------------------- |
| Empresas | 10 |
| Agentes de IA | Ilimitados |
| Tokens Estandar | 25M / mes |
| Tokens Premium | 2M / mes |
| Voz (STT) | 300 min |
| Voz (TTS) | 500K caracteres |
| Almacenamiento | 50 GB |
| Documentos de Conocimiento | 1,000 |
| Conversaciones | 50,000 |
| Retencion de Seguimiento | 730 dias (2 anos) |
| Integraciones | Todas (incl. Google Workspace, Ads) |
| Marca del Widget | Marca Blanca |
### Que Cuenta como Token
Cada interaccion con IA tiene dos partes:
* **Tokens de entrada** — su mensaje + prompt del sistema + fragmentos recuperados de la base de conocimientos + historial de conversacion
* **Tokens de salida** — la respuesta del agente
Diferentes modelos consumen diferentes tipos de tokens:
| Tipo de Token | Modelos | Planes |
| ------------- | ------------------------------------------------------------- | ---------------- |
| **Estandar** | GPT-4o-mini, Claude 3.5 Haiku, Gemini 2.0 Flash, Llama 3.1 8B | Todos los planes |
| **Premium** | GPT-4o, Claude 3.5 Sonnet, Gemini 2.5 Pro, Llama 3.3 70B | Premium+ |
### Paquetes Adicionales
Necesita mas recursos? Adquiera paquetes adicionales sin actualizar su plan:
| Paquete | Que obtiene | Precio |
| ------------------------- | -------------------------------- | ------ |
| Paquete de Tokens S | 5M tokens estandar | \$4 |
| Paquete de Tokens M | 20M tokens estandar | \$15 |
| Paquete de Tokens L | 50M tokens estandar | \$35 |
| Paquete de Tokens Premium | 2M tokens premium | \$20 |
| Paquete de Voz | 60 min STT + 100K caracteres TTS | \$3 |
| Paquete de Almacenamiento | 10 GB de almacenamiento | \$1 |
Los paquetes adicionales expiran **3 meses** despues de la compra. Los tokens no utilizados no se transfieren entre periodos de facturacion.
### Que Sucede Cuando Alcanza el Limite
| Recurso | Comportamiento |
| ------------------------- | --------------------------------------------------------------------------------------------- |
| Tokens Estandar / Premium | El agente deja de responder hasta el siguiente ciclo de facturacion o la compra de un paquete |
| Almacenamiento | No se pueden cargar nuevos archivos |
| Voz | Las funciones de voz se desactivan |
| Conversaciones | Se bloquean las nuevas conversaciones |
Revol envia notificaciones al **80%** (advertencia) y **90%** (critico) de uso para que pueda actuar antes de alcanzar el limite.
***
## Proximos Pasos
Configure su empresa y su primer agente en minutos
Profundice en la configuracion y capacidades de los agentes
Instale el widget de chat en su sitio web
Integre Revol programaticamente