Documentación

Juxa CRM te ayuda a llevar personas, empresas, oportunidades, tareas y notas en un solo lugar. Incluye un asistente de IA integrado para consultar y actualizar tus datos en lenguaje natural, sin escribir consultas ni aprender una interfaz nueva.

Juxa CRM está disponible como servicio en la nube gestionado por Juxa y, para organizaciones que lo requieran, como versión empresarial en infraestructura dedicada bajo contrato. El código fuente del producto no se distribuye para clonar ni modificar por terceros.

• En la nube (SaaS): regístrate aquí. Empieza al momento: actualizaciones operadas por Juxa, sin instalaciones en tus equipos.
• Versión empresarial: despliegue dedicado, gobernanza reforzada y condiciones comerciales acordadas con Juxa. No incluye acceso al repositorio ni permisos de clonación. Detalles en Versión empresarial.

Las integraciones por API y MCP están documentadas aquí, pero su uso requiere previa autorización y habilitación por Juxa según tu contrato. Para el asistente de IA y el agente, consulta Integración del agente Juxa y Chat con IA.

Registro

1. En la página de inicio, pulsa Empezar.
2. Introduce tu nombre, correo y una contraseña (mínimo 8 caracteres). Si tu organización lo tiene configurado, también podrás iniciar sesión con Google u otros proveedores OAuth.
3. Elige un nombre para tu espacio de trabajo: es el entorno compartido de tu equipo. Si lo dejas en blanco, se usará por defecto algo como «Espacio de trabajo de [tu nombre]».
4. Pulsa Crear espacio de trabajo. Accederás a la página de inicio (Home).

Qué se crea automáticamente

Cada espacio de trabajo nuevo incluye tres objetos estándar ya configurados:

• Personas: contactos con nombre, correo, teléfono, puesto, empresa vinculada, ubicación y descripción.
• Empresas: organizaciones con nombre, dominios (sitios web), descripción, personas del equipo vinculadas, ubicación y categorías.
• Oportunidades: negocios con nombre, importe, etapa, fecha de cierre prevista y vínculos a empresa y contactos. El embudo trae seis etapas listas: Lead, Qualified, Proposal, Negotiation, Won y Lost.

La página de inicio (Home)

Al iniciar sesión llegas a Home: saludo con la fecha, métricas rápidas (personas, empresas, oportunidades, tareas abiertas), tareas recientes con aviso de retraso, notas recientes y registros vistos hace poco.

Los usuarios nuevos ven una lista de bienvenida con cuatro primeros pasos sugeridos. Puedes descartar cada paso o ocultar toda la lista; desaparece sola cuando empiezas a crear registros.

Antes de cargar datos, dedica unos minutos a estos cuatro pasos: mejoran mucho el día a día.

1. Aprende a moverte por la app

La barra lateral izquierda es la navegación principal: arriba están los objetos (Personas, Empresas, Oportunidades y los personalizados que crees). Debajo, Tareas, Notas, Listas, Chat y Buscar. La configuración va al final.

Pulsa Ctrl+K (o Cmd+K en Mac) para abrir la paleta de comandos: busca registros, salta a una página o crea uno nuevo sin soltar el teclado.

2. Configura el chat con IA

El chat con IA es la forma más rápida de consultar datos y lanzar acciones. Actívalo con las credenciales del proveedor de modelos que corresponda a tu entorno (plantilla de servidor y, si aplica, Configuración → IA en el espacio de trabajo).

1. Obtén una clave API del proveedor o pasarela acordada con tu organización.
2. En Juxa, entra en Configuración → IA desde la barra lateral.
3. Pega la clave en el campo Clave API del asistente.
4. Elige un modelo por defecto entre los que ofrezca tu proveedor.
5. Pulsa Guardar y luego Probar conexión para comprobar que responde bien.

Cuando esté listo, abre Chat en la barra lateral. Puedes preguntar, por ejemplo: «¿Cuántas oportunidades tenemos en Negotiation?» o «Crea un contacto Jane Doe en Acme Corp» y la IA lo gestiona.

3. Mete tus datos

Hay dos formas de añadir registros; usa la que encaje con tu situación.

Alta manual: abre Personas, Empresas u Oportunidades, pulsa «+ Nuevo registro», rellena y crea. Ideal para pocos registros o un CRM desde cero.

Importación CSV: si ya tienes datos en Excel, Google Sheets u otro CRM, expórtalos a CSV y usa Importar. Pasos:

1. Abre el objeto destino (p. ej. Personas).
2. Pulsa Importar en la barra de herramientas.
3. Arrastra o elige el CSV; la primera fila debe ser cabeceras de columnas.
4. Aparece el mapeo: cada cabecera del CSV se asocia a un campo del CRM. Si los nombres coinciden, se mapean solos.
5. No hace falta mapear todas las columnas: omite las que no tengan campo equivalente.
6. Pulsa Importar. Hasta 1.000 filas por ejecución; si hay errores, verás el número de fila para corregir y volver a importar.

4. Invita a tu equipo

Si otras personas usarán el CRM contigo, invítalas ya para que empiecen a cargar datos.

1. Ve a Configuración → Miembros.
2. Escribe el correo en Añadir miembro.
3. Elige rol: Administrador (configura el espacio, miembros y claves API) o Miembro (acceso a datos del CRM sin cambiar ajustes del espacio).
4. Pulsa Añadir. Podrán entrar en cuanto tengan cuenta.

Puedes cambiar roles o quitar miembros cuando quieras desde la misma página.

Juxa CRM se conecta al agente Juxa: generas un archivo de skill, lo enlazas en la configuración del agente y podrá crear contactos, actualizar oportunidades, dejar notas, buscar y gestionar tareas desde el mismo canal donde ya hablas con él.

Genera tu archivo de skill

1. Ve a Configuración → Claves API y crea una clave.
2. Entra en Configuración → Integración del agente.
3. Sigue el asistente de cuatro pasos para generar el skill: incluye la URL base del CRM, la autenticación API y las categorías de endpoints.
4. Pulsa Descargar para guardar el archivo.

Configura el agente

1. Copia el archivo descargado a ~/.juxa/skills/juxa-io/SKILL.md
2. Añade la referencia al skill en la configuración del agente (p. ej. juxa-agent.json o moltbot.json).
3. Reinicia el agente Juxa.

Pruébalo

Pide al agente: «lista todos los objetos del CRM». Debería devolver Personas, Empresas y Oportunidades (más los personalizados). Ejemplos:

• "Añade un contacto Jane Doe en Acme Corp"
• "Muéstrame las oportunidades que cierran este mes"
• "Crea una tarea para seguir con Sarah el martes"

El recorrido completo está en los pasos de arriba de esta misma sección «Integración del agente Juxa».

Si quieres unificar el acceso por herramientas entre varios clientes de IA (no solo el agente Juxa), revisa Model Context Protocol (MCP) en integración técnica (siempre sujeto a autorización previa).

Personas y Empresas son los dos tipos de contacto principales: tablas de registros con campos configurables («atributos»). Los registros se pueden vincular entre sí y con oportunidades.

Campos por defecto

Personas: nombre, correos, teléfonos, puesto, empresa vinculada, ubicación y descripción.

Empresas: nombre, dominios (sitios web), descripción, equipo (personas vinculadas), ubicación principal y categorías.

Crear un registro

1. Abre Personas o Empresas en la barra lateral.
2. Pulsa + Nuevo registro (esquina superior derecha).
3. Completa los campos obligatorios (marcados).
4. Pulsa Crear. Se abre la ficha del registro.

Ficha de registro

Al abrir un registro verás pestañas: resumen, relaciones, actividad, notas y tareas.

• Resumen: todos los campos; edición en línea (Enter o clic fuera para guardar).
• Registros relacionados: personas, empresas u oportunidades vinculadas.
• Actividad: historial de cambios con quién y cuándo.
• Notas: notas en texto enriquecido asociadas al registro.
• Tareas: tareas con fecha y responsables.

Tipos de atributo

Juxa CRM admite 17 tipos de atributo (texto, número, moneda, fecha, marca de tiempo, casilla, lista, estado, valoración, correo, teléfono, dominio, ubicación, nombre personal, referencia a registro, referencia a actor e interacción). Al añadir un campo personalizado eliges de esta lista.

Las oportunidades siguen tu pipeline comercial e incluyen tablero Kanban para ver en qué etapa está cada negocio.

Etapas del embudo por defecto

Cada espacio nuevo trae seis etapas: Lead, Qualified, Proposal, Negotiation, Won y Lost. Al ganar una oportunidad verás una animación breve. Puedes renombrar, reordenar, recolorear o quitar etapas.

Crear una oportunidad

1. Abre Oportunidades en la barra lateral.
2. Pulsa + Nuevo registro.
3. Indica nombre, importe (cualquier moneda), etapa, fecha de cierre prevista y, si quieres, empresa y contactos.
4. Pulsa Crear.

Tablero Kanban

Activa la vista «Tablero» en la parte superior. Cada columna es una etapa: arrastra tarjetas entre columnas y reordena prioridades. El importe total por etapa aparece en la cabecera.

Personalizar etapas

Ve a Configuración → Objetos, despliega Oportunidades y edita el atributo Etapa: añade etapas, colores, orden y marca cuáles son activas o de cierre (ganadas/perdidas).

El CRM incluye un asistente de IA que puede leer y escribir datos en lenguaje natural. Los modelos disponibles dependen de la pasarela y la configuración que aplique a tu entorno.

Configurar la IA

Sigue Configuración esencial arriba. En resumen: clave API en Configuración → IA, elige modelo y guarda.

Qué puede hacer la IA

La IA dispone de 13 herramientas: 8 de lectura inmediata y 5 de escritura que piden tu confirmación antes de cambiar datos.

Herramientas de lectura (sin confirmación):

• Buscar registros por nombre, correo, dominio o texto
• Listar tipos de objeto y sus atributos
• Explorar registros por tipo (personas, empresas, oportunidades)
• Ver un registro por ID con todos los campos
• Mostrar tareas abiertas y completadas
• Recuperar notas de cualquier registro
• Listar listas del espacio de trabajo
• Obtener entradas de una lista concreta

Herramientas de escritura (requieren confirmación):

• Crear registros (contactos, empresas, oportunidades u objetos personalizados)
• Actualizar campos de registros existentes
• Eliminar registros de forma permanente
• Crear tareas vinculadas a registros
• Añadir notas a registros

Ejemplos de preguntas

• "Muéstrame las oportunidades que cierran este mes"
• "¿Cuál es el valor total del pipeline?"
• "¿Cuántos contactos añadimos esta semana?"
• "¿Quiénes son los contactos de Acme Corp?"
• "Añade una nota de seguimiento a Sarah Chen"
• "Crea un contacto: Jane Doe, jane@example.com"
• "Mueve la oportunidad Acme a la etapa Negotiation"
• "Crea una tarea para llamar a John Smith el viernes"

Cómo funcionan las confirmaciones

Antes de crear, actualizar o borrar, la IA describe la acción y espera tu aprobación. Puedes confirmar, pedir ajustes o cancelar. Nada se guarda hasta que apruebes.

Tu contexto personal del chat

En Configuración (con sesión iniciada), abre el bloque de contexto del asistente para fijar instrucciones persistentes (tono, idioma, jurisdicción) y textos de referencia. Se aplican a tus conversaciones del asistente en el espacio, junto con instrucciones por conversación.

Para ver asistente integrado frente a agente externo, revisa juntas las secciones Chat con IA y Integración del agente Juxa.

Conversaciones

Cada sesión es una conversación persistente: puedes abrir nuevas, cambiar entre anteriores o borrar las que ya no necesites. La IA recuerda el hilo dentro de la misma conversación.

Los despliegues en la nube y la versión empresarial pueden enrutar el asistente del CRM por un modelo en la nube (SDK en servidor) y usar búsqueda web y otras herramientas cuando el modo de inteligencia sea Hybrid o Nube directa. Para el flujo recomendado de investigación en CRM y borrador en Juxa Docs, lee Agentes, modelos en la nube y Juxa Docs.

Juxa Docs (copiloto de documentos en /docs) usa un compositor más rico: teclea / para modos y acciones y @ para el alcance del documento. La misma lista está en Comandos de chat (Juxa Docs) más abajo y en la barra lateral de la app como «Comandos de chat (/)».

Guía operativa para equipos de producto y operaciones: cómo el motor en la nube alimenta el CRM y Juxa Docs, el traspaso desde el chat del CRM al editor, la medición de uso y lo que el producto todavía no hace (sin «agente de proyecto» multiarchivo autónomo en segundo plano).

1. Entorno de modelo en la nube (CRM + Juxa Docs)

La misma configuración en servidor alimenta: (a) el chat del CRM cuando la conversación usa el modo de inteligencia en la nube y (b) el chat de Juxa Docs cuando no hay proxy JUXA_CHAT_*, el modo es Agente o Revisión y el mensaje no lleva adjuntos: entonces la app transmite desde el proveedor con el SDK configurado. Los detalles de implementación internos solo se comparten con equipos autorizados bajo acuerdo con Juxa.

Variables principales (referencia en la plantilla de entorno que facilite tu administrador o Juxa para tu despliegue; bloque de proveedor en la nube):

Opcional: VERTEX_MODEL_ECONOMY, VERTEX_API_ENDPOINT, VERTEX_AI_ENABLED=false, JUXA_CRM_VERTEX_TEST_MODE=true (solo SDK en el CRM para pruebas), JUXA_CRM_AI_DEBUG_LOG=true.

Lista de comprobación

1. El project_id de la cuenta de servicio coincide con VERTEX_PROJECT_ID (o ADC apunta al proyecto correcto).
2. API del proveedor habilitada y cuotas correctas en esa región.
3. VERTEX_MODEL existe para la región en la consola del proveedor; los 404 suelen indicar nombre o región incorrectos.
4. CRM: abre /chat, modo inteligencia Nube directa, envía un mensaje breve: debe completarse sin errores del proveedor.
5. Juxa Docs: abre /docs, modo Agente, sin PDF adjunto: usa el SDK en nube cuando el proxy no tiene prioridad.
6. Si JUXA_CHAT_API_URL y JUXA_CHAT_API_KEY están definidos, el CRM puede preferir el proxy Juxa; Juxa Docs también prioriza el proxy en agente/revisión sin adjuntos. Para validar el SDK nativo en el editor, desactiva o quita temporalmente el proxy.

2. Flujo oficial: investigación → Juxa Docs

Mantén la investigación con herramientas (búsqueda web, bases legales, índices) en el chat del CRM (modo Híbrido o nube directa). Usa Juxa Docs para el borrador estructurado (menús, arquitectura, cuerpo del documento).

1. Abre el CRM en /chat; vincula un expediente cuando el contexto importe.
2. Menú cerebro → Nube directa (SDK en proveedor) o Hybrid (mismas herramientas; el upstream depende de tu despliegue).
3. Pide investigación, teoría del caso, mapa de riesgos, esquema de sentencia: el modelo puede llamar web_search y otras herramientas expuestas en ese modo.
4. Itera hasta tener el análisis o el texto que necesitas.
5. Usa el generador de tareas (modo Agente en el compositor) o pega en el compositor principal.
6. En el bloque Juxa Docs: Juxa Docs · pestaña modo agente o Abrir con constructor de documentos: el traspaso usa session storage y abre Juxa Docs con tu borrador semilla.
7. En Juxa Docs, alterna Agent (pagarés, convenios, flujo de cláusulas) frente a Review (informe rúbrica, juxa-review). Para una teoría del caso larga, pídelo explícitamente en modo Agente o pega un borrador y usa Revisión: el prompt por defecto de Agente favorece actos y contratos breves.
8. Integra en el documento solo después del paso de revisión de cambios del editor.

Este flujo no presenta escritos, aplica sellos ni firma por ti. No es un proyecto multi-documento autónomo de larga duración: cada turno requiere un usuario.

3. Medición de uso y planes

La app convierte el uso (tokens de entrada/salida, búsquedas web, páginas PDF) en créditos de IA abstractos con valores por defecto en ai-credit-formula.ts y token-metering.ts (ajustables con variables de entorno como AI_CREDIT_PER_1K_INPUT, WEB_SEARCH_CREDIT_FLAT). Los planes SaaS exponen un presupuesto mensual de tokens LLM por workspace (plan-catalog.ts); las «consultas al mes» son supuestos de marketing (~10k tokens por interacción de referencia), no un tope duro por mensaje.

Coste del proveedor en la nube sigue la tarifa del modelo y región; no está fijado aquí. En versión empresarial dedicada, el reparto de coste del proveedor en la nube se define en el contrato; en SaaS alojado suele ir incluido en la suscripción.

Mensaje sugerido: «Investigación y razonamiento en CRM + borrador asistido en Juxa Docs» con un pool mensual y trazabilidad, no un «agente de proyecto» autónomo hasta que exista ese producto.

4. Investigación solo en Juxa Docs (futuro)

Hoy, el SDK nativo en POST /api/juxa-legal-editor/chat transmite texto sin herramientas tipo función del CRM; searchDepth: deep solo enriquece el prompt del sistema. Para una sola pantalla podrías: (A) mantener CRM → Docs como hoy; (B) reutilizar el ejecutor de herramientas del CRM desde el editor; (C) añadir grounding/búsqueda en el proveedor; (D) apoyarte en el proxy Juxa. La opción A es la predeterminada documentada; B/C requieren ingeniería y gobernanza.

Material ampliado para operadores (checklists y límites del producto) lo proporciona Juxa bajo el canal acordado para tu organización; no se publica aquí como código descargable.

Estos atajos coinciden con la «Biblioteca» y el menú / en Juxa Docs (/docs). Abre la página dedicada en /docs/comandos o escribe /comandos en el compositor. Las etiquetas de las tablas siguen el idioma del producto; el comportamiento es el mismo en todos los espacios.

Comandos con barra (/)

Tokens de mención (@)

CRM y Juxa General (compositor)

En el compositor del CRM y Juxa General escribe @ al inicio de línea (o tras un espacio) para menciones @expediente, @busqueda, @cartera (Recovery), @breve, @pasos, @legal, @crm, o / para plantillas (/a, /resumen, /pedido…) y agentes de skills del laboratorio. La fuente canónica es la misma que Juxa Docs: juxy-command-registry. Ajustes de contexto persistente: /settings/juxa-ia.

Las herramientas del CRM y las confirmaciones siguen el flujo descrito en Chat con IA arriba.

Las tareas te ayudan a llevar el seguimiento del trabajo pendiente. Cada tarea puede vincularse a uno o varios registros (persona, empresa, oportunidad u objeto personalizado) para no perder el contexto.

Crear una tarea

1. Abre Tareas en la barra lateral o pulsa Añadir tarea en la ficha del registro (pestaña Tareas).
2. Escribe la descripción.
3. Opcional: fecha límite y responsable (cualquier miembro del espacio).
4. Opcional: vincula la tarea a registros buscándolos.
5. Pulsa Crear.

Gestionar tareas

Marca el círculo junto a la tarea para completarla. La página Tareas muestra abiertas con aviso en rojo si pasaron la fecha. En Home verás un resumen de las más recientes. Las tareas vinculadas también aparecen en la ficha del registro.

Las notas son texto enriquecido asociado a un registro: resúmenes de reunión, bitácoras de llamada, propuestas o cualquier contexto que quieras conservar junto al contacto u oportunidad.

Crear una nota

1. Abre un registro y entra en la pestaña Notas.
2. Pulsa + Nueva nota.
3. Redacta con el editor: negrita, cursiva, encabezados, listas, enlaces, etc.
4. Se guarda automáticamente mientras escribes.

Ver todas las notas

La página Notas agrupa por fecha (hoy, ayer, esta semana, anteriores). Pulsa una nota para abrirla en panel lateral.

Las listas son colecciones manuales de registros: por ejemplo «Clientes VIP», «Prospectos Q1», «Leads del congreso» o «Partners».

Crear una lista

1. En la barra lateral, bajo Listas, pulsa el icono +.
2. Pon nombre y elige el tipo de objeto (Personas, Empresas, Oportunidades u otro).
3. Pulsa Crear.

Añadir registros a una lista

Abre la lista, pulsa «+ Añadir registro» y busca los registros que quieras incluir.

Atributos propios de la lista

Una lista puede tener columnas extra que solo existen ahí (p. ej. prioridad o fecha de seguimiento en «Prospectos Q1») sin añadir esos campos al objeto global.

Importar desde CSV

Puedes importar lotes desde CSV a cualquier objeto: la forma más rápida de migrar desde otra hoja o CRM.

1. Abre el objeto destino (Personas, Empresas, Oportunidades u objeto personalizado).
2. Pulsa Importar en la barra de herramientas.
3. Elige el CSV: la fila 1 debe ser cabeceras (nombres de campo, no datos).
4. Mapea cada columna a un campo del CRM u omítela. Si los nombres coinciden (sin distinguir mayúsculas), el mapeo es automático.
5. Pulsa Importar. Hasta 1.000 filas por ejecución; las vacías se omiten.

Al terminar verás cuántos registros se crearon y las filas con error (número de fila). Corrige el CSV y vuelve a importar solo lo necesario. Los pasos detallados también están en Importar y exportar arriba.

Exportar a CSV

En cualquier página de objeto, pulsa Exportar para descargar un CSV con los registros visibles según filtros activos.

Desde Apps puedes abrir «Juxa Repositorio»: incluye formatos funcionales (p. ej. nota interna y lista de chequeo) y una vista en cuadrícula de los archivos del workspace. «Guardar en archivos» sube el formato al vault del equipo; «Abrir en Juxa Docs» abre el contenido del archivo guardado (no un borrador aparte generado solo desde la plantilla pública). La gestión completa de carpetas y subidas está en «Archivos».

Rutas típicas en la app web: /apps/repositorio · /apps/repositorio/archivos.

No confundas esto con el «repositorio interno de archivos» del panel de plataforma (prefijo platform-repo/ en bucket compartido): ese almacén es operativo de Juxa para administradores, independiente del vault por workspace.

Cada objeto admite dos modos de vista desde el interruptor superior:

• Vista tabla: rejilla tipo hoja; ordena por cabecera, redimensiona columnas y edita celdas al hacer clic.
• Vista tablero: Kanban agrupado por un atributo de estado; arrastra tarjetas. Requiere al menos un campo de estado.

Filtrar

Pulsa Filtrar y combina condiciones según el tipo de campo (número, texto, fecha, lista, etc.).

Puedes encadenar filtros con lógica Y u O (por ejemplo: oportunidades > 10.000 USD y en Negotiation, o contactos de Nueva York o Londres).

Ordenar

En vista tabla, pulsa la cabecera de columna para ordenar ascendente o descendente; vuelve a pulsar para invertir.

Pulsa Ctrl+K (o Cmd+K en Mac) para la paleta de comandos: busca por nombre, correo, empresa o texto en todos los objetos y listas.

Los resultados se agrupan por tipo e incluyen coincidencias en listas. También puedes saltar a páginas escribiendo su nombre.

Para una búsqueda a página completa, abre Buscar en la barra lateral.

Además de Personas, Empresas y Oportunidades puedes definir objetos propios (proyectos, tickets, campañas, etc.).

Crear un objeto personalizado

1. Ve a Configuración → Objetos.
2. Pulsa + Nuevo objeto.
3. Nombre singular y plural e icono.
4. Añade atributos: tipo entre las 17 opciones, nombre y si es obligatorio, único o multivalor.
5. Pulsa Crear. El objeto aparece en la barra lateral.

Los objetos personalizados admiten tabla, tablero, filtros, import/export, notas, tareas, relaciones y chat con IA como los estándar.

Añadir atributos a objetos existentes

Puedes ampliar Personas, Empresas u Oportunidades con campos extra: en Configuración → Objetos, despliega el objeto y usa «+ Añadir atributo». Los nuevos campos aparecen en tabla y en la ficha.

Las guías siguen el flujo recomendado: primero contexto y objetivos, luego acciones en la interfaz, por último comprobación. Las preguntas frecuentes comerciales y el JSON para chatbots están en la guía dedicada (no se duplican aquí en bloque).

• Preguntas frecuentes (visitantes y asistentes): /guias/preguntas-frecuentes — JSON en /api/public/support-knowledge.
• Guía rápida de incorporación: Crear tu cuenta → Configuración esencial → Importar y exportar.
• Guía de ventas y embudo: Personas y empresas → Oportunidades y embudo → Tareas.
• Guía de productividad con IA: Chat con IA → Integración del agente Juxa (claves y permisos según política del espacio).
• Guía de administración: Configuración → Atajos de teclado.

Enlaces y materiales pensados para que adoptes el CRM con menos fricción. Los accesos técnicos avanzados (API, MCP) dependen de contrato y habilitación.

• Primeros pasos en la app: Registro, inicio de sesión, barra lateral y paleta Ctrl/Cmd+K.
• Preguntas frecuentes (web y chatbots): /guias/preguntas-frecuentes, JSON.
• Centro de ayuda y confianza: Cumplimiento y transparencia (UE), usabilidad y trazabilidad en esta documentación.
• Plantillas de datos: Importar CSV (cabeceras, mapeo, límite por lote) y vistas guardadas.
• Soporte: desde la app, usa la sección de soporte o el canal acordado con Juxa para incidencias, altas de integración o versión empresarial.

Entra en Configuración desde el enlace al final de la barra lateral. Las opciones están agrupadas por secciones.

General

Edita el nombre del espacio de trabajo. El slug y el ID interno son de solo lectura. Solo administradores cambian ajustes del espacio.

Miembros

Invita por correo; cada persona tiene uno de dos roles:

• Administrador: acceso completo, incluida configuración, miembros, claves API e IA.
• Miembro: acceso a datos del CRM (personas, empresas, oportunidades, tareas, notas, listas, chat con IA) sin gestionar el espacio.

Puedes cambiar el rol o quitar a alguien en cualquier momento; al quitarlo pierde el acceso de inmediato.

Claves API

Crea claves Bearer para acceso programático desde herramientas externas. Empiezan por oc_sk_ y solo se muestran una vez al crearlas: cópialas y guárdalas en un sitio seguro. Puedes revocarlas al instante.

Las claves API solo están disponibles si el precio de lista mensual del plan del espacio supera MXN 1000. Actualiza el plan en Configuración → Facturación si aplica; si el plan deja de cumplir el requisito, las peticiones Bearer se rechazan.

Incluye la clave en la cabecera Authorization: Bearer oc_sk_... en cada petición.

Recuerda: el uso de la API y la ampliación de integraciones puede requerir autorización previa adicional con Juxa además del plan.

Configuración de IA

Introduce la clave de la pasarela de modelos y elige el modelo por defecto del catálogo que corresponda a tu despliegue. El botón Probar conexión envía una petición de prueba para validar clave y modelo antes de que el equipo use el chat.

Desde aquí también enlazas el agente de IA integrado para acciones en el CRM. Detalle de capacidades en Chat con IA.

Objetos

Gestiona tipos de objeto y atributos: campos personalizados, nuevos objetos, colores de estado y restricciones. Más detalle en Objetos personalizados.

Esta guía resume cómo el producto apoya buenas prácticas alineadas con el marco de la Unión Europea (en particular transparencia y gobernanza de sistemas de IA según el Reglamento (UE) 2024/1689, y principios de protección de datos). No sustituye asesoría legal ni una evaluación de conformidad: tu organización sigue siendo responsable del despliegue, del contrato con proveedores y del tratamiento de datos personales.

Juxa Red: próximamente ampliaremos esta guía con referencias específicas a la red profesional, el marketplace y la comunidad (mismos principios de transparencia y trazabilidad).

Usabilidad

• Configura el contexto persistente del asistente en Ajustes (instrucciones, tono, jurisdicción) para reducir repeticiones y ambigüedad.
• En el chat, revisa el bloque de trazabilidad cuando exista: muestra modelo, modo y herramientas relevantes para entender cómo se generó la respuesta.
• Los administradores de plataforma pueden usar las trazas de respuestas de IA para auditoría operativa (según permisos).

Seguridad

• Las claves API del workspace se muestran una sola vez al crearlas; revócalas si hay riesgo de exposición.
• El acceso al CRM y a las APIs exige sesión o token Bearer; la configuración de la app aplica marco de iframes (middleware) y cabeceras HTTP base en next.config (tipo de contenido, referrer, permisos; HSTS en producción por defecto, desactivable con ENABLE_HSTS=false o DISABLE_HSTS=true) sin sustituir tu política en el borde.
• Opcional: define CSP en modo solo informe con la variable documentada en el ejemplo de entorno para ir endureciendo sin romper integraciones de un golpe.

Trazabilidad

• El producto puede registrar eventos agregados de transparencia de uso de IA (resumen disponible en la página de cumplimiento para usuarios autenticados).
• Las exportaciones y anexos de documentos pueden incluir metadatos de modelo y contexto de diseño cuando la función lo indique (ayuda a documentar decisiones, no certifica cumplimiento normativo por sí sola).

Más información

En el marco de un proyecto o contrato, Juxa entrega el material y las indicaciones concretas por el canal acordado (no publicamos aquí runbooks, credenciales, parámetros operativos reservados ni nombres internos de servicio).

Cumplimiento, transparencia e IA (UE) — página legal — matriz orientativa, enlaces a términos y privacidad, y resumen de consentimientos cuando aplique.

Autorización previa obligatoria: el uso de la API REST, la emisión de claves de integración y cualquier automatización conectada al CRM requieren acuerdo explícito con Juxa (alcance, entornos, volumetría y responsables). No se considera válido el acceso técnico sin esa habilitación por escrito o sin el flujo comercial/soporte acordado.

Juxa CRM expone una API REST para integrar herramientas, automatizar flujos, sincronizar datos con sistemas externos o construir experiencias sobre tus datos del CRM, siempre dentro del marco contractual.

Las referencias abiertas de este sitio (OpenAPI, resúmenes) describen la superficie pública de producto; concesión y revocación de claves, criterios de aceptación en despliegue, ventanas y SLAs concretas se fijan con Juxa según el plan o el contrato Enterprise, no se sustituyen por leer la documentación sola.

Inicio rápido

1. Ve a Configuración → Claves API y crea una clave (solo tras habilitación).
2. Incluye la clave en cada petición como Bearer: Authorization: Bearer oc_sk_...
3. Empieza con GET /api/v1/objects para listar tipos de objeto y slugs del espacio de trabajo.
4. Ejemplos: GET /api/v1/objects/people/records, /companies, /deals, etc.

Endpoints clave

Documentación de referencia

La superficie estable de integración (objetos, registros, consulta, búsqueda, listas, notas, tareas) y los ámbitos de las claves se resumen al inicio de /llms-api.txt.

• Referencia breve: /llms-api.txt — lista rápida de endpoints, útil para agentes.
• Referencia completa: /llms-full.txt — peticiones y respuestas detalladas.
• OpenAPI: /openapi.json (completo) y /openapi-llm-tools.json (subconjunto curado para automatizaciones y acciones de LLM).

Para exponer esta API a asistentes compatibles con MCP, el patrón habitual es un servidor MCP que llame a estos endpoints con el token Bearer del espacio de trabajo; el despliegue concreto y la gobernanza los acuerda Juxa contigo. Ver MCP.

Autorización previa obligatoria: cualquier proyecto que conecte asistentes de IA al CRM mediante MCP (servidores de herramientas, hosts de escritorio, integraciones iPaaS) debe estar aprobado por Juxa y acotado en el contrato (datos permitidos, entornos, trazas y responsables). Esta página describe el estándar y el encaje con el CRM; no sustituye esa habilitación.

El Model Context Protocol (MCP) es un estándar abierto que permite a los modelos conectarse a datos y herramientas de forma estructurada y auditable.

En lugar de integraciones ad hoc por cada asistente, puedes exponer capacidades del CRM (vía la API REST habilitada) detrás de un servidor MCP que tú operas bajo las políticas acordadas con Juxa.

El despliegue, las credenciales de integración, los entornos permitidos y las pruebas de aceptación concretas no se negocian en esta guía: van en el anexo o la habilitación con Juxa, alineada con gobernanza y residencia de datos acordada.

Por qué importa en legaltech

Los flujos legales suelen fragmentarse entre DMS, calendarios, CRM y correo. MCP ayuda a que la IA actúe como agente operativo con acceso gobernado, no solo como generador de texto.

1. Conectar fuentes de datos

• DMS: búsqueda y lectura con permisos del usuario aplicados en el servidor MCP.
• Calendarios y plazos: consultas de fechas críticas y apoyo a recordatorios, siempre dentro del alcance contratado.

2. Automatizar con herramientas

• Generación o registro de borradores expuestos como herramientas con parámetros explícitos y revisión humana.
• Actualización de notas u oportunidades en el CRM a través de la API, solo con tokens y scopes autorizados.

La API REST del CRM (sección API e integraciones) es el backend natural para herramientas del tipo «crear tarea», «registrar nota» o «consultar registros» dentro de un servidor MCP aprobado.

3. Gobernanza y seguridad

• Acceso granular: cada servidor decide qué recursos y operaciones ve el modelo.
• Trazabilidad: las llamadas a herramientas estandarizadas se auditan mejor que integraciones dispersas en prompts.

Beneficios para escalar

API v1 y límites

Los sistemas externos (incluido MCP) deben preferir las rutas documentadas del CRM. Listado completo, paginación y ámbitos de clave (por ejemplo integrations:read, integrations:write, *) en /llms-api.txt. Las claves Bearer pueden tener límite de frecuencia por clave (por ejemplo 300 req/min; configurable con API_KEY_RATE_LIMIT_PER_MINUTE).

Habilitación y despliegue de MCP

Juxa no publica en esta documentación instrucciones para clonar repositorios ni binarios de servidor MCP: el despliegue (stdio, host de escritorio, HTTP/SSE, multi-tenant) se define contigo según seguridad, residencia de datos y modelo operativo. Contacta con soporte o tu interlocutor comercial para el paquete técnico y las pruebas de aceptación.

Primeros pasos recomendados

1. Arquitectura: inventaria CRM, DMS y bases de conocimiento que más tiempo consumen.
2. Contrato y alcance: acuerda con Juxa datos, entornos y trazas antes de conectar hosts MCP.
3. Referencia del estándar: modelcontextprotocol.io.

Para el agente Juxa y la API REST, enlaza con Integración del agente Juxa y API e integraciones.

Para organizaciones que necesitan control contractual sobre infraestructura, residencia de datos, integraciones avanzadas (API/MCP) y soporte operativo, Juxa ofrece una versión empresarial: despliegue dedicado, gobernanza y condiciones comerciales acordadas.

• No se facilita el código fuente del producto para clonarlo ni modificarlo por cuenta ajena.
• Las integraciones API y MCP se habilitan de forma explícita y quedan reflejadas en el acuerdo con Juxa.
• El acompañamiento (SLA, monitoreo, actualizaciones) lo define el contrato marco o el anexo de servicios gestionados.

Para explorar esta modalidad, abre conversación con el equipo de Juxa (comercial o soporte) y comparte requisitos de seguridad, volumetría y sistemas colindantes.

Contacto técnico dedicado, credenciales de conexión, nombres de canales, horarios reales de actuación y cifras de servicio: solo bajo el contrato y los canales oficiales; no se listan en la web pública como sustituto del anexo o del plan de habilitación.