# UTILIA OS — Documentación

> UTILIA OS es un sistema operativo empresarial integral (SaaS multi-tenant) que unifica en una sola plataforma CRM, finanzas y facturación (con cumplimiento fiscal español y VeriFactu), presupuestos con firma electrónica, chat de equipo, videollamadas, calendario, gestor de archivos, gestión de proyectos, tickets de soporte, fichaje, ausencias, formación, marketing por correo, captación de leads, portal del cliente, AI Studio e integraciones (API REST, SDK JavaScript/Python, MCP, OAuth, webhooks y widget). Todos los módulos comparten una base de datos común y los datos están conectados entre sí.

Esta documentación se organiza en dos mundos: USAR UTILIA OS (guías de uso de cada módulo para cualquier usuario) e INTEGRAR UTILIA OS (referencia técnica para desarrolladores). Las páginas viven bajo /dashboard/docs/<sección>/<slug>.

## Inicio rápido

- [Bienvenida a UTILIA OS](https://os.utilia.ai/dashboard/docs/inicio/bienvenida): Qué es UTILIA OS, qué cubre el ecosistema (comunicación, CRM, presupuestos, finanzas, trabajo, personas, marketing, IA y portal del cliente) y por dónde empezar según si usted usa la plataforma o la integra con su software.
- [Primeros pasos](https://os.utilia.ai/dashboard/docs/inicio/primeros-pasos): Configure su espacio de trabajo y empiece a usar UTILIA OS en minutos: inicio de sesión, perfil, dashboard, notificaciones y alta del equipo.
- [Configuración inicial](https://os.utilia.ai/dashboard/docs/inicio/configuracion-inicial): Deje su organización lista en UTILIA OS: identidad y datos fiscales, región y zona horaria, branding, equipo y roles, e integraciones externas. Guía de arranque para administradores con enlaces a cada panel.
- [Cómo está organizada la documentación](https://os.utilia.ai/dashboard/docs/inicio/como-esta-organizada-la-documentacion): Guía de los dos mundos de la documentación de UTILIA OS: Usar la plataforma y Integrar con ella. Aprenda dónde buscar según su perfil y qué encontrará en cada sección.

## Conceptos

- [Arquitectura](https://os.utilia.ai/dashboard/docs/conceptos/arquitectura): Cómo está construido UTILIA OS y cómo se comunican sus componentes
- [Organización y equipos](https://os.utilia.ai/dashboard/docs/conceptos/organizacion-y-equipos): Qué es su organización en UTILIA OS, cómo el aislamiento multi-tenant mantiene sus datos separados de los de otras empresas y cómo estructurar el equipo en departamentos.
- [Tiempo real](https://os.utilia.ai/dashboard/docs/conceptos/tiempo-real): Cómo funciona la comunicación en tiempo real en UTILIA OS
- [Permisos](https://os.utilia.ai/dashboard/docs/conceptos/roles-y-permisos): Sistema de control de acceso basado en roles y permisos por módulo
- [Privacidad y cumplimiento](https://os.utilia.ai/dashboard/docs/conceptos/privacidad-y-cumplimiento): Cómo gestiona UTILIA OS el consentimiento de cookies, el listado de subencargados del tratamiento y el contrato de encargo (DPA), y dónde controla cada cosa el usuario.
- [Glosario de entidades](https://os.utilia.ai/dashboard/docs/conceptos/glosario-entidades): Diccionario de las entidades del ecosistema de UTILIA OS (Cliente, Contacto, Lead, Oportunidad, Presupuesto, Proyecto, Tarea, Interacción, Factura, Gasto, Proveedor y más): qué significa cada término, cómo se relaciona con los demás y dónde aprender a usarlo.

## Comunicación

- [Vincular conversaciones de chat con el CRM](https://os.utilia.ai/dashboard/docs/uso-comunicacion/chat): Cómo enlazar una conversación del chat interno con una entidad del CRM para que cada día se genere automáticamente una interacción con el resumen de los mensajes.
- [Videoconferencias (Meet)](https://os.utilia.ai/dashboard/docs/uso-comunicacion/meet): Guía completa para crear, unirse y gestionar reuniones de vídeo en UTILIA OS
- [Guía de uso del calendario](https://os.utilia.ai/dashboard/docs/uso-comunicacion/calendar): Cómo crear y gestionar eventos, invitar asistentes, definir recordatorios y recurrencias, consultar la disponibilidad del equipo y ver de un vistazo eventos, tareas, reuniones e interacciones en una sola agenda.
- [Notificaciones y No molestar](https://os.utilia.ai/dashboard/docs/uso-comunicacion/notificaciones): Cómo recibir avisos de UTILIA OS en el momento adecuado: canales (in-app, push, email), preferencias por tipo de evento, horario de No molestar y silencio por dispositivo.

## CRM comercial

- [El CRM de UTILIA OS: el flujo comercial completo](https://os.utilia.ai/dashboard/docs/uso-crm/introduccion-crm): Página índice del CRM: qué entidades lo componen (Leads, Clientes, Contactos, Oportunidades, Presupuestos, Proyectos, Tareas, Interacciones e Informes) y cómo se conectan en un único flujo comercial, del primer contacto al cobro.
- [Clientes y contactos en el CRM](https://os.utilia.ai/dashboard/docs/uso-crm/clientes-y-contactos): Guía práctica para crear, organizar, asignar y consultar clientes y contactos en el CRM: ficha completa, enriquecimiento con IA, detección de duplicados, contactos compartidos entre clientes y qué ve cada rol según su alcance.
- [Leads: captar, calificar y convertir en clientes](https://os.utilia.ai/dashboard/docs/uso-crm/leads): Guía de uso del módulo de Leads del CRM: cómo crear leads (manual, rápido o por importación), calificarlos por etapa y temperatura, detectar y fusionar duplicados, enriquecerlos con IA y convertirlos en Cliente o Contacto, con o sin Oportunidad.
- [Oportunidades: vistas, equipo y estado compartido](https://os.utilia.ai/dashboard/docs/uso-crm/oportunidades): Guía de uso del módulo de Oportunidades del CRM: las tres vistas (Lista, Pipeline y Análisis), las pestañas Mías, Equipo y Todas, qué se recuerda entre sesiones, los permisos que gobiernan cada bloque y cómo se conecta la oportunidad con presupuestos, facturas, proyectos y reuniones.

## Presupuestos y firma

- [Presupuestos y firma electrónica](https://os.utilia.ai/dashboard/docs/uso-presupuestos/introduccion): Cómo preparar, enviar, firmar y cerrar presupuestos dentro del CRM, con firma electrónica con valor legal
- [Ciclo de vida del presupuesto](https://os.utilia.ai/dashboard/docs/uso-presupuestos/ciclo-de-vida): Estados del presupuesto, transiciones y qué firma electrónica admite cada estado
- [Enviar un presupuesto al cliente](https://os.utilia.ai/dashboard/docs/uso-presupuestos/envio-presupuesto): Flujo normal de envío del presupuesto con enlace de revisión, descarga y firma desde el correo
- [Solicitar firma ahora](https://os.utilia.ai/dashboard/docs/uso-presupuestos/solicitar-firma): Cómo reforzar la solicitud de firma electrónica desde el detalle del presupuesto, con plazo y mensaje personalizados
- [Firma de refuerzo legal sobre presupuestos aprobados](https://os.utilia.ai/dashboard/docs/uso-presupuestos/refuerzo-legal): Cómo solicitar firma electrónica a posteriori cuando un presupuesto ya está aprobado sin firma digital
- [Configurar la firma de presupuestos para la organización](https://os.utilia.ai/dashboard/docs/uso-presupuestos/configuracion-organizacion): Parámetros globales de la organización que afectan a la duración y validez de los enlaces de firma de presupuestos
- [Convertir un presupuesto en factura o proyecto](https://os.utilia.ai/dashboard/docs/uso-presupuestos/convertir-a-factura-o-proyecto): Cómo transformar un presupuesto aprobado en una factura, en un cobro recurrente o en un proyecto, qué datos se heredan y qué requisitos debe cumplir.

## Finanzas y facturación

- [Introducción a Finanzas](https://os.utilia.ai/dashboard/docs/uso-finanzas/introduccion-finanzas): Punto de entrada al módulo de Finanzas de UTILIA OS: facturación, cobros con Stripe, gastos y proveedores, tesorería, contabilidad, impuestos AEAT y VeriFactu, con enlaces a cada guía y al flujo que las conecta.
- [Guía de facturación completa](https://os.utilia.ai/dashboard/docs/uso-finanzas/facturacion-completa): Recorrido de extremo a extremo por el módulo de facturas: crear y emitir, numeración correlativa AEAT, firma VeriFactu, envío al cliente, cobro, rectificativas y exportación a Facturae, UBL y envío a FACe.
- [Cobrar una factura con Stripe](https://os.utilia.ai/dashboard/docs/uso-finanzas/cobrar-factura-stripe): Flujo completo de cobro manual desde el panel: tarjeta guardada, tarjeta nueva, enlace de pago al cliente, devoluciones y gestión del historial.
- [Conectar Stripe a su organización](https://os.utilia.ai/dashboard/docs/uso-finanzas/conectar-stripe): Alta y configuración de Stripe Connect Standard desde el dashboard de UTILIA OS. Los cobros llegan directamente a su banco.
- [Gestionar tarjetas guardadas del cliente](https://os.utilia.ai/dashboard/docs/uso-finanzas/gestionar-tarjetas-cliente): Añadir, marcar como predeterminada y desvincular tarjetas guardadas por un cliente del CRM. Requisito previo para los cobros automáticos.
- [Facturas recurrentes y cobro automático](https://os.utilia.ai/dashboard/docs/uso-finanzas/facturas-recurrentes-automaticas): Cómo se generan las facturas recurrentes a las 8:00 UTC y cómo se cobran solas a la tarjeta del cliente mediante el mandato y la programación de cobro (ScheduledInvoiceCharge), con reintentos, autenticación 3D Secure y avisos.
- [Rectificativas y notas de crédito](https://os.utilia.ai/dashboard/docs/uso-finanzas/rectificativas-y-notas-credito): Cómo emitir una factura rectificativa o una nota de crédito en UTILIA OS, con los códigos legales R1-R5 obligatorios para la AEAT.
- [Gastos, proveedores y facturas recibidas](https://os.utilia.ai/dashboard/docs/uso-finanzas/gastos-proveedores): Cómo registrar gastos y facturas recibidas, organizar sus proveedores, pasar cada gasto por el circuito de aprobación y dejarlo pagado y contabilizado en UTILIA OS.
- [Pagos desde el portal del cliente](https://os.utilia.ai/dashboard/docs/uso-finanzas/portal-pagos-clientes): Cómo el cliente paga sus facturas, guarda tarjetas y ve el estado desde el portal privado de UTILIA OS.
- [Cobros automáticos desde el portal del cliente](https://os.utilia.ai/dashboard/docs/uso-finanzas/cobros-automaticos-portal): Cómo activa, gestiona y revoca un cliente la autorización de cobro automático para sus cuotas recurrentes desde el portal privado de UTILIA OS.
- [Guía de tesorería: bancos, conciliación y previsión de caja](https://os.utilia.ai/dashboard/docs/uso-finanzas/tesoreria): Cómo gestionar la tesorería en UTILIA OS: dar de alta cuentas bancarias, importar movimientos por CSV o Norma 43, conectar el banco con Open Banking, conciliar movimientos con facturas y gastos, automatizar la categorización con reglas, y leer la previsión de caja y las alertas de saldo.
- [Contabilidad para no contables](https://os.utilia.ai/dashboard/docs/uso-finanzas/contabilidad): Cómo funciona la contabilidad de UTILIA OS sin saber de contabilidad: activación en un clic, asientos automáticos desde sus facturas y gastos, plan de cuentas, libro mayor, balances, cierre del ejercicio y legalización de libros.
- [Impuestos y modelos AEAT](https://os.utilia.ai/dashboard/docs/uso-finanzas/impuestos-aeat): Cómo configurar su régimen fiscal, llevar al día la agenda de impuestos y calcular, presentar y archivar los modelos de Hacienda (303, 111, 130, 347, 390, IGIC, forales e IPSI) en UTILIA OS, partiendo de las facturas y gastos que ya tiene registrados.
- [VeriFactu: facturación conforme a la AEAT](https://os.utilia.ai/dashboard/docs/uso-finanzas/verifactu): Qué es VeriFactu, si su organización está obligada y desde cuándo, cómo activarlo en UTILIA OS, subir su certificado digital y seguir el envío automático de cada factura a la Agencia Tributaria, todo paso a paso y sin tecnicismos.
- [Códigos de error de facturación](https://os.utilia.ai/dashboard/docs/uso-finanzas/codigos-error-facturacion): Referencia completa de los códigos de error que puede devolver la API externa y el dashboard al trabajar con facturas y pagos.

## Trabajo y productividad

- [Gestión de proyectos: issues, sprints y proyectos](https://os.utilia.ai/dashboard/docs/uso-trabajo/gestion-proyectos): Guía de uso del módulo Gestión de proyectos de UTILIA OS: cómo organizar el trabajo en proyectos, planificar sprints, crear y seguir issues con sus estados, prioridades, comentarios, adjuntos y registro de horas, y cómo se conecta con soporte y facturación.
- [Perfil de trabajo por sector](https://os.utilia.ai/dashboard/docs/uso-trabajo/perfil-de-trabajo-por-sector): Cómo adaptar el módulo de Gestión de proyectos al sector de su organización (software, equipos genéricos, agencias o consultoras): elija un perfil y el módulo cambia su terminología, las capacidades visibles y las plantillas de cada proyecto nuevo. Incluye la diferencia entre el perfil de la organización y el ajuste por proyecto.
- [Horas facturables: del registro de tiempo a la factura](https://os.utilia.ai/dashboard/docs/uso-trabajo/horas-facturables): Cómo convertir las horas que su equipo registra en los issues en un borrador de factura: marcar el tiempo como facturable, fijar la tarifa por hora, revisar las horas pendientes agrupadas por proyecto y cliente, y generar la factura en Finanzas sin facturar dos veces.
- [Guía del gestor de archivos](https://os.utilia.ai/dashboard/docs/uso-trabajo/file-manager): Cómo organizar, subir, compartir, etiquetar y versionar archivos en carpetas dentro de UTILIA OS, y cómo conectar esos archivos con clientes, proyectos, presupuestos y otras entidades del CRM.
- [WebDAV: el gestor de archivos como unidad de red](https://os.utilia.ai/dashboard/docs/uso-trabajo/webdav-unidad-red): Conecte el gestor de archivos de UTILIA OS como una unidad de red en Windows, macOS o Linux mediante WebDAV: acceda a sus carpetas y a los archivos de clientes y proyectos del CRM desde el propio explorador del sistema, con sus mismos usuario y permisos.
- [Guía de tickets de soporte](https://os.utilia.ai/dashboard/docs/uso-trabajo/tickets-soporte): Cómo reportar bugs, consultas y sugerencias mediante tickets de soporte, seguir su estado, comentar, adjuntar capturas y entender cómo el equipo los gestiona, los convierte en issues de desarrollo y los resuelve.
- [El buscador global: encuéntrelo todo desde cualquier pantalla](https://os.utilia.ai/dashboard/docs/uso-trabajo/buscador-global): Cómo usar el buscador global de UTILIA OS (Cmd+K) para localizar al instante clientes, contactos, leads, oportunidades, proyectos, tareas, facturas, archivos, tickets e issues sin cambiar de módulo. Atajo de teclado, búsqueda con tildes, agrupación por tipo y respeto de sus permisos.

## Personas y RRHH

- [Guía de formación interna](https://os.utilia.ai/dashboard/docs/uso-personas/formacion): Cree formaciones internas con lecciones de vídeo y documentos, asígnelas por departamento, publíquelas y aproveche la IA para redactar el contenido a partir del material subido.
- [Guía de gamificación](https://os.utilia.ai/dashboard/docs/uso-personas/gamificacion): Motive a su equipo con puntos, rankings y rachas: descubra qué acciones suman puntos en cada módulo, consulte su posición, configure las reglas y ajuste puntos manualmente como administrador.
- [Fichaje y registro horario](https://os.utilia.ai/dashboard/docs/uso-personas/fichaje): Cómo fichar entrada y salida, gestionar pausas, consultar su historial y resumen de horas, y cómo los responsables supervisan, corrigen y exportan el registro horario legal en UTILIA OS.
- [Solicitudes de ausencia y vacaciones](https://os.utilia.ai/dashboard/docs/uso-personas/ausencias): Flujo completo de peticiones de vacaciones y permisos en UTILIA OS: solicitud, aprobación, saldos y calendario de equipo.
- [Guía de departamentos](https://os.utilia.ai/dashboard/docs/uso-personas/departamentos): Cree y organice los departamentos de su organización en una estructura jerárquica, asígneles una plantilla de permisos sugerida y aprovéchelos para acotar el acceso en CRM, formación, archivos, fichaje y marketing.

## Marketing y captación

- [Marketing conectado al CRM](https://os.utilia.ai/dashboard/docs/uso-marketing/campanas-email): El módulo Marketing como centro de mando único, con pruebas A/B desde el asistente, cierre comercial de clics a oportunidades y leads, automatizaciones con plantillas y disparadores, segmentos que cubren leads, y seguimiento como interacciones del CRM.
- [Entregabilidad: SPF, DKIM y DMARC](https://os.utilia.ai/dashboard/docs/uso-marketing/entregabilidad-dominios): Cómo configurar y verificar un dominio de envío contra DNS real desde el módulo Marketing, con un wizard guiado de tres pasos.
- [Sincronizar tu buzón con el CRM](https://os.utilia.ai/dashboard/docs/uso-marketing/sincronizar-correo): Guía paso a paso para conectar tu cuenta de correo (Outlook, Google o IMAP) y que los correos intercambiados con clientes, contactos y leads se registren solos como interacciones en el CRM, sin copiar nada a mano.
- [Guía del scraper](https://os.utilia.ai/dashboard/docs/uso-marketing/scraper): Aprenda a crear scrapers para vigilar páginas web, ejecutarlos, detectar qué ha cambiado entre una revisión y otra, programarlos para que se repitan solos y exportar el contenido recogido. Pensado para vigilancia de competencia, captación de información pública y seguimiento de webs.

## Inteligencia artificial

- [Introducción a AI Studio](https://os.utilia.ai/dashboard/docs/uso-ia/ai-studio-introduccion): Qué es AI Studio: la biblioteca central de activos de inteligencia artificial reutilizables (prompts, skills, agentes, comandos y plugins) que su organización crea, versiona, comparte y exporta en formato oficial de Anthropic.
- [Primeros pasos](https://os.utilia.ai/dashboard/docs/uso-ia/ai-studio-primeros-pasos): Cómo crear su primer prompt y cómo importar una skill desde un archivo ZIP en el formato oficial de Anthropic.
- [Organización del catálogo](https://os.utilia.ai/dashboard/docs/uso-ia/ai-studio-organizacion): Cómo estructurar el catálogo de AI Studio con colecciones anidables, etiquetas y vínculos con entidades del ecosistema.
- [Versionado de activos](https://os.utilia.ai/dashboard/docs/uso-ia/ai-studio-versionado): Cómo AI Studio gestiona el histórico de versiones de cada activo, cómo se incrementa la versión y cómo volver a una versión anterior.
- [Compartición de activos](https://os.utilia.ai/dashboard/docs/uso-ia/ai-studio-comparticion): Visibilidad base, compartición granular con usuarios, departamentos o roles, y niveles de permiso READ, EXECUTE, EDIT y ADMIN sobre cada activo.
- [Formato oficial de Anthropic](https://os.utilia.ai/dashboard/docs/uso-ia/ai-studio-formato-anthropic): Estructura de Skills y Agents según el formato oficial de Anthropic de octubre de 2025: carpeta, SKILL.md, frontmatter YAML y recursos.
- [Marketplace](https://os.utilia.ai/dashboard/docs/uso-ia/ai-studio-marketplace): Cómo publicar, instalar y reportar activos de IA en el marketplace compartido del AI Studio, con moderación central del equipo de UTILIA.
- [Permisos y roles](https://os.utilia.ai/dashboard/docs/uso-ia/ai-studio-permisos-y-roles): Los ocho permisos específicos del módulo AI Studio, sus scopes (ALL, DEPARTMENT, OWN) y cómo se asignan por rol.
- [Integración con el ecosistema](https://os.utilia.ai/dashboard/docs/uso-ia/ai-studio-integracion-ecosistema): Cómo AI Studio se conecta con incidencias, proyectos, oportunidades y otros módulos de UTILIA OS, con eventos SSE y audit log.
- [Variables de entorno](https://os.utilia.ai/dashboard/docs/uso-ia/ai-studio-variables-entorno): Las cinco variables de entorno que configuran los límites de almacenamiento e importación de AI Studio: tamaño de adjuntos, tamaño de versión y límites del ZIP de importación, con sus valores por defecto y códigos de error.
- [Conectar tu asistente de IA](https://os.utilia.ai/dashboard/docs/uso-ia/conectar-tu-ia): Conecta tu asistente de IA (Claude, ChatGPT, Cursor o Claude Code) a los datos de tu negocio en UTILIA para que pueda consultarlos y ayudarte, respetando siempre tus permisos.
- [Guía de Call Copilot](https://os.utilia.ai/dashboard/docs/uso-ia/call-copilot): Cómo usar Call Copilot: el asistente en tiempo real que escucha sus llamadas, las transcribe y le sugiere qué decir, apoyándose en la ficha del Cliente, la oportunidad o el proyecto que tenga abierto en el CRM.
- [Guía de anuncios](https://os.utilia.ai/dashboard/docs/uso-ia/anuncios): Cómo crear, programar y publicar anuncios internos para su equipo en UTILIA OS, dirigirlos por rol o departamento y redactarlos en segundos con ayuda de la inteligencia artificial.

## Portal del cliente

- [Introducción al portal del cliente](https://os.utilia.ai/dashboard/docs/uso-portal-cliente/introduccion-portal): Qué es el portal del cliente de UTILIA OS, cómo invitar a un contacto, qué puede ver y hacer cada persona invitada (facturas, presupuestos, documentos, reuniones, chat y tickets) y cómo se controla su acceso por empresa y por permisos.
- [Invitar clientes al portal](https://os.utilia.ai/dashboard/docs/uso-portal-cliente/invitar-clientes): Guía paso a paso para dar acceso al portal a los contactos de un cliente: a qué empresas concede acceso la invitación, qué permisos elige, cómo se reenvía si caduca y cómo revocarla. Incluye el detalle del correo, la caducidad de 72 horas y los permisos disponibles.
- [Conceder y revocar el acceso al portal del cliente](https://os.utilia.ai/dashboard/docs/uso-portal-cliente/gestionar-acceso): Guía paso a paso para invitar a un contacto al portal, dar o quitar acceso a cada cliente cuando una persona representa a varios, reactivar accesos revocados y entender qué ocurre con sus sesiones y permisos en cada caso.
- [El cliente aprueba presupuestos](https://os.utilia.ai/dashboard/docs/uso-portal-cliente/cliente-presupuestos): Guía del flujo de presupuestos en el portal del cliente: cómo el cliente ve los presupuestos que ha recibido, descarga el PDF, los aprueba firmando con su firma manuscrita, los rechaza indicando un motivo, deja comentarios para su equipo y verifica la firma. Qué ve el cliente, qué permisos hacen falta y cómo se conecta con el resto del CRM.
- [El cliente consulta sus facturas](https://os.utilia.ai/dashboard/docs/uso-portal-cliente/cliente-facturas): Guía del portal del cliente para consultar facturas: qué facturas ve cada persona invitada, cómo busca y filtra por estado o tipo, qué muestra el detalle, cómo descarga el PDF, qué permisos hacen falta y cómo se aíslan las facturas cuando el cliente tiene varias empresas.
- [El cliente paga y autoriza cobros](https://os.utilia.ai/dashboard/docs/uso-portal-cliente/cliente-pagos): Guía del flujo de pago en el portal del cliente: pagar una factura en línea con tarjeta nueva o guardada, superar la autenticación 3D Secure del banco, guardar métodos de pago, autorizar mandatos de cobro automático y programar cobros sobre una factura. Qué ve el cliente, qué permisos hacen falta y cómo se conecta con sus facturas.
- [El cliente abre tickets](https://os.utilia.ai/dashboard/docs/uso-portal-cliente/cliente-tickets): Guía del soporte en el portal del cliente: cómo abre un ticket (título, descripción, categoría y prioridad), cómo adjunta capturas, cómo la IA ayuda a redactar el ticket a partir de texto, voz o imágenes, cómo sigue el estado y responde con comentarios, y qué permisos del portal hacen falta. Qué ve el cliente, qué consigue y cómo se conecta el ticket con Gestión de proyectos.
- [El cliente chatea con el equipo](https://os.utilia.ai/dashboard/docs/uso-portal-cliente/cliente-chat): Guía del chat del portal del cliente: cómo conversa una persona invitada con su equipo en tiempo real, qué permisos necesita (Ver Chat y Enviar Mensajes), cómo envía texto, adjuntos, notas de voz y stickers, cómo responde citando un mensaje, cómo busca en la conversación, cuándo el canal pasa a solo lectura y qué nunca ve el cliente. Qué ve, qué consigue y cómo se conecta con el chat interno y el CRM.

## Equipo y administración

- [Gestionar el equipo: usuarios, roles y permisos](https://os.utilia.ai/dashboard/docs/uso-administracion/gestionar-equipo): Guía práctica para dar de alta a las personas de su equipo, asignarles un rol, ajustar sus permisos individuales (conceder o quitar accesos sobre el rol base), copiar la configuración de otra persona, y activar, desactivar o dar de baja cuentas. Incluye los seis roles del sistema, los cuatro alcances de permiso y las protecciones del único administrador.
- [Plantillas de permisos por puesto](https://os.utilia.ai/dashboard/docs/uso-administracion/plantillas-permisos): Aprenda a crear plantillas de permisos reutilizables (Comercial junior, Administración, Solo lectura) que combinan un rol base con accesos concretos concedidos o retirados, y a aplicarlas a cualquier persona del equipo en un solo paso. Incluye qué es una plantilla, cómo se construyen sus reglas, qué pasa al aplicarla a un usuario, los alcances de cada acceso y las protecciones de seguridad del sistema.
- [Autenticación](https://os.utilia.ai/dashboard/docs/uso-administracion/autenticacion-acceso): Cómo funciona el sistema de autenticación y la seguridad de las sesiones
- [Ajustes de la organización](https://os.utilia.ai/dashboard/docs/uso-administracion/ajustes-organizacion): Configure la identidad corporativa, los datos fiscales y bancarios, el branding, la región, la facturación y los módulos opcionales de su organización desde un único panel.
- [El registro de auditoría: quién hizo qué y cuándo](https://os.utilia.ai/dashboard/docs/uso-administracion/auditoria): Guía práctica del panel Actividad y auditoría: cómo consultar el libro legal inalterable de cambios y el registro de accesos, descargas e inicios de sesión, cómo filtrar por categoría, persona o fechas, ver el detalle de cada evento con su sello de integridad y exportar el historial en CSV o JSON. Incluye los tres permisos que controlan el acceso y por qué el registro no se puede borrar.
- [Sesiones activas: ver y cerrar accesos del equipo](https://os.utilia.ai/dashboard/docs/uso-administracion/sesiones): Guía práctica del panel de Sesiones de Ajustes: cómo ver desde qué dispositivos y direcciones IP están conectadas las personas de su organización, distinguir una sesión activa de una caducada, inactiva o revocada, cerrar la sesión de un dispositivo concreto o todas las de una persona a la vez, limpiar las sesiones caducadas y entender la limpieza automática diaria. Incluye los dos permisos que controlan el acceso, la marca de sesión de soporte de UTILIA y por qué nunca puede cerrar por error su propia sesión actual.
- [Mi plan y suscripción](https://os.utilia.ai/dashboard/docs/uso-administracion/mi-plan-suscripcion): Cómo consultar el estado de su plan, añadir una tarjeta, gestionar el cobro automático, descargar sus facturas, cancelar o reactivar la suscripción a UTILIA OS.

## Integrar: introducción

- [Introducción a Integraciones API](https://os.utilia.ai/dashboard/docs/integrar-introduccion/introduccion): Documentación técnica para introducción
- [Arquitectura y Flujos](https://os.utilia.ai/dashboard/docs/integrar-introduccion/arquitectura-flujos): Flujo principal de la API externa, OAuth y procesamiento AI
- [Autenticación API Key](https://os.utilia.ai/dashboard/docs/integrar-introduccion/autenticacion-api-key): Documentación técnica para autenticación-api-key
- [Rate Limiting y CORS](https://os.utilia.ai/dashboard/docs/integrar-introduccion/rate-limiting-y-cors): Documentación técnica para rate-limiting-y-cors
- [Errores, Request ID y Reintentos](https://os.utilia.ai/dashboard/docs/integrar-introduccion/errores-request-id-reintentos): Manejo de errores, códigos de error de negocio, correlación por x-request-id y política de reintentos
- [Primeros 15 minutos con la API](https://os.utilia.ai/dashboard/docs/integrar-introduccion/quickstart-integracion): Guía mínima para integrar UTILIA OS desde cero: identificar usuarios, crear tickets, pedir IA, reportar errores y manejar fallos sin romper tu frontend
- [Ubicación de parámetros: query vs body vs path](https://os.utilia.ai/dashboard/docs/integrar-introduccion/ubicacion-parametros): Tabla canónica de dónde van los parámetros en cada endpoint de la API externa: query string, body, path. Imprescindible para evitar errores 400 y 500.
- [Antipatrones: errores que no debes cometer](https://os.utilia.ai/dashboard/docs/integrar-introduccion/antipatrones): Lista corta de errores recurrentes en integraciones nuevas con la API externa de UTILIA OS y cómo evitarlos.
- [Pestaña Errores: gestión interna](https://os.utilia.ai/dashboard/docs/integrar-introduccion/ui-errores-integracion): Cómo el equipo de UTILIA OS gestiona los errores que reporta tu app desde el panel de detalle de la integración
- [Arquitectura de la facturación centralizada](https://os.utilia.ai/dashboard/docs/integrar-introduccion/arquitectura-facturacion): Cómo conviven UTILIA OS, las apps externas y Stripe en el sistema de facturación y cobro. Modelo de datos, flujos y aislamiento.

## Integrar: API REST

- [Endpoints de usuarios externos](https://os.utilia.ai/dashboard/docs/integrar-api/endpoints-users): Referencia de /external/v1/users: identificar usuarios externos en UTILIA OS y consultar el listado de usuarios vinculados a la app. Incluye el scope crm:users:read exigido desde 2026-05-25.
- [Endpoints de clientes del CRM](https://os.utilia.ai/dashboard/docs/integrar-api/endpoints-clients): API externa /external/v1/clients para apps de facturación, sincronización CRM y soporte: listado, búsqueda por NIF/CIF timing-uniform, contactos vinculados, deactivate y webhooks CLIENT_*
- [Endpoints de contactos del CRM](https://os.utilia.ai/dashboard/docs/integrar-api/endpoints-contacts): API externa /external/v1/contacts para apps de envío de correos: listado, sync delta, opt-out, opt-in y webhooks CONTACT_*
- [Endpoints de leads del CRM](https://os.utilia.ai/dashboard/docs/integrar-api/endpoints-leads): API externa /external/v1/leads para apps de prospección y sincronización CRM bidireccional: listado, sync delta, qualify, disqualify, convert y webhooks LEAD_*
- [Endpoints de facturas externas](https://os.utilia.ai/dashboard/docs/integrar-api/endpoints-invoices): Referencia completa de la API externa /external/v1/invoices: crear, listar, detalle, PDF, anular y estadísticas. Incluye los scopes crm:invoices:* exigidos desde 2026-05-25.
- [Endpoints de cobro de facturas](https://os.utilia.ai/dashboard/docs/integrar-api/endpoints-payments): Referencia de /external/v1/invoices/:id/pay y /payment-intents: iniciar un cobro con tarjeta guardada o nueva y consultar el histórico. Incluye el scope billing:charge exigido desde 2026-05-25.
- [Endpoints de métodos de pago](https://os.utilia.ai/dashboard/docs/integrar-api/endpoints-payment-methods): Referencia de /external/v1/payment-methods: SetupIntents para guardar tarjetas, listar, marcar predeterminada y desvincular. Incluye los scopes billing:payment-methods:* exigidos desde 2026-05-25.
- [Cancelación de reembolsos](https://os.utilia.ai/dashboard/docs/integrar-api/endpoints-refund-cancellation): Cómo previsualizar y ejecutar la cancelación de un reembolso de factura: endpoints REST, herramienta MCP, SDK JS/Python y evento canónico.
- [Endpoints de comentarios de presupuesto](https://os.utilia.ai/dashboard/docs/integrar-api/endpoints-budgets-comments): Referencia de la API externa /external/v1/budgets/:budgetId/comments para listar y crear comentarios CLIENT del presupuesto. Incluye los scopes crm:budgets:comments:* exigidos desde 2026-05-25.
- [Endpoints de firmas de presupuesto](https://os.utilia.ai/dashboard/docs/integrar-api/endpoints-budgets-signatures): Referencia de la API externa /external/v1/budgets/:budgetId/signatures para listar, consultar y verificar firmas electrónicas del presupuesto. Incluye los scopes crm:budgets:signatures:* exigidos desde 2026-05-25.
- [Endpoints Core de Tickets](https://os.utilia.ai/dashboard/docs/integrar-api/endpoints-tickets-core): Referencia completa de los endpoints CRUD de tickets, mensajes y eventos en tiempo real. Incluye los scopes support:tickets:* exigidos desde 2026-05-25.
- [Endpoints de Sugerencias IA](https://os.utilia.ai/dashboard/docs/integrar-api/endpoints-tickets-ai): Referencia completa de los endpoints de sugerencias inteligentes para tickets. Incluye el scope support:tickets:ai exigido desde 2026-05-25.
- [Endpoints de Transcripción](https://os.utilia.ai/dashboard/docs/integrar-api/endpoints-tickets-transcripcion): Referencia completa de los endpoints de transcripción de audio a texto
- [Endpoint de Errores del Cliente](https://os.utilia.ai/dashboard/docs/integrar-api/endpoints-client-errors): Referencia del endpoint para reportar errores del SDK y widget al servidor
- [Endpoints de Errores del Sistema](https://os.utilia.ai/dashboard/docs/integrar-api/endpoints-errors): Documentación de los endpoints REST para reportar, listar y consultar estadísticas de errores desde apps externas. Incluye los scopes analytics:errors:* exigidos desde 2026-05-25.
- [Endpoints de ficheros externos](https://os.utilia.ai/dashboard/docs/integrar-api/endpoints-files): Referencia de la API externa /external/v1/files para subir, consultar cuota, obtener URLs firmadas y borrar ficheros desde una app externa. Incluye los scopes fm:files:* exigidos desde 2026-05-25.
- [Endpoints de AI Analytics](https://os.utilia.ai/dashboard/docs/integrar-api/endpoints-ai-analytics): Referencia de la API externa /external/v1/ai-analytics para consultar resumen y tendencias del uso propio de IA en UTILIA. Incluye el scope analytics:ai:read exigido desde 2026-05-25.
- [Marketing: API y herramientas MCP](https://os.utilia.ai/dashboard/docs/integrar-api/endpoints-marketing): Superficie de API interna y herramientas MCP del módulo Marketing: pruebas A/B, cierre comercial (clic a oportunidad o lead), automatizaciones con plantillas y disparadores, segmentos con leads, etiquetas del CRM y exportación de informes.
- [Gestión de scopes de apps externas](https://os.utilia.ai/dashboard/docs/integrar-api/gestion-scopes): Cómo conceder y retirar scopes a una aplicación externa desde el panel admin: catálogo de 35 scopes, reglas RGPD, periodo de gracia, optimistic locking y AuditLog.
- [El catálogo de scopes son 35: conteo canónico](https://os.utilia.ai/dashboard/docs/integrar-api/unificar-scopes-conteo): Cifra de referencia del catálogo de scopes de la API externa: 35 scopes en total, 10 que exigen SUPER_ADMIN. Desglose por dominio, fuente de verdad en el backend y dónde se cita el número en la documentación.
- [Integrar facturación en tu app externa](https://os.utilia.ai/dashboard/docs/integrar-api/guia-integrar-facturacion): Guía paso a paso para emitir, cobrar y recibir webhooks de facturas desde tu propia aplicación: activar facturación, guardar tarjeta con Stripe, pagar y verificar la firma HMAC sobre timestamp.rawBody.
- [API Admin de Integraciones](https://os.utilia.ai/dashboard/docs/integrar-api/api-admin-integraciones): Endpoints del panel admin para gestionar apps externas (alta, scopes, webhooks, métricas y facturación). Autenticación por JWT Bearer y permisos del módulo Integraciones, no por X-Api-Key.
- [Panel de aplicaciones externas](https://os.utilia.ai/dashboard/docs/integrar-api/panel-integraciones): Guía técnica del panel de integraciones: crear y configurar una aplicación externa, gestionar sus claves, scopes, webhooks, usuarios externos y métricas de la API admin de UTILIA OS.
- [Métricas de API](https://os.utilia.ai/dashboard/docs/integrar-api/metricas-api): Documentación técnica para métricas API
- [Endpoints analíticos de Oportunidades](https://os.utilia.ai/dashboard/docs/integrar-api/oportunidades-endpoints-analitica): Referencia de los endpoints REST que alimentan la vista Análisis del módulo Oportunidades del CRM, incluidos los tres añadidos en el sprint del 2026-05-14 y los cambios contractuales sobre PipelineStatsDto y OpportunityFilterDto.
- [API REST de AI Studio](https://os.utilia.ai/dashboard/docs/integrar-api/ai-studio-api-rest): Referencia de los endpoints REST internos del módulo AI Studio: catálogo de activos, versiones, colecciones, vínculos, comparticiones, métricas de uso y reacciones, y el stream SSE del catálogo en tiempo real.

## Integrar: Webhooks

- [Webhooks Overview](https://os.utilia.ai/dashboard/docs/integrar-webhooks/webhooks-overview): Visión general de los webhooks de UTILIA OS: autenticación, permisos, cabeceras de seguridad, verificación anti-replay y catálogo de eventos emitidos.
- [Webhooks Payloads y Eventos](https://os.utilia.ai/dashboard/docs/integrar-webhooks/webhooks-payloads-eventos): Estructura del payload base y catálogo completo de eventos de webhook emitidos por UTILIA OS, con ejemplos de cuerpo para tickets, errores, facturación, pagos y autorizaciones de cobro.
- [Firma HMAC de los webhooks](https://os.utilia.ai/dashboard/docs/integrar-webhooks/webhooks-firma-hmac): Cómo UTILIA OS firma cada webhook con HMAC-SHA256 sobre timestamp.rawBody y cómo verificar la firma de forma segura en Node.js y Python, con defensa anti-replay.
- [Webhooks Entregas y Reintentos](https://os.utilia.ai/dashboard/docs/integrar-webhooks/webhooks-entregas-reintentos): Endpoints para listar entregas de webhooks, consultar su detalle, reintentarlas y enviar una entrega de prueba, con ejemplos en curl, fetch, axios y Python.

## Integrar: SDK

- [SDK Overview](https://os.utilia.ai/dashboard/docs/integrar-sdk/sdk-overview): Resumen de los SDKs oficiales de UTILIA OS: JavaScript y Python
- [SDK JS Instalación](https://os.utilia.ai/dashboard/docs/integrar-sdk/sdk-js-instalacion): Instalación y configuración del SDK JavaScript para la API externa
- [Configuración del SDK JavaScript](https://os.utilia.ai/dashboard/docs/integrar-sdk/sdk-js-configuracion): Referencia completa de UtiliaSDKConfig: parámetros, headers automáticos, sistema de reintentos con backoff exponencial, modo debug, autenticación por API Key u OAuth 2.1 y manejo de errores. Verificada contra el SDK 2.16.0.
- [SDK JS Guía de Usuarios](https://os.utilia.ai/dashboard/docs/integrar-sdk/sdk-js-guia-usuarios): Guía completa del servicio de usuarios del SDK JavaScript de UTILIA OS
- [SDK JS Guía de Tickets](https://os.utilia.ai/dashboard/docs/integrar-sdk/sdk-js-guia-tickets): Guía completa del servicio de tickets de soporte del SDK JavaScript de UTILIA OS
- [SDK JS Guía de Archivos](https://os.utilia.ai/dashboard/docs/integrar-sdk/sdk-js-guia-archivos): Guía completa del servicio de archivos del SDK JavaScript: subir archivos, obtener URLs de descarga y consultar cuota de almacenamiento
- [SDK JS Guía de Errores](https://os.utilia.ai/dashboard/docs/integrar-sdk/sdk-js-guia-errores): Guía completa del servicio de errores del SDK JavaScript: reportar errores, listar errores con filtros y consultar estadísticas
- [SDK JS - Sugerencias con IA](https://os.utilia.ai/dashboard/docs/integrar-sdk/sdk-js-guia-ai-sugerencias): Guía completa para solicitar sugerencias inteligentes con el servicio de IA del SDK JavaScript de UTILIA OS
- [SDK JS - Transcripción de Audio](https://os.utilia.ai/dashboard/docs/integrar-sdk/sdk-js-guia-ai-transcripcion): Guía completa para transcribir audio a texto con el servicio de IA del SDK JavaScript de UTILIA OS
- [SDK JS Streaming AI](https://os.utilia.ai/dashboard/docs/integrar-sdk/sdk-js-streaming-ai): Documentación técnica para sdk-js-streaming-ai
- [SDK JS: Guía de facturas](https://os.utilia.ai/dashboard/docs/integrar-sdk/sdk-js-guia-invoices): Servicio sdk.invoices del SDK JavaScript: crear, listar, descargar PDF, anular y obtener estadísticas de facturas externas.
- [SDK JS: Guía de métodos de pago](https://os.utilia.ai/dashboard/docs/integrar-sdk/sdk-js-guia-payment-methods): Servicio sdk.paymentMethods: SetupIntents para guardar tarjetas, listar, marcar predeterminada y desvincular.
- [SDK JS: Guía de pagos](https://os.utilia.ai/dashboard/docs/integrar-sdk/sdk-js-guia-payments): Servicio sdk.payments: iniciar cobro de una factura con tarjeta guardada o nueva, consultar histórico de intentos.
- [SDK JS: Guía OAuth](https://os.utilia.ai/dashboard/docs/integrar-sdk/sdk-js-guia-oauth): Guía completa de autenticación OAuth 2.1 con PKCE para el SDK JavaScript de UTILIA OS
- [Referencia del SDK JavaScript](https://os.utilia.ai/dashboard/docs/integrar-sdk/sdk-js-referencia): Catálogo completo de los servicios y métodos del SDK JavaScript de UTILIA OS 2.16.0: contactos y CRM externo, presupuestos, firma electrónica, facturación, cobros, suscripciones, mandatos, tickets, archivos, IA, OAuth y herramientas MCP. Verificado contra el código del paquete.
- [SDK JS Tipos Completos](https://os.utilia.ai/dashboard/docs/integrar-sdk/sdk-js-tipos-completos): Referencia completa de todos los tipos TypeScript exportados por el SDK JavaScript de UTILIA OS
- [SDK JS Límites y Validaciones](https://os.utilia.ai/dashboard/docs/integrar-sdk/sdk-js-limites-validaciones): Referencia de todos los límites, validaciones y restricciones del SDK JavaScript de UTILIA OS
- [SDK JS Manejo de Errores](https://os.utilia.ai/dashboard/docs/integrar-sdk/sdk-js-manejo-errores): Guía completa para capturar y gestionar errores del SDK JavaScript de UTILIA OS
- [SDK Python Instalación](https://os.utilia.ai/dashboard/docs/integrar-sdk/sdk-python-instalacion): Guía de instalación, requisitos y primeros pasos con el SDK Python de UTILIA OS (async y sync)
- [SDK Python Configuración](https://os.utilia.ai/dashboard/docs/integrar-sdk/sdk-python-configuracion): Parámetros del constructor del SDK Python de UTILIA OS (versión 2.16.0): timeouts, reintentos con backoff, cabeceras automáticas, autenticación por API Key u OAuth 2.1 y manejo de errores con UtiliaSDKError
- [SDK Python Guía de Usuarios](https://os.utilia.ai/dashboard/docs/integrar-sdk/sdk-python-guia-usuarios): Guía completa del servicio de usuarios del SDK Python de UTILIA OS
- [SDK Python Guía de Tickets](https://os.utilia.ai/dashboard/docs/integrar-sdk/sdk-python-guia-tickets): Guía completa del servicio de tickets de soporte del SDK Python de UTILIA OS
- [SDK Python Guía de Archivos](https://os.utilia.ai/dashboard/docs/integrar-sdk/sdk-python-guia-archivos): Guía completa del servicio de archivos del SDK Python: subir archivos, obtener URLs de descarga y consultar cuota de almacenamiento
- [SDK Python - Guía de Errores del Sistema](https://os.utilia.ai/dashboard/docs/integrar-sdk/sdk-python-guia-errores): Guía completa del servicio de errores del SDK Python: reportar errores, listar errores con filtros y consultar estadísticas
- [SDK Python - Sugerencias con IA](https://os.utilia.ai/dashboard/docs/integrar-sdk/sdk-python-guia-ai-sugerencias): Guía completa para solicitar sugerencias inteligentes con el servicio de IA del SDK Python de UTILIA OS
- [SDK Python - Transcripción de Audio](https://os.utilia.ai/dashboard/docs/integrar-sdk/sdk-python-guia-ai-transcripcion): Guía completa para transcribir audio a texto con el servicio de IA del SDK Python de UTILIA OS
- [SDK Python: Guía de facturas](https://os.utilia.ai/dashboard/docs/integrar-sdk/sdk-python-guia-invoices): Servicio invoices del SDK Python: emitir, listar, descargar PDF, anular y obtener estadísticas de facturas externas.
- [SDK Python: Guía de métodos de pago](https://os.utilia.ai/dashboard/docs/integrar-sdk/sdk-python-guia-payment-methods): Servicio payment_methods del SDK Python: SetupIntents, listar, marcar predeterminada y desvincular tarjetas.
- [SDK Python: Guía de pagos](https://os.utilia.ai/dashboard/docs/integrar-sdk/sdk-python-guia-payments): Servicio payments del SDK Python: cobrar facturas con tarjeta guardada o nueva y consultar el histórico de intentos.
- [SDK Python: Guía OAuth](https://os.utilia.ai/dashboard/docs/integrar-sdk/sdk-python-guia-oauth): Guía completa de autenticación OAuth 2.1 con PKCE para el SDK Python de UTILIA OS
- [Referencia del SDK Python](https://os.utilia.ai/dashboard/docs/integrar-sdk/sdk-python-referencia): Catálogo completo de los servicios y métodos del SDK Python de UTILIA OS 2.16.0: contactos y CRM externo, presupuestos, firma electrónica, facturación, cobros, suscripciones, mandatos, tickets, archivos, IA, calendario, OAuth y herramientas MCP. Verificado contra el código del paquete.
- [SDK Python Tipos Completos](https://os.utilia.ai/dashboard/docs/integrar-sdk/sdk-python-tipos-completos): Referencia completa de todos los modelos Pydantic y dataclasses exportados por el SDK Python de UTILIA OS
- [SDK Python Manejo de Errores](https://os.utilia.ai/dashboard/docs/integrar-sdk/sdk-python-manejo-errores): Guía completa para capturar y gestionar errores del SDK Python de UTILIA OS
- [Versiones y compatibilidad del SDK](https://os.utilia.ai/dashboard/docs/integrar-sdk/versiones-compatibilidad-sdk): Matriz de versiones actualizada a 2.16.0: API externa v1, SDK JavaScript, SDK Python y widget. Incluye hitos por versión, catálogo de scopes y política de compatibilidad.
- [SDK de Oportunidades (JavaScript y Python)](https://os.utilia.ai/dashboard/docs/integrar-sdk/oportunidades-sdk): Ejemplos de uso de las cinco operaciones nuevas del módulo Oportunidades expuestas en los SDKs oficiales utilia-os/sdk-js v2.10.0 y utilia-sdk (Python) v2.10.0.

## Integrar: MCP

- [Quickstart MCP integraciones (10 minutos)](https://os.utilia.ai/dashboard/docs/integrar-mcp/mcp-quickstart): Guía rápida para integrar tu aplicación con UTILIA OS usando los SDKs MCP de JavaScript y Python, desde la instalación hasta la primera entrega de webhook.
- [Referencia MCP integraciones](https://os.utilia.ai/dashboard/docs/integrar-mcp/mcp-reference): Catálogo completo de las cuatro herramientas MCP del dominio integraciones (apps, credenciales, ajustes de organización y vista 360°).
- [Tool MCP tickets](https://os.utilia.ai/dashboard/docs/integrar-mcp/mcp-tickets): Referencia de la tool MCP tickets: listar, consultar y crear tickets de soporte interno con contrato completo, scopes OAuth y ejemplos en JavaScript y Python.
- [Migración MCP integraciones v1 → v2](https://os.utilia.ai/dashboard/docs/integrar-mcp/mcp-migracion-v1-v2): Cambios introducidos por el rediseño MCP integraciones, equivalencias entre la tool legacy y la nueva, y calendario de deprecación del wrapper.
- [Herramienta MCP ai_studio](https://os.utilia.ai/dashboard/docs/integrar-mcp/mcp-herramientas-ai-studio): Referencia de la herramienta MCP ai_studio: las operaciones disponibles, parámetros y la retrocompatibilidad con la antigua ai_prompts.

## Integrar: OAuth y Sign In

- [OAuth Overview](https://os.utilia.ai/dashboard/docs/integrar-oauth/oauth-overview): Servidor OAuth 2.1 de UTILIA OS: flujo completo con PKCE, OIDC, Dynamic Registration y Resource Binding
- [Quickstart: Tu primer token en 5 minutos](https://os.utilia.ai/dashboard/docs/integrar-oauth/oauth-quickstart): Obtiene un access token de UTILIA en 5 minutos con OAuth 2.1 y PKCE, paso a paso y sin salir de esta página
- [OAuth Discovery](https://os.utilia.ai/dashboard/docs/integrar-oauth/oauth-discovery): Endpoints .well-known para descubrimiento automático del servidor de autorización y recursos protegidos
- [OAuth Authorization Flow](https://os.utilia.ai/dashboard/docs/integrar-oauth/oauth-authorize-flow): Flujo completo de autorización con PKCE en UTILIA OS: solicitud GET, decisión del usuario, parámetros OIDC soportados (prompt, login_hint, nonce, resource) y comportamiento real de cada uno
- [Token, Revocación e Introspección](https://os.utilia.ai/dashboard/docs/integrar-oauth/oauth-token-revoke-introspect): Intercambio de authorization code por tokens, renovación con refresh token, revocación e introspección
- [Rotación de refresh tokens](https://os.utilia.ai/dashboard/docs/integrar-oauth/oauth-refresh-rotation): Cómo adaptar su integración a la rotación obligatoria del refresh token y la detección de reuso introducidas en abril de 2026
- [Scopes y Recursos](https://os.utilia.ai/dashboard/docs/integrar-oauth/oauth-scopes-recursos): Referencia completa de scopes OAuth, bundles de conveniencia y filtrado por recurso protegido
- [OIDC Scopes y Claims](https://os.utilia.ai/dashboard/docs/integrar-oauth/oauth-oidc-scopes-claims): Referencia técnica de scopes OpenID Connect, claims del ID token y endpoints de descubrimiento
- [Pantalla de Consentimiento](https://os.utilia.ai/dashboard/docs/integrar-oauth/oauth-ui-consent): Cómo funciona la UI de consentimiento OAuth: componentes, agrupación de permisos y comportamiento para desarrolladores
- [RP-Initiated Logout (OIDC)](https://os.utilia.ai/dashboard/docs/integrar-oauth/oauth-logout): Cierre de sesión iniciado por el cliente OAuth. Revoca tokens del usuario para ese cliente y redirige a post_logout_redirect_uri
- [Troubleshooting OAuth](https://os.utilia.ai/dashboard/docs/integrar-oauth/oauth-troubleshooting): Solución a problemas comunes al integrar con el servidor OAuth de UTILIA OS
- [Panel de Aplicaciones OAuth](https://os.utilia.ai/dashboard/docs/integrar-oauth/oauth-panel-apps): Guía para crear y gestionar aplicaciones OAuth desde el panel de UTILIA OS
- [Branding Kit y Botones](https://os.utilia.ai/dashboard/docs/integrar-oauth/oauth-branding-botones): Logos, colores, tipografía y código listo para copiar del botón Iniciar sesión con UTILIA
- [Sign In con Next.js](https://os.utilia.ai/dashboard/docs/integrar-oauth/oauth-sign-in-nextjs): Guía paso a paso para implementar inicio de sesión con UTILIA en una aplicación Next.js usando Auth.js
- [Sign In con Flask](https://os.utilia.ai/dashboard/docs/integrar-oauth/oauth-sign-in-flask): Guía paso a paso para implementar inicio de sesión con UTILIA en una aplicación Flask usando Authlib
- [Sign In con SDK JS](https://os.utilia.ai/dashboard/docs/integrar-oauth/oauth-sign-in-sdk-js): Guía para implementar inicio de sesión con UTILIA usando el SDK JavaScript v1.8.0
- [Sign In con SDK Python](https://os.utilia.ai/dashboard/docs/integrar-oauth/oauth-sign-in-sdk-python): Guía para implementar inicio de sesión con UTILIA usando el SDK Python v0.7.0
- [Changelog OAuth e Integraciones](https://os.utilia.ai/dashboard/docs/integrar-oauth/oauth-changelog): Historial de cambios del servidor OAuth 2.1, la API externa, los SDK y el widget de UTILIA OS: breaking changes, deprecaciones, novedades, refuerzos de seguridad y límites de uso
- [Mantenimiento y Release Checklist](https://os.utilia.ai/dashboard/docs/integrar-oauth/mantenimiento-y-release-checklist): Documentación técnica para mantenimiento-y-release-checklist

## Integrar: Widget

- [Widget Overview](https://os.utilia.ai/dashboard/docs/integrar-widget/widget-overview): Widget embebible de soporte basado en Web Components con Shadow DOM
- [Widget CDN Script Tag](https://os.utilia.ai/dashboard/docs/integrar-widget/widget-cdn-script-tag): Integración del widget mediante CDN con un script tag y data attributes
- [Widget por npm y React](https://os.utilia.ai/dashboard/docs/integrar-widget/widget-npm-react): Instala @utilia-os/widget por npm e inicialízalo programáticamente desde una SPA o React, con la tabla completa de WidgetConfig y un ejemplo de integración con useEffect.
- [Widget Web Component](https://os.utilia.ai/dashboard/docs/integrar-widget/widget-web-component): Uso del widget como Web Component personalizado utilia-support
- [Widget Eventos y Callbacks](https://os.utilia.ai/dashboard/docs/integrar-widget/widget-eventos-y-callbacks): Documentación técnica para widget-eventos-y-callbacks
- [Widget Estilos CSS Vars](https://os.utilia.ai/dashboard/docs/integrar-widget/widget-estilos-css-vars): Documentación técnica para widget-estilos-css-vars
- [Widget Troubleshooting](https://os.utilia.ai/dashboard/docs/integrar-widget/widget-troubleshooting): Diagnóstico y solución de problemas comunes del widget embebible

## Integrar: Captación de leads

- [Captación de Leads](https://os.utilia.ai/dashboard/docs/integrar-captacion-leads/introduccion): Visión general del sistema de captación de leads en UTILIA OS
- [Form Builder](https://os.utilia.ai/dashboard/docs/integrar-captacion-leads/form-builder): Guía del constructor visual de formularios no-code para captación de leads
- [Tipos de Campo](https://os.utilia.ai/dashboard/docs/integrar-captacion-leads/tipos-de-campo): Referencia técnica de los tipos de campo del Form Builder, incluido el campo consent de consentimiento RGPD obligatorio (art. 13)
- [Personalización y Estilos](https://os.utilia.ai/dashboard/docs/integrar-captacion-leads/personalizacion-estilos): Referencia de opciones de personalización visual para formularios de captación
- [API Pública de Formularios](https://os.utilia.ai/dashboard/docs/integrar-captacion-leads/endpoints-formularios-publicos): Endpoints públicos del widget de formularios: configuración, envío con validación de consentimiento (400 CONSENT_REQUIRED), límite de 10 envíos por minuto por IP, vistas y errores.
- [API de Formularios (Admin)](https://os.utilia.ai/dashboard/docs/integrar-captacion-leads/endpoints-lead-forms): Documentación de los endpoints de administración de formularios de captación
- [Estadísticas de Formularios](https://os.utilia.ai/dashboard/docs/integrar-captacion-leads/estadisticas-formularios): Métricas de rendimiento y conversión de los formularios de captación
- [API de Leads](https://os.utilia.ai/dashboard/docs/integrar-captacion-leads/api-leads): Documentación completa del endpoint POST /v1/leads para crear leads vía API
- [Widget Embebible](https://os.utilia.ai/dashboard/docs/integrar-captacion-leads/widget-embebible): Guía para embeber formularios de captación en sitios web externos

## Integrar: novedades

- [Versionado API Externa](https://os.utilia.ai/dashboard/docs/integrar-changelog/versionado-api-externa): Documentación técnica para versionado-api-externa
- [Changelog Integraciones](https://os.utilia.ai/dashboard/docs/integrar-changelog/changelog-integraciones): Historial de cambios y versiones de la API externa, SDKs y widget de UTILIA OS
- [Roadmap: fases futuras](https://os.utilia.ai/dashboard/docs/integrar-changelog/ai-studio-fases-futuras): Qué queda fuera de la primera versión de AI Studio y qué se incorporará en las fases 2, 3 y 4.

## API y servidores MCP

- API interna del dashboard: base `https://os.utilia.ai/api`
- API externa para integradores: base `https://os.utilia.ai/api/external/v1` (autenticación por API Key con cabecera `X-Api-Key`, o por OAuth 2.1)
- Servidor MCP CRM `utilia-crm`: clientes, contactos, leads, oportunidades, presupuestos, facturas, tareas, interacciones, proyectos, calendario, tickets, archivos y ajustes
- Servidor MCP Trabajo `utilia-work`: issues, proyectos, sprints, documentación, horas y perfil de trabajo
- Servidor MCP Finanzas `utilia-finance`: tesorería, contabilidad, impuestos y fiscal
- Servidor MCP Marketing: campañas, audiencias, automatizaciones y entregabilidad