Todo sobre easy/answer
Guías paso a paso para dueños de negocio, integradores y agencias. Aprende a configurar tu agente de IA, conectarlo a Kommo CRM, y orquestar las respuestas, cambios de pipeline y etiquetas de forma automática.
Bienvenida a easy/answer
easy/answer es la plataforma que reemplaza los flujos frágiles de n8n por un agente de IA que entiende tu negocio. Conecta tu Kommo CRM, sube la documentación de tu producto y deja que el agente califique, responda y mueva leads sin que tengas que estar pendiente 24/7.
¿Qué es easy/answer?
Un orquestador de agentes de IA pensado específicamente para Kommo CRM. En lugar de pagar por 10 vendedores a tiempo completo o construir automatizaciones rígidas en n8n, cada agente:
- Recibe los mensajes que entran a un pipeline de Kommo (vía webhook del Salesbot).
- Responde con la personalidad, tono y reglas que tú configures.
- Mueve al lead al
status_idcorrecto según la intención detectada. - Aplica tags al contacto para segmentar después.
- Escala a un asesor humano cuando se requiere.
¿Para quién es?
- Dueños de negocio que venden infoproductos, webinars o productos físicos por chat y necesitan responder al instante sin contratar más personal.
- Integradores y agencias que quieren entregar valor en horas, no días, sin pelear con flujos n8n que se rompen al cambiar una columna del CRM.
Crear tu cuenta
- Entra a /signup.
- Introduce nombre, email, empresa y contraseña.
- En desarrollo local, si tu
.env.localtieneSUPABASE_SERVICE_ROLE_KEYconfigurada, tu correo se confirma automáticamente y entras directo al dashboard. - Sin service role: revisa tu correo para confirmar la cuenta (puede tardar por límites del SMTP de Supabase en plan gratis).
Crear tu primer agente
Desde Mis Agentes haces clic en + Nuevo Agente. El límite depende de tu plan (ver Roles y planes).
Un agente tiene 6 áreas que configurar — todas accesibles como tabs dentro del agente:
- Configuración: nombre, rol, tono comercial, system prompt, reglas de negocio.
- Pipelines Kommo: pipeline donde escucha, status permitidos, reglas de cambio de columna y tags.
- Conocimiento: sube los documentos que el agente usará para responder.
- Integraciones: conexión OAuth2 a la cuenta Kommo del cliente.
- Sandbox: prueba conversaciones con el agente sin tocar Kommo.
- Logs: histórico de webhooks que recibió el agente.
Roles y planes
Cuatro roles, distintos límites:
| Plan | Agentes | Documentos | Sandbox + Logs |
|---|---|---|---|
| Free | 1 | Solo lectura | Limitado |
| Paid | 3 | Sí | Sí |
| Pro | 10 | Sí | Sí |
| Admin | Sin límite | Sí | Sí + secciones admin (Usuarios, Config IA, Tickets) |
El simulador en la barra superior (Free/Paid/Pro/Admin) sirve para previsualizar la UI de cada plan sin cambiar tu rol real.
Personalidad y system prompt
En la tab Configuración del agente defines:
- Nombre: cómo se va a identificar el agente ("Sofi", "Clara", "Leo").
- Tono:
amigable,formalopersuasivo. Afecta la temperatura y el estilo de las respuestas. - System prompt: instrucciones de alto nivel ("Eres Sofi, asesora comercial de Fórmula SaaS...").
- Reglas estrictas: lista numerada de cosas que el agente NUNCA debe hacer ("No menciones precios en el primer mensaje", etc).
Reglas de pipeline Kommo
En la tab Pipelines Kommo el agente sabe a qué pipeline está atado y qué puede hacer:
- Pipeline ID: solo procesa webhooks de este pipeline. Si llega tráfico de otro, lo ignora.
- Status IDs permitidos: el agente solo califica leads que estén en uno de estos estados (vacío = todos los estados del pipeline).
- Reglas de columna: lista
intención → status_id destino. Cuando el agente detecta esa intención, hacePATCH /api/v4/leads/[id]para mover al lead. - Reglas de tags: lista
intención → tag. Aplica tags al contacto conPATCH /api/v4/contacts/[id]. - Status de hand-off humano: cuando el agente decide que necesita un humano, mueve al lead a este estado.
Base de conocimiento
En la tab Conocimiento subes los archivos que el agente usará para responder con datos específicos de tu negocio (precios, garantías, scripts de venta).
- Formatos:
.md(preferido),.pdf,.docx,.txt,.csv. - Cada agente tiene su propia base — los documentos no se comparten entre agentes.
- El sistema convierte cada archivo a markdown/texto y lo inyecta en el contexto del prompt cuando responde.
Sandbox de pruebas
La tab Sandbox es un chat aislado contra OpenRouter usando exactamente la configuración del agente (prompt, tono, reglas, pipeline). No envía nada a Kommo — es solo para verificar cómo responde antes de poner el webhook en producción.
Crear integración privada en Kommo
Para que un agente pueda hablar con Kommo necesitas registrar una integración OAuth2:
- Entra a la cuenta Kommo del cliente → Configuración → Integraciones → Crear integración → Privada.
- Redirect URI:
http://localhost:3000/api/kommo/oauth/callback(o el dominio de tu deployment). - Marca los permisos que necesita el agente: CRM, Chats, Salesbot, Contactos.
- Guarda. Copia el Integration ID y el Secret.
Conectar agente vía OAuth2
- Entra al agente → tab Integraciones.
- Pega Integration ID, Client Secret y opcionalmente el subdomain.
- Clic en Conectar con Kommo (OAuth2). Te rebota al consent screen de Kommo, autorizas, y vuelves automáticamente.
- La conexión queda guardada en la BD (tabla
kommo_connections) con el access_token, refresh_token y el slug del agente.
¿Por qué OAuth2 y no el token de larga duración del panel? Porque el long-lived token tiene scopes limitados: lee y crea templates, pero NO puede editar templates ni ejecutar Salesbot. OAuth2 te da scopes completos.
Renovación automática de tokens
El access_token dura 24 horas, el refresh_token 3 meses. El cliente HTTP de easy/answer:
- Refresca proactivamente si quedan menos de 60 segundos de vida del access_token.
- Si Kommo devuelve
401a mitad de una petición, refresca y reintenta una vez. - Persiste el nuevo par
access/refreshen la BD — Kommo rota ambos en cada refresh.
Webhook URL del agente
Cada agente tiene una URL única tipo http://localhost:3000/api/webhook?agent=sofi-ventas. Configúrala en el Salesbot de Kommo:
- Dentro de tu Salesbot, agrega una acción "Enviar petición HTTP".
- Método: POST.
- URL: la del agente que copias de la tab Integraciones.
- El handler valida que el webhook venga del pipeline configurado en la tab Pipelines. Si no, lo ignora.
Cambios de status_id
Cuando el agente detecta una intención que coincide con una de tus reglas, hace PATCH /api/v4/leads/[lead_id] con el status_id destino. El lead se mueve automáticamente en el pipeline.
OpenRouter como provider
easy/answer usa OpenRouter como proxy a los modelos de IA. Configura tu API key en OPENROUTER_API_KEY dentro de .env.local. El modelo activo se define con OPENROUTER_MODEL.
Tanto el copiloto de onboarding como el sandbox del agente comparten esta integración — no hay claves separadas.
Modelos recomendados
anthropic/claude-3.5-sonnet— calidad máxima para conversaciones comerciales delicadas.deepseek/deepseek-chat— relación calidad/precio fuerte, buena comprensión del español.google/gemini-2.5-flash— rápido y barato, ideal para alto volumen.openai/gpt-4o-mini— opción equilibrada con buen razonamiento.
Lista completa con precios en openrouter.ai/models.
FAQ
No me llegó el correo de confirmación al registrarme▾
En desarrollo local agrega SUPABASE_SERVICE_ROLE_KEY a tu .env.local — easy/answer auto-confirma los signups. En producción configura un SMTP propio en Supabase (Settings → Auth → SMTP).
¿Puedo conectar dos cuentas de Kommo distintas?▾
Sí. Cada agente tiene sus propias credenciales (Integration ID + Secret + subdomain). Crea un agente por cuenta Kommo del cliente.
¿Qué pasa si Kommo rota el refresh_token?▾
El cliente HTTP detecta el nuevo par en la respuesta del refresh y lo persiste. Si el refresh_token expira por 3 meses sin uso, el cliente recibe 400 y el agente vuelve al estado 'desconectado'.
¿El sandbox usa tokens de OpenRouter?▾
Sí, cada mensaje en el sandbox es una llamada real a OpenRouter. Usa modelos baratos en el sandbox (gemini-2.5-flash o gpt-4o-mini) si harás muchas pruebas.
Soporte
¿Algo no funciona? Crea un ticket desde el copiloto flotante (esquina inferior derecha del dashboard) o escríbenos a hola@charrolab.com.