Documentación de ImplementIA
Guía completa para instalar, configurar y usar ImplementIA — la app de HubSpot que genera arquitecturas CRM completas con IA y las aplica directamente en tu portal.
ImplementIA genera borradores que tú revisas y decides ejecutar. Cada ejecución requiere confirmación manual y un plan con escritura habilitada. Los tokens de HubSpot nunca se exponen al navegador.
¿Qué es ImplementIA?
ImplementIA es una aplicación de HubSpot desarrollada por Estado 7 que usa inteligencia artificial para diseñar, validar y aplicar arquitecturas CRM completas en HubSpot. Acelera el proceso de implementación reduciendo de semanas a horas el diseño inicial de pipelines, propiedades, workflows y reportes.
Genera una arquitectura CRM completa con IA a partir de un wizard guiado o chat libre.
Comprueba el blueprint con esquemas Zod gratis o una auditoría IA con score de confianza.
Ejecuta por scopes en HubSpot con confirmación manual y logs detallados por ítem.
Todo lo creado lleva prefijo [CRM IA] y queda en historial con estado por ítem.
Para quién es
ImplementIA está diseñada para profesionales que implementan HubSpot y necesitan acelerar el diseño inicial de la arquitectura CRM:
- Consultores e implementadores HubSpot que trabajan con múltiples portales de clientes.
- Agencias RevOps que necesitan producir diseños CRM rápidos y revisables con sus clientes.
- Equipos de operaciones internos que están configurando HubSpot desde cero.
- Partners HubSpot que quieren acelerar la fase de diagnóstico y diseño de sus proyectos.
Requisitos previos
- Cuenta activa en HubSpot (cualquier plan, incluyendo el gratuito para el plan Free de ImplementIA).
- Rol de Administrador o Super Administrador en el portal de HubSpot.
- Acceso al HubSpot App Marketplace o a implementia.estado7.com.
- Navegador actualizado (Chrome, Firefox, Edge o Safari).
Instalar la app
Hay dos formas de acceder a ImplementIA según tu plan:
Opción A — App web (Free, Pro, Agencia)
Accede directamente desde el navegador. No requiere instalación previa desde el Marketplace.
Serás redirigido a la pantalla de autorización OAuth de HubSpot para autorizar los permisos.
Revisa los scopes solicitados y haz clic en "Conectar app". Se crea tu cuenta con plan Free automáticamente.
Accede a "Nuevo diseño" para iniciar el wizard de 5 pasos. Tu primer proyecto se crea automáticamente.
Opción B — App embebida (plan Starter vía Marketplace)
- Busca "ImplementIA" en el HubSpot App Marketplace e instala con un clic.
- Al autorizar los permisos OAuth con source=marketplace, el plan Starter se activa automáticamente.
- La app vive dentro de HubSpot como una experiencia embebida.
Permisos OAuth
ImplementIA solicita los permisos mínimos necesarios para leer la estructura actual del CRM y ejecutar la arquitectura diseñada:
| Scope | Tipo | Uso |
|---|---|---|
| crm.objects.contacts.read | Lectura | Leer estructura de contactos para el snapshot CRM actual |
| crm.objects.companies.read | Lectura | Leer estructura de empresas existentes en el portal |
| crm.objects.deals.read | Lectura | Leer pipelines y propiedades de deals actuales |
| crm.schemas.deals.write | Escritura | Crear pipelines de deals (ejecución — planes con escritura) |
| crm.schemas.contacts.write | Escritura | Crear propiedades custom de contactos |
| crm.schemas.companies.write | Escritura | Crear propiedades custom de empresas |
| automation | Escritura | Crear workflows deshabilitados (solo app web, planes Pro/Agencia) |
| tickets | Escritura | Crear pipelines de tickets si el blueprint los incluye |
Planes y créditos
| Plan | Precio | Créditos IA/mes | Ejecuciones/mes | Escritura HubSpot |
|---|---|---|---|---|
| Free | $0 — Para siempre | 80 | 0 | No |
| Starter | $50 / mes | 200 | 10 | Sí |
| Pro | $99 / mes | 800 | 30 | Sí |
| Agencia | $399 / mes | 2,500 | 100 | Sí |
Costo en créditos por acción
| Acción | Créditos |
|---|---|
| Generar blueprint completo | 25 créditos |
| Refinar blueprint con instrucciones | 12 créditos |
| Validar blueprint con IA (auditoría) | 3 créditos |
| Mensaje de chat con el asistente | 2 créditos |
| Validación Zod (esquema estructural) | Gratis |
| Leer estructura CRM actual del portal | Gratis |
El wizard de 5 pasos
El wizard guía al usuario a través de 5 bloques de preguntas para construir un briefing completo. La IA usa ese briefing para generar una arquitectura CRM precisa sin necesidad de escribir un prompt desde cero.
Industria, modelo B2B/B2C, tamaño de empresa, región, multisede y madurez CRM actual.
Ciclo de ventas, etapas (presets por vertical), tickets, oferta, postventa y aprobaciones.
Número de usuarios CRM, roles, canal de adquisición, origen de leads y CRM que usan actualmente.
Qué quieren automatizar, KPIs prioritarios, métrica más crítica e integraciones necesarias.
Metas del proyecto, dolores actuales del equipo y plazo de implementación esperado.
Validar el blueprint
Antes de ejecutar en HubSpot, es recomendable validar el blueprint generado. Hay dos tipos de validación:
Validación Zod — Gratis, sin créditos
Comprueba la estructura del JSON contra los esquemas Zod de ImplementIA. Detecta campos vacíos, tipos incorrectos y conflictos estructurales sin consumir créditos de IA.
Auditoría IA — 3 créditos
El motor de IA analiza el blueprint y devuelve:
- Un score de confianza del diseño (0–100).
- Advertencias de validación (validation_warnings): riesgos detectados, datos faltantes y conflictos de modelo.
- Recomendaciones: pasos manuales post-implementación y mejoras sugeridas.
- Preguntas pendientes: lo que la IA necesita para completar el diseño.
Ejecutar en HubSpot
La ejecución escribe el blueprint en el portal de HubSpot de forma controlada. Requiere plan con escritura habilitada (Starter, Pro o Agencia) y confirmación explícita del usuario.
Scopes de ejecución disponibles
| Scope | Qué ejecuta | Disponible en |
|---|---|---|
| PIPELINES | Pipelines de deals y tickets con sus etapas | Starter, Pro, Agencia |
| PROPERTIES | Propiedades custom por objeto CRM | Starter, Pro, Agencia |
| WORKFLOWS | Automatizaciones deshabilitadas por defecto | Pro, Agencia (solo app web) |
| FULL | Todo lo anterior en fases secuenciales | Pro, Agencia (solo app web) |
Estados de una ejecución
- PENDING — ejecución en cola, pendiente de inicio.
- RUNNING — en proceso, ítems creándose en HubSpot.
- SUCCESS — todo creado correctamente.
- PARTIAL — algunos ítems fallaron; los demás se crearon.
- FAILED — la ejecución no pudo completarse.
Qué crea en HubSpot
| Elemento | Cómo se crea | Prefijo | Nota |
|---|---|---|---|
| Pipelines | API CRM v3 | [CRM IA] | Omite nombres duplicados automáticamente |
| Propiedades | API CRM v3 | [CRM IA] | Contacts, companies, deals, tickets, quotes, meetings, products |
| Workflows | API Workflows v4 | [CRM IA] | Creados deshabilitados por defecto. Solo app web Pro/Agencia |
| Reportes | — | — | Se entregan como guía de configuración manual, no se crean por API |
Seguridad y control
Los tokens de HubSpot nunca se exponen al navegador. Se almacenan cifrados en el backend y se refrescan automáticamente.
Ninguna ejecución corre sin confirmed: true enviado por el usuario y plan con escritura habilitada.
Todo lo creado lleva prefijo [CRM IA] y queda registrado en el historial con estado por ítem.
Autenticación mediante el flujo OAuth oficial de HubSpot. Sesión con JWT httpOnly de 7 días de vigencia.
Privacidad de datos
ImplementIA no almacena datos de contactos, empresas ni deals del portal del usuario. Solo se guardan en los sistemas de Estado 7:
- Los blueprints generados (JSON de arquitectura CRM) asociados al proyecto.
- Los tokens OAuth cifrados para mantener la conexión con HubSpot.
- El historial de ejecuciones con estados y logs por ítem.
- El email del administrador que conectó el portal, para comunicaciones del servicio.
- Nombres, emails ni teléfonos de contactos del CRM del cliente.
- Contenido de notas, emails ni actividades del portal.
- Datos financieros de deals ni información sensible del negocio del cliente.
Preguntas frecuentes
Contacto y soporte
Para consultas sobre la app, activación de planes o soporte técnico: