> 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

{% hint style="warning" %}
**Disponível para o perfil: Superadministrador**
{% 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.

***

### 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="/files/2ronBcefkWdMlP1e1rrx" alt=""><figcaption></figcaption></figure>

***

### Entendendo as Informações da Tela

<figure><img src="/files/pLRFoXHHRY2Pzx4bvPyj" 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.

#### 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="/files/xOoFVfLrsStI8aEm7j7g" 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="/files/Z25fcW0zBIeA77wAQBlC" 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 %}

***

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

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.

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.dev.br`.

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:** apenas um domínio
* **Unlimited:** todos os domínios utilizados na instalação, separados por vírgula

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

***

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

***

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