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

# Compartilhar e publicar

> Quatro modos de compartilhar um dashboard: privado, público, protegido por senha ou restrito por e-mail.

# Compartilhar e publicar

Cada dashboard pode ser compartilhado em um de **quatro modos**, controlando quem pode ver os dados.

***

## Modos de compartilhamento

| Modo                       | Quem acessa                                       |
| -------------------------- | ------------------------------------------------- |
| **🔒 Privado**             | Apenas você e membros do workspace                |
| **🌐 Público**             | Qualquer pessoa com o link                        |
| **🔑 Protegido por senha** | Quem tiver o link e a senha                       |
| **✉️ Restrito por e-mail** | E-mails autorizados, com senha enviada por e-mail |

***

## Privado (padrão)

O dashboard só aparece dentro do painel para você e os membros do workspace que têm acesso à instância. Não há URL pública.

Use quando:

* O dashboard tem dados sensíveis
* Ainda está em construção
* Não há necessidade de compartilhamento externo

***

## Público

Qualquer pessoa com o link pode visualizar o dashboard, sem login.

### Configurar

<Steps>
  <Step title="Abrir compartilhamento">
    No dashboard, clique em **Compartilhar** no canto superior direito.
  </Step>

  <Step title="Selecionar Público">
    Escolha o modo **Público** no diálogo.
  </Step>

  <Step title="Definir slug">
    O slug compõe a URL pública: `/d/<prefixo-da-instancia>_<slug>`.

    O prefixo da instância é fixo (a partir do nome da instância). O sufixo você customiza ou deixa o sistema sugerir a partir do nome do dashboard.
  </Step>

  <Step title="Copiar link">
    Use **Copiar link** e compartilhe.
  </Step>
</Steps>

<Warning>
  No modo Público, **qualquer pessoa com o link** consegue ver. Não use para dashboards com dados de clientes, faturamento ou métricas sensíveis.
</Warning>

***

## Protegido por senha

Mesma URL pública, mas exige uma senha para visualizar. Útil para dashboards que precisam ser acessíveis a parceiros ou clientes específicos sem precisar cadastrá-los.

### Configurar

<Steps>
  <Step title="Selecionar modo">
    Escolha **Protegido por senha**.
  </Step>

  <Step title="Definir senha">
    Crie uma senha forte. Compartilhe pelo canal seguro (não envie no mesmo e-mail do link).
  </Step>

  <Step title="Slug e link">
    Configure o slug igual ao modo Público. O visualizador receberá uma tela de login antes do dashboard.
  </Step>
</Steps>

<Tip>
  Você pode **trocar a senha** a qualquer momento — todos os visualizadores serão deslogados.
</Tip>

***

## Restrito por e-mail

O modo mais seguro para compartilhamento externo. Apenas e-mails da lista autorizada podem entrar, e cada um recebe acesso individualmente.

### Como funciona

1. Você cadastra a lista de e-mails permitidos
2. O visualizador acessa o link e informa o e-mail
3. Se autorizado, recebe um código/senha por e-mail
4. Ele entra com essa credencial

### Configurar

<Steps>
  <Step title="Selecionar modo">
    Escolha **Restrito por e-mail**.
  </Step>

  <Step title="Adicionar e-mails">
    Cole ou digite os e-mails autorizados (um por linha ou separados por vírgula).
  </Step>

  <Step title="Salvar">
    A lista pode ser editada a qualquer momento. Remover um e-mail revoga o acesso imediatamente.
  </Step>
</Steps>

***

## Slug e URL

A URL final tem o formato:

```
https://<seu-dominio>/d/<prefixo-instancia>_<slug-dashboard>
```

| Parte             | Origem                                                              |
| ----------------- | ------------------------------------------------------------------- |
| **Prefixo**       | Nome da instância, normalizado                                      |
| **Sufixo (slug)** | Definido por você, ou sugerido automaticamente do nome do dashboard |

<Tip>
  O slug aceita letras, números, hífens e underlines. Mantenha curto e legível para facilitar o compartilhamento.
</Tip>

***

## Revogar acesso

Para revogar o acesso de todos:

1. Volte ao diálogo de compartilhamento
2. Mude para **Privado**
3. Salve

Para revogar **um e-mail específico** (modo restrito), basta removê-lo da lista.

***

## Boas práticas

<Tip>
  * Para dashboards executivos compartilhados com diretoria, use **Restrito por e-mail**.
  * Para dashboards operacionais internos, mantenha **Privado** e use o painel.
  * Para dashboards públicos de marketing (KPIs vitrine), o modo **Público** é OK.
  * Sempre que possível, use **filtros globais** para que o mesmo dashboard sirva diferentes audiências sem expor dados além do necessário.
</Tip>

<Warning>
  Antes de tornar um dashboard **Público**, revise os widgets:

  * Há dados pessoais (CPF, e-mail, telefone) na tabela?
  * Há valores monetários sensíveis?
  * Filtros estão configurados para limitar o escopo?
</Warning>