> For the complete documentation index, see [llms.txt](https://ajuda.digitalsac.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.digitalsac.io/digicrm/operacao-uso-do-sistema/configuracoes/links-externos.md).

# Links Externos

### Links Externos

**Finalidade:** cadastrar atalhos de URLs externas no menu do sistema (drawer ou topo), abertos em iframe ou nova aba, com restrição por perfil e ordem.

**Caminho:** Configurações → **Links Externos** (`/configuracoes/links-externos`)

**Código:** `LinksExternos.vue`\
**i18n:** `externalLinksManagement.*`

\[\[FOTO]]

***

#### Permissões / licença

| Requisito | Valor    |
| --------- | -------- |
| Menu      | Admin    |
| Licença   | **FREE** |

***

#### Lista

**Modos:** tabela / cards.

**Colunas:**

| Coluna | Valores                                     |
| ------ | ------------------------------------------- |
| Título | Texto do menu                               |
| URL    | Destino                                     |
| Local  | Menu lateral (`drawer`) ou superior (`top`) |
| Modo   | Iframe ou nova aba (`newtab`)               |
| Perfis | user / super / admin                        |
| Ordem  | Número (menor = primeiro)                   |
| Status | Ativo / Inativo                             |
| Ações  | Editar, remover, ativar/desativar           |

\[\[FOTO]]

***

#### Modal criar / editar

| Campo             | Propriedade       | Regras                             |
| ----------------- | ----------------- | ---------------------------------- |
| Título            | `title`           | Obrigatório                        |
| URL               | `url`             | Obrigatória e válida               |
| Ícone MDI         | `icon`            | Ex.: `mdi-web` (com preview)       |
| Local de exibição | `location`        | `drawer` \| `top`                  |
| Modo de abertura  | `openMode`        | `iframe` \| `newtab`               |
| Ordem             | `order`           | Menor número primeiro              |
| Link ativo        | `enabled`         | Toggle                             |
| Perfis com acesso | `profilesAllowed` | Usuário, Supervisor, Administrador |

**Ações:** Cancelar / Salvar; na lista: editar, excluir, toggle ativo.

\[\[FOTO]]

***

#### Regras

* Links inativos não aparecem no menu.
* Perfis não selecionados não veem o link.
* Iframe depende de o site destino permitir embed (X-Frame-Options / CSP).