> 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.md).

# Gerenciar Licença Z-PRO

Ativar, renovar e gerenciar a licença do Z-PRO pela tela de Assinatura e pelo Painel do Licenciado: validar chave, trocar domínio, entender bloqueios e  status da assinatura.

{% hint style="warning" %}
**Disponível para o perfil: Superadministrador**\
Agora esse gerenciamento também está disponível no [**PAINEL DO LICENCIADO**](/configuracao-superadmin/tenants-e-licenca/gerenciar-licenca-z-pro/painel-do-licenciado.md)
{% endhint %}

A licença Z-PRO é o que mantém sua instalação ativa e com direito a atualizações. Ela é gerenciada pelo **Superadmin** e precisa ser ativada logo após a instalação, renovada anualmente e mantida associada ao domínio correto — caso contrário, o sistema é bloqueado automaticamente.

{% hint style="info" %}
**A gestão da licença também acontece fora da instalação.** No Painel do Licenciado você consulta status, validade, domínios, instalações e números da sua chave sem depender do Z-PRO estar no ar, e gerencia tudo isso com confirmação por e-mail. Esta página cobre a tela de Assinatura, que segue disponível dentro da instalação. **Acesse** [**painel.zdg.com.br**](https://painel.zdg.com.br)
{% endhint %}

***

### Acessando a Página de Assinatura

No menu lateral do painel **Superadmin**, localize a seção "TENANTS E LICENCIAMENTO" e entre na aba **Assinatura**.

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FgwlDLaFVJ1qVgadpjvpO%2Fimage.png?alt=media&amp;token=2b9b8add-4d5c-4855-8872-5808557c5fe1" alt=""><figcaption></figcaption></figure>

***

### Entendendo as Informações da Tela

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2Fo3Ls5kNejkioVI3FjeVZ%2Fimage.png?alt=media&amp;token=ff499d11-811d-4e55-9c75-2cd854ce9d26" alt="" width="342"><figcaption></figcaption></figure>

#### Licença

* **Status da Licença:** O estado atual da sua licença (Ativo, Inativo, Em Validação).
* **Código da Licença:** A sua chave de licença atual, parcialmente ofuscada por segurança.
* **Validade da Licença:** A data de vencimento da sua assinatura anual.
* **Domínio:** Domínio utilizado na instalação (não é necessário adicionar subdomínios).

#### Score do App Tech Provider

Mede os canais conectados via App Tech Provider compartilhado. Não inclui canais conectados via App Próprio. O score é compartilhado por chave de licença. Para ver os números de **todas** as instalações que usam a sua chave, e agir sobre eles, use a aba **Números** do Painel do Licenciado. Licenciados que revendem para muitos clientes podem contratar o add-on **Score Blindado**, que impede que números banidos de clientes travem a conexão de novos canais.

#### Versão do Sistema

* **Versão do Backend / Frontend:** As versões atuais da sua instalação Z-PRO.
* **Expira em:** A data limite em que a versão instalada deixa de receber suporte.
* **Dias restantes:** Contagem regressiva para a atualização obrigatória de versão.

{% hint style="warning" %}
Quando os dias restantes chegarem a zero, **o sistema para de funcionar mesmo com a licença em dia**. Atualize antes do prazo para evitar interrupção no atendimento.

[Procedimento Padrão de Atualização](/central-do-assinante/atualizacoes-e-status-do-z-pro/procedimento-padrao-de-atualizacao.md)
{% endhint %}

***

### Validade da Licença vs. Validade do Sistema

Estas são as duas datas que mais geram confusão no painel. Elas são independentes e controlam coisas completamente diferentes.

<table><thead><tr><th width="199.5"></th><th width="251.5">Validade da Licença</th><th>Validade do Sistema</th></tr></thead><tbody><tr><td><strong>O que é</strong></td><td>Sua assinatura anual paga</td><td>O prazo de vida da versão instalada</td></tr><tr><td><strong>O que acontece quando expira</strong></td><td>Você perde acesso à plataforma até renovar</td><td>O sistema <strong>para de funcionar</strong>, mesmo com a licença em dia</td></tr><tr><td><strong>Como renovar</strong></td><td>Acessando a página de renovação e pagando</td><td>Atualizando o Z-PRO para uma versão mais nova</td></tr><tr><td><strong>Depende da outra?</strong></td><td>Não</td><td>Não</td></tr></tbody></table>

{% hint style="info" %}
**Como funciona na prática:** cada versão do Z-PRO tem um período máximo de vida — geralmente alguns meses. Isso é um mecanismo de segurança que garante que todas as instalações sejam atualizadas com regularidade, recebendo correções e melhorias. Na prática, isso significa que você precisa atualizar pelo menos duas vezes por ano, independentemente de quando renova a licença.

Fique atento às duas datas: uma não substitui a outra.
{% endhint %}

***

### Ativar Licença (primeiro acesso)

Realize estes dois passos logo após a primeira instalação do Z-PRO.

#### Passo 1 — Adicionar o código de licença

1. Na página de Assinatura, clique no botão **"Alterar licença"**.
2. No campo **"Atualizar licença"**, cole a chave de licença recebida por e-mail após a compra.
3. Clique em **"Salvar"**.

{% hint style="warning" %}
Após salvar, o status pode levar alguns minutos para atualizar. Aguarde até que o sistema processe a validação e o status mude para **"Ativo"**.
{% endhint %}

{% hint style="info" %}
Não recebeu sua licença por e-mail? Abra um chamado de suporte administrativo em [suporte.zdg.com.br](https://suporte.zdg.com.br/).
{% endhint %}

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2F504DrBTav1MoaJcHlxOe%2Fimage.png?alt=media&amp;token=c3dd953b-740b-467a-9b1e-61a95886e6c4" alt=""><figcaption></figcaption></figure>

#### Passo 2 — Adicionar o domínio

1. Clique em **"Editar domínio"**.

{% hint style="danger" %}
Retire o domínio "whatsapp.com" e adicione o domínio da sua instalação. Não é necessário adicionar subdomínios — apenas o domínio raiz.
{% endhint %}

2. Adicione o(s) domínio(s) utilizados na instalação, separados por vírgula.

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FxVUZ9PgatcbOADOQuUwh%2Fimage.png?alt=media&amp;token=5a84f928-139c-418f-84c7-0e56e3afc6e7" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Fique atento ao seu plano:

* **One Domain:** adicionar apenas um domínio
* **Unlimited:** adicionar todos os domínios utilizados na instalação
  {% endhint %}

{% hint style="warning" %}
**O botão "Editar domínio" não funciona?** O titular da licença pode ter travado a gestão de domínios no Painel do Licenciado. Nesse caso os domínios continuam visíveis aqui, mas só podem ser alterados pelo painel. Isso é intencional: evita que quem tem acesso Super Admin altere os domínios da licença.
{% endhint %}

***

### Renovar Licença Anual

Quando você renova a assinatura por mais um ano, o procedimento para atualizar a data de expiração no sistema é simples.

{% hint style="info" %}
A renovação também pode ser feita pela aba **Renovação** do Painel do Licenciado, que já identifica o seu plano e mostra as opções de renovação e de troca de plano. Como o painel é externo, isso funciona mesmo com a instalação fora do ar.
{% endhint %}

1. **A chave de licença não muda.** Você continuará usando o mesmo código.
2. Após a confirmação do pagamento da renovação, acesse a página **"Assinatura"**.
3. Clique em **"Atualizar dados"**.
4. Aguarde alguns minutos. O sistema identificará a renovação e atualizará a **"Expiração da Licença"** no painel.

{% hint style="warning" %}
A nova data de validade será de mais 12 meses somados à data de vencimento **atual** — não à data em que o pagamento foi realizado.
{% endhint %}

***

### Perguntas Frequentes

#### Minha licença aparece como "Validando" ou recebo "License Error" ao fazer login. O que fazer?

Ambos os problemas geralmente estão ligados à configuração da licença. Verifique:

1. **Chave de licença:** confirme se a chave foi inserida corretamente na aba **Assinatura**.
2. **Domínio:** garanta que o domínio configurado é exatamente o mesmo usado para acessar a plataforma — sem subdomínios como `app.` ou `api.`, apenas o domínio principal (ex: `suaempresa.com.br`).
3. **Domínio padrão:** verifique se `whatsapp.com` não permanece no campo de domínio — ele deve ser removido e substituído pelo seu domínio.
4. **Instalação bloqueada ou domínio fora da lista:** se a licença é de um revendedor, o titular pode ter bloqueado esta instalação, ou ativado a opção de aceitar somente os domínios cadastrados no Painel do Licenciado. Confirme com o titular da licença antes de abrir chamado.

Se o erro persistir após essas verificações, abra um chamado no [suporte administrativo](https://suporte.zdg.com.br/).

***

#### Onde encontro minha chave de licença?

Sua chave foi enviada automaticamente para o e-mail cadastrado logo após a confirmação da compra. Verifique a caixa de entrada e a pasta de spam procurando por e-mails de `suporte@zdg.com.br`.

Você também consulta os dados da licença entrando no [Painel do Licenciado](https://painel.zdg.com.br) com o e-mail usado na compra, sem depender do e-mail original.

Se não encontrar, abra um chamado no [suporte administrativo](https://suporte.zdg.com.br/) solicitando o reenvio.

***

#### Por que o status da licença não atualizou depois de salvar?

O sistema leva alguns minutos para processar a validação com os servidores da ZDG. Aguarde e recarregue a página. Se após 10 minutos o status ainda não for **"Ativo"**, verifique se a chave e o domínio estão corretos.

***

#### Vejo duas datas diferentes no painel: "Expiração da Licença" e "Essa versão expira em". Qual é a minha data de renovação?

São datas completamente diferentes — veja a tabela de comparação acima.

A **"Expiração da Licença"** é a data da sua assinatura anual — quando você precisa renovar o pagamento.

A **"Essa versão expira em"** é o prazo da versão de software instalada — quando você precisa atualizar o Z-PRO. Passar dessa data sem atualizar faz o sistema parar de funcionar, mesmo com a licença paga.

***

#### Renovei minha licença mas a data no painel não mudou. O que fazer?

Acesse a aba **Assinatura** e clique em **"Atualizar dados"**. O sistema irá buscar a nova validade nos servidores. Aguarde alguns minutos.

Lembre que a nova data é calculada a partir da data de vencimento **anterior** — e não da data do pagamento. Se sua licença vencia em 01/11/2025, a nova expiração será 01/11/2026.

***

#### Quantos domínios posso adicionar na licença?

Depende do seu plano:

* **One Domain:** um domínio principal, com subdomínios ilimitados a partir dele (ex: `app1.suaempresa.com.br`, `app2.suaempresa.com.br`). Para usar um segundo domínio principal, existe o domínio extra.
* **Unlimited (legado, disponível apenas para renovação):** domínios principais diferentes, sem precisar partir de um domínio único.

Em ambos os casos, cadastre apenas o domínio raiz (ex: `suaempresa.com.br`), sem subdomínios.

Os domínios podem ser cadastrados aqui na tela de Assinatura ou pela aba **Domínios** do Painel do Licenciado. No painel também é possível restringir a licença para que ela funcione **somente** nos domínios cadastrados, o que protege a chave contra uso não autorizado.

***

#### O sistema parou de funcionar mas minha licença ainda está dentro da validade. O que acontece?

Provavelmente a **validade da versão instalada** expirou — veja a diferença entre as duas datas explicada acima. Mesmo com a licença em dia, se a versão do Z-PRO instalada passou do prazo de suporte, o sistema é bloqueado até que você atualize.

[Atualize o ZPRO](/central-do-assinante/atualizacoes-e-status-do-z-pro/procedimento-padrao-de-atualizacao.md)

Se a versão ainda está dentro do prazo, a segunda causa possível é o bloqueio pelo lado do licenciamento: a instalação pode ter sido bloqueada, ou o domínio dela pode estar fora da lista permitida, no [**Painel do Licenciado**](https://painel.zdg.com.br/). Quem contratou a licença consegue verificar e reverter isso em poucos minutos.

***

#### Como renovar minha assinatura?

Acesse [zpro.zdg.com.br/renovar](https://zpro.zdg.com.br/renovar/), informe o e-mail utilizado na compra original e siga para o checkout. Trabalhamos apenas com plano anual — não há renovação automática ou recorrência.

***

#### Ainda não consegui resolver. Como abrir suporte?

Abra um chamado no portal de suporte administrativo em [suporte.zdg.com.br](https://suporte.zdg.com.br/). Selecione o departamento **"Suporte Administrativo"** e descreva o problema com o print do status da licença e o domínio configurado.

#### [Link para aula completa - portal do assinante](https://portal.zdg.com.br/270021-sistema-zpro/5179463-primeiros-passos-e-ativacao-da-licenca)


---

# 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.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.
