> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tess.im/llms.txt
> Use this file to discover all available pages before exploring further.

# Cómo crear y compartir un Artifact

> Genera informes, dashboards y presentaciones en el chat, revisa las versiones y compártelos con personas y equipos según la política de la empresa.

Esta guía muestra cómo generar un Artifact en el chat de Tess, revisar sus versiones y compartirlo con las personas correctas. Para la visión general de la función y las reglas de gobernanza, consulta [Artifacts](https://docs.tess.im/es/html-artifacts.md).

> [!NOTE]
>
> La creación de Artifacts depende del plan y del rol. Sin ese permiso, el chat responde en texto y no genera la página.

**1. Genera el Artifact**

En el chat, describe el entregable: público, formato, estructura y datos. Pega o adjunta los datos que deben aparecer en la página.

```text theme={null}
Crea un informe ejecutivo de pipeline para la dirección.
Estructura: tres indicadores arriba (pipeline abierto, comprometido
y perdido, con la variación frente a la semana anterior); tabla de
oportunidades por encima de $50 mil con responsable, etapa y fecha
prevista; al final, hasta cinco puntos que requieren decisión.
Datos: [pega la tabla o adjunta el archivo].
```

El Artifact se abre en el panel junto al chat como v1.

**2. Revisa y ajusta**

Pide cambios en el chat, de forma objetiva:

```text theme={null}
Corrige la variación del comprometido a +12% y mueve la tabla
antes de los indicadores.
```

Para cambiar una parte específica, usa **Seleccionar elemento** en el menú del panel (en modo de vista previa), haz clic en el elemento y describe el cambio. Cada cambio guardado crea una nueva versión. El dueño alterna entre **Vista previa** y **Código**.

**3. Gestiona las versiones**

En **Versiones**, cada fila indica **Últimos** (versión más reciente), **Compartida** (versión que ve el público) y **Viendo** (versión en pantalla). Puedes previsualizar versiones anteriores, **Restaurar** una como nueva versión o usar **Compartir esta versión**.

En **Eliminar**, en el menú del panel, elige entre **Eliminar solo esta versión** y **Eliminar todas las versiones**. Con una sola versión, la opción es eliminar el Artifact. Eliminar el Artifact termina todos los accesos compartidos. La eliminación también depende del permiso de eliminación de contenido del workspace.

**4. Comparte**

En **Compartir**:

* **Añadir personas**: busca por nombre o correo entre los miembros del workspace y, si existe, de la organización.
* **Equipos**: equipos de los que participas.
* **Acceso general**: **Todos en este espacio de trabajo** o **Cualquier persona con el enlace** (usuarios con sesión en Tess, incluso fuera de la organización).
* **Copiar link**: la dirección para enviar al público.

El primer uso compartido libera la versión actual. Después, las nuevas ediciones no llegan a quien recibió el acceso hasta que hagas clic en **Compartir vN**. Los gestores con el permiso Artifacts Manager pueden ver la versión más reciente. La confirmación es **Última versión compartida**.

**5. Presenta, exporta o profundiza**

En la página del Artifact (la que abre el enlace), **Presentar** abre en pantalla completa, **Descargar** guarda el HTML e **Imprimir** está en el menú. **Iniciar chat** abre una nueva conversación con un pedido de resumen del Artifact ya completado, útil para que quien recibió el enlace haga preguntas.

## Uso compartido y gobernanza

Cada uso compartido sigue reglas definidas por la empresa, no por la persona que comparte. El administrador decide hasta dónde puede llegar cada Artifact, supervisa lo que circula y, con el permiso Artifacts Manager, puede retirar cualquier Artifact del workspace.

### Quién define el alcance

En la página de miembros, el administrador habilita los niveles de uso compartido por miembro y por equipo:

| Nivel | Alcance | Por defecto |
| - | - | - |
| Organización | Personas específicas de otros workspaces de la misma organización (solo cuando el workspace pertenece a una organización) | Habilitado |
| Workspace | Personas específicas o todos en este workspace | Habilitado |
| Equipos | Equipos de los que forma parte el dueño | Habilitado |
| Público | Cualquier persona con sesión en Tess, incluso fuera de la organización | Desactivado |

* **Precedencia:** primero vale la configuración del miembro. Sin ella, valen juntos los niveles de todos los equipos activos de la persona; un equipo sin configuración propia cuenta como la configuración por defecto. Sin ninguna, vale la configuración por defecto.
* **Bloqueo total:** una configuración de miembro sin niveles desactiva el uso compartido para esa persona. Para bloquear a alguien, configura el miembro: una restricción de equipo no vale si la persona está en otro equipo con más niveles.
* **En la pantalla de compartir:** los niveles no habilitados aparecen desactivados, con la indicación de pedirlos al administrador.

### Lo que garantiza la plataforma

* **Solo miembros:** solo puedes añadir miembros activos del workspace o de la organización. Nadie externo aparece en la búsqueda, ni siquiera por correo exacto. La única forma de llegar a alguien externo es **Hacer público**, si la política lo permite.
* **Las restricciones valen al instante:** cuando el administrador reduce los niveles de un miembro o equipo, el acceso fuera de la nueva regla se corta al instante y los accesos correspondientes se revocan automáticamente. Cuando el cambio quita un nivel, la pantalla pide confirmación antes de guardar.
* **Acceso verificado en cada apertura:** quien sale del workspace o del equipo pierde el acceso al instante, sin acción manual. La excepción es el enlace abierto, que vale para cualquier persona con sesión en Tess.
* **Sin exposición en internet:** incluso el enlace público exige iniciar sesión en Tess. Las páginas no se indexan en buscadores y no pueden incrustarse en otros sitios.
* **El público ve solo la versión aprobada:** quien recibe el enlace nunca ve borradores ni la pestaña Código. Puede descargar el HTML de la versión compartida, así que incluye en la página solo lo que ese público puede ver.

### Supervisión

* En **Configuración > Artefactos**, los gestores con el permiso Artifacts Manager filtran por persona, ven el estado de cada Artifact (privado, compartido o publicado) y abren cualquiera de ellos.
* El gestor puede despublicar uno o varios a la vez. La despublicación elimina todos los accesos, y el dueño no puede publicar ese Artifact de nuevo.
* Las aperturas de los gestores quedan registradas en la auditoría como un evento propio, separado de las visualizaciones comunes (uno por gestor por día en cada Artifact).

### Registro de auditoría

En el plan Enterprise, los [Eventos de Auditoría](https://docs.tess.im/es/audit-events.md) registran el ciclo de vida de cada Artifact. El SIEM de la empresa puede recoger estos eventos por la API:

* creación, edición, cambio de nombre, restauración y eliminación de versiones y del Artifact;
* publicación y despublicación, indicando si despublicó el dueño o un gestor;
* cada acceso concedido y revocado; cuando la revocación viene de una despublicación o de una reducción de la política, el evento trae el motivo (dueño, gestor o política);
* visualizaciones (una por persona por día por Artifact) y aperturas de gestores;
* cambios en las restricciones de uso compartido de miembros y equipos, con el antes y el después.

Los eventos identifican quién hizo la acción. Los destinos de uso compartido aparecen por ID interno, y los eventos no incluyen el título del Artifact ni el correo de quien recibió el acceso.

### Revocar accesos

Para revocar el acceso de una persona o equipo, usa **Eliminar** en la lista de accesos. Desactivar **Todos en este espacio de trabajo** o **Cualquier persona con el enlace** revoca ese alcance. Para retirar todo de una vez, selecciona el Artifact en **Configuración > Artefactos** y usa **Despublicar**.

## Ejemplos de pedidos por área

> [tab] Ventas
>
> ```text theme={null}
> Crea un dashboard del embudo de ventas del mes: cuatro indicadores
> arriba, embudo por etapa y filtro por equipo comercial.
> Datos: [pega o adjunta].
> ```

> [tab] Finanzas
>
> ```text theme={null}
> Crea un informe de cierre mensual con ingresos, gastos y margen
> por unidad de negocio, comparado con el presupuesto y destacando
> las desviaciones superiores al 5%. Datos: [pega o adjunta].
> ```

> [tab] Liderazgo
>
> ```text theme={null}
> Convierte este informe en una presentación de ocho diapositivas
> para el directorio. Un tema por diapositiva. La última muestra
> las decisiones que necesitamos aprobar.
> ```

> [tab] RR. HH. y Comunicación
>
> ```text theme={null}
> Crea un comunicado interno sobre la nueva política de trabajo
> híbrido: qué cambia, desde cuándo, a quién afecta y a quién
> consultar en caso de dudas.
> ```

> [tab] Comercial
>
> ```text theme={null}
> Crea una propuesta de una página para el cliente [nombre]: contexto,
> alcance de los primeros 90 días, qué queda fuera del alcance,
> inversión y próximos pasos.
> ```

## Buenas prácticas

* **Comparte la versión aprobada.** Revisa antes de usar **Compartir vN**. Hasta entonces, el público sigue en la versión anterior.
* **Prefiere equipos y workspace al enlace abierto** para contenido interno.
* **Mantén un único Artifact para materiales recurrentes.** Pide la actualización en el mismo Artifact para conservar el enlace y el historial.
* **Incluye solo los datos que el público puede ver.** Quien tiene acceso ve todo el contenido de la página.
* **Pide el formato de archivo cuando el destino lo exija.** Para PowerPoint, Word, PDF o Excel, solicita el formato en el chat.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.