# La ficha de tu aplicación Cada campo de la ficha del catálogo y para qué sirve: presentación, imágenes, permisos, conexión, datos y privacidad, soporte y legal, y precio. La ficha es lo que ve una empresa antes de instalar tu aplicación y lo que acepta, en la práctica, al instalarla: qué hace, qué podrá hacer con sus datos, quién la ha hecho, qué datos guarda y cuánto cuesta. Cada campo tiene un porqué, y la revisión comprueba que lo que dice es verdad. ## Dónde se prepara En la [consola de desarrolladores](https://os.utilia.ai/docs/developers/console/overview), abre la aplicación en **Aplicaciones**. Si aún no tiene ficha, la pestaña **Ficha** te ofrece **Crear la ficha**. Después la ficha se reparte en tres pestañas: - **Ficha**: presentación, imágenes, permisos, datos y privacidad, soporte y legal, y lo que lee quien la revisa. Al final está la lista **Antes de enviar**. - **Precio**: el modelo de precio y, si es de pago, sus planes. - **Conexión**: adónde mandamos a quien instala y qué avisos recibe tu servidor. Cada sección dice «Completa» o cuánto le falta, y lo que escribes se guarda solo. Tu dominio y tus datos fiscales no son de la ficha, sino de tu cuenta: están en **Cuenta › Dominio** y **Cuenta › Datos fiscales**. Lo que publicas es siempre una **versión** revisada. Si cambias algo de una ficha ya publicada, preparas la versión siguiente mientras la publicada sigue disponible. Cómo funcionan las versiones está en [Versiones de la ficha y cambios de permisos](https://os.utilia.ai/docs/developers/apps-platform/publish-and-update). ## Presentación | Nombre | Tipo | Obligatorio | Descripción | | - | - | - | - | | `Nombre` | `hasta 60 caracteres` | Sí | El de tu aplicación, tal como lo verán las empresas. Con tu propia marca: un nombre o un icono que se confunda con UTILIA OS se rechaza. | | `Frase corta` | `hasta 120 caracteres` | Sí | Lo que hace, en una línea. Sale en las tarjetas de Explorar y es lo que decide si alguien abre tu ficha. | | `Descripción` | `hasta 4.000 caracteres` | Sí | Qué resuelve, para quién es y qué hace con UTILIA OS. Sin promesas que la aplicación no cumpla hoy: es lo que comprueba la revisión. | | `Categoría` | `una` | Sí | Dónde la buscarán en Explorar: Productividad, Ventas y CRM, Desarrollo, Finanzas, Marketing, Atención al cliente, Análisis, Automatización, Documentación, Comunicación, Inteligencia artificial u Otras. | | `Visibilidad` | `Pública o Solo con el enlace` | Sí | Quién la encuentra. Ver la comparación de abajo. | **Dos visibilidades, la misma revisión** ### Pública (En Explorar) Cualquier empresa de UTILIA OS la encuentra en Explorar y en su buscador. ### Solo con el enlace (Para tus clientes o tus pruebas) No aparece en Explorar ni en el buscador. La instala quien tenga el enlace de la ficha, que lleva un sufijo aleatorio. No es secreta: quien tenga el enlace puede instalarla. ## Imágenes Un icono y de una a cinco capturas, todas con su descripción para quien no puede verlas. **Límites de las imágenes** - Icono: De 256 a 2.048 px. Cuadrado y hasta 1 MB. - Capturas por ficha: De 1 a 5. Cada una con su descripción, hasta 250 caracteres. - Lado de una captura: De 640 a 4.096 px. El menor, al menos 640; ninguno, más de 4.096. Hasta 5 MB. - Formatos: PNG, JPEG o WebP. Nunca SVG. El tipo se comprueba por el contenido del archivo, no por su extensión, y cada imagen se vuelve a codificar sin sus metadatos: una captura hecha con el móvil puede llevar la ubicación, y no sale de aquí. Después pasa el antivirus: mientras tanto se ve **Revisándose**, y si no lo supera, «No ha pasado la revisión de seguridad. Sube otra.». Una ficha guarda como mucho 30 imágenes entre todas sus versiones; quita las que ya no uses. Las capturas tienen que ser de tu aplicación funcionando y leerse: una ilustración de marketing no vale como captura. ## Permisos Los permisos de la API que pedirá a cada empresa, cada uno con su **Para qué**, una frase de hasta 280 caracteres que la empresa lee antes de instalar. Solo se pueden pedir los de la [lista cerrada del catálogo](https://os.utilia.ai/docs/developers/apps-platform/permissions), y hace falta al menos uno. ## Conexión | Nombre | Tipo | Obligatorio | Descripción | | - | - | - | - | | `Dirección de instalación` | `HTTPS, en tu dominio` | Sí | Adonde mandamos a quien instala, con un código de un solo uso que tu servidor canjea por sus credenciales. Ver La instalación y el canje del código. | | `Dirección de avisos` | `HTTPS, en tu dominio` | No | Adonde llegan los avisos de las empresas que la instalan. Obligatoria si eliges algún aviso. Sin ella no recibes ni los del ciclo de vida. | | `Avisos que recibirá` | `lista` | No | Los eventos que quieres de cada instalación. Instalar, desinstalar, los cambios de permisos y la suspensión llegan siempre. Cada empresa te manda solo los que cubren los permisos que te concede. | La dirección de instalación, la de avisos y la web tienen que estar en tu dominio verificado o en un subdominio suyo, para que nadie publique una ficha que lleve a otro sitio. El dominio se verifica una vez, en **Cuenta › Dominio**, con un registro TXT en tu proveedor de dominio. Qué recibe cada una está en [La instalación y el canje del código](https://os.utilia.ai/docs/developers/apps-platform/installation-and-exchange) y en [Avisos de cada instalación](https://os.utilia.ai/docs/developers/apps-platform/webhooks). ## Datos y privacidad Al instalar tu aplicación, la empresa te encarga el tratamiento de sus datos: ella decide y tú tratas los datos por su cuenta. Por eso, antes de instalar, ve qué datos guardas, para qué, cuánto tiempo y dónde. - **¿Guarda datos personales de las empresas?** «No» si solo los usas mientras trabajas y no guardas copia. Si es que sí: - **Qué datos guarda**: clientes, contactos, personas del equipo, facturas, presupuestos, tickets de soporte, citas del calendario, mensajes del chat u otro tipo de dato que escribas. - **Para qué**, en una frase, por ejemplo «enviar recordatorios de citas». - **Cuánto tiempo**, por ejemplo «mientras esté instalada y 30 días después». - **Dónde los guarda**: en el Espacio Económico Europeo; fuera, en un país que la Comisión Europea reconoce como seguro; o fuera, con garantías por contrato. Si es fuera, en qué países y con qué **garantía legal** (decisión de adecuación, Marco de Privacidad de Datos UE-EE. UU., cláusulas contractuales tipo o normas corporativas vinculantes). - **Contrato de encargo**: la dirección del contrato que firma la empresa contigo como encargado del tratamiento. - **¿Usa inteligencia artificial?** Si algo de lo que hace lo genera un modelo de IA, márcalo y di de qué proveedores (OpenAI, Anthropic, Google, Mistral AI u otro; hasta diez). La ficha lo enseña con su logotipo. La empresa ve esto en la ficha y otra vez en la hoja de instalación, junto a «Acme es una empresa independiente de UTILIA…». Ocultar un uso de IA o un país es motivo para pedir cambios o rechazar la ficha. ## Soporte y legal | Nombre | Tipo | Obligatorio | Descripción | | - | - | - | - | | `Web` | `HTTPS, en tu dominio` | Sí | La de tu aplicación o tu empresa. Sale como «Web de Acme». | | `Documentación` | `HTTPS` | No | Dónde aprender a usarla. | | `Soporte` | `correo o dirección HTTPS` | Sí | Basta con uno de los dos. Sale como «Soporte de Acme», antes que «Denunciar esta aplicación», para que un problema de funcionamiento llegue a ti y no acabe en una denuncia. | | `Política de privacidad` | `HTTPS` | Sí | Cómo tratas los datos, también los de las cuentas que las personas creen en tu servicio. | | `Condiciones de uso` | `HTTPS` | Sí | Las que rigen tu relación con cada empresa. | | `Contacto de seguridad` | `correo` | Sí | Te escribiremos aquí si hay un problema de seguridad. Tiene que responder. | Todas las direcciones van por HTTPS y sin usuario ni contraseña dentro. La documentación, el soporte y los textos legales pueden estar en un servicio de terceros; la web, no. ## Precio En la pestaña **Precio** eliges uno de tres modelos: **Gratis**, **Necesita cuenta en tu servicio**, con la **Dirección de tu servicio** donde la empresa crea su cuenta o ve tus planes, o **De pago en UTILIA**, con sus planes. La ficha lo enseña a cada empresa antes de instalar, y deja claro que va aparte de lo que paga a UTILIA por su plan. Los modelos, los planes y sus límites están en [Modelos de precio y planes](https://os.utilia.ai/docs/developers/pricing-and-payouts/pricing). ## Revisión | Nombre | Tipo | Obligatorio | Descripción | | - | - | - | - | | `Novedades de esta versión` | `hasta 1.000 caracteres` | No | Lo que cambia respecto a la versión publicada. Lo leen las empresas que la tienen instalada. | | `Notas para la revisión` | `hasta 2.000 caracteres` | No | Cómo probarla y, si hace falta, una cuenta de prueba. Solo las ve UTILIA. | Antes de enviar, un control busca en los textos de la ficha cualquier cosa que parezca una clave, un token o una contraseña. Las **Notas para la revisión** no se analizan, porque son el sitio para una cuenta de prueba: que sea desechable y sin datos reales. ## La dirección de tu ficha La ficha tiene su propia dirección en el catálogo, que se propone a partir del nombre (`acme-recordatorios`) cuando la envías por primera vez. Si otra ficha ya la usa, se le añade un sufijo corto; si es «Solo con el enlace», un sufijo aleatorio de doce caracteres que no se puede adivinar. Esa dirección es la que compartes y la de tu botón **Instalar en UTILIA OS**: ver [Empezar desde tu web](https://os.utilia.ai/docs/developers/apps-platform/installation-and-exchange#empezar-desde-tu-web).