# Widgets do Sistema
# Entendendo o funcionamento dos widgets do sistema
Os **Widgets do Sistema** permitem exibir uma tela de outra ferramenta diretamente dentro do Apresenta.me.
Com esse recurso, a equipe pode consultar painéis, relatórios ou informações de sistemas parceiros sem precisar abrir outra aba do navegador. O widget também pode utilizar informações do registro que está aberto no momento para direcionar automaticamente a ferramenta externa para o cliente, contrato ou cadastro correspondente.
---
##### **Navegação no Módulo**
[](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/widgets.gif)
**Rotina:** Configurações > Integrações > **Widgets do Sistema**
Nesta tela é possível cadastrar, configurar, ativar e remover os widgets utilizados no sistema.
---
##### **Entender a listagem de Widgets**
[](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/Mt4image.png)
Os widgets cadastrados são apresentados em uma listagem com suas principais informações.
| Campo
| Descrição
|
|---|
| **Código**
| Identificador interno do widget.
|
| **Título**
| Nome exibido na aba dentro do sistema.
|
| **Localização**
| Indica em qual área do sistema o widget será apresentado.
|
| **URL**
| Endereço da ferramenta externa carregada pelo widget.
|
| **Ordem**
| Define a posição da aba em relação aos demais widgets.
|
Para criar um novo widget, clique em **Cadastrar**.
---
##### **Identificar e posicionar o Widget**
[](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/Ztkimage.png)
Defina como o widget será identificado e onde ele será apresentado.
| Campo
| Descrição
|
|---|
| **Título da Aba**
| Nome exibido na aba dentro do sistema. Campo obrigatório.
|
| **Slug da Aba**
| Identificador curto utilizado para representar a aba.
|
| **Localização do Widget**
| Define em qual tela ou módulo o widget será exibido. Campo obrigatório.
|
| **Ordem de Exibição**
| Define a posição da aba em relação aos demais widgets da mesma localização.
|
| **Ícone do Widget**
| Define o ícone apresentado ao lado do título da aba.
|
---
##### **Informar a URL do Widget**
[](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/tiLimage.png)
A **URL do Widget** define qual página externa será carregada dentro do sistema.
| Campo
| Descrição
|
|---|
| **URL do Widget**
| Endereço completo da tela externa que será apresentada no widget. Campo obrigatório.
|
A URL também pode utilizar **variáveis**, permitindo que o endereço seja montado dinamicamente conforme a tela ou registro acessado pelo usuário.
| Variável
| Descrição
|
|---|
| `{id}`
| Código do próprio widget.
|
| `{url}`
| Endereço da página atual do sistema.
|
| `{company_id}`
| Código da imobiliária.
|
| `{module.propriedade}`
| Utiliza uma informação do registro atualmente aberto, como
`{module.id}`
.
|
Por exemplo, se uma ferramenta externa utiliza o código do cliente na URL, pode ser configurado:
`https://sistema-parceiro.com/cliente/{module.id}`
Ao abrir o cliente de código **150**, o endereço utilizado pelo widget será:
`https://sistema-parceiro.com/cliente/150`
Assim, o mesmo widget pode ser utilizado para diferentes registros sem precisar criar uma configuração para cada um.
Quando uma variável utilizada na URL não existe ou não possui valor, ela é substituída por vazio. Caso o widget abra uma página genérica ou diferente da esperada, confira se o nome da variável foi informado corretamente.
---
##### **Ajustar a exibição do Widget**
Também é possível controlar o espaço ocupado e em quais situações a aba deverá aparecer.
| Campo / Opção
| Descrição
|
|---|
| **Altura do Conteúdo**
| Define a altura ocupada pelo widget. Quando não informado, utiliza a altura disponível da tela. Pode aceitar uma medida fixa ou ajuste automático.
|
| **Esconder quando Cadastrando**
| Oculta a aba enquanto um novo registro está sendo criado.
|
| **Esconder quando Editando**
| Oculta a aba enquanto o registro estiver em modo de edição.
|
Quando o widget depende de informações do registro, como `{module.id}`, é recomendado habilitar Esconder quando Cadastrando. Durante a criação, o registro ainda pode não possuir um código e a variável utilizada na URL ficará vazia.
---
##### **Ativar e gravar o Widget**
Depois de concluir a configuração, defina se o widget ficará disponível.
Grave as informações para concluir. Após salvar, a aba passa a ser apresentada na localização configurada.
---
##### **Remover um Widget**
Para excluir um widget, selecione o registro correspondente na listagem e clique em **Remover**. Após a remoção, a aba deixa de ser exibida no sistema.
---
#### **Perguntas frequentes**
➜ **O que aparece dentro do Widget?** A página definida na **URL do Widget**. O conteúdo exibido e suas funcionalidades são controlados pela ferramenta externa.
➜ **Preciso saber programar para cadastrar um Widget?** Não necessariamente. Porém, a URL e as variáveis utilizadas precisam estar de acordo com o funcionamento da ferramenta externa.
➜ **A aba aparece para todos os usuários?** Ela é exibida na localização configurada para quem possui acesso àquela área do sistema. O conteúdo apresentado pela ferramenta externa pode possuir regras próprias de acesso.
➜ **Por que o Widget sempre abre a mesma página?** Verifique se a URL possui as variáveis necessárias e se elas estão escritas corretamente. Variáveis inexistentes ou sem valor são substituídas por vazio.
➜ **Posso cadastrar mais de um Widget?** Sim. É possível cadastrar vários widgets e utilizar a **Ordem de Exibição** para definir a sequência das abas.
➜ **Posso desligar um Widget temporariamente?** Sim. Desative a opção **Widget Ativo**. A configuração permanece salva e pode ser reativada posteriormente.
➜ **O Widget ocupa a tela inteira?** Quando a altura não é definida, ele utiliza o espaço disponível. O campo **Altura do Conteúdo** permite ajustar esse tamanho.
➜ **Por que esconder o Widget durante o cadastro?** Porque o novo registro pode ainda não possuir informações necessárias para montar a URL, como um código de identificação. Nesse caso, variáveis como `{module.id}` ainda não terão valor.