> ## 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.

# Como criar e compartilhar um Artifact

> Gere relatórios, dashboards e apresentações no chat, revise as versões e compartilhe com as pessoas e equipes certas, dentro das políticas da empresa.

Este guia mostra como gerar um Artifact no chat da Tess, revisar as versões e compartilhar com as pessoas certas. Para a visão geral do recurso e das regras de governança, veja [Artifacts](https://docs.tess.im/pt/html-artifacts.md).

> [!NOTE]
>
> A criação de Artifacts depende do plano e do papel. Sem essa permissão, o chat responde em texto e não gera a página.

**1. Gere o Artifact**

No chat, descreva o entregável: público, formato, estrutura e dados. Cole ou anexe os dados que devem aparecer na página.

```text theme={null}
Crie um relatório executivo de pipeline para a diretoria.
Estrutura: três indicadores no topo (pipeline aberto, comprometido
e perdido, com variação contra a semana anterior); tabela das
oportunidades acima de R$ 50 mil com responsável, estágio e data
prevista; ao final, até cinco pontos que exigem decisão.
Dados: [cole a tabela ou anexe o arquivo].
```

O Artifact abre no painel ao lado do chat como v1.

**2. Revise e ajuste**

Peça alterações no chat, de forma objetiva:

```text theme={null}
Corrija a variação do comprometido para +12% e coloque a tabela
antes dos indicadores.
```

Para alterar um trecho específico, use **Selecionar elemento** no menu do painel (no modo de pré-visualização), clique no elemento e descreva a mudança. Cada alteração salva gera uma nova versão. O dono alterna entre **Pré-visualização** e **Código**.

**3. Gerencie as versões**

Em **Versões**, cada linha indica **Últimos** (versão mais recente), **Compartilhada** (versão que o público vê) e **Visualizando** (versão em tela). Você pode visualizar versões anteriores, **Restaurar** uma delas como nova versão ou usar **Compartilhar esta versão**.

Em **Excluir**, no menu do painel, escolha entre **Excluir somente esta versão** e **Excluir todas as versões**. Com uma única versão, a opção é excluir o Artifact. Excluir o Artifact encerra todos os compartilhamentos. A exclusão também depende da permissão de exclusão de conteúdo do workspace.

**4. Compartilhe**

Em **Compartilhar**:

* **Adicionar pessoas**: busca por nome ou e-mail entre membros do workspace e, se houver, da organização.
* **Equipes**: equipes das quais você participa.
* **Acesso geral**: **Todos neste workspace** ou **Qualquer pessoa com o link** (usuários autenticados na Tess, inclusive fora da organização).
* **Copiar link**: endereço para enviar ao público.

O primeiro compartilhamento libera a versão atual. Depois disso, novas edições não chegam a quem recebeu o compartilhamento até que você clique em **Compartilhar vN**. Gestores com a permissão Artifacts Manager conseguem ver a versão mais recente. A confirmação exibida é **Última versão compartilhada**.

**5. Apresente, exporte ou aprofunde**

Na página do Artifact (a que abre pelo link), **Apresentar** abre em tela cheia, **Baixar** salva o HTML e **Imprimir** está no menu. **Iniciar chat** abre uma nova conversa com um pedido de resumo do Artifact já preenchido, útil para quem recebeu o link tirar dúvidas.

## Compartilhamento e governança

Cada compartilhamento segue regras definidas pela empresa, não pela pessoa que compartilha. O administrador decide até onde cada Artifact pode chegar, acompanha o que está circulando e, com a permissão Artifacts Manager, pode retirar do ar qualquer Artifact do workspace.

### Quem define o alcance

Na página de membros, o administrador libera os níveis de compartilhamento por membro e por equipe:

| Nível | Alcance | Padrão |
| - | - | - |
| Organização | Pessoas específicas de outros workspaces da mesma organização (só existe quando o workspace pertence a uma organização) | Liberado |
| Workspace | Pessoas específicas ou todos neste workspace | Liberado |
| Equipes | Equipes das quais o dono participa | Liberado |
| Público | Qualquer pessoa logada na Tess, inclusive fora da organização | Desativado |

* **Precedência:** a configuração do membro vale primeiro. Sem ela, valem juntos os níveis de todas as equipes ativas da pessoa; uma equipe sem configuração própria conta como o padrão. Sem nenhuma das duas, vale o padrão.
* **Bloqueio total:** uma configuração de membro sem níveis desativa o compartilhamento para aquela pessoa. Para bloquear alguém, configure o membro: uma restrição de equipe não vale se a pessoa estiver em outra equipe com mais níveis.
* **Na tela de compartilhamento:** níveis não liberados aparecem desativados, com a orientação para pedir a liberação ao administrador.

### O que a plataforma garante

* **Só membros entram:** só é possível adicionar membros ativos do workspace ou da organização. Ninguém de fora é encontrado na busca, nem por e-mail exato. Para alcançar alguém externo, apenas **Tornar público**, se a política permitir.
* **Restrições valem na hora:** ao reduzir os níveis de um membro ou de uma equipe, o acesso fora da nova regra é cortado na hora e os compartilhamentos correspondentes são revogados automaticamente. Quando a mudança remove um nível, a tela pede confirmação antes de salvar.
* **Acesso conferido a cada abertura:** quem sai do workspace ou da equipe perde o acesso imediatamente, sem ação manual. A exceção é o link aberto, que vale para qualquer pessoa logada na Tess.
* **Sem exposição na internet:** mesmo o link público exige login na Tess. As páginas não são indexadas por buscadores e não podem ser incorporadas em outros sites.
* **Público vê só a versão aprovada:** quem recebe o link nunca vê rascunhos nem a aba Código. Ele pode baixar o HTML da versão compartilhada, então inclua na página apenas o que esse público pode ver.

### Supervisão

* Em **Configurações > Artefatos**, gestores com a permissão Artifacts Manager filtram por pessoa, veem o status de cada Artifact (privado, compartilhado ou publicado) e abrem qualquer um deles.
* O gestor pode despublicar um ou vários de uma vez. A despublicação remove todos os acessos, e o dono não consegue publicar aquele Artifact de novo.
* As aberturas feitas por gestores ficam registradas na auditoria como um evento próprio, separado das visualizações comuns (um por gestor por dia em cada Artifact).

### Trilha de auditoria

No plano Enterprise, os [Eventos de Auditoria](https://docs.tess.im/pt/audit-events.md) registram o ciclo de vida de cada Artifact. O SIEM da empresa pode coletar esses eventos pela API:

* criação, edição, renomeação, restauração e exclusão de versões e do Artifact;
* publicação e despublicação, indicando se a despublicação foi do dono ou de um gestor;
* cada acesso concedido e revogado; quando a revogação vem de uma despublicação ou de uma redução de política, o evento traz o motivo (dono, gestor ou política);
* visualizações (uma por pessoa por dia por Artifact) e aberturas feitas por gestores;
* mudanças nas restrições de compartilhamento de membros e equipes, com o antes e o depois.

Os eventos identificam quem fez a ação. Os destinos de compartilhamento aparecem por ID interno, e os eventos não incluem o título do Artifact nem o e-mail de quem recebeu o acesso.

### Revogar acessos

Para revogar o acesso de uma pessoa ou equipe, use **Remover** na lista de acessos. Desativar **Todos neste workspace** ou **Qualquer pessoa com o link** revoga esse alcance. Para tirar tudo do ar de uma vez, selecione o Artifact em **Configurações > Artefatos** e use **Despublicar**.

## Exemplos de pedidos por área

> [tab] Vendas
>
> ```text theme={null}
> Crie um dashboard do funil de vendas do mês: quatro indicadores no
> topo, funil por estágio e filtro por equipe comercial.
> Dados: [cole ou anexe].
> ```

> [tab] Finanças
>
> ```text theme={null}
> Crie um relatório de fechamento mensal com receita, despesas e
> margem por unidade de negócio, comparando com o orçamento e
> destacando os desvios acima de 5%. Dados: [cole ou anexe].
> ```

> [tab] Liderança
>
> ```text theme={null}
> Transforme este relatório em uma apresentação de oito slides para
> o conselho. Um tema por slide. O último slide traz as decisões
> que precisamos aprovar.
> ```

> [tab] RH e Comunicação
>
> ```text theme={null}
> Crie um comunicado interno sobre a nova política de trabalho
> híbrido: o que muda, a partir de quando, quem é impactado e a
> quem recorrer em caso de dúvida.
> ```

> [tab] Comercial
>
> ```text theme={null}
> Crie uma proposta de uma página para o cliente [nome]: contexto,
> escopo dos primeiros 90 dias, o que está fora do escopo,
> investimento e próximos passos.
> ```

## Boas práticas

* **Compartilhe a versão aprovada.** Revise antes de usar **Compartilhar vN**. Até lá, o público continua na versão anterior.
* **Prefira equipes e workspace ao link aberto** para conteúdo interno.
* **Mantenha o mesmo Artifact para materiais recorrentes.** Peça a atualização no próprio Artifact para preservar o link e o histórico.
* **Inclua apenas os dados que o público pode ver.** Quem tem acesso vê todo o conteúdo da página.
* **Peça o formato do arquivo quando o destino exigir.** Para PowerPoint, Word, PDF ou Excel, solicite o formato no chat.


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