# Creadas por tu empresa Crea las aplicaciones que conectan vuestra web, vuestros programas o vuestro producto con UTILIA OS, y gestiona su ficha, sus claves y sus permisos. **Creadas por tu empresa** son las aplicaciones que conectan vuestra web, vuestros programas o vuestro propio producto con UTILIA OS. Cada una tiene su clave de API, sus permisos, su persona responsable y su ficha, donde se ve qué hace, si funciona y qué le falta. Las aplicaciones que habéis instalado del catálogo no están aquí, sino en [Instaladas](https://os.utilia.ai/docs/guides/integrations/installed). Si solo necesitas una clave para que un programa de tu empresa trabaje con vuestros datos, no hace falta una aplicación: usa una [clave de API](https://os.utilia.ai/docs/guides/security/api-keys). ## Antes de empezar Integraciones tiene que estar en el plan de tu empresa. Cada acción pide su permiso: **Creadas por tu empresa, de fábrica** | Acción | Super Administrador | Gerente | | - | - | - | | Ver la lista y la ficha de cada aplicación (Ver las aplicaciones externas) | Sí | Sí | | Crear una aplicación (Crear aplicaciones externas) | Sí | No | | Cambiar sus datos, dominios, permisos y avisos (Editar las aplicaciones creadas por la empresa) | Sí | No | | Renovar sus claves y cambiar su persona responsable (Gestionar las credenciales de las aplicaciones) | Sí | No | | Eliminarla, restaurarla y eliminarla definitivamente (Eliminar las aplicaciones creadas por la empresa) | Sí | No | El resto de roles no tiene ninguno de fábrica; se pueden conceder a cualquier persona desde [la gestión del equipo](https://os.utilia.ai/docs/guides/users-and-permissions/manage-team). ## Dónde está En **Ajustes › Creadas por tu empresa**, junto a Aplicaciones en el grupo Integraciones del menú de Ajustes. Las eliminadas quedan al final, plegadas. ## Crear una aplicación 1. **Pulsa Nueva aplicación** Está en la cabecera de **Creadas por tu empresa**. 2. **Dale un nombre** Todo lo demás se puede cambiar después. 3. **Marca para qué la usarás** En **¿Para qué la usarás?** puedes marcar **Tickets y soporte**, **Facturación y cobros** o **Datos del CRM**, varias o ninguna. Solo decide qué más te pregunta el formulario y qué permisos te propone al terminar. 4. **Crea la aplicación y guarda sus claves** Pulsa **Crear la aplicación**. Verás su clave de API y su clave de firma de los avisos, **una sola vez**: guárdalas en un sitio seguro, marca «He guardado las dos claves» y sigue los pasos de **Para empezar**. Toda aplicación nace **sin permisos**: hasta que se los concedes, su clave no puede hacer nada. ## La ficha de una aplicación Al abrir una aplicación ves su ficha, con su estado arriba y sus apartados en pestañas: **Ajustes › Creadas por tu empresa · Ficha de una aplicación** Pestañas: Resumen, Pruebas, Actividad, Dinero, Usuarios y Configuración. 1. El nombre de la aplicación y su estado: activa, desactivada o eliminada. 2. Resumen, Pruebas, Actividad, Dinero, Usuarios y Configuración. 3. Lo que le falta para funcionar y lo que ha pasado últimamente. 4. Desactivar, renovar claves, eliminar y el resto de acciones de la aplicación. _Las pestañas que no se aplican a tu aplicación no aparecen._ - **Resumen**: si funciona y qué le falta. - **Pruebas**: el diagnóstico de la aplicación, con cada problema y su arreglo, y las pruebas que puede lanzar quien la programa. - **Actividad**: **Métricas** de uso de la API y **Errores** de la aplicación. - **Dinero**: la **Facturación** de la aplicación y, si factura, sus **Facturas**, **Cobros**, **Suscripciones** y **Autorizaciones de cobro**. - **Usuarios**: las personas de vuestra aplicación que ha dado de alta en UTILIA OS. - **Configuración**: **Ajustes** (sus datos, dominios autorizados, el widget y sus **Permisos**), **Avisos a tu servidor** e **Inicio de sesión**. ## Permisos y persona responsable Los permisos de la API se conceden en **Configuración › Ajustes › Permisos**. Hay conjuntos ya preparados (como «Tickets y soporte») y permisos sueltos. Los que tocan datos personales críticos o mueven dinero solo los puede conceder un Super Administrador, con un motivo escrito. El catálogo de todos los permisos, con lo que abre cada uno, está en [Permisos de la API](https://os.utilia.ai/docs/developers/api/scopes). La aplicación actúa con los permisos de su **persona responsable**, nunca con más. Si esa persona deja la empresa o se bloquea, la aplicación deja de funcionar hasta que nombres a otra con **Cambiar la persona responsable**. ## Desactivar y eliminar - **Desactivar** la para del todo: sus llamadas se rechazan, pero sigue en la lista y se activa cuando quieras. - **Eliminar** la quita de la lista y deja de funcionar en el acto, pero no borra nada: se restaura desde **Eliminadas** y vuelve desactivada. - **Eliminar definitivamente** la borra para siempre, con lo que solo es suyo. Lo que la ley obliga a guardar (facturas, suscripciones, tickets, fichas del CRM, archivos) se queda. Antes te enseña qué se borra, qué se conserva y qué lo impide, y se confirma escribiendo su nombre. No se puede eliminar mientras cobra, con suscripciones activas o cobros programados pendientes. ## Publicarla para otras empresas Si una de vuestras aplicaciones puede servir a otras empresas, se publica en el catálogo desde la **consola de desarrolladores**, con una cuenta de desarrollador aparte de la de tu empresa. Ábrela y, en su menú, pulsa **Publicar en el catálogo de UTILIA OS** (hace falta el permiso «Publicar aplicaciones para otras empresas»). La consola prepara su ficha con su nombre, su logotipo, sus permisos y sus avisos, sin copiar ninguna clave, y la aplicación de tu empresa no cambia. Para eso, la consola se **vincula** con tu cuenta en la empresa, con tu consentimiento y tus permisos. Las vinculaciones de cada persona salen en «Cuentas de desarrollador vinculadas», en **Perfil › IA y aplicaciones**; un Super Administrador ve además las de toda la empresa en esta pantalla y puede retirarlas. La referencia técnica está en [Vincular la consola con tu empresa](https://os.utilia.ai/docs/developers/console/company-link). ## Si algo falla - **«No puedes ver las aplicaciones de tu empresa».** Te falta «Ver las aplicaciones externas»: pídeselo a quien administre UTILIA OS. - **Una aplicación del catálogo no se puede editar.** «Esta aplicación se instaló desde el catálogo y la gestiona Acme.»: la gestiona su desarrollador. Desde [Instaladas](https://os.utilia.ai/docs/guides/integrations/installed) puedes cambiar su persona responsable o desinstalarla. - **La clave responde que le falta un permiso.** Concédeselo en **Configuración › Ajustes › Permisos**. Si es uno protegido, lo hace un Super Administrador. Quien programa la aplicación tiene el detalle técnico de la ficha en [Panel de aplicaciones externas](https://os.utilia.ai/docs/developers/api/apps-panel) y sus primeros pasos en [Primeros 15 minutos con la API](https://os.utilia.ai/docs/developers/getting-started/quickstart).