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

# Compartilhar o dashboard

> Compartilhe seu dashboard por link externo com senha ou incorpore via embed (iframe).

O Metrito permite compartilhar um dashboard sem que a outra pessoa precise ter conta na plataforma. Clique em **Compartilhar** no topo do painel para abrir as opções. Há dois modos de distribuição.

<CardGroup cols={2}>
  <Card title="Link externo (com senha)" icon="link">
    Um link protegido por senha. Qualquer pessoa com o link e a senha consegue visualizar o painel.
  </Card>

  <Card title="Embed (token de acesso)" icon="code">
    Um código `<iframe>` para incorporar o dashboard em sistemas externos. O acesso é controlado por um token gerado automaticamente.
  </Card>
</CardGroup>

## Link externo (com senha)

Ideal para enviar o painel a um cliente ou sócio de forma rápida e segura.

<Steps>
  <Step title="Selecione “Link externo”">
    No modal **Compartilhar Dashboard**, escolha o modo **Link externo**.
  </Step>

  <Step title="Copie o link de acesso">
    O Metrito gera uma URL no formato `https://app.metrito.com/d/XXXXXXXX`. Use o botão de copiar.
  </Step>

  <Step title="Defina a senha de acesso">
    Informe uma senha obrigatória (mínimo de 4 caracteres) e clique em **Salvar**. Sem a senha, o link não abre.
  </Step>
</Steps>

<Warning>
  Quem tiver o link **e** a senha poderá ver o dashboard. Compartilhe a senha por um canal separado do link e troque-a se precisar revogar o acesso.
</Warning>

## Embed (incorporar via iframe)

Use o embed para exibir o dashboard dentro de outro sistema — um portal de cliente, uma área de membros ou uma intranet — sem pedir senha ao visitante.

<Steps>
  <Step title="Selecione “Embed”">
    No modal de compartilhamento, escolha o modo **Embed**.
  </Step>

  <Step title="Habilite o embed">
    Ative a opção **Habilitar embed**. Isso gera um **token único** que permite o acesso sem senha.
  </Step>

  <Step title="Copie o código de incorporação">
    O Metrito monta um `<iframe>` pronto. Cole-o na página onde quer exibir o painel:

    ```html theme={null}
    <iframe
      src="https://app.metrito.com/embed/SEU_DASHBOARD?token=SEU_TOKEN"
      width="100%"
      height="600"
      frameborder="0"
    ></iframe>
    ```
  </Step>
</Steps>

<Warning>
  Ao **desabilitar o embed**, o token é revogado e os iframes existentes param de funcionar. Reabilitar gera um novo token — e o código antigo deixa de valer.
</Warning>

## Qual modo escolher?

| Use **Link externo** quando…                 | Use **Embed** quando…                             |
| -------------------------------------------- | ------------------------------------------------- |
| Quer enviar o painel a uma pessoa específica | Quer exibir o painel dentro de outro site/sistema |
| Prefere proteger com senha                   | Quer acesso sem senha, controlado por token       |
| É um compartilhamento pontual                | É uma integração permanente em outra plataforma   |

## Próximos passos

<CardGroup cols={2}>
  <Card title="Filtros e granularidade" icon="filter" href="/dashboard/filtros-e-granularidade">
    Ajuste a visão antes de compartilhar.
  </Card>

  <Card title="Configurações do projeto" icon="gear" href="/conceitos/configuracoes-do-projeto">
    Defina logo e nome — eles aparecem no painel compartilhado.
  </Card>
</CardGroup>