> For the complete documentation index, see [llms.txt](https://ajuda.zdg.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.zdg.com.br/configuracao-superadmin/configuracoes/aplicativos-globais.md).

# Aplicativos Globais

{% hint style="warning" %}
**Disponível para o perfil: Super Admin**
{% endhint %}

Os **Aplicativos globais** colocam um sistema no menu das empresas (tenants) da sua instalação, sem precisar cadastrar empresa por empresa. Use para oferecer aos seus clientes a sua central de ajuda, o portal de pagamento, um sistema de relatórios ou qualquer ferramenta que você disponibiliza na revenda.

Você escolhe para quais empresas ou planos o aplicativo aparece e quais perfis o veem dentro de cada empresa. Se quiser, ele também aparece no seu menu do Super Admin.

{% hint style="info" %}
**Pré-requisitos:**

* Z-PRO na versão **4.0.7** ou superior.
* Acesso ao painel **Super Admin**.
* O endereço (URL) do sistema. Para abrir **Dentro do painel**, o endereço precisa ser **https**.
  {% endhint %}

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FNbgbE7C0rlisKgq1pO3w%2Fimage.png?alt=media&amp;token=e1f76b35-a6be-4d14-b71d-0c706ec2aff5" alt=""><figcaption></figcaption></figure>

***

### Como funciona

* Cada aplicativo global é um **endereço de site com nome e ícone**, que aparece no menu das empresas escolhidas.
* Você libera por **todas as empresas**, **empresas específicas** e/ou **planos**: basta a empresa estar em uma das opções.
* Dentro de cada empresa, **só os perfis marcados** veem o aplicativo.
* O **administrador de cada empresa pode ocultar** o aplicativo na empresa dele (**Ocultar nesta empresa**, no bloco **Aplicativos do provedor**).
* No menu da empresa, os **aplicativos da própria empresa aparecem primeiro** e os globais logo depois.
* Aplicativo global **abre só pelo menu**, não pelo contato nem pelo atendimento.
* Até **50 aplicativos globais**. As mudanças chegam aos usuários **em alguns segundos**.

{% hint style="info" %}
Cada empresa também pode cadastrar os próprios aplicativos, com abertura pelo contato e pelo atendimento. Veja Aplicativos.
{% endhint %}

***

### Como acessar

No painel **Super Admin**, clique em **Configurações** e selecione **Aplicativos globais**.

A tela mostra o bloco **Aplicativos cadastrados**, com o contador (ex.: **0 de 50**) e o botão **Novo aplicativo** no canto superior direito.

***

### Como cadastrar um aplicativo global

1. Clique em **Novo aplicativo**.
2. Preencha **Nome** (até 60 caracteres), **Endereço** e **Ícone**. Os campos são os mesmos do cadastro de aplicativos da empresa (veja Aplicativos).
3. Clique em **Testar**. Se aparecer o aviso "Este site não aceita ser aberto dentro de outro site. Escolha 'Nova aba' para ele.", use **Nova aba** no passo 5.
4. Em **Onde aparece no menu**, escolha a categoria do menu das empresas. Em **Onde aparece**, o **Menu lateral** já vem marcado e não muda: aplicativo global não abre pelo contato nem pelo atendimento, porque os dados dos clientes são de cada empresa.
5. Em **Como abre**, escolha **Dentro do painel** (só https) ou **Nova aba** (http ou https).
6. Defina **Para quais empresas** e **Perfis que veem dentro da empresa** (seções a seguir).
7. Se quiser o aplicativo também no seu menu, ligue **Mostrar no meu menu**.
8. Clique em **Salvar**.

{% hint style="info" %}
Quem não tem a categoria escolhida no menu vê o aplicativo em **Ferramentas**. No seu menu do Super Admin, ele aparece sempre em **Ferramentas**.
{% endhint %}

{% hint style="danger" %}
**Não coloque senha ou chave no endereço.** Quem vê o aplicativo vê o endereço completo.
{% endhint %}

***

### Para quais empresas

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2F29rtRmeqErVW5zQdP1Ul%2Fimage.png?alt=media&amp;token=d32571fb-f831-484c-8ace-8f0d76925d8c" alt="" width="375"><figcaption></figcaption></figure>

| Opção                    | Como funciona                                                                                                                   |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------- |
| **Todas as empresas**    | Liga o aplicativo para todas as empresas, inclusive as criadas depois                                                           |
| **Empresas específicas** | Clique em **Adicionar**, busque e marque as empresas, e clique em **Concluir**                                                  |
| **Planos**               | Clique em **Adicionar**, busque e marque os planos, e clique em **Concluir**. Todas as empresas desses planos veem o aplicativo |

Basta a empresa estar em **uma** das opções.

{% hint style="warning" %}
Enquanto nenhuma opção estiver escolhida, **nenhuma empresa vê o aplicativo**. O modal mostra esse aviso em laranja.
{% endhint %}

***

### Perfis que veem dentro da empresa

Marque quais perfis veem o aplicativo em cada empresa liberada: **Administrador**, **Supervisor**, **Atendente** e/ou **Todos os perfis personalizados**.

Diferente dos aplicativos da empresa, aqui não há liberação por usuário ou equipe: a regra vale por perfil, igual para todas as empresas.

***

### Mostrar no meu menu

Ligue **Mostrar no meu menu** para o aplicativo aparecer também para você, no menu do Super Admin, em **Ferramentas**.

***

### Lista de aplicativos globais

Depois de salvo, o aplicativo entra em **Aplicativos cadastrados**, e o contador mostra quantos já foram cadastrados (ex.: **1 de 50**).

| Coluna          | O que mostra                                                                                                 |
| --------------- | ------------------------------------------------------------------------------------------------------------ |
| **Aplicativo**  | Nome e, abaixo, a categoria do menu, como abre e o domínio. Ex.: Ferramentas · Nova aba · suporte.zdg.com.br |
| **Empresas**    | Quantas empresas e planos foram escolhidos. Ex.: 1 empresa · 1 plano                                         |
| **Perfis**      | Perfis que veem dentro da empresa                                                                            |
| **No meu menu** | Marca **No meu menu** quando **Mostrar no meu menu** está ligado                                             |
| **Situação**    | **Ativo** ou desativado                                                                                      |
| **Ações**       | Setas para mudar a ordem, lápis para editar e lixeira para excluir                                           |

A ordem da lista é a ordem em que os aplicativos globais aparecem no menu das empresas. No menu de cada empresa, eles vêm **depois dos aplicativos da própria empresa**, na mesma categoria.

***

### Variáveis e ficha assinada

O aplicativo global recebe no endereço **só os dados de quem abre, da empresa e a ficha assinada**. Para inserir, deixe o cursor no ponto do **Endereço**, clique em **Inserir variável** e clique na variável. Ao abrir o aplicativo, ela é trocada pelo dado de verdade.

| Variável               | Dado                                             | Onde pode ir no endereço     |
| ---------------------- | ------------------------------------------------ | ---------------------------- |
| `{{currentUserId}}`    | ID de quem abre (o usuário do painel que clicou) | No caminho ou nos parâmetros |
| `{{currentUserName}}`  | Nome de quem abre                                | Só depois do `?` ou do `#`   |
| `{{currentUserEmail}}` | E-mail de quem abre                              | Só depois do `?` ou do `#`   |
| `{{tenantId}}`         | ID da empresa de quem abre                       | No caminho ou nos parâmetros |
| `{{token}}`            | Ficha assinada                                   | No caminho ou nos parâmetros |

Exemplo:

```
https://portal.suarevenda.com.br/empresa/{{tenantId}}?usuario={{currentUserEmail}}
```

* **Dados do contato e do atendimento não existem no aplicativo global**: eles ficam só nos aplicativos de cada empresa.

#### Ficha assinada

A **ficha assinada** deixa a sua ferramenta reconhecer quem abriu sem pedir senha. Vale 5 minutos e só vai em endereço https.

1. Insira **Ficha assinada** no **Endereço**, de preferência depois do `#` (ex.: `https://portal.suarevenda.com.br/#t={{token}}`).
2. Clique em **Salvar**. A chave é criada ao salvar.
3. Abra o cadastro de novo (lápis) e copie a **chave pública** em **Chave da ficha assinada**. Logo abaixo ficam as instruções e os exemplos em Node.js e PHP para a ferramenta conferir a ficha.

No aplicativo global, a ficha traz quem abriu (`user`), a empresa (`tenant`) e `placement` igual a `menu`, sem contato nem atendimento. O passo a passo da conferência é o mesmo do aplicativo da empresa: veja Ficha assinada.

{% hint style="warning" %}
**Trocar o domínio do endereço gera uma chave nova.** Atualize a chave na sua ferramenta depois de mudar o domínio.
{% endhint %}

{% hint style="danger" %}
Como o aplicativo global abre em várias empresas, **identifique a pessoa pelo `user.id` junto com o `tenant.id`** (e o `iss`). O `user.id` sozinho não basta, e nome e e-mail podem ser trocados pelo administrador de cada empresa.
{% endhint %}

***

### Sites que não abrem dentro do painel

* Alguns sites proíbem ser abertos dentro de outro site. Use **Testar** no cadastro: se o site recusar, escolha **Nova aba**.
* Sistemas que pedem login costumam não manter a sessão dentro do painel, em qualquer navegador. Nesses casos, prefira **Nova aba**.
* Câmera, microfone e localização não funcionam dentro do painel.

***

### Resumo

| Quero…                                         | Onde                                                      |
| ---------------------------------------------- | --------------------------------------------------------- |
| Cadastrar um aplicativo para as empresas       | **Configurações → Aplicativos globais → Novo aplicativo** |
| Liberar para todas, algumas empresas ou planos | **Para quais empresas**                                   |
| Escolher os perfis que veem                    | **Perfis que veem dentro da empresa**                     |
| Ver o aplicativo no meu menu                   | Ligar **Mostrar no meu menu**                             |
| Tirar do menu sem apagar                       | Desligar **Ativo**                                        |
| Mudar a ordem                                  | Setas em **Ações**                                        |
| Editar ou excluir                              | Lápis ou lixeira em **Ações**                             |

***

### Possíveis erros e soluções

#### Nenhuma empresa vê o aplicativo

**Causa:** nenhuma opção marcada em **Para quais empresas**, ou o aplicativo está com **Ativo** desligado. **Solução:** ligue **Todas as empresas** ou adicione empresas ou planos, e confira o **Ativo**.

#### Uma empresa liberada não vê o aplicativo

**Causa:** o perfil do usuário não está marcado em **Perfis que veem dentro da empresa**, ou o administrador da empresa ligou **Ocultar nesta empresa**. **Solução:** marque o perfil no cadastro. Se foi ocultado, só o administrador da empresa pode mostrar de novo, em **Configuração → Aplicativos → Aplicativos do provedor**.

#### O aplicativo não aparece no Abrir em… do contato ou do atendimento

**Causa:** aplicativo global abre só pelo menu. **Solução:** para abrir pelo contato ou atendimento, o aplicativo precisa ser cadastrado pela empresa em **Configuração → Aplicativos**.

#### A ferramenta parou de reconhecer a ficha assinada

**Causa:** o domínio do endereço foi trocado, o que gera uma chave pública nova. **Solução:** copie a nova chave pública do cadastro e atualize na sua ferramenta.

#### O site não abre dentro do painel ou não mantém o login

**Causa:** o site proíbe ser aberto dentro de outro site, ou o sistema pede login. **Solução:** use **Testar** e, se preciso, mude **Como abre** para **Nova aba**.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://ajuda.zdg.com.br/configuracao-superadmin/configuracoes/aplicativos-globais.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
