> 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/tenants-e-licenca/gerenciar-licenca-z-pro/painel-do-licenciado.md).

# Painel do Licenciado

Como acessar e usar o Painel do Licenciado (painel.zdg.com.br): visão geral da   licença, instalações, canais, números do score, domínios, renovação e o add-on   Score Blindado.

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2F6RXy1676JDaINH0tge17%2Fimage.png?alt=media&amp;token=afbf50bb-af14-4cb9-886b-922c1142791d" alt="" width="563"><figcaption></figcaption></figure>

## Como usar o Painel do Licenciado

O **Painel do Licenciado** é o painel externo de gestão da sua licença Z-PRO, hospedado nos servidores da ZDG em [painel.zdg.com.br](https://painel.zdg.com.br/). Ele reúne, em um único lugar, tudo o que antes só existia dentro da tela de **Assinatura** do Super Admin: status e validade da licença, domínios liberados, instalações ativas, canais conectados, números do Score do App Tech Provider, renovação e add-ons.

Como o painel roda fora da sua infraestrutura, você continua gerenciando a licença mesmo com a instalação fora do ar. E como o acesso é feito pelo e-mail titular da licença, seus clientes não enxergam mais os domínios e as instalações uns dos outros.

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

* Licença Z-PRO comprada em seu nome (ativa, vencida ou bloqueada, o painel abre em qualquer caso)
* Acesso à caixa de entrada do e-mail cadastrado na compra da licença
* Instalação do Z-PRO atualizada, para que os recursos de trava de domínio e leitura de instalações funcionem
  {% endhint %}

***

### Como funciona

Antes do painel, toda a gestão do licenciamento acontecia dentro da instalação, na tela **Super Admin > Tenants e Licenciamento > Assinatura**. Isso trazia dois problemas: a tela é compartilhada com quem tem acesso Super Admin, então um cliente conseguia ver e editar os domínios de outro; e, se o backend estivesse caído, não havia como corrigir a licença justamente no momento em que isso era mais necessário.

O Painel do Licenciado resolve os dois pontos:

|                                          | Tela de Assinatura (Super Admin)        | Painel do Licenciado                      |
| ---------------------------------------- | --------------------------------------- | ----------------------------------------- |
| **Onde roda**                            | Dentro da sua instalação                | Nos servidores da ZDG                     |
| **Funciona com a instalação fora do ar** | Não                                     | Sim                                       |
| **Quem acessa**                          | Qualquer usuário com perfil Super Admin | Somente o e-mail titular da licença       |
| **Visão**                                | Apenas aquela instalação                | Todas as instalações que usam a sua chave |
| **Ações sensíveis**                      | Sem confirmação                         | Confirmação por código no e-mail          |

{% hint style="warning" %}
**Toda ação sensível pede confirmação por e-mail.** Bloquear uma instalação, adicionar domínio, travar a gestão de domínios ou desregistrar um número geram um código de confirmação enviado para o e-mail da licença. Mantenha esse e-mail acessível e seguro: quem tem acesso a ele tem acesso ao painel.
{% endhint %}

***

### Etapa 1: Acessar o painel

1. Abra [painel.zdg.com.br](https://painel.zdg.com.br/).
2. Informe o **e-mail cadastrado na licença**, o mesmo usado na compra.
3. Você receberá nesse e-mail um **link de acesso** e um **código de 6 dígitos**. Use qualquer um dos dois.
4. Clique no link ou informe o código para entrar.

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FtA6NJ2RjrlOvy9HPJwwD%2Fimage.png?alt=media&amp;token=a9d29ff7-de76-41da-8a50-ec86bd63e685" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
O link de acesso é de **uso único**. Depois de aberto, ele não funciona novamente. Para entrar de novo, solicite um novo acesso na tela de login.
{% endhint %}

{% hint style="info" %}
**Não sabe qual é o e-mail da sua licença?** Clique em **"Falar com suporte"** na própria tela de login e nosso time comercial confirma o endereço cadastrado.
{% endhint %}

Se o mesmo e-mail tiver mais de uma licença, todas aparecem listadas depois do login, cada uma com o seu status. Basta selecionar qual você quer gerenciar.

***

### Etapa 2: Visão geral (Dashboard)

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FhKx5bheUs6i5iwYA3K9I%2Fimage.png?alt=media&amp;token=69d6c10d-1d58-44b9-86f5-a0f2a39d0c7e" alt=""><figcaption></figcaption></figure>

A tela inicial mostra o retrato da licença selecionada:

* **Status da licença:** ativa, vencida ou bloqueada.
* **Dados da licença:** tipo de plano (One Domain, One Tenant ou Unlimited), validade e dias restantes para o vencimento.
* **Cards totalizadores:** instalações ativadas com a chave, domínios liberados, canais e números monitorados.
* **Conectividade das instalações:** quantas instalações deram sinal nas **últimas 24 horas** e quantas estão sem sinal.

{% hint style="info" %}
"Sem sinal" não significa licença inválida. Significa que aquela instalação não fez a leitura de licença nas últimas 24 horas, normalmente porque está desligada, foi desinstalada ou está com o servidor fora do ar.
{% endhint %}

Use a validade exibida aqui para se planejar: a renovação pode ser feita antes do vencimento, sem perder os dias restantes.

***

### Etapa 3: Instalações

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FjQyWnrwk8k4lyM7nje1G%2Fimage.png?alt=media&amp;token=9e3bf853-a012-4136-acdf-2c77f870bc1c" alt=""><figcaption></figcaption></figure>

A aba **Instalações** lista todos os endereços onde a sua chave de licença está ativada, com:

* o domínio ou subdomínio da instalação;
* a quantidade de números/canais ativos naquela instalação;
* a data da **última leitura** da licença, ou seja, o último sinal recebido;
* o status de bloqueio.

#### Bloquear uma instalação

Se você encontrar uma instalação que não reconhece, ou de um cliente que deixou de pagar:

1. Localize a instalação na lista e clique em **Bloquear**.
2. Confirme o endereço que será bloqueado.
3. Informe o **código de confirmação** enviado para o seu e-mail.
4. Confirme o aviso de que a instalação vai parar de funcionar.

O bloqueio é imediato: a partir dele, aquela instalação deixa de validar a licença e para de funcionar. O mesmo caminho permite **desbloquear** depois.

{% hint style="warning" %}
**Caso real:** um licenciado abriu o painel e encontrou dezenas de subdomínios que não conhecia. A licença dele havia sido compartilhada com terceiros e repassada adiante. Se ao abrir o painel você vir instalações que não são suas, bloqueie-as e, em seguida, considere travar os domínios (Etapa 6). Se a chave já estiver circulando, [abra um chamado](https://suporte.zdg.com.br/) para solicitar a substituição da licença.
{% endhint %}

***

### Etapa 4: Canais

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FkjGqBtPnm9HQRUJSFMXa%2Fimage.png?alt=media&amp;token=0c502a25-137e-48eb-ab5e-533233d7047d" alt=""><figcaption></figcaption></figure>

A aba **Canais** consolida o que está conectado em todas as instalações da sua chave:

* total de canais e quantos estão conectados neste momento;
* quebra **por tipo de canal** (WhatsApp Oficial, WhatsApp via API não oficial, Instagram, Messenger, Webchat, E-mail, marketplaces e demais integrações);
* quantidade de empresas (tenants) em cada instalação;
* horário da última leitura.

É a visão que responde, sem abrir um Super Admin de cada vez, quantos canais a sua operação inteira tem no ar.

***

### Etapa 5: Números (Score do App Tech Provider)

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FxLsJvcLPuEo57aexHTzR%2Fimage.png?alt=media&amp;token=79b35b67-d687-4221-820b-74931b317d4d" alt=""><figcaption></figcaption></figure>

A aba **Números** lista os números **WABA** conectados pelo App Tech Provider compartilhado da ZDG, que são os que influenciam o Score do App Tech Provider da sua licença. É aqui que você identifica os números com problema e age sobre eles.

Duas ações estão disponíveis:

**Desregistrar número**

1. Clique em **Desregistrar** no número desejado.
2. Informe os **últimos dígitos** do número para confirmar.
3. Confirme com o código enviado ao seu e-mail.

O sistema executa o desregistro junto à Meta e remove o número do App compartilhado.

**Remover do monitoramento**

Use quando o desregistro não for possível, por exemplo se o número já foi associado a outro aplicativo. Ele deixa de ser contabilizado no seu score.

{% hint style="warning" %}
**Remover do monitoramento não resolve sozinho.** Se o número continuar conectado em uma instalação que usa a sua licença, a checagem de saúde que rodamos periodicamente em todas as instalações vai encontrá-lo novamente e reassociá-lo ao seu score em algumas horas.

O tratamento definitivo é resolver o canal na origem: desconectar o número no Z-PRO do cliente, ou reconectá-lo em um App Próprio.
{% endhint %}

***

### Etapa 6: Domínios

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FxMuLp4pznucC7vmN58cP%2Fimage.png?alt=media&amp;token=f10acd4f-8f89-4eb7-b7d8-57e441988eb7" alt=""><figcaption></figcaption></figure>

A aba **Domínios** é onde fica o controle mais fino sobre onde a sua licença pode ser usada.

#### Adicionar um domínio

1. Clique em **Adicionar domínio**.
2. Informe o domínio (apenas o domínio raiz, sem subdomínios).
3. Confirme com o código recebido por e-mail.

#### Travar a gestão de domínios no painel

Na tela de Assinatura do Super Admin, qualquer usuário com esse perfil consegue editar os domínios da licença. Para impedir isso:

1. Na aba **Domínios**, escolha **Travar a gestão neste painel**.
2. Confirme com o código enviado por e-mail.

A partir daí, os domínios continuam **visíveis** na tela de Assinatura, mas o botão de editar deixa de funcionar para os seus clientes. Toda alteração passa a ser feita exclusivamente pelo painel.

{% hint style="info" %}
Adicionar um domínio pelo painel já ativa a trava automaticamente. Para devolver a edição à tela de Assinatura, use **Devolver a gestão à instalação** e confirme com o código. A informação leva alguns minutos para propagar até a instalação.
{% endhint %}

#### Aceitar somente os seus domínios

Licenças **Unlimited** não têm restrição de domínio por padrão: qualquer domínio que use a chave consegue ativar a instalação. Se você quer que a sua licença funcione **apenas** nos domínios cadastrados:

1. Na aba **Domínios**, marque a opção de **aceitar somente os domínios cadastrados**.
2. Clique em **Travar** e confirme.

Qualquer tentativa de ativar a licença em um domínio fora da lista passa a falhar. É a proteção mais eficaz contra uma chave que vazou.

{% hint style="danger" %}
Antes de travar, confira se todos os domínios que você realmente usa estão cadastrados. Se faltar algum, aquela instalação para de validar a licença.
{% endhint %}

***

### Etapa 7: Renovar a licença pelo painel

A renovação continua disponível no site, em [zpro.zdg.com.br/renovar](https://zpro.zdg.com.br/renovar/), e agora também dentro do painel, na aba **Renovação**. O painel já identifica o seu plano e mostra as opções aplicáveis:

* **Licença Unlimited:** renovar como Unlimited ou migrar para o plano **One Domain** (Revenda), que trabalha com subdomínios ilimitados de um domínio principal.
* **Licença One Domain:** renovar como One Domain ou migrar para o plano **One Tenant** (Uso Próprio), indicado para quem opera um único painel.

Escolha a opção, siga para o checkout e a validade é atualizada após a confirmação do pagamento.

{% hint style="info" %}
A nova validade é somada à data de vencimento **atual**, e não à data do pagamento. Renovar antes do vencimento não faz você perder dias.
{% endhint %}

***

### Etapa 8: Score Blindado (add-on)

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FjST4GmbdmtUQGhVEGCrG%2Fimage.png?alt=media&amp;token=68cab5df-8367-4f01-ba43-2a1efbdcd37c" alt=""><figcaption></figcaption></figure>

O **Score Blindado** é um complemento de licença contratado no menu **Score Blindado** do painel, onde ficam os valores e as condições.

**O problema que ele resolve:** o Score do App Tech Provider é compartilhado por chave de licença. Se o número de um cliente seu é banido ou fica com qualidade vermelha e não é tratado a tempo, a pontuação da licença inteira cai e você fica impedido de conectar **novos** números WABA pelo nosso App. Na prática, um cliente que faz spam trava a operação de todos os outros.

**O que muda com o add-on ativo:**

* Números banidos ou em qualidade vermelha deixam de penalizar o score da sua licença.
* Você continua conectando novas contas WABA pelo App Tech Provider mesmo com números bloqueados na conta.
* Acaba a rotina de sair desconectando número banido só para liberar a pontuação.

Depois de ativado, o aviso **"Score Blindado ativo"**, com a data de validade do add-on, passa a aparecer na tela **Super Admin > Tenants e Licenciamento > Assinatura**.

{% hint style="warning" %}
O Score Blindado protege a **sua licença**, não os números do seu cliente. O número que a Meta baniu continua banido, e as regras de qualidade da Meta continuam valendo para cada número individualmente. O que o add-on faz é impedir que esse problema se propague para a sua capacidade de conectar novos canais.
{% endhint %}

{% hint style="info" %}
**Para quem faz sentido:** licenciados que revendem para muitos clientes e não conseguem controlar o comportamento de cada um. Se a sua operação é enxuta e você acompanha a qualidade dos seus números, o Score Blindado não é necessário: siga as práticas do artigo Score do App Tech Provider.
{% endhint %}

***

### Etapa 9: Atividade

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FiTE8U6DdwbC0zrr8KoNo%2Fimage.png?alt=media&amp;token=1e354c45-c199-4792-af76-8b06c33de5a2" alt=""><figcaption></figcaption></figure>

A aba **Atividade** é o registro de auditoria da licença: o histórico do que foi feito na conta e por quem. Cada linha traz a **data e hora**, a **ação** e a **origem** (o e-mail que executou).

Entre os eventos registrados estão:

* acessos ao painel (login por link ou por código);
* pedidos de acesso à licença;
* ações sensíveis confirmadas por código — bloqueio e desbloqueio de instalação, adição de domínio, trava e devolução da gestão de domínios, desregistro ou remoção de número do monitoramento;
* renovações e contratação de add-ons.

{% hint style="info" %}
Use a aba **Atividade** quando desconfiar que a chave foi compartilhada ou quando mais de uma pessoa tem acesso ao e-mail titular: ela mostra de qual endereço partiu cada alteração e em que momento.
{% endhint %}

***

### Etapa 10: Roadmap

A aba **Roadmap** traz, dentro do painel, o **roadmap público** do Z-PRO ([roadmap.zdg.com.br](https://roadmap.zdg.com.br/)): o board de sugestões, os itens em desenvolvimento e o que já foi entregue. Sem sair do painel, você pode:

* acompanhar o que está planejado, em andamento e concluído;
* **votar** nas sugestões que fazem mais diferença para a sua operação;
* enviar uma **nova sugestão** de funcionalidade.

{% hint style="info" %}
Pedido de recurso novo entra por aqui. O roadmap público é onde a priorização acontece — quanto mais votos um item recebe, mais peso ele ganha. Não trabalhamos com desenvolvimento sob demanda por fora dessa fila.
{% endhint %}

***

### Etapa 11: Onboarding (Primeiros passos)

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FK9NOMk5IpBUZZl0PKXWl%2Fimage.png?alt=media&amp;token=b717fe23-f055-4b9e-8b58-d51eb9966dcb" alt=""><figcaption></figcaption></figure>

A aba **Onboarding** é o guia de primeiros passos da licença: leva você do servidor contratado até o sistema no ar. O item aparece no menu lateral com um **selo de progresso** (por exemplo, **2/5**), que mostra quantos passos você já concluiu.

A tela se chama **Primeiros passos** e traz os cinco passos na ordem, cada um como um cartão expansível. Você **marca cada passo ao concluir** — o círculo à esquerda vira um ✓ verde e a barra de progresso avança.

| Passo                           | O que você faz                                                                                                                                                                     |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **1. Comece por aqui**          | Ponto de partida: pega a **chave de licença** e conhece os canais de apoio (central de ajuda, canal de avisos no Telegram, roadmap).                                               |
| **2. Preparar o ambiente**      | Contrata a VPS e aponta os **dois subdomínios** para o IP dela.                                                                                                                    |
| **3. Instalar o sistema**       | Agenda a instalação com a equipe da ZDG ou roda o script de instalação por conta própria.                                                                                          |
| **4. Ativar a licença**         | No Super Admin da instalação, em **Tenants e Licenciamento > Assinatura**, cola a chave e informa o **domínio principal**. Depois confere o domínio na aba **Domínios** do painel. |
| **5. Diretrizes da plataforma** | Lê **Manutenção e Segurança**, **Política de Suporte Técnico** e os **Termos de Uso e Licenciamento** antes de pôr a operação em produção.                                         |

Cada cartão traz uma descrição curta e, quando existir, os links de **vídeo-aula** e de **documentação completa** daquele passo.

No rodapé da tela fica o atalho **"Tem dúvida ou precisa de ajuda técnica? Abrir um chamado"**, que leva ao [suporte.zdg.com.br](https://suporte.zdg.com.br/).

{% hint style="info" %}
Os passos são marcados manualmente. Você pode marcar e desmarcar a qualquer momento — o progresso serve para você se organizar, não trava nenhuma função do painel.
{% endhint %}

***

### Resumo das Funcionalidades

| Funcionalidade                                      | Onde acessar                                                            |
| --------------------------------------------------- | ----------------------------------------------------------------------- |
| Entrar no painel                                    | [painel.zdg.com.br](https://painel.zdg.com.br/) com o e-mail da licença |
| Ver status, plano e validade                        | **Visão geral**                                                         |
| Ver instalações ativas e último sinal               | **Instalações**                                                         |
| Bloquear ou desbloquear uma instalação              | **Instalações > Bloquear / Desbloquear**                                |
| Ver canais conectados por tipo e por instalação     | **Canais**                                                              |
| Desregistrar número ou remover do monitoramento     | **Números**                                                             |
| Adicionar domínio                                   | **Domínios > Adicionar domínio**                                        |
| Impedir que clientes editem domínios no Super Admin | **Domínios > Travar a gestão neste painel**                             |
| Restringir a licença aos domínios cadastrados       | **Domínios > Aceitar somente os domínios cadastrados**                  |
| Renovar ou migrar de plano                          | **Renovação**                                                           |
| Contratar o add-on                                  | **Score Blindado**                                                      |
| Ver o histórico de ações e acessos da licença       | **Atividade**                                                           |
| Acompanhar e votar no roadmap, enviar sugestões     | **Roadmap**                                                             |
| Seguir o guia de primeiros passos da licença        | **Onboarding**                                                          |

***

### Encerramento

Com o Painel do Licenciado você deixa de depender da instalação para administrar a licença e passa a ter controle real sobre onde a sua chave é usada. Para quem revende, a recomendação é fazer três coisas logo no primeiro acesso: revisar a lista de instalações, bloquear o que não reconhecer e travar a gestão de domínios no painel.

***

### Possíveis Erros e Soluções

#### Não recebi o e-mail com o link ou o código de acesso

**Causa:** e-mail digitado diferente do cadastrado na licença, ou mensagem retida no spam.

**Solução:** confira a pasta de spam procurando mensagens da ZDG e confirme o endereço cadastrado. Se não souber qual é, clique em **"Falar com suporte"** na tela de login.

#### O link de acesso não funciona quando clico de novo

**Causa:** o link é de uso único.

**Solução:** volte a [painel.zdg.com.br](https://painel.zdg.com.br/) e solicite um novo acesso.

#### Aparecem instalações e subdomínios que eu não reconheço

**Causa:** a chave de licença foi compartilhada com terceiros em algum momento.

**Solução:** bloqueie as instalações na aba **Instalações**, cadastre apenas os seus domínios e ative **aceitar somente os domínios cadastrados**. Se a chave já circulou bastante, [abra um chamado](https://suporte.zdg.com.br/) e solicite a substituição da licença.

#### "A Meta não aceitou a operação" ao desregistrar um número

**Causa:** o número não está mais vinculado ao App Tech Provider da ZDG, geralmente porque foi associado a outro aplicativo ou removido pelo lado da Meta.

**Solução:** use a opção **Remover do monitoramento** para tirar o número do seu score.

#### Removi o número do monitoramento, mas ele voltou a aparecer no score

**Causa:** o número continua conectado em uma instalação que usa a sua licença, e a checagem periódica de saúde o reassociou.

**Solução:** desconecte o canal no Z-PRO onde ele está ativo, ou reconecte esse número em um App Próprio. Detalhes em Score do App Tech Provider.

#### Meu cliente ainda consegue editar os domínios na tela de Assinatura

**Causa:** a trava ainda não propagou, ou a instalação está em uma versão anterior à que faz a checagem no painel.

**Solução:** aguarde alguns minutos e recarregue a tela de Assinatura. Se continuar, atualize a instalação seguindo o Procedimento Padrão de Atualização.

#### Uma instalação legítima parou de funcionar depois que travei os domínios

**Causa:** o domínio dela não está na lista de domínios cadastrados.

**Solução:** adicione o domínio na aba **Domínios** e aguarde alguns minutos para a instalação voltar a validar a licença.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ajuda.zdg.com.br/configuracao-superadmin/tenants-e-licenca/gerenciar-licenca-z-pro/painel-do-licenciado.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.